Core Concepts
Updated

MCP Protocol

Model Context Protocol (MCP) is the open standard AI clients use to call external tools. InsightfulPipe hosts MCP servers, so Claude, ChatGPT, Cursor, Claude Code, Gemini CLI and Codex can reach your connected accounts after you add a server URL and authorize access.

Servers

  • Each platform has its own server at https://<platform>.insightfulmcp.com/, for example https://google-ads.insightfulmcp.com/. The in-app connection guide names it <platform>-mcp, such as google-ads-mcp.
  • The unified server https://main.insightfulmcp.com/ (server name main-mcp) covers every connected source through one connection.
  • The MCP Servers page in the app lists each server with its URL and a setup guide for every AI client.

Tools every server exposes

  • query_contexts: returns the workspace, brands, connected accounts, available actions and the request format for each action.
  • query_data: runs read actions such as reports and listings.
  • execute_action: runs write actions such as creating or updating campaigns.
  • prompts_menu: lists saved prompts for a data source.
  • The unified server also exposes list_platforms.

What controls access

  • You authorize the client with your InsightfulPipe login.
  • Your workspace role decides whether you can run write actions.
  • Each connection exposes only the actions enabled for it, and Read Only connections never run writes.

Add a server

Follow the guide for your client: Claude, ChatGPT, Claude Code, Cursor, Gemini CLI or Codex CLI. Browse all servers in the MCP server directory.

Need help?

If you need help connecting a source or setting up an AI workflow, the team can help you get from first sync to production faster.

Read the blogStart a trial