# Adtest MCP

> Adtest MCP is a paid MCP server for design and media. Score image, video or text ads on 13 dimensions with AdTest.AI before you spend. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** CLI, API
- **Website:** https://adtest.ai
- **Repository:** https://github.com/menaker/adtest-mcp
- **License:** MIT
- **MCP Registry name:** ai.adtest/adtest-mcp
- **Categories:** design and media, marketing and SEO
- **Listing updated:** 2026-11-16

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

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

## 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

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [MCP](https://ai-powered.com/mcp/mcp-mwhffe53): MCP is a freemium MCP server for marketing and seo.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/adtest-mcp
