AdSpends MCP

npx add-mcp 'https://app.adspends.com/api/mcp'

Set up in under a minute

Paste one URL, sign in with your AdSpends account and start asking.

1. 1 In Claude, open Settings → Connectors → Add custom connector.
2. 2 Paste the server URL: https://app.adspends.com/api/mcp
3. 3 Click Connect and approve access in the AdSpends login window (OAuth).
4. 4 Enable the AdSpends connector in a chat via the tools menu.

MCP server URL

https://app.adspends.com/api/mcp

Signs in with OAuth. No API key needed.

1. 1 In ChatGPT, enable Settings → Connectors → Advanced → Developer mode.
2. 2 Create a connector with the MCP server URL: https://app.adspends.com/api/mcp
3. 3 Choose OAuth authentication and approve access in the AdSpends login window.
4. 4 ChatGPT uses the search and fetch tools automatically; the full tool set is available in developer mode.

MCP server URL

https://app.adspends.com/api/mcp

Signs in with OAuth. No API key needed.

1. 1 Create an API key at app.adspends.com/mcp.
2. 2 Add this to.cursor/mcp.json in your project (or ~/.cursor/mcp.json) and replace the placeholder with your key.
3. 3 Reload Cursor. The AdSpends tools appear in the MCP panel.

{
  "mcpServers": {
    "adspends": {
      "url": "https://app.adspends.com/api/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_API_KEY>"
      }
    }
  }
}

Create your API key at app.adspends.com/mcp.

Automate your research & ideation

Turn the manual work you do in AdSpends into skills and scheduled agents: competitor research, weekly spend reports, hook libraries and briefs, wherever you build your AI workflows.

Connect MCP →

Discover unknown brands & competitors

Find the advertisers that scale in your niche and market, ranked by new ads and estimated Meta ad spend, before they show up in everyone’s swipe file.

Connect MCP →

Reverse-engineer landing pages that scale

Search advertorials and sales pages by the words on the page, see how much spend goes behind them and let your AI break down the structure and offer.

Connect MCP →

Access 9.3M Meta ads with ad spend

Give Claude, ChatGPT and Cursor the context they need: creatives, ad copy, CTA, run time, landing pages, EU reach and estimated EUR ad spend for every Meta ad delivered in the EU, updated daily.

Meta ads

9.3M

Brands

849k

Landing pages

740k

Est. ad spend

€14.7B

Connect MCP →

Real workflows

What you can do with the Meta Ads MCP server

Six workflows you can run in minutes: the prompt, the tools the AI calls, the credits it costs and what comes back.

eCom brands & media buyers

Competitor teardown in one prompt

Analyze my competitor nordglow.de: how much are they spending on Meta, which ads are scaling, and which landing pages get the traffic?

AdSpends tools:search_advertisers· 3 crget_brand_overview· 5 crget_advertiser_ads· 10 cr

• NordGlow (Skincare, DE): est. €412k Meta ad spend in the last 90 days, 214 active ads.
• Top ad: a UGC video “Dermatologist reacts to my routine”, est. €58k, running for 41 days.
• About 60% of the spend goes to one advertorial (/routine-guide); the rest goes to product pages.
• Angle shift: 7 of the 10 newest ads lead with “barrier repair” instead of “anti-aging”.

Total: 18 credits · search_advertisers (query “nordglow”, 3 results), get_brand_overview (details, top ads, top landing pages), get_advertiser_ads (sorted by ad spend, 10 results)

Creative strategists

Find winning hooks in your niche

Find the 20 highest-spend sleep supplement ads in Germany right now and group their hooks into 5 patterns I can test next week.

AdSpends tools:list_niches· freesearch_ads· 20 cr

• 1. “Doctor warns” authority hook: 6 ads, est. €190k combined.
• 2. “3 a.m. wake-up” problem callout: 5 ads, est. €142k.
• 3. Ingredient comparison vs. melatonin: 4 ads, est. €96k.
• 4. Founder story with before/after sleep data: 3 ads, est. €71k.
• 5. “Swiss study” proof hook: 2 ads, est. €44k. Suggested test: patterns 2 and 3 as static ads.

