Log inSubmit server
Adtest MCP logo

Adtest MCP

Scores image, video, and text ads across 13 AI analysis dimensions before launch.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Adtest MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "adtest-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "adtest-mcp"
      ],
      "env": {
        "ADTEST_API_KEY": "YOUR_VALUE_HERE",
        "ADTEST_API_BASE": "YOUR_VALUE_HERE",
        "ADTEST_POLL_TIMEOUT_MS": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

The adtest-mcp MCP server connects Claude or another MCP client to AdTest.AI for AI-based scoring of image, video, and text advertisements. Its single `analyze_advert` tool accepts a public URL, local file path, or ad copy, with an optional brand website. Jobs run asynchronously and return an analysis report, charge, and remaining balance. Use it when you need to evaluate creative before spending on distribution; each successful analysis costs $1.

Use cases

  • Score ad creative before a paid campaign
  • Evaluate local promotional videos
  • Review ad copy across analysis dimensions
  • Check brand and logo detection with a brand URL

Key features

  • Analyzes image, video, and text ads
  • Scores creatives across 13 dimensions
  • Accepts URLs, local files, or inline copy
  • Polls asynchronous analysis jobs
  • Reports charges and remaining balance
  • Supports configurable API and polling endpoints

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 3d ago

Recent health check succeeded.

6/6 checks healthy over the last 46d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 3h ago via OSV.dev · adtest-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

npm downloads214Package downloads in the last 30 days.
Last commit1mo agoMost recent push to the default branch.

How Adtest MCP works

What the adtest-mcp MCP server does

The adtest-mcp MCP server exposes AdTest.AI’s AI-only advert analysis through one MCP tool: analyze_advert. It evaluates an image, video, or text advertisement across 13 dimensions and returns a detailed scoring report. The response also includes the amount charged and the remaining account balance.

The tool accepts exactly one primary creative input: a public url, a local file_path, or inline text. An optional brand_url points to the advertiser’s website and can improve brand or logo detection. Public image and video URLs are downloaded by the service, while local media is uploaded from the machine running the MCP process.

Human-panel validation is not available through this server. That option is provided only in the AdTest.AI web application.

How it works

Each request creates an asynchronous analysis job through the AdTest.AI developer API. The server receives a job identifier, then checks the job status periodically until it completes or fails. This design supports video processing, which may take several minutes and could exceed the roughly 100-second limit of a single synchronous request.

A successful job is billed once when processing finishes. Failed jobs are not charged. The server converts API failures into readable error text, including invalid credentials, insufficient funds, invalid URLs, unsupported media, rate limits, and failed analysis states.

The default API base is https://app.adtest.ai/adtest-api. Requests authenticate with the x-api-key header, populated from the configured API key. The default polling limit is 15 minutes, with a setting available for longer videos.

Setup and configuration

The adtest-mcp MCP server requires Node.js 18 or newer and an AdTest.AI API key. Generate the key from the Developer area of app.adtest.ai, and ensure the associated wallet has funds before submitting analysis jobs.

For a package-based setup, configure an MCP client to run npx -y adtest-mcp and pass the key as ADTEST_API_KEY. A local checkout can instead run node against the repository’s mcp-server/index.js after installing dependencies with npm install.

Supported environment variables are:

  • ADTEST_API_KEY: API key used for authentication.
  • ADTEST_API_BASE: Optional API endpoint override, such as a staging endpoint.
  • ADTEST_POLL_TIMEOUT_MS: Optional polling ceiling in milliseconds.

Restart the MCP client after adding the server configuration. Example prompts can reference a public ad URL, a local video path, or ad copy directly.

Tools and capabilities

analyze_advert supports:

  • Image analysis from a public URL or local file.
  • Video analysis from a public URL or local file.
  • Text-only ad copy analysis.
  • Optional advertiser website context through brand_url.
  • Asynchronous polling for long-running jobs.
  • Reporting of analysis results, charges, and remaining balance.

Per-key limits are 30 submissions per minute and 2,000 submissions per day. The service also documents a 60-per-minute limit per IP; polling is handled by the server and has a higher allowance.

Limitations and notes

The adtest-mcp MCP server performs AI-only analysis; it does not expose the web app’s human-panel validation. A successful analysis costs $1, so the configured wallet must have sufficient funds. Video jobs can take several minutes and may require increasing ADTEST_POLL_TIMEOUT_MS beyond the default.

The server depends on reachable public URLs for URL-based media and on supported image or video formats. Requests can fail with no_creative, invalid_url, unsupported_media_type, too_many_requests, or analysis_failed. The documented analysis_failed condition is not billed. Rate limits also apply, so automated workloads should account for the submission quotas.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Adtest MCP

adtest-mcp is an MCP server that connects Claude and other MCP clients to AdTest.AI. Its main tool, `analyze_advert`, scores image, video, or text advertisements across 13 AI analysis dimensions, then returns the report, charge, and remaining balance. Human-panel validation remains available only in the AdTest.AI web app.

Install it by configuring your MCP client to run `npx -y adtest-mcp` with `ADTEST_API_KEY` set. You can also run a local checkout with Node.js 18 or newer, after installing dependencies and pointing the client to `mcp-server/index.js`.

Provide `analyze_advert` with either a public video `url` or a local `file_path`. The server submits an asynchronous job and polls until completion, allowing videos to run longer than a synchronous request would permit.

Each successful analysis costs $1. The charge occurs when the job completes, while failed jobs are not billed. Your AdTest.AI wallet must have sufficient funds before submitting a request.

Yes, it works with Claude Desktop and Claude Code, as well as other MCP clients. Add the server to the client configuration, set `ADTEST_API_KEY`, restart the client, and call `analyze_advert` through a prompt.

Related MCP servers

All in Marketing All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewAdtest MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/adtest-mcp?style=directory)](https://allmcps.com/mcp/adtest-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/adtest-mcp"><img src="https://allmcps.com/api/badge/adtest-mcp?style=directory" alt="Adtest MCP on AllMCPs" /></a>