Get started
Early access

Meta Ad Library MCP server

Research public ad creative by keyword or known Facebook Page IDs within the Ad Library’s regional coverage. Access is gated: request enablement for your organization before connecting.

Request early accessSee 7 actions ↓
MarketingOAuthMCP + RESTfacebook.com
AUDIT LOG · META AD LIBRARYPOLICY: acme-support
09:41:07 · claude · u_8f2read
meta_ad_library.list_page_ads
List page ads✓ allowed · 212ms
09:41:08 · claude · u_8f2read
meta_ad_library.search_ads
Search archived ads✓ allowed · 164ms
ILLUSTRATIVE POLICY TRACE · NOT A LIVE RECEIPT
01 · USE CASES

Agent workflows for Meta Ad Library.

01

Get connected user ID

Use when checking which app-scoped Facebook user is connected before searching the Ad Library. Returns only the stable user ID. Long-lived user tokens last about 60 days and cannot be refreshed; reconnect when expired. Every connecting user must complete Meta ID confirmation.

02

Search archived ads

Use when researching public ad creative by keyword or exact phrase. Results outside the EU cover political and issue ads only. Pass nextCursor as after; countries and optional page IDs narrow the search.

03

List page ads

Use when inspecting ads from up to ten known Facebook Page IDs. Country and date filters bound the listing; commercial coverage is limited to ads reaching the EU. Pass nextCursor as after.

02 · ACTIONS

7 Meta Ad Library actions, graded by risk.

These actions come from the Arc0 registry. Your identity, provider permissions and Arc0 policies determine which actions can run.

read

7

Look things up, subject to your permissions.

  • meta_ad_library.get_identity
    Get connected user ID

    Use when checking which app-scoped Facebook user is connected before searching the Ad Library. Returns only the stable user ID. Long-lived user tokens last about 60 days and cannot be refreshed; reconnect when expired. Every connecting user must complete Meta ID confirmation.

  • meta_ad_library.search_ads
    Search archived ads

    Use when researching public ad creative by keyword or exact phrase. Results outside the EU cover political and issue ads only. Pass nextCursor as after; countries and optional page IDs narrow the search.

  • meta_ad_library.list_page_ads
    List page ads

    Use when inspecting ads from up to ten known Facebook Page IDs. Country and date filters bound the listing; commercial coverage is limited to ads reaching the EU. Pass nextCursor as after.

  • meta_ad_library.search_political_ads
    Search political and issue ads

    Use when researching political or issue messaging by keyword, country and optional page IDs. Spend and impressions are reported as ranges and may be absent or null. Pass nextCursor as after.

  • meta_ad_library.search_housing_ads
    Search housing ads

    Use when researching housing ads by keyword. Non-political ads must reach an EU country. A non-EU-only search (e.g. US) returns no commercial ads; empty does not mean none exist. Pass nextCursor as after. Tokens last ~1–2h; reconnect on expiry.

  • meta_ad_library.search_employment_ads
    Search employment ads

    Use when researching employment ads by keyword. Non-political ads must reach an EU country. A non-EU-only search (e.g. US) returns no commercial ads; empty does not mean none exist. Pass nextCursor as after. Tokens last ~1–2h; reconnect on expiry.

  • meta_ad_library.search_financial_ads
    Search financial products ads

    Use when researching financial-product ads by keyword. Non-political ads must reach an EU country. A non-EU-only search (e.g. US) returns no commercial ads; empty does not mean none exist. Pass nextCursor as after. Tokens last ~1–2h; reconnect on expiry.

write

0

Create and change things. Allow, or ask the user first.

  • No write actions.

destructive

0

Delete, cancel or archive. Ask first, or deny outright.

  • No destructive actions.
03 · POLICIES AND AUDIT

Control access to Meta Ad Library.

After early access is enabled, connect the intended Meta Ad Library account, authorize your AI client and set policies for its tools.

Provider permissions and Arc0 policy both apply. Allow reads, require approval for selected writes, or deny destructive actions. The audit log records execution decisions.

Configure policies and approvals

Example policy choices

  • Read actions: allow where authorized

Arc0 MCP endpoint: https://api.arc0.ai/mcp

04 · AUTH AND DATA

How Meta Ad Library connects.

Connect Meta Ad Library using OAuth. OAuth grants the provider scopes shown during consent; API keys and other credentials retain the permissions configured at the provider. Arc0 stores credentials in its encrypted vault and does not pass them to the model. Disconnect to remove access through Arc0; revoke a key at the provider to invalidate it there. Token refresh and provider-side revocation depend on the authentication lane and provider.

The connection serves authorized calls through Arc0 MCP and REST. How Arc0 handles credentials →

AUTH
OAuth
CREDENTIALS
Per-tenant encrypted vault
MODEL SEES
Results only, never credentials
AUDIT LOG
Every call, on every plan
05 · AI CLIENTS

Use Meta Ad Library with your AI client.

Request access to Meta Ad Library first. An Arc0 administrator must enable it for your organization before these actions appear. Then authorize your AI client separately. It only receives tools and accounts allowed for that identity.

Meta Ad Library with Claude

Claude Desktop + Claude Code

  1. In Claude Desktop, add Arc0 through the remote MCP settings and use OAuth. Follow the generic remote-client steps if your account’s interface differs.
  2. For Claude Code, run the command below. Open /mcp, select Arc0, and authenticate in your browser. Select your workspace and review access.
  3. Check the connection with claude mcp get arc0.