Total: 20 credits · list_niches (resolve “sleep supplements”), search_ads (niche + market DE, sorted by ad spend, 20 results)

Teams using AdSpends boards

Weekly digest of your swipe file

Summarize what’s new on my “Q4 Hooks” board and tell me which saved ads gained the most spend this week.

AdSpends tools:list_saved_boards· 1 crget_saved_board_ads· 25 crget_board_statistics· 1 cr

• “Q4 Hooks”: 25 ads from 11 brands, 6 added this week.
• Biggest gainers: two Black Friday countdown statics (+€18k and +€12k est. spend).
• 3 saved ads were switched off, so their hooks probably stopped working.

Total: 27 credits · list_saved_boards (find “Q4 Hooks”), get_saved_board_ads (25 saved ads), get_board_statistics (board totals)

Agencies

Pitch prep and client reporting

I’m pitching a pet food brand tomorrow. Compare the top 5 pet food advertisers in DACH by Meta spend and list 3 opportunities my prospect is missing.

AdSpends tools:list_categories· freesearch_advertisers· 5 crget_brand_overview· 25 cr

• Top 5 by est. 90-day spend: €620k, €410k, €275k, €190k and €88k. Your prospect ranks #5.
• Opportunity 1: the top 3 all run advertorials; the prospect only sends traffic to product pages.
• Opportunity 2: no video ads, while 64% of competitor spend goes to video.
• Opportunity 3: no subscription offer in the ads; 4 of 5 competitors push “save 15% with a subscription”.

Total: 30 credits · list_categories (resolve “pet food”), search_advertisers (category pet food, 5 results), get_brand_overview (× 5 brands)

Growth teams & developers

Automated monitoring with Claude Code, n8n or the REST API

Every Monday at 8:00: check my tracked brands, list new ads with more than €5k estimated spend, and post the summary to Slack.

AdSpends tools:list_tracked_brands· 1 crget_advertiser_ads· 80 cr

• Weekly report: 8 tracked brands, 23 new ads, 5 above €5k est. spend.
• Two competitors launched the same “price lock” angle on the same day.
• The summary goes to #competitor-watch every Monday. No dashboard needed.

Same data via the REST API (e.g. in an n8n HTTP node)

curl -H "Authorization: Bearer <YOUR_API_KEY>" \
  "https://app.adspends.com/api/v1/ads?query=skincare&limit=5"

Total: 81 credits · list_tracked_brands (your tracked-brand lists), get_advertiser_ads (10 newest ads × 8 brands)

Illustrative examples: brand names and figures are made up. Your AI answers with live AdSpends data.

Tool reference

All 22 Meta Ads MCP tools

Generated from the live OpenAPI spec. Credits are charged per call; errors are free. Your AI calls get_usage (free) to check your balance first.

Show all 22 tools with credits and REST endpoints

