How to Use the Musixmatch MCP in Vercel AI SDK

Q: How do I install the Musixmatch toolset in my Vercel AI SDK project?

Run npm install ai @ai-sdk/mcp in your terminal. Next, initialize the client using createMCPClient pointing to your Vinkius endpoint, and pass the tools directly into streamText.

Q: Can I fetch track snippets instead of full lyrics?

Yes, use gettracksnippet instead of gettracklyrics. This is ideal when you want to show a quick hook preview in your music player UI without consuming too much bandwidth.

Feed real-time lyrics and artist metadata directly into your React frontends 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 Musixmatch MCP to Vercel AI SDK

Create your Vinkius account to connect Musixmatch 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 Musixmatch with Vercel AI SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Real-time lyric streams in Vercel AI SDK

The Musixmatch MCP server exposes `get_track_lyrics` to fetch full song texts instantly. When your user asks for song details, your Vercel AI SDK app streams the lines line-by-line into the UI. No more waiting for a massive payload to download before showing anything on screen. You can combine this with `get_track_snippet` to show quick previews during live searches. The SDK handles the chunked transfer on Edge Functions, keeping your music search interface fast and responsive.

Match messy user queries to exact tracks

The `match_track_lyrics` tool identifies songs based on partial or misheard lyrics entered by the user. Your AI client takes whatever broken phrase the user types, sends it to the Musixmatch API, and gets back clean metadata. This means your search bar can resolve vague inputs without requiring a perfect title. By pairing this with `search_tracks`, the SDK renders interactive cards for the closest matches. It lets you build a search experience that feels like a native music app.

Build rich artist dashboards on the fly

The `get_artist_details` tool pulls biography data and metadata for any musician in the database. When a user clicks an artist, your agent uses this tool to instantly populate the view. It prevents you from having to pre-render thousands of static pages. Use `get_artist_albums` to list their discography right next to the bio. The Vercel AI SDK handles these concurrent tool calls easily, updating your React state as each piece of data resolves.

Setup guide

Set up Musixmatch 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 Musixmatch 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 Musixmatch 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 Musixmatch. 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 Musixmatch 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 Musixmatch MCP in Vercel AI SDK

Run `npm install ai @ai-sdk/mcp` in your terminal. Next, initialize the client using `createMCPClient` pointing to your Vinkius endpoint, and pass the tools directly into `streamText`.

Yes, this MCP server runs perfectly on the edge. Because the Vercel AI SDK is built for edge runtimes, you can fetch lyric data via `get_track_lyrics` without hitting cold start delays.

The SDK relies on your application's error handling or Vinkius proxying. If `get_top_tracks` hits a rate limit, the SDK receives a standard API error, which you can catch in your stream configuration to show a fallback UI.

Yes, use `get_track_snippet` instead of `get_track_lyrics`. This is ideal when you want to show a quick hook preview in your music player UI without consuming too much bandwidth.

Vinkius runs the server in an isolated sandbox, meaning your search queries and the retrieved lyrics are never stored or logged. Your API keys for the music database are kept encrypted in your environment variables, ensuring secure transit.

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