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.

​
Available tools

The Converge MCP server exposes four 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.
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. You only need to authenticate once per session.

​
Example prompts

Here are a few things you can ask once the MCP server is connected:
  • “Break down this week’s spend, new customer orders, and CPA by channel.”
  • “Show me campaign-level spend and ROAS for Meta this week vs last week.”
  • “What are my top 10 ads by ROAS in the last 30 days?”
  • “Give me monthly revenue by channel for the last 12 months.”
  • “Pull yesterday’s hourly spend and new customer orders by channel.”
  • “Which landing pages drove the most new customer orders this month?”

​
Applications and use cases

Chat with your data

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

Automate workflows

Schedule recurring reports with n8n, Zapier, or other automation platforms.