Server data from the Official MCP Registry
AI-only ad scoring for Claude: score image, video or text ads on 13 dimensions before you spend.
About
AI-only ad scoring for Claude: score image, video or text ads on 13 dimensions before you spend.
Security Report
This MCP server is well-structured and secure. It properly authenticates all API requests using an API key from environment variables, handles file uploads safely, and implements appropriate polling logic for async jobs. Minor code quality improvements around error handling and input validation are recommended, but no security vulnerabilities or dangerous patterns were identified. Supply chain analysis found 1 known vulnerability in dependencies (0 critical, 1 high severity). Package verification found 1 issue.
3 files analyzed · 7 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
What You'll Need
Set these up before or after installing:
Environment variable: ADTEST_API_KEY
Environment variable: ADTEST_API_BASE
Environment variable: ADTEST_POLL_TIMEOUT_MS
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"ai-adtest-adtest-mcp": {
"env": {
"ADTEST_API_KEY": "your-adtest-api-key-here",
"ADTEST_API_BASE": "your-adtest-api-base-here",
"ADTEST_POLL_TIMEOUT_MS": "your-adtest-poll-timeout-ms-here"
},
"args": [
"-y",
"adtest-mcp"
],
"command": "npx"
}
}
}Documentation
View on GitHubFrom the project's GitHub README.
AdTest.AI MCP server
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
-
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.
-
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 installin this folder):{ "mcpServers": { "adtest": { "command": "node", "args": ["/absolute/path/to/mcp-server/index.js"], "env": { "ADTEST_API_KEY": "adk_your_key_here" } } } } -
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:
| arg | meaning |
|---|---|
url | public URL of an image or video advert (we download it) |
file_path | local image/video file to upload |
text | ad 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-keyheader, set fromADTEST_API_KEY. -
Endpoint defaults to
https://app.adtest.ai/adtest-api; override withADTEST_API_BASEfor 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.
Links
- Product: https://adtest.ai
- App and API keys: https://app.adtest.ai
- Issues: https://github.com/menaker/adtest-mcp/issues
License
MIT — see LICENSE.
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Fetch
Freeby Modelcontextprotocol · Developer Tools
Web content fetching and conversion for efficient LLM usage
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.
MarkItDown
Freeby Microsoft · Content & Media
Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption