How to Use the Genius MCP in Windsurf

Q: How does Windsurf use the Genius MCP Server to find songs?

Cascade triggers searchsongs with your query to find the correct track ID. From there, it automatically feeds that ID into other tools to pull lyrics or album art without requiring you to copy the ID manually.

Q: Can Windsurf build a local database of Genius artist catalogs?

Yes, Cascade uses getartistsongs to loop through paginated results for any artist. It writes the titles and pageviews directly into a local JSON or markdown file in your workspace.

Q: What format do the lyrics arrive in?

The getsong tool returns lyrics in both plain text and structured HTML. This lets your agent parse the text easily or render formatted lyrics in your local workspace.

Let Windsurf search lyrics, pull song metadata, and explain annotations automatically without asking for permission.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Genius MCP to Windsurf

Create your Vinkius account to connect Genius to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Genius with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Auto-chain Genius search and lyric extraction

`search_songs` lets Cascade find any track on Genius and immediately pass the ID to `get_song` for the full text. Windsurf handles this chain in a single pass without waiting for you to type the next prompt. You get the exact lyrics and release details in your editor window. The agent handles the intermediate ID matching behind the scenes, saving you from manual copy-paste steps.

Map full discographies in Windsurf

`get_artist_songs` fetches paginated tracks for any musician you specify while Cascade manages the page parameters. This MCP Server integration allows Windsurf to crawl entire catalogs to build local databases or markdown files. Cascade reads the returned JSON, figures out the total page count, and loops through the pages automatically. You end up with a clean, structured file containing every title and pageview metric.

Extract annotations directly inside Windsurf

`get_song_annotations` retrieves the community-written explanations for specific lyric lines so your agent can analyze references. This Genius MCP Server connection gives Windsurf the context it needs to explain complex metaphors or cultural references. If the initial returned reference is vague, Cascade triggers `get_annotation` to pull the full HTML breakdown and author details. Your agent then presents the complete backstory right alongside your active codebase.

Setup guide

Set up Genius MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Genius MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Genius payment history." If connected, Cascade will call the Genius tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "genius-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Genius. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Genius now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Genius MCP in Windsurf

Cascade triggers `search_songs` with your query to find the correct track ID. From there, it automatically feeds that ID into other tools to pull lyrics or album art without requiring you to copy the ID manually.

Yes, Cascade uses `get_artist_songs` to loop through paginated results for any artist. It writes the titles and pageviews directly into a local JSON or markdown file in your workspace.

No, Vinkius manages the API connection and token rotation on its side. You only need to add the single Vinkius MCP Server endpoint to your configuration file.

The `get_song` tool returns lyrics in both plain text and structured HTML. This lets your agent parse the text easily or render formatted lyrics in your local workspace.

Yes, your search queries and song IDs pass through a secure, ephemeral V8 sandbox that deletes all session data immediately after execution. Vinkius never logs the specific lyrics or artist profiles you look up.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript