
Tracktag Mcp
io.github.adigoldPublished by GitHub account adigoldv0.2.0Updated Oct 28, 2026
AI music analysis for agents: BPM, key, genres, moods, instruments and 35+ tags per track.
Overview
TrackTag MCP lets an assistant analyze audio files or URLs for BPM, key, genres, moods, instruments and 35+ metadata fields via the TrackTag API.
- What you can do
- Analyze a local audio file (mp3, wav, flac, aiff, m4a, ogg) and return BPM, key, genres, moods, instruments, energy and 35+ metadata fields
- Analyze audio from an https URL
- Check the remaining credit balance and limits
- List recent API analyses
- Run small batches by calling the analysis tool once per track and summarizing the results
- When to use it
- Useful when you want an assistant to produce consistent, catalog-grade music metadata for tracks, sync libraries or marketplaces instead of guessing from a file name. Suited to conversational, handful-of-tracks work; larger catalogs are pointed to TrackTag Studio or the API.
- Requirements
- Runs as a local process started by the MCP client (npx tracktag-mcp, or a one-click Claude Desktop bundle). Requires a TrackTag API key supplied in the TRACKTAG_API_KEY environment variable, created in the TrackTag studio; free test keys are available. Network access to TrackTag is needed for analysis.
Installation
In SourceWeft
- Open Tracktag Mcp in the dashboard and add it to a workspace.
- Enable the server for the chats that should use its tools.
Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.
Other MCP clients
Follow the launch instructions in the repository.
README
TrackTag MCP Server
Let AI agents (Claude Desktop, Claude Code, Cursor, and any MCP-capable client) analyze music with TrackTag: drop an MP3 into your agent, say "analyze this track", and get BPM, key, genres, moods, instruments, energy and 35+ metadata fields back.
Runs entirely on your own computer — your agent app starts it, talks to it directly (no middleman server, so your audio and API key never leave your machine on the way to TrackTag), and stops it when you quit. Analyses are billed from your TrackTag credit balance (1 credit per track with the core model, 2 with ultra); failed analyses are refunded automatically.
Setup
First, get an API key: tracktag.me/studio → API & MCP → Create key (tt_live_…). Free test keys available.
⚡ One-click install (Claude Desktop) — recommended
Download tracktag.mcpb → double-click it → Claude Desktop opens an install window → paste your API key → done. No config files, no Node.js, nothing to edit. (One Claude quirk: after installing, flip the extension ON in Settings → Extensions.)
Manual config (Cursor, Claude Code, other MCP clients)
Add the server to your agent's MCP config:
Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):
Claude Code:
Cursor (~/.cursor/mcp.json): same JSON block as Claude Desktop.
Tools
Docs
Full API reference: tracktag.me/developers
Can I analyze multiple tracks? (batching)
Yes — small batches work right in the chat. Drop several audio files into your assistant (or name a folder's worth of tracks) and say "analyze all of these with TrackTag" — the agent calls the analysis tool once per track and summarizes the results together. Each track bills its own credit, and the default rate limit (10 requests/minute) makes this comfortable for a handful of tracks at a time.
For real catalog work, use the tools built for it: TrackTag Studio runs 100-file batches with folders, progress tracking and XLSX/CSV/XML exports, and the TrackTag API handles high-volume pipelines with async jobs and webhooks. Same engine, same credits — pick the surface that fits the job: MCP for conversation, Studio for catalogs, API for automation.
"Can't I just drag the MP3 into ChatGPT or Claude and ask?"
Not if you want real, reliable metadata — and here's the honest breakdown.
Claude cannot hear audio, and ChatGPT doesn't musically analyze it. Drop an MP3 into a Claude chat and it sees the file's name and metadata — it never processes the actual sound. ChatGPT will at best transcribe any speech in the file; it won't tell you the key, the groove or the instrumentation from the waveform. Whatever "analysis" comes back is largely an educated guess from the title. This MCP server is what gives your assistant real ears.
Some models can accept audio — but a raw model is not an analysis product. TrackTag runs every track through a purpose-built pipeline: audio preprocessing, signal-level analysis of the actual waveform (tempo, tonality, timbre, instrumentation, vocal characteristics, dynamics), an extraction process tuned specifically for music metadata, and validation of every result against a strict 35+ field taxonomy with controlled vocabulary. A one-off chat prompt gives you different fields, different wording and different judgments every single run — fine for curiosity, useless for a catalog.
Consistency is the product. Sync libraries, marketplaces and labels need the same schema, the same vocabulary and the same standards across 10 or 10,000 tracks — plus batch handling and automatic refunds when an analysis fails. That's engineering around the model, not the model itself, and it's what you're getting here.
Your AI assistant does what it's great at — conversation and workflow. TrackTag does what it's built for — turning sound into professional, uniform metadata.
About the creator
TrackTag is built by Adi Goldstein — a composer and music producer based in Tel Aviv who has spent years on both sides of the problem: writing and licensing music, and wrestling with the metadata that makes it findable. TrackTag exists because tagging a catalog by hand is the least musical part of making music.
It's part of a family of tools Adi builds for musicians and creators:
Questions, ideas, or building something with the TrackTag API? Reach out via tracktag.me/support.
Source: README.md at commit e04c784
Tools
0Version history
1- v0.2.0LatestSep 16, 2026
Score
40% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
- Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
- Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
- Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
- DescriptionRequired15 pts
- Logo10 pts
- Documentation15 pts
- License10 pts
Declare a license in the repository or the registry entry.