maqui-mcp
All-in-one marketing analytics MCP — Instagram, ads, web traffic, SEO and reviews for local businesses and the agencies that manage them
Documentation
Maqui Analytics MCP Server
All-in-one marketing analytics MCP — Instagram, ads, web traffic, SEO and reviews for local businesses and the agencies that manage them.
Server URL: `https://app.somosmaqui.com/api/mcp`
What you can ask
Connect Maqui to your AI assistant and query all your marketing channels in plain language — no dashboards, no tab switching.
| Channel | What you can ask |
|---|---|
| Reach, engagement rate, top posts, follower growth, hashtag performance | |
| Google Ads | Spend, CTR, CPC, conversions, CPA, ROAS by campaign and keyword |
| Meta Ads | Facebook & Instagram ad spend, reach, leads, messages, purchases |
| Google Analytics 4 | Sessions, users, bounce rate, top pages, traffic sources |
| Search Console | Organic clicks, impressions, rankings, top queries and pages |
| Reviews | Google Business & Facebook ratings, response rate, recent reviews |
| CRM / Leads | Pipeline leads by status and source |
| POS Sales | Fudo restaurant sales by channel (dine-in, delivery, counter) |
Example prompts
- *"How did our Instagram perform last month compared to the month before?"*
- *"Which Google Ads campaign has the best ROAS this quarter?"*
- *"What are our top 5 organic search queries this week?"*
- *"Show me all 1-star reviews from the last 30 days"*
- *"How many leads did we get from Meta Ads vs organic in January?"*
Compatible clients
Works with any MCP-compatible AI client:
- Claude Desktop and Claude.ai
- ChatGPT (with MCP support enabled)
- Cursor
- Windsurf
- Cline
- Continue
- Any client that supports the Model Context Protocol
Authentication
Maqui uses per-account authentication. Each client account has its own token — data is always scoped to that account.
Option A: OAuth 2.0 (recommended for Claude.ai, ChatGPT and modern clients)
Clients that support OAuth 2.0 can connect automatically. Maqui implements the full PKCE flow:
| Endpoint | URL |
|---|---|
| Discovery | `https://app.somosmaqui.com/.well-known/oauth-authorization-server` |
| Authorization | `https://app.somosmaqui.com/oauth/authorize` |
| Token | `https://app.somosmaqui.com/oauth/token` |
Just add the server URL to your client — it will handle login automatically.
Option B: Bearer token (for Claude Desktop and manual configuration)
Get your API token from the Maqui dashboard, then configure your client manually.
Claude Desktop — add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
{
"mcpServers": {
"maqui": {
"url": "https://app.somosmaqui.com/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}Other clients — use the server URL with an `Authorization: Bearer YOUR_API_TOKEN` header.
> 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.
For agencies
Maqui 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.
If 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:
{
"mcpServers": {
"maqui-cliente-a": {
"url": "https://app.somosmaqui.com/api/mcp",
"headers": { "Authorization": "Bearer TOKEN_CLIENTE_A" }
},
"maqui-cliente-b": {
"url": "https://app.somosmaqui.com/api/mcp",
"headers": { "Authorization": "Bearer TOKEN_CLIENTE_B" }
}
}
}About Maqui
Maqui 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.
Frequently asked questions
What is maqui-mcp?
maqui-mcp is All-in-one marketing analytics MCP — Instagram, ads, web traffic, SEO and reviews for local businesses and the agencies that manage them
How do I install maqui-mcp?
Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.
Is maqui-mcp open source?
Yes — it is hosted on GitHub at https://github.com/somosmaqui/maqui-mcp.
Related MCP tools
The easy-to-use open source Business Intelligence and Embedded Analytics tool that lets everyone work with data :bar_chart:
The Open-Source Multimodal AI Agent Stack: Connecting Cutting-Edge AI Models and Agent Infra
A MCP for Claude Desktop / Claude Code / Windsurf / Cursor to build n8n workflows for you
🔥 Official Firecrawl MCP Server - Adds powerful web scraping and search to Cursor, Claude and any other LLM clients.
Browser MCP is a Model Context Provider (MCP) server that allows AI applications to control your browser
A Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.
Run your own MCP server? See who uses it and what to fix.
Measure it with TrackMCP