{
  "markdown": "# Maqui Analytics MCP Server\n\nAll-in-one marketing analytics MCP — Instagram, ads, web traffic, SEO and reviews for local businesses and the agencies that manage them.\n\n**Server URL:** `https://app.somosmaqui.com/api/mcp`\n\n---\n\n## What you can ask\n\nConnect Maqui to your AI assistant and query all your marketing channels in plain language — no dashboards, no tab switching.\n\n| Channel | What you can ask |\n|---|---|\n| **Instagram** | Reach, engagement rate, top posts, follower growth, hashtag performance |\n| **Google Ads** | Spend, CTR, CPC, conversions, CPA, ROAS by campaign and keyword |\n| **Meta Ads** | Facebook & Instagram ad spend, reach, leads, messages, purchases |\n| **Google Analytics 4** | Sessions, users, bounce rate, top pages, traffic sources |\n| **Search Console** | Organic clicks, impressions, rankings, top queries and pages |\n| **Reviews** | Google Business & Facebook ratings, response rate, recent reviews |\n| **CRM / Leads** | Pipeline leads by status and source |\n| **POS Sales** | Fudo restaurant sales by channel (dine-in, delivery, counter) |\n\n### Example prompts\n\n- *\"How did our Instagram perform last month compared to the month before?\"*\n- *\"Which Google Ads campaign has the best ROAS this quarter?\"*\n- *\"What are our top 5 organic search queries this week?\"*\n- *\"Show me all 1-star reviews from the last 30 days\"*\n- *\"How many leads did we get from Meta Ads vs organic in January?\"*\n\n---\n\n## Compatible clients\n\nWorks with any MCP-compatible AI client:\n\n- [Claude Desktop](https://claude.ai/download) and [Claude.ai](https://claude.ai)\n- [ChatGPT](https://chatgpt.com) (with MCP support enabled)\n- [Cursor](https://cursor.com)\n- [Windsurf](https://codeium.com/windsurf)\n- [Cline](https://github.com/cline/cline)\n- [Continue](https://continue.dev)\n- Any client that supports the [Model Context Protocol](https://modelcontextprotocol.io)\n\n---\n\n## Authentication\n\nMaqui uses per-account authentication. Each client account has its own token — data is always scoped to that account.\n\n### Option A: OAuth 2.0 (recommended for Claude.ai, ChatGPT and modern clients)\n\nClients that support OAuth 2.0 can connect automatically. Maqui implements the full PKCE flow:\n\n| Endpoint | URL |\n|---|---|\n| Discovery | `https://app.somosmaqui.com/.well-known/oauth-authorization-server` |\n| Authorization | `https://app.somosmaqui.com/oauth/authorize` |\n| Token | `https://app.somosmaqui.com/oauth/token` |\n\nJust add the server URL to your client — it will handle login automatically.\n\n### Option B: Bearer token (for Claude Desktop and manual configuration)\n\nGet your API token from the Maqui dashboard, then configure your client manually.\n\n**Claude Desktop** — add to `~/Library/Application Support/Claude/claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"maqui\": {\n      \"url\": \"https://app.somosmaqui.com/api/mcp\",\n      \"headers\": {\n        \"Authorization\": \"Bearer YOUR_API_TOKEN\"\n      }\n    }\n  }\n}\n```\n\n**Other clients** — use the server URL with an `Authorization: Bearer YOUR_API_TOKEN` header.\n\n> API tokens are generated per account from the Maqui admin panel and are valid for one year. They can be revoked at any time from the dashboard — access is cut off immediately, without affecting any other account's token.\n\n---\n\n## For agencies\n\nMaqui is built for marketing agencies managing multiple clients. Each client account has an isolated dataset and its own API token — there is no cross-account data access.\n\nIf you manage several clients, each gets their own token scoped to their data. When a client relationship ends, revoke that client's token from the admin panel and their access stops immediately — the other clients' tokens keep working. You can configure multiple instances in your AI client:\n\n```json\n{\n  \"mcpServers\": {\n    \"maqui-cliente-a\": {\n      \"url\": \"https://app.somosmaqui.com/api/mcp\",\n      \"headers\": { \"Authorization\": \"Bearer TOKEN_CLIENTE_A\" }\n    },\n    \"maqui-cliente-b\": {\n      \"url\": \"https://app.somosmaqui.com/api/mcp\",\n      \"headers\": { \"Authorization\": \"Bearer TOKEN_CLIENTE_B\" }\n    }\n  }\n}\n```\n\n---\n\n## About Maqui\n\n[Maqui](https://somosmaqui.com) is a marketing analytics platform for restaurants, retail, and service businesses. It syncs data daily from Instagram, Google Ads, Meta Ads, Google Analytics, Search Console, Google Business reviews, and POS systems — and makes it queryable through a conversational interface.\n\n→ [somosmaqui.com](https://somosmaqui.com)\n",
  "bytes": 4456,
  "sha": "d050c2c12be2a0b93e2834ab27c938a51f56db91cae6f80078bc1e127a94ac6c",
  "repo_slug": "somosmaqui/maqui-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_luis_fuentes_maqui_c4caedca/readme"
}