Tool	What it does	Credits	REST endpoint
Ads
search_ads	Search and browse ads Response: ≈ 9 tokens + ≈ 290 per result	1 credit per returned result (min 1, max 50)	GET /ads
get_ad	Get one ad by id Response: ≈ 940 tokens	2 credits	GET /ads/{adId}
Brands
search_advertisers	Search advertisers by name Response: ≈ 11 tokens + ≈ 86 per result	1 credit per returned result (min 1, max 50)	GET /advertisers
get_advertiser	Get one advertiser by id Response: ≈ 130 tokens	1 credit	GET /advertisers/{advertiserId}
get_brand_overview	Brand overview: details, top ads and top landing pages Response: ≈ 2,400 tokens	5 credits	GET /advertisers/{advertiserId}/overview
get_advertiser_ads	List ads of one advertiser Response: ≈ 3 tokens + ≈ 290 per result	1 credit per returned result (min 1, max 50)	GET /advertisers/{advertiserId}/ads
Landing pages
search_landing_pages	Search and browse landing pages Response: ≈ 11 tokens + ≈ 160 per result	1 credit per returned result (min 1, max 50)	GET /landing-pages
get_landing_page	Get one landing page by id Response: ≈ 3,200 tokens	3 credits	GET /landing-pages/{landingPageId}
Markets, categories & niches
list_markets	List markets (valid marketId values) Response: ≈ 940 tokens	free	GET /markets
list_categories	List advertiser categories (valid categoryId values) Response: ≈ 3,000 tokens	free	GET /categories
list_niches	List niches (valid niche values) Response: ≈ 1,900 tokens	free	GET /niches
Your saved data
list_tracked_brands	List your tracked-brand lists Response: ≈ 9 tokens + ≈ 150 per result	1 credit	GET /tracking/brands
list_saved_boards	List your saved ad boards Response: ≈ 9 tokens + ≈ 33 per result	1 credit	GET /boards
get_saved_board_ads	List ads on one saved board Response: ≈ 12 tokens + ≈ 290 per result	1 credit per returned result (min 1, max 50)	GET /boards/{boardId}/ads
list_saved_folders	List your saved folders of one kind Response: ≈ 10 tokens + ≈ 37 per result	1 credit	GET /saved/folders
list_saved_collections	List your saved collections Response: ≈ 11 tokens + ≈ 35 per result	1 credit	GET /saved/collections
list_saved_tags	List your private tags Response: ≈ 9 tokens + ≈ 35 per result	1 credit	GET /saved/tags
get_saved_items	List saved ads, landing pages or brands of a folder, collection or tag Response: ≈ 13 tokens + ≈ 290 per result	1 credit per returned result (min 1, max 50)	GET /saved/items
get_board_statistics	Aggregated statistics for one saved board Response: ≈ 49 tokens	1 credit	GET /boards/{boardId}/statistics
Account
get_usage	Your API credit balance and costs Response: ≈ 510 tokens	free	GET /usage
ChatGPT connector
search	ChatGPT-connector alias of search_ads: returns id, title and url per ad.	1 credit per returned result (min 1, max 10)	MCP only
fetch	ChatGPT-connector alias of get_ad: the full ad as a document.	2 credits	MCP only

For developers

Prefer code? Use the REST API

Every MCP tool except the ChatGPT aliases has a matching REST endpoint with the same credits. Authenticate with your API key as a Bearer token. Each response returns your remaining credits in the X-Credits-* headers.

• MCP: Best for chat and agents: Claude, ChatGPT, Cursor, Claude Code.
• REST: Best for scripts, dashboards, n8n, Make and data pipelines.
• Web app: Best for visual browsing, boards and team collaboration.

Reference: API docs · openapi.json

REST API base URL

https://app.adspends.com/api/v1

curl -H "Authorization: Bearer <YOUR_API_KEY>" \
  "https://app.adspends.com/api/v1/advertisers?query=snocks&limit=3"

Pricing, security & troubleshooting

API credits are included in every plan

The free trial includes 100 credits. Paid plans include 2,000 to 30,000 credits per month, and you can buy credit packs on top. List tools cost 1 credit per returned result, detail tools 1 to 5 credits, and lookups like markets, niches and usage are free.

See plans & pricing →

Read-only by design

The Meta Ads MCP server only reads data. It never edits your boards, never posts anything and never triggers scraping.

OAuth or revocable API keys

Chat apps sign in through OAuth, so no password ends up in a chat. API keys can be revoked at any time at app.adspends.com/mcp.

Your data stays yours

Boards, folders, tags and tracked brands are only visible to your own account. Everything else is public Meta Ad Library data.

My AI says it has no AdSpends tools.

Enable the AdSpends connector in the chat’s tools menu, or reload your editor after editing mcp.json.

Requests fail with 401 or 403.

Check that the Authorization header is “Bearer <YOUR_API_KEY>” and that your plan or trial is active.

The AI says I’m out of credits.

