How to Use the ACRCloud Music Recognition MCP in Windsurf

Give Windsurf an audio URL and watch Cascade autonomously identify the song, fetch its ISRC, and map the artist's entire catalog.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect ACRCloud Music Recognition MCP to Windsurf

Create your Vinkius account to connect ACRCloud Music Recognition 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 ACRCloud Music Recognition with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Cascade automates audio recognition

`identify_music_from_url` lets Cascade analyze raw audio files directly from your workspace prompts. You hand the agent a link to a mysterious MP3, and it instantly runs the analysis to extract the exact track details. Cascade doesn't stop at the name. Once it gets the match, it automatically chains the next steps to pull the full record label and release year without you asking.

Deep catalog searches via Windsurf MCP Server

`search_tracks` and `search_albums` give your workspace immediate access to the global ACRCloud database. Cascade uses these to cross-reference partial lyrics or vague artist names you throw at it during development. The agent builds complete tracklists by linking these search results. It makes organizing music databases or building playlist generators inside this IDE incredibly fast.

Instant ISRC metadata resolution

`get_track_by_isrc` resolves industry-standard codes into rich metadata. When you are writing code in Windsurf, Cascade pulls release dates, rights holders, and regional details using this MCP tool. This eliminates manual database lookups. Your agent verifies track licensing data and populates your local files in one autonomous run.

Setup guide

Set up ACRCloud Music Recognition 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 ACRCloud 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

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 ACRCloud Music Recognition payment history." If connected, Cascade will call the ACRCloud Music Recognition tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "acrcloud-music-recognition-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 ACRCloud. 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 ACRCloud 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 ACRCloud Music Recognition MCP in Windsurf

Cascade runs the tools autonomously when you ask about a song. It detects when you mention an audio URL, calls the recognition engine, and presents the metadata directly in your chat.

Yes, Cascade uses the track search tool to find matches from partial lyric snippets. It then automatically queries the artist and album databases to give you a full profile.

Cascade handles this by looping through a list of audio URLs. It triggers the identification tool for each file and writes the results to a structured JSON file in your workspace using the MCP protocol.

The tool accepts standard formats like MP3, WAV, and AAC. Just provide a direct, publicly accessible URL to the file, and the server handles the rest.

Vinkius runs the server in a secure, isolated sandbox. Your audio URLs and ISRC queries pass directly to ACRCloud for processing and are never stored or logged on our infrastructure.

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