MCP for AI agents
Connect Claude, Claude Code, Cursor and other MCP clients to the hosted AdLib MCP server at mcp.adlibapi.com and let your agent research ads.
The AdLib MCP server gives an AI agent 33 tools over the ad libraries: resolve a domain, search ads, read history, check whether a brand advertises, and set up watchlists. It is hosted, so there is nothing to install.
https://mcp.adlibapi.com/mcpClaude.ai and Claude Desktop
Open Settings → Connectors → Add custom connector, name it AdLib, paste the URL, click Connect and sign in with your AdLib account.
Claude Code
claude mcp add --transport http adlib https://mcp.adlibapi.com/mcpThen run /mcp in Claude Code and choose adlib to sign in. With an API key instead:
claude mcp add --transport http adlib https://mcp.adlibapi.com/mcp --header "X-API-Key: your-key"Cursor and other clients
Add the URL as a remote MCP server (in Cursor: {"mcpServers": {"adlib": {"url": "https://mcp.adlibapi.com/mcp"}}}) and sign in, or send your key as the X-API-Key header.
Prompting
Name AdLib in the prompt, so the agent uses these tools rather than a web search:
- "With AdLib: which platforms is hellofresh.com advertising on right now, and since when?"
- "Use AdLib to compare the ad copy Nike and Adidas ran on Meta in September."
- "With AdLib: which of hellofresh.com's Meta ads were removed from the library this month, and what did they say?"
- "Use AdLib to watch adidas.com and post new, stopped and removed ads to this Slack webhook: https://hooks.slack.com/services/..."
- "With AdLib: what do the five longest-running ads of gymshark.com have in common? Use the creative features."
Every tool result ends with the credits it used, for example billed: 5 credits. Empty results and errors are free, as in the REST API.
Tools
| Tool | What it does |
|---|---|
check_domain |
Is this brand advertising right now, and where? |
get_company |
All ad accounts of a company across platforms, with stats |
resolve_advertisers |
Domain to advertiser ids on every platform |
suggest_domains |
Candidate domains for a brand name |
report_resolve_match |
Flag a wrong or missing account match |
list_resolve_reports |
Your match reports and their review status |
search_ads |
Search ads by keyword, advertiser, domain, country, placement |
get_ad |
One ad with creatives and EU fields |
get_ad_history |
Every recorded version of an ad |
get_ad_variants |
The advertiser's other ads with the same text |
get_ad_features |
Measured creative features: duration, aspect ratio, on-screen text, offers |
parse_library_url |
Turn a link copied from an ad library into an AdLib id |
advertiser_stats |
Counts, run lengths, formats, countries, longest-running ads |
get_advertiser |
Advertiser record |
list_advertiser_ads |
All ads of an advertiser |
advertiser_timeline |
When ads started and stopped |
advertiser_changes |
New, stopped and changed ads since a date |
create_watchlist |
Watch brands by domain or single advertisers, with an optional webhook |
get_watchlist |
One watchlist |
list_watchlists |
Your watchlists |
update_watchlist |
Change interval, webhook or email alerts |
add_watchlist_advertisers |
Add advertisers to a watchlist |
add_watchlist_brands |
Add brands to a watchlist by domain |
create_batch |
Many lookups as one job |
get_batch |
Batch job status and results |
list_webhook_deliveries |
Recent webhook deliveries |
get_webhook_delivery |
One delivery with its payload and response |
redeliver_webhook |
Send a delivery again |
test_webhook |
Send a signed test event |
test_watchlist_alert |
Send a test alert mail for a watchlist |
get_account |
Plan, credits left, credit packs and limits |
get_usage |
Credits used per endpoint |
api_status |
Platform health |