Unified MCP Server

Unified server or platform server

• Unified server: https://main.insightfulmcp.com/ with the server name main-mcp. The agent can reach every connected platform in the workspace, plus the research tools that need no platform account: Ads Libraries, Web Crawler, PageSpeed Insights, Screenshots and Enrichment Crawlers.
• Platform server: https://<platform>.insightfulmcp.com/ with the server name <platform>-mcp, for example google-ads-mcp. The agent only sees that platform's accounts.
• The InsightfulPipe listings in the Claude Directory and in the ChatGPT & Codex app directory both connect the unified server.
• Both kinds of server use the same connected accounts, the same sign-in and the same action controls.

What agents can do

The unified server exposes the same tools as every platform server, plus list_platforms:

• list_platforms: lists the supported platform slugs with a short description of each.
• query_contexts: with request="accounts" and no platform, lists your connected sources across every platform; with a platform, returns the workspace, brand and account identifiers, the available actions (request="available_actions") and the exact request format for each action (request="actions_details").
• query_data: runs read actions such as reports and listings on the platform you name.
• execute_action: runs write actions such as creating or updating campaigns on the platform you name.
• prompts_menu: lists saved prompts for a data source.

Every call names a platform, for example google-ads, google-analytics or shopify. A few platform slugs differ from their server names: YouTube uses youtube-analytics and youtube-data, and the research tools use enrichment-crawlers, pagespeed-insights and screenshot.

Before you connect

• An InsightfulPipe workspace with at least one connected account. See First Connection.
• Plans start at $29.99/month with a 7-day free trial. The unified server is included with the platform servers and the CLI.

Connect the unified server

1. In the InsightfulPipe app, open MCP Servers and choose InsightfulPipe.
2. Pick your AI client's tab in the guide, or use one of the directory listings below.
3. Add the server with the URL https://main.insightfulmcp.com/ and the server name main-mcp, following the steps for your client.
4. Click Authorize access in the browser window that opens.

Add the MCP server to your AI client

Server URL: https://main.insightfulmcp.com/ and server name: main-mcp.

• Claude, fastest: open InsightfulPipe in the Claude Directory. One click connects the unified server with all your connected accounts.
• Claude, manually: open Claude Connectors Settings, scroll to the bottom and click Add custom connector, paste the URL, click Add, then click Connect.
• ChatGPT and Codex app, fastest: open the InsightfulPipe listing in the ChatGPT or Codex desktop app, or in your browser, and click Connect. There is no URL to paste and no Developer mode, and the app works in both ChatGPT and Codex under the same account.
• ChatGPT, manually: in ChatGPT Security Settings turn on Developer mode, click Create on the Connectors page, paste the URL, click Create, then click Connect. Turn the connector on in each new chat with + → More.
• Claude Code: run claude mcp add --transport http main-mcp https://main.insightfulmcp.com/, then type /mcp, select main-mcp and click Authenticate.
• Cursor: in the app, open MCP Servers, choose InsightfulPipe and click Install InsightfulPipe MCP, click Open Cursor then Install, then click Connect and Open.
• Gemini CLI: run gemini mcp add --transport http main-mcp https://main.insightfulmcp.com/, then /mcp auth main-mcp.
• Codex CLI: run codex mcp add main-mcp --url https://main.insightfulmcp.com/; authorization starts automatically.

Each client opens a browser window where you log in to InsightfulPipe and click Authorize access. Step-by-step guides: Claude, ChatGPT, Claude Code, Cursor, Gemini CLI and Codex CLI.

Clients that read an mcpServers object can use this entry:

{
  "mcpServers": {
    "main-mcp": {
      "url": "https://main.insightfulmcp.com/"
    }
  }
}

Permissions and safety

• The unified server doesn't add permissions. Each connected account keeps its own Read Only or Read & Write access and its own enabled actions.
• Owners, administrators and operators choose which actions each account exposes in Configure actions for this account. Destructive actions such as deletes stay off until someone enables them.
• Write actions need the Owner, Administrator or Operator role. Members with the User role only reach the accounts granted to them, with read actions only, and only the research tools they have been granted.
• Because one server reaches every platform, check which platform and account the agent names before you approve a write.

Limits

• Every tool call has to name a platform, so ask the agent to list platforms or accounts first when a workspace has many connections.
• The agent only sees accounts in the workspace you authorized, and only the ones your role can access.
• In ChatGPT Developer mode, turn the connector on again in each new chat.

Example prompts

• "List every platform I have connected and the accounts on each."
• "Compare last month's spend in Google Ads and Facebook Ads with sessions in Google Analytics 4."
• "Using Shopify and Klaviyo, show revenue per day next to campaign sends for the last 30 days."
• "Run an SEO audit on https://example.com/pricing and check its Search Console clicks."

Troubleshooting

• "You need access to at least one account to authorize this application": connect an account first, or ask a workspace admin to grant you access to one.
• The agent can't find an account: ask it to call query_contexts with request="accounts" and no platform, then name the account you mean. Check that the connection is active in Connectors.
• "This action is disabled for this connected account. An owner or admin must enable it for the account.": an owner, administrator or operator can turn it on in Configure actions for this account.
• "Your role does not have permission to execute write actions. Only operators, admins, and owners can execute write operations.": members with the User role can only run read actions.
• More error messages are in Troubleshooting.

FAQ

Is the Claude Directory listing the same as the unified server?

Yes. The InsightfulPipe listings in the Claude Directory and in the ChatGPT & Codex app directory connect the full InsightfulPipe MCP with all your connected accounts, which is the unified server. To limit a client to one platform, add that platform's server URL instead.

Can I add the unified server and platform servers to the same client?

Yes. They are separate servers with their own names, such as main-mcp and google-ads-mcp, and they use the same connected accounts and permissions.

Do I need the unified server to use the CLI?

No. The InsightfulPipe CLI calls InsightfulPipe directly with an API key and reaches the same connected accounts.

Related

• InsightfulPipe MCP server page
• What Is MCP
• MCP Connectors Overview
• Other Clients
• Roles and Permissions