claude mcp add --transport http --scope user arc0 https://api.arc0.ai/mcp
Full MCP setup and troubleshooting
All apps for Claude
Meta Ad Library with ChatGPT

ChatGPT on the web

  1. Open Plugins in ChatGPT, select the plus button, then Add custom MCP server.
  2. Name it Arc0, enter the server URL below, and choose OAuth. Use dynamic client registration if asked; no Arc0 API key is needed.
  3. Review the notice and select Create as a plugin. Complete Arc0 sign-in, workspace selection and consent, then install and select the plugin in your conversation. Labels and access vary by account; managed workspaces may require administrator approval.
https://api.arc0.ai/mcp
Full MCP setup and troubleshooting
All apps for ChatGPT
Meta Ad Library with OpenAI Codex

Codex app + CLI

  1. Run the registration command below. The app and CLI share ~/.codex/config.toml.
  2. Complete browser OAuth, choose your Arc0 workspace, and review access. If authentication does not start, run codex mcp login arc0.
  3. Check codex mcp list, then open a new Codex chat. Inspect an existing arc0 entry before changing it.
codex mcp add arc0 --url https://api.arc0.ai/mcp
Full MCP setup and troubleshooting
All apps for OpenAI Codex
Meta Ad Library with Cursor

Remote MCP setup

  1. Add Arc0 in your client’s remote MCP settings using the server URL below.
  2. Choose OAuth, sign in to Arc0, select the intended workspace and review access.
  3. Confirm the server is connected and start with an allowed read. These are generic remote-MCP steps; consult your client’s settings for its current interface.
https://api.arc0.ai/mcp
Full MCP setup and troubleshooting
All apps for Cursor
Meta Ad Library with VS Code

Remote MCP setup

  1. Add a remote HTTP MCP server named Arc0 using the URL below.
  2. Use OAuth and finish Arc0 sign-in, workspace selection and consent.
  3. Confirm discovery succeeds before requesting a read. These are generic remote-MCP steps; client UI and availability may differ.
https://api.arc0.ai/mcp
Full MCP setup and troubleshooting
Meta Ad Library with Any MCP client

Streamable HTTP

  1. Use a client that supports remote MCP over Streamable HTTP. Add the server URL below and choose OAuth.
  2. For a client without OAuth, use a self-bound API key with execute permission in the X-API-Key header. Store it in secret storage or an environment variable, outside source control. Never send both an API key and an OAuth bearer token.
  3. Use the MCP clients guide for the SDK transport example and Embedded identity for business-managed end users.
https://api.arc0.ai/mcp
Full MCP setup and troubleshooting

After setup, ask your agent to find an allowed read action, load its schema, and execute it on the intended account. Check Activity for the receipt. A connected MCP client alone does not confirm a successful provider call.

06 · RELATED

More marketing apps.

ActiveCampaignEarly access · 8 actionsMailchimpEarly access · 8 actionsKlaviyoEarly access · 10 actionsKit (ConvertKit)Early access · 10 actionsSemrushEarly access · 6 actionsBrevoEarly access · 8 actionsMozEarly access · 6 actionsMeta AdsComing soon
ALL MARKETING APPS →
07 · FAQ

Meta Ad Library and Arc0, answered.

Q01

Does Meta Ad Library work with Claude Desktop and Claude Code?

Yes, after early access is enabled for your organization and you connect the intended account. Use Arc0’s remote MCP endpoint with OAuth. Claude Code has a documented registration command; Desktop uses the generic remote-client setup.

Q02

Can I use Meta Ad Library with OpenAI Codex, ChatGPT and Cursor?

Yes, after early access is enabled for your organization and you connect the intended account. Codex and ChatGPT have setup instructions in Arc0’s MCP clients guide. Cursor uses the generic remote-MCP steps. Tool access remains scoped to the authorized identity.

Q03

Is this the official Meta Ad Library MCP server?

This is Arc0’s integration page, not a claim of an official Meta Ad Library server. Arc0 adds a shared connection, policy and audit experience across apps. Consult Meta Ad Library for its own current MCP offerings.

Q04

Which Meta Ad Library actions are supported?

7 registry-defined actions: 7 read, 0 write and 0 destructive. Provider permissions, access enablement and Arc0 policy determine what can execute.

Q05

Which permissions does Meta Ad Library need?

Connect Meta Ad Library using OAuth. OAuth grants the provider scopes shown during consent; API keys and other credentials retain the permissions configured at the provider. Arc0 stores credentials in its encrypted vault and does not pass them to the model. Disconnect to remove access through Arc0; revoke a key at the provider to invalidate it there. Token refresh and provider-side revocation depend on the authentication lane and provider.

Q06

Can I restrict writes in Meta Ad Library?

You can deny write and destructive actions or require approval. Provider scopes and Arc0 action policies are separate controls; a policy does not grant additional provider permissions.

Q07

What does Meta Ad Library through Arc0 cost?

See Arc0 pricing for current connectivity plans. The provider may require its own subscription or charge per request. Arc0 plan allowances do not make third-party data or paid actions free.

Get started

Request Meta Ad Library access.

Meta Ad Library MCP server: 7 actions including get connected user id, search archived ads, list page ads. Request early access through Arc0.

Request early accessBrowse all apps →

Free to build · MCP + REST · Audit log on every plan

Meta Ad Library and its logo are trademarks of their respective owners. Arc0 is not affiliated with or endorsed by Meta Ad Library.