Skip to main content
The Model Context Protocol (MCP) is an open standard that lets AI assistants connect to external data sources. The Converge MCP server gives any MCP-compatible client read access to your analytics data, with no code required.

Applications and use cases

Pick a use case to get started. Each page walks you through the full setup.

Example prompts

Ask analytics questions from Claude, ChatGPT, or any MCP-compatible assistant.

Automate workflows

Schedule recurring reports with n8n, Zapier, or Claude Cowork.

Ask Claude in Slack

Query your analytics data by @mentioning Claude in any Slack channel.

Available tools

The Converge MCP server exposes the following tools:
ToolDescription
list_workspacesLists all workspaces you have access to.
list_analytics_viewsLists your saved analytics views from within the app. The different types are: attribution, overview, pacing, landing page, product.
get_analytics_view_dataExport a saved analytics view’s data. Useful for further analysis.
analytics_queryRun custom queries with full flexibility over metrics, filters, breakdowns, date ranges, and attribution models.
list_store_dimensionsList store dimensions available for a workspace. Store dimensions are user-defined groupings typically used for separating regions, brands, or sales channels.
collect_feedbackCollects feedback about your experience. Fires automatically when issues arise, or ask your AI assistant to submit feedback anytime.
Given these tools, there are two main ways to pull data:
  • Saved reports (get_analytics_view_data): Pull data directly from a report you’ve already built in Converge. What you get back is exactly what you see in the app, no extra configuration needed. Use the list_analytics_views tool to see what reports are available.
  • Flexible queries (analytics_query): Choose any combination of metrics, date ranges, attribution models, and breakdowns (channel, campaign, ad set, landing page). Far more versatile and powerful, and what you’ll use most of the time.

Workspaces

If your account has access to multiple workspaces, specify the one you want by name in your prompt (e.g. “Show me last week’s spend for Acme US). If you don’t specify one, the AI assistant will fetch your list of available workspaces and ask you to pick one. Once a workspace is selected, it stays active for the rest of the conversation. You can switch at any time by asking for a different workspace. New conversations start fresh — there’s no workspace carried over between chats.
Instead of passing a workspace name, you can also define your workspace ID in the prompt, which skips the workspace-lookup step and is slightly faster. Find both your workspace name and ID in the Converge app:
How to find your workspace name and ID

Authentication

The Converge MCP server URL is:
https://app.runconverge.com/api/mcp
Authentication happens via Google OAuth. On your first interaction, a browser window opens automatically for Google sign-in. Use the same Google account you use to access Converge.

Example prompts

Anything you can query in Converge, you can ask in natural language. Your AI assistant translates your question into the right metrics, filters, breakdowns, and date ranges automatically.
  • Channel and campaign performance: “Break down yesterday’s new customer orders, spend, and CPA by channel group.”
  • Ad-level creative analysis: “Show total spend and new customer first-touch ROAS for all ads with ‘UGC Script’ last quarter.”
  • Daily performance and revenue tracking: “Pull an MTD summary of spend, revenue, and new customer orders by channel.”
  • Country and market comparisons: “Break down monthly Facebook spend, new customer orders, and revenue per country from March 2024 to now.”
  • Landing page and funnel analysis: “Which landing pages drove the most new customer orders this month?”