MCP

SnapAny ships a hosted MCP server (Model Context Protocol, Streamable HTTP). Once it's set up you can just say "extract the video and images from this link" in Claude Code, Codex or Cursor and the agent will call SnapAny — no code required. Same API key, same billing as the REST API.

Endpoint: https://api.snapany.com/mcp

Before you start

You need an API key first. Two steps:

1. Create a key under API Keys, then claim 50 free credits in the console
2. Copy that key — it starts with sk_snapany_

The sk_snapany_xxx in every config below is a placeholder you must replace with your own real key. Pasting it as-is won't fail loudly up front, but every call afterwards will.

See Authentication for key rotation and limits.

Claude Code

claude mcp add --transport http snapany https://api.snapany.com/mcp \
  --header "Authorization: Bearer sk_snapany_xxx"

This only applies to the directory you ran it in. Add -s user to make it available in every project.

Codex

# ~/.codex/config.toml
[mcp_servers.snapany]
url = "https://api.snapany.com/mcp"
http_headers = { "Authorization" = "Bearer sk_snapany_xxx" }

~ is your home directory; create the file if it doesn't exist. Restart Codex afterwards.

Generic JSON config (Cursor and others)

Cursor reads ~/.cursor/mcp.json (global) or .cursor/mcp.json in the project root (that project only). For other clients, check their docs for the MCP config file location.

{
  "mcpServers": {
    "snapany": {
      "url": "https://api.snapany.com/mcp",
      "headers": { "Authorization": "Bearer sk_snapany_xxx" }
    }
  }
}

Restart the client afterwards.

Verify the connection

In Claude Code, run:

claude mcp list

Seeing snapany listed as connected means you're set — /mcp inside a session works too. Other clients show the server in their MCP settings panel. If the seven tools below are listed, it's working.

Available tools

extract_post, extract_playlist and extract_subtitles return direct links and metadata, not the files themselves. youtube_proxy_download returns the same shape as extract_post, plus proxy URLs (*_proxy_url) for YouTube variants up to 1080p, valid for 30 minutes to 1 hour. To actually save something locally, have your agent download the link it got back — most clients can do that directly. If a YouTube direct link fails with 403, have it call youtube_proxy_download and download the *_proxy_url instead.

Credits

New developers can claim 50 free credits in the console, and credits never expire. Your balance and top-ups live there too; per-call usage is under Credits history.

When you run out, tools return Insufficient credits. Full billing rules are in Credits & Billing.

Troubleshooting

Next steps

• Authentication — creating and rotating API keys
• Credits & Billing — the billing model and topping up
• API Reference — full endpoint docs with a try-it console

Try telling your agent: "Extract this YouTube video and transcribe its audio with speaker labels: https://..."