Adtest MCP server

AdTest.AI MCP server

· Registry name: ai.adtest/adtest-mcp · License: MIT

Adds a single analyzeadvert tool to Claude (Desktop, Code, or any MCP client) that runs AdTest.AI's AI-only 13-dimension analysis of an advert — image, video, or text** — and returns a detailed scoring report. (Human-panel validation is available in the web app only, not through this server.)

Quick add for Claude Code:

claude mcp add adtest -e ADTEST_API_KEY=adk_your_key_here -- npx -y adtest-mcp

Setup

icon → Generate key. Make sure your wallet has funds — each successful analysis costs $1.

1. Get an API key: sign in at → the Developer (gear)

claudedesktopconfig.json; Claude Code: .mcp.json):

1. Add the server to your Claude config (Claude Desktop:

{
     "mcpServers": {
       "adtest": {
         "command": "npx",
         "args": ["-y", "adtest-mcp"],
         "env": { "ADTEST_API_KEY": "adk_your_key_here" }
       }
     }
   }

Or run it from a local checkout (after npm install in this folder):

{
     "mcpServers": {
       "adtest": {
         "command": "node",
         "args": ["/absolute/path/to/mcp-server/index.js"],
         "env": { "ADTEST_API_KEY": "adk_your_key_here" }
       }
     }
   }

1. Restart Claude, then just ask:

• “Analyze this advert: https://example.com/ad.jpg”
• “Analyze this ad video file: /Users/me/promo.mp4”
• “Score this ad copy: 50% off all shoes this weekend — shop now.”

The tool

analyzeadvert — provide one** of:

Returns the AI analysis text plus the amount charged and your remaining balance.

How it works (async — so video works)

The server submits the job to POST /developer/ai-analysis/jobs, gets a jobid back immediately, then polls GET /developer/ai-analysis/jobs/{jobid} every few seconds until it's complete or failed. This is why video works: a single synchronous request would be cut off by the CDN edge timeout (~100s), but video analysis can take several minutes. You're charged once, on success, when the job completes — a failed job is never billed.

Notes

• Registered in the official MCP Registry as ai.adtest/adtest-mcp.

ADTESTAPIBASE for staging.

• Auth is the x-api-key header, set from ADTESTAPIKEY.
• Endpoint defaults to https://app.adtest.ai/adtest-api; override with

(milliseconds) for very long video.

• Poll ceiling defaults to 15 min; override with ADTESTPOLLTIMEOUT_MS

generous (240/min) and handled for you.

• Rate limits: 30 submits/min and 2000/day per key (60/min per IP); polling is

nocreative, invalidurl, unsupportedmediatype, toomanyrequests, analysisfailed (the last is not** charged).

• Errors come back as readable text: invalidapikey, insufficient_funds,

• Requires Node ≥ 18.

Links

• Product:
• Setup guide and FAQ:
• App and API keys:
• Issues:

License

MIT — see LICENSE.