English Français العربية

ai.adtest/adtest-mcp

Official registry Marketing and sales

AI-only ad scoring for Claude: score image, video or text ads on 13 dimensions before you spend.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package adtest-mcp
Claude Code 
claude mcp add adtest-mcp -e 'ADTEST_API_KEY=<your adtest_api_key>' -e 'ADTEST_API_BASE=<ADTEST_API_BASE>' -e 'ADTEST_POLL_TIMEOUT_MS=<ADTEST_POLL_TIMEOUT_MS>' -- npx -y adtest-mcp@1.1.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "adtest-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "adtest-mcp@1.1.0"
            ],
            "env": {
                "ADTEST_API_KEY": "<your adtest_api_key>",
                "ADTEST_API_BASE": "<ADTEST_API_BASE>",
                "ADTEST_POLL_TIMEOUT_MS": "<ADTEST_POLL_TIMEOUT_MS>"
            }
        }
    }
}

Environment variables

  • ADTEST_API_KEY required secret AdTest.AI developer API key (app.adtest.ai → Developer → Generate key). Each successful analysis costs 1 credit.
  • ADTEST_API_BASE Optional API base URL override (default https://app.adtest.ai/adtest-api).
  • ADTEST_POLL_TIMEOUT_MS Optional max wait for a job in milliseconds (default 900000 = 15 min).

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. AdTest.AI MCP server
  2. Setup
  3. The tool
  4. How it works (async — so video works)
  5. Notes
  6. Links
  7. License

AdTest.AI MCP server

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

Adds a single analyze_advert 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

  1. Get an API key: sign in at https://app.adtest.ai → the Developer (gear) icon → Generate key. Make sure your wallet has funds — each successful analysis costs $1.

  2. Add the server to your Claude config (Claude Desktop: claude_desktop_config.json; Claude Code: .mcp.json):

     {
   "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" }
     }
   }
 }
  3. 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

analyze_advert — provide one of:

argmeaning
urlpublic URL of an image or video advert (we download it)
file_pathlocal image/video file to upload
textad copy to analyze
brand_url (optional)advertiser website — improves brand/logo detection

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 job_id back immediately, then polls GET /developer/ai-analysis/jobs/{job_id} 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.
  • Auth is the x-api-key header, set from ADTEST_API_KEY.
  • Endpoint defaults to https://app.adtest.ai/adtest-api; override with ADTEST_API_BASE for staging.
  • Poll ceiling defaults to 15 min; override with ADTEST_POLL_TIMEOUT_MS (milliseconds) for very long video.
  • Rate limits: 30 submits/min and 2000/day per key (60/min per IP); polling is generous (240/min) and handled for you.
  • Errors come back as readable text: invalid_api_key, insufficient_funds, no_creative, invalid_url, unsupported_media_type, too_many_requests, analysis_failed (the last is not charged).
  • Requires Node ≥ 18.

License

MIT — see LICENSE.

Frequently asked questions

What is ai.adtest/adtest-mcp?

AI-only ad scoring for Claude: score image, video or text ads on 13 dimensions before you spend.

How do I install ai.adtest/adtest-mcp?

It runs on your machine. In Claude Code: claude mcp add adtest-mcp -e 'ADTEST_API_KEY=<your adtest_api_key>' -e 'ADTEST_API_BASE=<ADTEST_API_BASE>' -e 'ADTEST_POLL_TIMEOUT_MS=<ADTEST_POLL_TIMEOUT_MS>' -- npx -y adtest-mcp@1.1.0. For other clients, paste the JSON configuration from this page into their MCP settings.

Does ai.adtest/adtest-mcp need an API key?

Yes. It expects ADTEST_API_KEY, which you set in its configuration.

Is ai.adtest/adtest-mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains ai.adtest/adtest-mcp?

It is published by menaker. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.