How to Use the AudD Music Recognition MCP in Claude Code

Q: How do I add the AudD Music Recognition MCP server to Claude Code?

Run claude mcp add --transport http audd-music-recognition-mcp -- in your terminal. Ensure all flags come before the server name. Verify the installation by running claude mcp list.

Q: How do I find a song by text query in the terminal?

You tell the agent to execute the searchmusic tool with your query string. It hits the MCP Server and prints the matching track, artist, and album data directly to your console.

Pipe audio URLs and lyric queries through Claude Code for headless music identification.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect AudD Music Recognition MCP to Claude Code

Create your Vinkius account to connect AudD Music Recognition to Claude Code 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 AudD Music Recognition with Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Headless Music Recognition

The `recognize_music` tool processes audio URLs and returns structured JSON containing artist, title, and streaming platform links. You run a terminal command, and your agent hits the API to identify the MP3 file. You don't even need to leave your shell. Processing large podcast archives requires targeted extraction. Claude Code triggers `recognize_at_time` to identify background music at specific timestamps, allowing you to script automated copyright checks across hundreds of files in your CI/CD pipeline.

Query Lyrics via Claude Code

The `search_lyrics` tool takes a text string and returns the matching song metadata. You pipe a text file into your CLI agent, and it queries the MCP Server to find the track details associated with those words. Grabbing the full text requires the `get_lyrics` endpoint. Your terminal agent pulls the complete song verses and outputs them directly to standard out or writes them to a local file in your repository.

Manage Audio Streams

The `add_monitored_stream` tool registers live broadcast URLs for continuous track detection. You instruct your agent to start watching a server feed, and it initiates the monitoring process entirely from the command line. Routing those detection events requires `set_stream_callback_url`. Claude Code configures your webhook destination, then executes `list_monitored_streams` to output a formatted table of all active audio feeds currently running on the service.

Setup guide

Set up AudD Music Recognition MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see audd-music-recognition-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest AudD Music Recognition transactions." It will automatically discover and invoke the available AudD Music Recognition tools.

Terminal

claude mcp add --transport http audd-music-recognition-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
2

Add the AudD Music Recognition 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

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "audd-music-recognition-mcp": {
      "type": "url",
      "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 AudD. 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 AudD Music Recognition 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 AudD Music Recognition MCP in Claude Code

Run `claude mcp add --transport http audd-music-recognition-mcp -- ` in your terminal. Ensure all flags come before the server name. Verify the installation by running `claude mcp list`.

Yes. You'll wrap the CLI commands in a shell script to iterate over a list of audio URLs. The agent processes each link and outputs the track metadata as JSON for your next pipeline step.

It runs perfectly in headless environments like GitHub Actions. You pass the audio files or stream URLs to the agent, and it executes the recognition tasks without any GUI interaction.

You tell the agent to execute the `search_music` tool with your query string. It hits the MCP Server and prints the matching track, artist, and album data directly to your console.

Vinkius processes your live audio feed URLs through an ephemeral, isolated sandbox. The execution context vanishes immediately after the API call completes. The platform never logs your webhook destinations or the contents of your lyric searches.

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