{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_nhhjbuc9hnfm","handle":"meta-ads-mcp-python","url":"https://wellknown.network/agents/meta-ads-mcp-python","links":{"self":"https://wellknown.network/agents/meta-ads-mcp-python/record.json","html":"https://wellknown.network/agents/meta-ads-mcp-python","markdown":"https://wellknown.network/agents/meta-ads-mcp-python/record.md","api":"https://wellknown.network/api/v1/agents/meta-ads-mcp-python","status":"https://wellknown.network/api/v1/agents/meta-ads-mcp-python/status","claim":"https://wellknown.network/agents/meta-ads-mcp-python/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/meta-ads-mcp-python/claim.json","badge":"https://wellknown.network/agents/meta-ads-mcp-python/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/meta-ads-mcp-python/history","tools":"https://wellknown.network/api/v1/agents/meta-ads-mcp-python/tools"},"ard":{"identifier":"urn:air::server:meta-ads-mcp-python","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"meta-ads-mcp-python","summary":"MCP server for Meta Ads API -- manage campaigns, ad sets, ads, and Business Manager accounts","description":"# Meta Ads MCP\n\nA [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server for analysing Meta Ads campaigns through an AI interface. Retrieve performance data, visualize ad creatives, and surface insights for Facebook, Instagram, and other Meta platforms.\n\n> **Read-only:** All tools are strictly read-only. No tool creates, modifies, or deletes any data.\n\n> **Independent project:** This is an open-source project using Meta's public APIs. Not affiliated with or endorsed by Meta. For an officially approved Meta app, see [Pipeboard](https://pipeboard.co).\n\n---\n\n## Quick Start (Remote MCP)\n\nThe fastest way to get started is the [Pipeboard remote MCP](https://pipeboard.co) — no local setup required.\n\nRemote MCP URL: `https://mcp.pipeboard.co/meta-ads-mcp`\n\nWith token auth: `https://mcp.pipeboard.co/meta-ads-mcp?token=YOUR_PIPEBOARD_TOKEN`\n\nGet your token at [pipeboard.co/api-tokens](https://pipeboard.co/api-tokens).\n\n### Claude (Pro/Max)\n\n1. Go to [claude.ai/settings/integrations](https://claude.ai/settings/integrations)\n2. Click **Add Integration**, set the URL to `https://mcp.pipeboard.co/meta-ads-mcp`\n3. Click **Connect** and follow the prompts.\n\n### Cursor\n\nAdd to `~/.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"meta-ads-remote\": {\n      \"url\": \"https://mcp.pipeboard.co/meta-ads-mcp?token=YOUR_PIPEBOARD_TOKEN\"\n    }\n  }\n}\n```\n\n### Other MCP Clients\n\nUse the remote URL above. Full setup guides: [pipeboard.co](https://pipeboard.co)\n\n---\n\n## Local Installation\n\n> For advanced users. The remote MCP is recommended for most cases.\n\n**Requirements:** Python 3.12+, a Meta Developer App (App ID + Secret), and [uv](https://github.com/astral-sh/uv).\n\n```bash\npip install meta-ads-mcp\n```\n\n### Authentication\n\nCopy `.env.example` to `.env` and set one of:\n\n```\nPIPEBOARD_API_TOKEN=your_token       # Recommended — no Meta app required\nMETA_APP_ID=your_app_id              # Direct Meta app credentials\nMETA_APP_SECRET=your_app_secret\n```\n\n### Run\n\n```bash\nmeta-ad…","publisher":{"name":"Yves Junqueira","url":null},"homepage":"https://github.com/locomotive-agency/meta-ads-mcp-python","repository":"https://github.com/locomotive-agency/meta-ads-mcp-python/issues","version":"1.0.82","license":"BUSL-1.1","protocols":["mcp"],"tags":["meta","facebook","ads","api","mcp","claude"],"pricing":null,"endpoints":[{"url":"pypi:meta-ads-mcp-python","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"content.marketing","name":"Marketing","confidence":1,"provenance":"declared"},{"slug":"security.identity","name":"Identity & Access","confidence":0.825,"provenance":"derived"}],"categories":["content","security"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"meta-ads-mcp-python","registry":"pypi","observedAt":"2026-10-22T13:23:11.606Z","publishedAt":"2026-04-16T15:03:07.641206Z","latestVersion":"1.0.82"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"meta-ads-mcp-python","url":"https://pypi.org/project/meta-ads-mcp-python/","firstSeenAt":"2026-09-10T05:23:14.575Z","fetchedAt":"2026-10-22T13:21:45.231Z","normalizedAt":"2026-10-22T13:21:45.231Z"}]},"firstSeenAt":"2026-09-10T05:23:14.575Z","updatedAt":"2026-10-22T13:23:11.606Z"}