AdRadar / Docs / MCP server
Connect your assistant to AdRadar.
Claude, ChatGPT, Cursor and Claude Code read your competitor data over MCP. Sign in from the assistant, or use an API key. Read-only, 13 tools, on every plan.
- Connect an assistant
- Try it without an account
- What to ask
- The 13 tools
- How to read the numbers
- Limits and security
- Disconnect
- Support
AdRadar is an MCP server. An AI assistant connects to it once and then reads your competitor data in a conversation: the ads from the Meta, Google, LinkedIn and TikTok ad libraries, the landing pages those ads lead to, what customers write on review sites and Reddit, the competitor’s website and organic traffic, and who bids on your brand queries in Google. Everything is read-only: the assistant adds and changes nothing.
The server is part of every plan, Free included. The feature page shows what it looks like in use; this page is the reference.
Connect an assistant
Server address: https://app.adradar.digital/api/mcp (Streamable HTTP).
The usual way is to sign in from the assistant: add the address, the client opens AdRadar’s sign-in, you allow access, and the assistant reads the organization you belong to. Nothing to copy. For scripts and for a client that cannot sign in, an API key from Settings → API keys works instead.
| Client | How |
|---|---|
| claude.ai, Claude in Slack, ChatGPT | Settings → Connectors → Add custom connector. Address https://app.adradar.digital/api/mcp, then sign in when asked. |
| Claude Code | claude mcp add --transport http adradar https://app.adradar.digital/api/mcp, then /mcp once to sign in. With a key instead: add --header "Authorization: Bearer <key>". |
| Cursor, Claude Desktop, other clients | Remote MCP server of type http at https://app.adradar.digital/api/mcp; sign in, or send the key in an Authorization: Bearer header. |
| A client that takes only a URL and cannot sign in | https://app.adradar.digital/api/mcp/<key>. That address is as secret as the key: anyone who has it reads your data. Revoke the key to close it. |
What happens when you sign in
The client asks the server for its resource metadata, registers itself with AdRadar’s authorization server (OAuth 2.0 with PKCE, dynamic client registration and client ID metadata documents both supported), and sends you to the sign-in and consent screen. The access token the client receives opens only the first organization you belong to. To read another organization, use an API key made in that organization.
If your organization has no competitors yet, the assistant will say so: add a company in the app first.
Try it without an account
A public demo organization is served at https://app.adradar.digital/api/mcp/demo, no sign-in and no key. Add that address as a connector or remote server and ask, for example, “Which companies does this organization follow, and who launched the most ads this week?”. The demo follows a handful of well-known companies and is refreshed by the AdRadar team; it is limited to 60 requests a minute per client address. Links in the demo’s answers lead to the app’s sign-in page.
What to ask
You never name a tool. The assistant picks it, calls AdRadar and writes the answer with links to the ads, pages and reviews behind it.
| Question | What the assistant calls |
|---|---|
| What did Rival launch this week, and in which countries? | competitor_overview, recent_changes |
| Who is the most active competitor this month? Who is losing ground? | compare_competitors |
| Write five hooks for our DE campaign from what competitors have run 60+ days. | list_ads with country DE, 60+ days running, sorted by the longest run |
| What do Rival’s customers complain about that we solve? | review_insights, then list_reviews with rating ≤ 2 for quotes |
| Did anyone change prices? | recent_changes of type price_changed, or landing_pages |
| Is anyone bidding on our brand in France? | brand_queries |
| What do they publish, and where does their traffic come from? | site_changes |
| Show me this ad in full. | get_ad |
Good first questions after connecting: “Which companies do we track and what is known about each?” and “What changed this week, without reviews?”. A scheduled task in Claude (“every Monday, read what changed for project X and write three things worth deciding”) turns it into a weekly habit.
The 13 tools
All read-only, all scoped to one organization. Ids are UUIDs; the assistant takes them from list_projects and list_competitors.
| Tool | Answers |
|---|---|
list_projects | the projects of your organization and how many competitors each follows |
list_competitors | competitors with what is watched (ads, site, reviews) and when it was last checked |
competitor_overview | “what is X doing”: headline, a trend per channel, ad counts and AI angles, rating and its 30-day change, site growth and organic traffic, 20 latest changes |
compare_competitors | one row per competitor of a project, side by side, plus a one-line reading of the market |
list_ads | ads with AI labels; filters by competitor, platform, status, country, angle, days running and text |
get_ad | one ad in full: text, transcript, on-image text, media, when it was seen active |
recent_changes | events since a date, each as a sentence: new and stopped ads, bursts, proven creatives, price and landing changes, new bidders, new pages, negative reviews |
review_insights | per review site: rating, counts, the words that mark bad and good reviews, the latest AI digest with the reviews it cites |
list_reviews | the individual reviews and Reddit mentions behind the insights |
landing_pages | the pages the ads lead to, with the price found on them |
site_changes | pages by kind, additions and removals, organic traffic by market, leading pages, the change log |
list_reports | the weekly AI reports of a project |
brand_queries | who bids on the project’s brand and keyword queries in Google, per country |
How to read the numbers
The server sends these rules to the assistant when it connects. They are worth knowing as a person too.
- Every number is a count of the data AdRadar holds: what the ad libraries, review sites and sitemaps returned. It is not the whole market.
- Events are facts observed between two checks: an ad appeared, an ad stopped, a price changed. There are no forecasts and no spend figures.
days_runningcounts from the platform’s start date, or from the day AdRadar first saw the ad. An ad still running after 30+ days is usually one that works (“proven creative”).- AI labels (hook, angle, persona, offer) exist only for ads that were labelled and are hidden below confidence 0.5. Review digests cite the review ids they rest on.
urlfields open the app for a signed-in person. Media links point at the ad library’s own files and may expire.
Where the data comes from and where it can be wrong: methodology.
Limits and security
- 60 requests a minute per key, per signed-in person, or per client address on the demo. The limit answers
429withRetry-After. - One key, one organization. Ids of another organization answer an error, never data.
- Only reading. The assistant cannot add a competitor, follow a page or change a setting.
- The server keeps no session: every request stands on its own, so a connection survives restarts on both sides.
- Access tokens are issued by AdRadar’s authorization server and verified on every request. The server never sees your password.
Disconnect
Remove the connector in the assistant to stop it. To close a key, revoke it on Settings → API keys: both the header form and the address-with-key form stop working at once. Deleting your account removes the organization’s data and with it everything an assistant could read.
Support
Questions, problems and feature requests: [email protected]. Say which client you use and, if possible, paste the error the assistant showed. For the REST API and webhooks see the OpenAPI document linked on the API keys page.