Docs

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.

Output
https://mcp.adlibapi.com/mcp

Claude.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

Shell
claude mcp add --transport http adlib https://mcp.adlibapi.com/mcp

Then run /mcp in Claude Code and choose adlib to sign in. With an API key instead:

Shell
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