MCP server Pro

Your media library, in your agent's hands.

Point Claude Desktop, Claude Code, Cursor or any MCP client at MetaTana. Your agent can search the library, run scans and scrapes, find duplicate copies and organize files, with your MetaTana sign-in.

Download MetaTana Read the MCP guide

US$5 a month · desktop app on macOS, Windows and Linux

claude_desktop_config.json

{
  "mcpServers": {
    "metatana": {
      "command": "/Applications/MetaTana.app/Contents/MacOS/MetaTana",
      "args": ["--mcp-stdio"],
      "env": {
        "METATANA_DATA_DIR": "/Users/you/Library/Application Support/MetaTana/data"
      }
    }
  }
}

macOS example. Copy yours from Settings › Maintenance › Advanced › MCP.

An open standard for connecting agents to tools.

Model Context Protocol lets an AI client use tools on your computer. MetaTana's MCP server runs inside the installed app, so there is no separate install and nothing to host. Your agent works through the same local API the app uses, and the app's own checks apply to every call.

modelcontextprotocol.io

Eight MCP tools over the local API.

metatana_statusChecks the app is running, the sign-in, Pro, and the AI credits left this session.Read
metatana_accountShows the account and what its plan includes, without revealing the session.Read
metatana_openapiReads the local API reference, optionally for one path prefix.Read
metatana_readReads anything the local API offers: titles, folders, the Inbox, Activity.Read
metatana_organize_previewPlans movie, TV and anime file moves for up to 500 titles without writing anything.Preview
metatana_organize_executeMoves the files from one approved preview, once.Moves files
metatana_apiMakes library changes: scans, scrapes, metadata, NFO and artwork, renames, duplicates and sync.Library changes
metatana_workflowsLists the steps for common jobs: scan, scrape, organize, sync, subtitles and AI.Read

One config for Claude Desktop, Claude Code and Cursor.

Windows and Linux use the same config with their own app path. MetaTana copies the right one.

In MetaTana, open Settings › Maintenance › Advanced › MCP and click Set up.
Click Copy next to MCP client config. It holds this install’s app path and data folder.
Paste it into ~/Library/Application Support/Claude/claude_desktop_config.json. Merge it into mcpServers if you already have servers.
Restart Claude Desktop while MetaTana is running.
Ask Claude to call metatana_status.

claude_desktop_config.json

{
  "mcpServers": {
    "metatana": {
      "command": "/Applications/MetaTana.app/Contents/MacOS/MetaTana",
      "args": ["--mcp-stdio"],
      "env": {
        "METATANA_DATA_DIR": "/Users/you/Library/Application Support/MetaTana/data"
      }
    }
  }
}

In MetaTana, open Settings › Maintenance › Advanced › MCP and click Set up.
Copy the stdio command. It shows this install’s app path and data folder.
Run the claude mcp add command with that path and folder.
Run /mcp in Claude Code and check that metatana is connected.
Ask Claude to call metatana_status.

terminal

claude mcp add metatana \
  -e METATANA_DATA_DIR="$HOME/Library/Application Support/MetaTana/data" \
  -- /Applications/MetaTana.app/Contents/MacOS/MetaTana --mcp-stdio

In MetaTana, open Settings › Maintenance › Advanced › MCP and click Set up.
Click Copy next to MCP client config.
In Cursor, open Settings › MCP and add a new global MCP server. Cursor opens ~/.cursor/mcp.json.
Paste the config and save. Keep MetaTana running.
The MetaTana tools appear in Cursor’s tool list.

~/.cursor/mcp.json

{
  "mcpServers": {
    "metatana": {
      "command": "/Applications/MetaTana.app/Contents/MacOS/MetaTana",
      "args": ["--mcp-stdio"],
      "env": {
        "METATANA_DATA_DIR": "/Users/you/Library/Application Support/MetaTana/data"
      }
    }
  }
}

What an agent can't change.

Reads are open. Changes are limited to library work: scans, scrapes, the Inbox, metadata, NFO and artwork, subtitles, renames, duplicates, collections and sync.

Always refused through MCP

Settings, provider keys and AI models
Sign-ins for MetaTana, media servers and Trakt
Creating or editing hooks, webhooks and tools
Reset, backup export and backup restore
Opening files in other programs

Sign-in and plans.

Pro

The MCP server looks for a signed-in Pro account before it lists any tools. After that, each request is checked against your plan.

What your agent sees	What it means	What to do
No MetaTana toolsStartup stops	MetaTana couldn't find a signed-in Pro account when the server started.	Sign in with Pro in MetaTana, then restart your agent.
Not signed in401	The local API key or your MetaTana sign-in is missing.	Copy the config again from Settings and restart your agent.
Your plan doesn't include this402	The request needs a feature your plan doesn't have.	Don't retry until the plan changes.
Couldn't check your plan503	MetaTana couldn't reach the plan check.	Try again later.

Things to ask your agent.

“Find the duplicate copies in my 4K folder and tell me which ones to keep.”
metatana_read
“Rename and file the new episodes in my shows folder.”
metatana_organize_preview, then metatana_organize_execute
“Which titles are missing artwork? Fetch it for them.”
metatana_read, metatana_api

FAQ

Do I need Pro?

Yes. The MCP server is part of Pro, at US$5 a month or US$50 a year. It checks for a signed-in Pro account when it starts.

Which agents work with it?

Any MCP client that can start a local stdio server, including Claude Desktop, Claude Code and Cursor.

Does it work on Windows and Linux?

Yes. The installed desktop app runs the MCP server on macOS, Windows and Linux. The config has the same shape with your install's path. On Linux the copied command adds two switches so it starts without a display, for example over SSH.

Is there an MCP URL?

No. MCP runs over stdio through the installed app, so there is nothing to host. MetaTana must be running while your agent uses it.

Can an agent spend all my AI credits?

No. Each MCP session can spend at most 20 AI credits by default. Set METATANA_MCP_AI_CREDIT_LIMIT in the client's env to change the limit, or set it to 0 to turn AI calls off.

Connect your agent to MetaTana.

Included with Pro, along with 100 AI Vision credits a month.

Download MetaTana Read the MCP guide