How to Use the AcoustID MCP in LangChain

Q: How can my LangChain agent use AcoustID to find a song from an audio clip?

Your agent will use the lookupbyfingerprint tool. Just pass it the fingerprint string and audio duration, and it returns potential matches with confidence scores.

Q: Can a LangChain agent add new songs to the AcoustID database?

Yes. The agent calls the submitfingerprint tool. It needs the fingerprint and duration, and can optionally include the track name and artist if it has them.

Q: My agent has a song title, not a fingerprint. Can it still use this MCP server?

Absolutely. The searchbyrecording tool is for exactly that. Your agent passes it the track name and artist to get back the correct AcoustID and MusicBrainz ID.

Build music identification agents with LangChain. Chain AcoustID lookups, submissions, and metadata searches into a single workflow.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect AcoustID MCP to LangChain

Create your Vinkius account to connect AcoustID to LangChain 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 AcoustID with LangChain

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Build Song Recognition Chains

Give your LangChain agent the AcoustID tools and watch it solve problems. It can try to `lookup_by_fingerprint` first. If that match seems weak, the agent can decide to use the result to `search_by_recording` as a fallback. You're building a reasoning process, not just calling an endpoint. An agent can identify a track, grab its MusicBrainz ID, then immediately use `search_by_mbid` to find alternate versions of the same song. LangSmith shows you every step the agent took to get there.

Automate Your Music Library

A LangChain agent can manage a music database for you. It can monitor for new tracks and use `submit_fingerprint` to add any unidentified songs to the public AcoustID database. The agent decides when a new submission is actually needed. This is more reliable than a simple script. You can build a chain that first calls `search_by_recording` to check if the song already exists under a slightly different name. Your agent handles the logic, preventing duplicates and keeping your data clean.

Create Rich Metadata Pipelines with your LangChain MCP Server

This isn't just about finding a song title. You can build a pipeline that takes an audio fingerprint, runs `lookup_by_fingerprint`, extracts the AcoustID from the result, and then passes it to `get_recording_metadata` automatically. The final output is a complete record with artists, release groups, and more, all from one initial input. Your agent connects the dots between different AcoustID tools, creating a richer dataset than any single tool call could provide. This is what an MCP Server is for.

Setup guide

Set up AcoustID MCP in LangChain

Prerequisites

Python 3.10+ installed
langchain-mcp-adapters + langgraph packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run pip install langchain-mcp-adapters langgraph langchain-openai. The MCP adapters package converts MCP tools into native LangChain BaseTool objects.
2

Connect via HTTP transport
Use MultiServerMCPClient with "transport": "http" pointing to your Vinkius endpoint. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Create a ReAct agent
Pass the discovered tools to create_react_agent() from LangGraph. The agent automatically routes AcoustID tool calls through the MCP protocol.
4

Run with any LLM
Swap ChatOpenAI for ChatAnthropic, ChatGoogleGenerativeAI, or any LangChain-compatible model. The MCP tools work identically across all providers.

agent.py

from langchain_mcp_adapters.client import MultiServerMCPClient
from langgraph.prebuilt import create_react_agent
from langchain_openai import ChatOpenAI

async with MultiServerMCPClient({
    "acoustid-mcp": {
        "transport": "http",
        "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
    }
}) as client:
    tools = client.get_tools()

    agent = create_react_agent(
        ChatOpenAI(model="gpt-4o"),
        tools,
    )
    result = await agent.ainvoke({
        "messages": "List recent AcoustID transactions"
    })
    print(result["messages"][-1].content)

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 AcoustID. 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 AcoustID 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 AcoustID MCP in LangChain

Your agent will use the `lookup_by_fingerprint` tool. Just pass it the fingerprint string and audio duration, and it returns potential matches with confidence scores.

Yes. The agent calls the `submit_fingerprint` tool. It needs the fingerprint and duration, and can optionally include the track name and artist if it has them.

Have your agent get the MusicBrainz ID for a known version of the song first. Then, it can use the `search_by_mbid` tool to find all other AcoustIDs linked to that same recording, giving you a list of all known fingerprints.

Absolutely. The `search_by_recording` tool is for exactly that. Your agent passes it the track name and artist to get back the correct AcoustID and MusicBrainz ID.

The AcoustID MCP Server only processes the audio fingerprint string and track metadata you submit. Vinkius runs the server in an ephemeral sandbox, and your connection is secured by your single endpoint token. The raw audio never leaves your machine.

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