How to Use the ACRCloud Music Recognition MCP in Vercel AI SDK

Build live music recognition into your React or Next.js app using the Vercel AI SDK.

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 Vercel AI SDK

Create your Vinkius account to connect ACRCloud Music Recognition to Vercel AI SDK 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 Vercel AI SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Stream Audio Identification via MCP Server

Your Vercel AI SDK agent uses `identify_music_from_url` right from the edge. Pass an audio file URL from your frontend, and the model streams back the exact track details instantly. We designed this to eliminate loading spinners. The moment ACRCloud matches the acoustic fingerprint, the track name, artist, and album art appear in your user's UI.

Deep Metadata Retrieval

Fetching industry-standard track data happens through `get_track_by_isrc`. Your agent grabs the exact release details, label info, and publishing data without making the user wait. Next.js handles the UI updates while the Vercel AI SDK streams the raw MCP response into readable text. You get instant catalog verification directly in the browser.

Live Catalog Search

Users can hunt for specific music using `search_tracks`, `search_artists`, and `search_albums`. They type a lyric fragment, and your agent queries the ACRCloud database live. Instead of building custom search endpoints, you pass these tools to the streamText function. The AI client figures out which search to run based on the user's prompt.

Setup guide

Set up ACRCloud Music Recognition MCP in Vercel AI SDK

Prerequisites

Node.js 18+ and a TypeScript project
ai + @modelcontextprotocol/sdk packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies

Run npm install ai @modelcontextprotocol/sdk plus your preferred model provider (e.g. @ai-sdk/openai).
2

Create the Streamable HTTP transport

Use StreamableHTTPClientTransport with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and use tools

Call mcpClient.tools() to auto-discover all ACRCloud Music Recognition tools. Pass them directly to generateText() or streamText() — no manual schema definitions needed.
4

Works with any model provider

Swap openai("gpt-4o") for any AI SDK provider — Anthropic, Google, Mistral. The MCP tools work identically across all supported models.

index.ts

import { experimental_createMCPClient as createMCPClient } from "ai";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp";
import { generateText } from "ai";
import { openai } from "@ai-sdk/openai";

const transport = new StreamableHTTPClientTransport(
  new URL("https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp")
);

const mcpClient = await createMCPClient({ transport });
const tools = await mcpClient.tools();

const { text } = await generateText({
  model: openai("gpt-4o"),
  tools,
  prompt: "List recent ACRCloud Music Recognition transactions",
});

console.log(text);
await mcpClient.close();

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 Vercel AI SDK

Install @ai-sdk/mcp and call createMCPClient. Point the transport URL to your Vinkius endpoint. Pass the resulting mcpClient.tools() into streamText or generateText.

Yes, the HTTP transport works perfectly on the edge. Your Next.js route handlers can call the tools without needing a heavy Node.js environment. Just remember to call mcpClient.close() when the stream finishes.

You pass a direct URL to an audio file like an MP3 or WAV. The tool reads that remote file and matches it against the ACRCloud database.

That is the main advantage of this setup. When the agent calls a search tool, the text response streams directly into your React or Svelte UI component while the operation executes.

Vinkius runs this MCP server inside an isolated V8 sandbox. The audio URLs, ISRC codes, and search queries you send are processed ephemerally and instantly discarded. Nothing persists after the connection closes.

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