{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_4x2g7uht36bs","handle":"meta-ads-mcp-server","url":"https://wellknown.network/agents/meta-ads-mcp-server","links":{"self":"https://wellknown.network/agents/meta-ads-mcp-server/record.json","html":"https://wellknown.network/agents/meta-ads-mcp-server","markdown":"https://wellknown.network/agents/meta-ads-mcp-server/record.md","api":"https://wellknown.network/api/v1/agents/meta-ads-mcp-server","status":"https://wellknown.network/api/v1/agents/meta-ads-mcp-server/status","claim":"https://wellknown.network/agents/meta-ads-mcp-server/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/meta-ads-mcp-server/claim.json","badge":"https://wellknown.network/agents/meta-ads-mcp-server/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/meta-ads-mcp-server/history","tools":"https://wellknown.network/api/v1/agents/meta-ads-mcp-server/tools"},"ard":{"identifier":"urn:air::server:meta-ads-mcp-server","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"meta-ads-mcp-server","summary":"Model Context Protocol server exposing the Meta Ads Graph API — 300+ tools for Facebook & Instagram Ads.","description":"# meta-ads-mcp-server\n\n> MCP server for the Meta Marketing API (Facebook & Instagram Ads) — 300+ tools.\n\n[![PyPI](https://img.shields.io/pypi/v/meta-ads-mcp-server)](https://pypi.org/project/meta-ads-mcp-server/)\n[![Python](https://img.shields.io/pypi/pyversions/meta-ads-mcp-server)](https://pypi.org/project/meta-ads-mcp-server/)\n[![License](https://img.shields.io/pypi/l/meta-ads-mcp)](https://github.com/mattyu-dev/mcp-meta/blob/main/LICENSE)\n\n## Install\n\n### Option 1: uvx (zero install, recommended)\n\nAdd this to your MCP client config (e.g. Claude Desktop's `claude_desktop_config.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"meta-ads\": {\n      \"command\": \"uvx\",\n      \"args\": [\"meta-ads-mcp-server\"],\n      \"env\": {\n        \"META_ACCESS_TOKEN\": \"YOUR_TOKEN\",\n        \"META_DEFAULT_AD_ACCOUNT_ID\": \"act_YOUR_ACCOUNT_ID\"\n      }\n    }\n  }\n}\n```\n\n### Option 2: pip install\n\n```bash\npip install meta-ads-mcp-server\n```\n\nThen add to your MCP client config:\n\n```json\n{\n  \"mcpServers\": {\n    \"meta-ads\": {\n      \"command\": \"meta-ads-mcp\",\n      \"env\": {\n        \"META_ACCESS_TOKEN\": \"YOUR_TOKEN\",\n        \"META_DEFAULT_AD_ACCOUNT_ID\": \"act_YOUR_ACCOUNT_ID\"\n      }\n    }\n  }\n}\n```\n\n### Option 3: Interactive Setup Wizard\n\n```bash\npip install meta-ads-mcp-server\nmeta-ads-setup\n```\n\nThe wizard auto-detects your installed MCP clients (Claude Desktop, Cursor, VS Code, Windsurf, Gemini CLI) and configures them for you.\n\n## Getting Your Meta Access Token\n\n1. Go to [Meta Business Settings > System Users](https://business.facebook.com/settings/system-users)\n2. Create or select a System User\n3. Click **Generate New Token**\n4. Select `ads_management` and `ads_read` permissions\n5. Copy the token\n\n## Licensing\n\n**Free tier** (no key needed): 10 read-only tools — insights, campaign search, spend trends, business listing, and more. Enough to explore and evaluate.\n\n**Pro tier** (license key): Unlocks all 300+ tools including campaign creation, audience management, optimization, fraud detection, and th…","publisher":{"name":"Matt Yu","url":null},"homepage":"https://github.com/mattyu-dev/mcp-meta/tree/main/docs","repository":"https://github.com/mattyu-dev/mcp-meta/issues","version":"0.1.0","license":"MIT","protocols":["mcp"],"tags":["mcp","meta","facebook","instagram","ads","graph-api","marketing","model-context-protocol"],"pricing":null,"endpoints":[{"url":"pypi:meta-ads-mcp-server","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.social","name":"Social Media","confidence":1,"provenance":"declared"},{"slug":"content.marketing","name":"Marketing","confidence":1,"provenance":"declared"},{"slug":"knowledge.knowledge-graph","name":"Knowledge Graphs","confidence":0.997,"provenance":"derived"}],"categories":["content","knowledge"],"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-server","registry":"pypi","observedAt":"2026-10-22T13:23:11.752Z","publishedAt":"2026-02-16T19:11:09.127599Z","latestVersion":"0.1.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"meta-ads-mcp-server","url":"https://pypi.org/project/meta-ads-mcp-server/","firstSeenAt":"2026-09-10T05:23:14.811Z","fetchedAt":"2026-10-22T13:21:45.471Z","normalizedAt":"2026-10-22T13:21:45.471Z"}]},"firstSeenAt":"2026-09-10T05:23:14.811Z","updatedAt":"2026-10-22T13:23:11.752Z"}