Maqui Analytics

What Maqui Analytics does

Maqui Analytics exposes marketing and business performance data through MCP tools that an AI assistant can query in natural language. The service is aimed at local businesses and agencies working with restaurants, retail, and service companies. Its data sources include Instagram, Google Ads, Meta Ads, Google Analytics 4, Google Search Console, Microsoft Clarity, Google Business and Facebook reviews, CRM leads, and Fudo restaurant sales.

The server supports 22 tools. Example questions include comparing Instagram performance across months, finding the highest-ROAS Google Ads campaign, listing recent one-star reviews, comparing Meta-generated leads with organic leads, and identifying leading organic search queries.

How it works

Maqui hosts the MCP endpoint at https://app.somosmaqui.com/api/mcp. A compatible client connects over Streamable HTTP and authenticates with OAuth using resource discovery, PKCE S256, and explicit user consent. OAuth access tokens last one hour. When offline access is requested, rotating refresh tokens remain valid for up to 30 days and token-family reuse causes revocation.

Bearer API tokens are another connection method. Each token belongs to one Maqui account, lasts one year, and can be revoked independently. The token is required for tool discovery as well as data requests. Maqui provisions access to real business data, and account datasets remain isolated.

Agencies can configure separate MCP entries for separate client accounts. Each entry uses that client’s account-scoped token, preventing cross-account access and allowing one client’s credential to be revoked without affecting others.

Setup and configuration

For a client that accepts a remote MCP URL and custom headers, use the hosted endpoint with an API token in the Authorization header. Clients that launch local processes can use mcp-remote through npx, with the token supplied through MAQUI_TOKEN rather than placing the secret directly in shared configuration.

OAuth connections require an approved client registration or an approved Client ID Metadata Document and callback origin. Unrecognized clients and callback URLs are rejected. OAuth users sign in to Maqui and approve read access.

A synthetic demo option on the OAuth consent page allows all 22 tools to be tried without accessing customer metrics. Demo responses use fictional data, are marked as synthetic, and cannot be converted to real-account access by changing account_id. Keep real tokens out of repositories and public examples.

Tools and capabilities

• Query Instagram reach, engagement rate, follower growth, top posts, and hashtag performance.
• Analyze Google Ads spend, CTR, CPC, conversions, CPA, and ROAS by campaign or keyword.
• Review Meta Ads spend, reach, leads, messages, and purchases.
• Inspect GA4 sessions, users, bounce rate, pages, and traffic sources.
• Examine Search Console clicks, impressions, rankings, queries, and pages.
• Check Clarity behavior signals, reviews, CRM leads, and Fudo sales by channel.

Limitations and notes

The hosted service and backend are proprietary; the repository’s documentation, registry metadata, and configuration examples are MIT licensed. Real-data access depends on Maqui provisioning the relevant account. The synthetic demo does not apply every requested filter and uses a fixed sample period even when a different date range is requested. OAuth compatibility depends on client registration and supported callback origins.