DecryptAds MCP

Model Context Protocol bridge (Streamable HTTP) for ads.txt, sellers.json, and supply-chain investigations.

Endpoint

Use this URL in your MCP client (remote / HTTP transport):

https://mcp.decryptads.com/mcp

Transport path is /mcp, not the site root. Backend: same REST API as api.decryptads.com/docs.

API key (required)

MCP is available only to DecryptAds accounts. Each user connects with their own API key (same tokens as the REST API).

  1. Sign in at decryptads.com.
  2. Open Account → API keys and create a token.
  3. Copy the key when shown (svw_…); it is displayed only once.
  4. Add it to your MCP client (see below).

Send the token on every MCP request as Authorization: Bearer <key> or X-API-Key: <key>. The bridge validates it, then forwards it to the API (rate limits and monthly quota apply per user). Revoke the key in the app to disable MCP immediately.

See also: How to use the API.

Client setup

Cursor

Edit ~/.cursor/mcp.json or a project .cursor/mcp.json:

{
  "mcpServers": {
    "decryptads": {
      "url": "https://mcp.decryptads.com/mcp",
      "headers": {
        "Authorization": "Bearer svw_YOUR_KEY_HERE"
      }
    }
  }
}

Restart Cursor. Tools appear in the MCP panel after a successful connection.

Claude Desktop

Same url and headers block in claude_desktop_config.json under mcpServers. Restart the app fully.

Claude Code

claude mcp add --transport http decryptads https://mcp.decryptads.com/mcp \
  --header "Authorization: Bearer svw_YOUR_KEY_HERE"

More clients and examples: Using DecryptAds with MCP (blog).

Tools

After you connect with a valid API key, your MCP client lists tools from the server (tools/list). Names and descriptions match the deployed bridge. Below is the current catalog (grouped); parameters are in each tool’s schema in the client.

Hostname investigation

Schain & file hashes

Crawl

Stats & analytics

Compare & diff

sellers.json

ads.txt / app-ads.txt

Store app catalog

Impression logs

Large impression-log uploads are not exposed via MCP; use the web UI, then poll with get_impressionlog_analysis_job.

Example prompts

More documentation

MCP and REST share the same API keys and backend. For scripts without an AI assistant, call the REST API directly.