OpenAdLibrary

Investiga anuncios nativos y competidores, guarda investigaciones creativas y analiza tus propias campañas a través de un servidor MCP alojado.

Servidor MCP alojado

npx add-mcp 'https://mcp.openadlibrary.com/mcp'

Se instala en Claude Code, Codex, Cursor y más

Documentación

OpenAdLibrary API and MCP documentation

Query the public ad catalogue programmatically with the same leak-safe data available in the product.

Create and protect an API key

Create a key from Settings. A key is shown once when it is created, so store it securely and revoke it if it is exposed.

Authenticate requests

Send the key in the x-api-key header or as Authorization: Bearer <key>. The same key can authenticate the REST API and the hosted MCP endpoint.

REST API

The public API exposes leak-safe ad-library fields and supports filtering and pagination. It also publishes the redirect chain behind an ad — the tracker URL the click starts on, every hop it passes through, and the advertiser URL it ends on — through /api/v1/ads/{id}/chain, /api/v1/chains/{chainHash} and /api/v1/chains/match. Chain URLs are credential-scrubbed, while attribution parameters such as subid, click_id and utm_* stay intact. The API does not expose private account data or internal identifiers. The interactive reference loads on this page when JavaScript is available.

Quotas and responses

Ad data and research over the API and MCP are part of the Founders plan. A key that belongs to a Free account gets 402 Payment Required for those requests. Each key has a daily request quota, shown beside your keys in Settings. Over that quota, or when requests arrive too fast, the API returns 429 Too Many Requests.

Hosted MCP endpoint

The hosted MCP server is https://mcp.openadlibrary.com/mcp. In Claude or ChatGPT, add it as a connector and choose Connect, then sign in with your OpenAdLibrary account and approve access; the connection creates its own API key. In Claude Code, run claude mcp add --transport http openadlibrary https://mcp.openadlibrary.com/mcp, then /mcp to sign in. Other MCP clients can send an API key as Authorization: Bearer <key>. Machine-readable documentation is also available in llms.txt and llms-full.txt.