MCP server exposing Meta (Facebook/Instagram) business insights via the Graph and Marketing APIs
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"meta-insights-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# meta-insights-mcp An MCP server exposing Meta (Facebook / Instagram) business insights through the Graph and Marketing APIs, using a System User access token. ## Install ```bash pip install meta-insights-mcp # or uv add meta-insights-mcp # or run ad-hoc without installing uvx meta-insights-mcp ``` ## Configuration The server reads its configuration from environment variables: | Var | Required | Default | Purpose | |-----|----------|---------|---------| | `META_ACCESS_TOKEN` | **yes** | — | System User access token | | `META_API_VERSION` | no | `v23.0` | Graph API version | | `META_BUSINESS_ID` | no | — | When set, enables business-scoped tools (`list_business_assets`, etc.) | ## Connect to Claude Add one of the following to your MCP client config (Claude Desktop: `~/Library/Application Support/Claude/claude_desktop_config.json`; Claude Code: `~/.claude.json` or project `.mcp.json`). ### Recommended — zero-install via `uvx` ```json { "mcpServers": { "meta-insights": { "command": "uvx", "args": ["meta-insights-mcp"], "env": { "META_ACCESS_TOKEN": "EAAG..." } } } } ``` ### After `pip install` ```json { "mcpServers": { "meta-insights": { "command": "meta-insights-mcp", "env": { "META_ACCESS_TOKEN": "EAAG..." } } } } ``` ### Module form (fallback) ```json { "mcpServers": { "meta-insights": { "command": "python", "args": ["-m", "meta_insights_mcp"], "env": { "META_ACCESS_TOKEN": "EAAG..." } } } } ``` ## Tools ### User-scoped (always available) | Tool | Purpose | |------|---------| | `list_meta_assets` | Ad accounts + Pages the token can see | | `check_token_status` | Token scopes, app, expiry | | `get_ad_account_insights` | Ads performance for an ad account | | `get_campaign_insights` | Insights for a single campaign | | `list_campaigns` | List campaigns under an ad account | | `get_page_insights` | Organic Page insights | | `ge…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.