
Adtest MCP
Score image, video or text ads on 13 dimensions with AdTest.AI before you spend
- 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-mcpAdd 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.RequiredADTEST_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

HyperFrames by HeyGen
MCP serverHosted MCP connector for creating and rendering videos from HTML through AI chat
- Remote
- Freemium
- 85.3K GitHub stars
- Design and media

ffmpeg-skill
MCP serverLocal FFmpeg video and audio editing tools for coding agents over MCP
Runs locally- Open source
- 6.9K GitHub stars
- Design and media

Google Ads + Meta Ads + SEO/GEO MCP
MCP serverHosted 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

Calven
MCP serverProduct marketing context from Calven delivered into Claude, ChatGPT and other AI tools
Not checked yet- Remote
- Free trial
- 3 GitHub stars
- Marketing and SEO

Generate fictional character portraits and lip-synced talking videos from text over MCP
- 10 tools
- Remote
- Freemium
- Design and media

MCP
MCP serverMCP server for planning, scheduling and measuring social and ad campaigns with approvals
- Remote
- Freemium
- Marketing and SEO