OpenAdLibrary MCP ServerVerifiedFeatured

What is OpenAdLibrary MCP Server?

OpenAdLibrary MCP Server is the official hosted MCP endpoint for OpenAdLibrary, an ad-intelligence library of Meta, TikTok, Google Ads and native ads. It lets Claude, ChatGPT, Cursor and other MCP clients search live ad data inside a conversation.

OpenAdLibrary collects ads from Meta (Facebook, Instagram, Messenger, Audience Network, Threads), TikTok, Google Ads and native networks such as Taboola, Outbrain/Teads, MGID, RevContent, MediaGo and Yahoo into one searchable catalogue. For native ads it also follows each click through every redirect hop to the advertiser's real landing page and keeps that evidence. The same catalogue is available over a public REST API (/api/v1) and over the hosted MCP server at https://mcp.openadlibrary.com/mcp. OpenAdLibrary describes the MCP server as having "20+ tools". Our live check could not list them, because the endpoint requires sign-in.

How to use OpenAdLibrary MCP Server?

The endpoint is Streamable HTTP and returns 401 until you authenticate. It publishes OAuth discovery and dynamic client registration, so clients that support OAuth open a browser window where you sign in with your OpenAdLibrary account and approve access. According to OpenAdLibrary's docs, that connection creates its own API key. Clients without OAuth can send a personal API key, created under Settings, as Authorization: Bearer <key>.

Ad data and research over the API and MCP are part of the paid Founders plan. A key that belongs to a free account gets 402 Payment Required for those requests.

Claude Code

claude mcp add --transport http openadlibrary https://mcp.openadlibrary.com/mcp

Then run /mcp inside Claude Code and sign in. To use an API key instead of OAuth:

claude mcp add --transport http openadlibrary https://mcp.openadlibrary.com/mcp \
  --header "Authorization: Bearer YOUR_OPENADLIBRARY_API_KEY"

Claude Desktop and claude.ai

Open Settings, then Connectors, and add a custom connector with the URL https://mcp.openadlibrary.com/mcp. Choose Connect, sign in to OpenAdLibrary in the browser, and approve access. ChatGPT works the same way as a connector.

Cursor

In ~/.cursor/mcp.json:

{
  "mcpServers": {
    "openadlibrary": {
      "url": "https://mcp.openadlibrary.com/mcp"
    }
  }
}

VS Code

In .vscode/mcp.json:

{
  "servers": {
    "openadlibrary": {
      "type": "http",
      "url": "https://mcp.openadlibrary.com/mcp"
    }
  }
}

Cursor and VS Code start the OAuth sign-in in the browser on first use.

Key features of OpenAdLibrary MCP Server

• One library covers Meta, TikTok, Google Ads and many native ad networks, so there are no per-network plans.
• For native ads, it traces the funnel: the click URL, each redirect hop, the advertiser behind a tracking domain, and the captured landing page.
• The OAuth sign-in creates its own key, so no key has to be pasted into a config file.
• The REST API and the MCP endpoint accept the same API key.
• The OAuth server advertises the scopes public-data, oal:private-read and oal:private-write.
• It runs as a hosted service, with nothing to install locally.

Use cases of OpenAdLibrary MCP Server

• Competitor research: "Show me the native ads a given advertiser has been running the longest, and where they send traffic."
• Creative inspiration: "Find active TikTok ads in the fitness niche in Germany and summarize their hooks and CTAs."
• Funnel analysis: "For this Taboola ad, walk me through the redirect chain and the final landing page."
• Market scans: "Which advertisers started new Meta campaigns in this vertical recently?"
• Brand monitoring: Ask the assistant to look for ads that reference your own brand or site.

Troubleshooting OpenAdLibrary MCP Server

• 401 Unauthorized: The endpoint needs authentication. Finish the OAuth sign-in (run /mcp in Claude Code), or send a valid key as a bearer token.
• 402 Payment Required: The account or key is on the free plan. API and MCP research access needs the Founders plan.
• 429 Too Many Requests: Each key has a daily request quota, shown beside your keys in Settings, and requests can also be throttled if they arrive too fast. Wait and retry.
• Exposed key: Keys are shown only once when they are created. If a key leaks, revoke it in Settings and create a new one.