Adextract MCP Server

Adextract MCP Server

Connect AI assistants to Adextract — search ad libraries across Meta, Google Ads, LinkedIn, and TikTok, plus creative analysis with ad_reader.

Hosted endpoint: https://mcp.adextract.co/mcp

---

Installation

Hosted MCP (recommended)

Connect to the Adextract hosted server:

https://mcp.adextract.co/mcp

Get your API key at adextract.co (account → API keys).

Cursor

Add to ~/.cursor/mcp.json or project .cursor/mcp.json:

{
  "mcpServers": {
    "ad-extract": {
      "url": "https://mcp.adextract.co/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

VS Code

Add to .vscode/mcp.json:

{
  "servers": {
    "ad-extract": {
      "type": "http",
      "url": "https://mcp.adextract.co/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Claude Web (OAuth)

1. Open Claude → Settings → Connectors → Add custom connector
2. Name: ad-extract
3. URL: https://mcp.adextract.co/mcp
4. Sign in and approve when prompted — no API key in the URL.

Claude Desktop (mcp-remote)

{
  "mcpServers": {
    "ad-extract": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.adextract.co/mcp",
        "--header",
        "Authorization: Bearer YOUR_API_KEY"
      ]
    }
  }
}

More clients and config paths: docs/CLIENT_SETUP.md

---

Available Tools

Full reference: docs/TOOLS.md

---

Prompts & Resources

Built-in MCP prompts for common workflows:

• adextract_top_ads_for_brand
• adextract_competitor_benchmark
• adextract_channel_strategy
• adextract_analyze_ad_url
• adextract_schedule_watchlist

Resources include agent skill instructions and prompt-pack references (adextract://skill/main, etc.).

---

Authentication

Discovery endpoints:

• https://mcp.adextract.co/.well-known/oauth-protected-resource
• https://mcp.adextract.co/oauth/.well-known/oauth-authorization-server

Server card (registry / client discovery):

• https://mcp.adextract.co/.well-known/mcp.json

---

Example prompts

Show me the latest Nike ads on Facebook in the US.
→ search_meta_ads({ q: "nike", country: "US", active_status: "active" })

Find Google ads for tesla.com from the last 30 days.
→ search_google_ads({ domain: "tesla.com", time_period: "last_30_days" })

Analyze this ad creative URL with ad_reader.
→ ad_reader({ url: "https://..." })

---

Documentation

---

Links

• Website: adextract.co
• MCP endpoint: https://mcp.adextract.co/mcp
• Repository: github.com/ad-vertly/adextract-mcp-server

Built with ❤️ by Adextract