How to Use the Genius MCP in Cursor

Inject real music metadata into your code with Cursor. The Genius MCP Server fuels your agent with live data for your next app.

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 Cursor

Create your Vinkius account to connect Genius to Cursor 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 Cursor

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Search songs inside the editor

Call `search_songs` directly from your chat window to find the right track IDs for your code. It works just like a database query, returning titles and metadata in real-time. Stop stubbing your API responses. You’re working with live data from the start, which makes your development cycle much faster.

Get song details for your project

Use `get_song` to pull lyrics and production info into your codebase. It’s useful if you’re building a music player or a lyric-analysis tool that requires real-time data. The output gives you everything from cover art to producer names. You can feed this into your UI components without any extra formatting steps.

Explore artist catalogs with Cursor

Pull full song lists for any artist using `get_artist_songs`. If you need profile data, `get_artist` gives you the IQ score and official bio. This data helps you build features that rely on artist discographies. You'll have the full list of tracks at your fingertips for testing or building out your app's backend.

Setup guide

Set up Genius MCP in Cursor

Prerequisites

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

1

Open MCP Settings

Go to Cursor Settings → MCP or open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and search for "MCP: Add Server".
2

Add the Genius MCP

Cursor will create or open .cursor/mcp.json in your project root. Paste the JSON snippet on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Enable Agent mode

Open Composer (Cmd+I / Ctrl+I) and switch to Agent mode using the dropdown at the top. MCP tools are only available in Agent mode.
4

Verify the connection

Ask Cursor something like "List my recent Genius transactions." If the MCP tools are loaded correctly, Cursor will call the Genius tools automatically. You can also check Settings → MCP for a green status indicator.

.cursor/mcp.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 Cursor

Add the server to your .cursor/mcp.json file. Once configured, you can call the search tool during any coding session to find specific tracks.

Absolutely, just pass the song ID into the retrieval tool. The AI will inject the lyrics directly into your context window.

It is. You can set it up globally or per-project to start using these tools immediately in your agent sessions.

Use the artist ID to call the profile tool. You'll get back the artist name, image, and description for your application logic.

Your key is stored as an environment variable on your local machine. The server reads it only to authenticate requests to the Genius API, keeping your credentials out of your project files.

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