Skip to content
MCP server

Adtest MCP

Score image, video or text ads on 13 dimensions with AdTest.AI before you spend

Runs locallyStatus and history
Pricing
Paid
Platforms
CLI, API
Runs
Locally
License
MIT
Version
1.1.0
Listing updated
1 day ago

About Adtest MCP

Adtest MCP is a paid MCP server for design and media. It runs locally on your machine and is started by your AI client.

One tool, one job. analyze_advert takes a public URL, a local image or video file or pasted ad copy, plus an optional brand URL to improve logo detection, and returns AdTest.AI's AI-only analysis with the amount charged and your remaining balance. The README says human panel validation is available only in the web app, not through this server.

Because video analysis can take minutes, the server submits a job, then polls until it completes or fails, with a default ceiling of 15 minutes. You are charged once on success; a failed analysis is never billed. Rate limits are 30 submits a minute and 2,000 a day per key. Errors come back as readable codes such as invalid_api_key, insufficient_funds and unsupported_media_type.

An API key from the app's Developer section is required, and the README puts each successful analysis at $1 from your wallet. The vendor's site says API and MCP access is not part of the free trial. It runs on Node 18 or later and is MIT licensed.

Install

Run in a terminal

claude mcp add adtest-mcp --env ADTEST_API_KEY='<ADTEST_API_KEY>' -- npx -y adtest-mcp

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

{
  "servers": {
    "adtest-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "adtest-mcp"
      ],
      "env": {
        "ADTEST_API_KEY": "<ADTEST_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • ADTEST_API_KEYAdTest.AI developer API key (app.adtest.ai → Developer → Generate key). Each successful analysis costs 1 credit.Required
  • ADTEST_API_BASEOptional API base URL override (default https://app.adtest.ai/adtest-api).
  • ADTEST_POLL_TIMEOUT_MSOptional max wait for a job in milliseconds (default 900000 = 15 min).

Tools this server provides (1)

Taken from the project documentation; the running server may differ.

analyze_advert
Scores an image, video or text ad across 13 dimensions and returns a report.

What it does

13-dimension scoring
AI scores an ad across 13 dimensions.
Image, video and text
Accepts a URL, local file or ad copy.
Async job polling
Handles long video analyses without request timeouts.
Charged on success
A failed analysis is not billed.
Brand URL hint
An optional advertiser site improves brand and logo detection.
Clear errors
Readable error codes for key, funds and media problems.

Good for

  • Score ad variants before buying media
  • Check a video ad from a local file
  • Rate a piece of ad copy
  • Let an agent filter weak creative automatically

Pricing

Paid

$1 per successful analysis; API access not included in the free trial

Prices change. Check adtest.ai before you buy.

Adtest MCP FAQ

How much does an analysis cost?

The README says each successful analysis costs $1 from your wallet.

Does it include human audience testing?

No. Human panel validation is in the web app only.

Am I billed for failures?

No. A failed analysis is not charged.

What do I need to run it?

An AdTest.AI API key and Node 18 or later.

Is Adtest MCP free?

No. Adtest MCP is a paid product.

How do I add Adtest MCP to Claude Code?

Run this command in your terminal: claude mcp add adtest-mcp --env ADTEST_API_KEY='<ADTEST_API_KEY>' -- npx -y adtest-mcp

What are the best alternatives to Adtest MCP?

The closest alternatives to Adtest MCP are HyperFrames by HeyGen, ffmpeg-skill, Google Ads + Meta Ads + SEO/GEO MCP, Calven and AvatarSay — Fictional Character & Talking Video MCP.

Alternatives to Adtest MCP

  1. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  2. ffmpeg-skill

    MCP server

    Local FFmpeg video and audio editing tools for coding agents over MCP

    Runs locally
    • Open source
    • 6.9K GitHub stars
    • Design and media
  3. Hosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat

    • 8 tools
    • Remote
    • Freemium
    • 8.1K GitHub stars
    • Marketing and SEO
  4. Calven

    MCP server

    Product marketing context from Calven delivered into Claude, ChatGPT and other AI tools

    Not checked yet
    • Remote
    • Free trial
    • 3 GitHub stars
    • Marketing and SEO
  5. MCP

    MCP server

    MCP server for planning, scheduling and measuring social and ad campaigns with approvals

    • Remote
    • Freemium
    • Marketing and SEO