Ask it to call get_usage (free). Credits reset monthly, and credit packs top you up instantly.

Meta Ads MCP vs. the Meta Ad Library API

The Meta Ad Library API is free, but it needs a developer account and identity verification, and it has no spend data for commercial ads. AdSpends adds the analysis layer and plugs straight into your AI.

Feature	Meta Ad Library	AdSpends
Ad spend	Spend ranges only for political and social issue ads	✅ Estimated EUR spend for every Meta ad delivered in the EU
Setup	Meta developer app, identity verification, access tokens	✅ Paste one URL and approve with OAuth
Works in Claude, ChatGPT & Cursor	Only if you build and host your own MCP server	✅ Native MCP server for 8+ AI clients
Landing pages	Link URLs only	✅ Advertorials and sales pages with extracted text, linked to their ads
Brand-level analysis	Per-ad results, aggregate them yourself	✅ Brand overview with spend, top ads and top landing pages in one call
Niches & categories	Keyword and page search only	✅ Filter by market, category and niche
Your research	Not available	✅ Your saved boards, folders, tags and tracked brands

FAQ

What is the AdSpends MCP (Meta Ads MCP server)?

The AdSpends MCP, also known as the Meta Ads MCP server or Meta Ad Library MCP, is a Model Context Protocol server that connects AI assistants like Claude, ChatGPT and Cursor to the AdSpends database of 9.3M Meta ads, 849k brands and 740k landing pages. Your AI can search ads, analyze competitors and break down advertorials and sales pages, with estimated EU ad spend for every ad. The server URL is https://app.adspends.com/api/mcp.

How do I connect AdSpends to Claude or ChatGPT?

Add a custom connector in Claude (Settings → Connectors) or ChatGPT (Developer mode), paste https://app.adspends.com/api/mcp and sign in with your AdSpends account. No API key and no code needed. Cursor and other code editors use an API key from app.adspends.com/mcp.

Which AI tools does the AdSpends MCP work with?

Claude (web, desktop and Claude Code), ChatGPT, Codex, Cursor, Perplexity, GitHub Copilot, Gemini CLI, Windsurf and any other MCP client that supports remote HTTP servers with OAuth or a Bearer token.

What data can my AI access through the MCP server?

Meta ads with creatives, copy, run time and estimated spend; advertisers with brand overviews; advertorials and sales pages with extracted page text; markets, categories and niches; and your own saved boards, folders, tags and tracked brands.

How current is the data?

Your AI queries the same live database that powers the AdSpends app. New Meta ads and their reach are collected daily from the Meta Ad Library.

How is the ad spend calculated?

Ad spend is an estimate in EUR, calculated from the EU reach that Meta publishes under the Digital Services Act at a €30 CPM. It covers every Meta ad delivered in the EU, with the deepest coverage in Germany and the DACH region. Use it to compare ads, brands and landing pages with each other, not as exact invoices.

Can my AI access my saved boards, and is it safe?

Yes. Your AI can browse your saved boards, folders, tags and tracked brands, which are only visible to your own account. The MCP server is read-only and never changes your data, chat apps connect through OAuth, and API keys can be revoked at any time.

What does the AdSpends MCP cost?

There is no separate charge. Every AdSpends plan includes 2,000 to 30,000 API credits per month and the free trial includes 100. List tools cost 1 credit per result, detail tools 1 to 5 credits, and lookups like markets, niches and usage are free.

What is the difference between the MCP server and the REST API?

Both expose the same data and credits. The MCP server is for AI assistants and agents; the REST API at https://app.adspends.com/api/v1 is for scripts, automations and dashboards, with an OpenAPI spec at https://app.adspends.com/api/v1/openapi.json.

Can I run AdSpends research on a schedule?

Yes. Use Claude Code in headless mode, an n8n or Make workflow, or any cron job that calls the REST API. A common setup is a weekly competitor report posted to Slack.

Give your AI real Meta ads data

Start the free trial, paste one URL and ask your first question in under a minute.

Start free trial