Core Concepts
Updated

How It Works

InsightfulPipe sits between your marketing and data platforms and your AI client. You connect accounts once in the app, add an MCP server URL to Claude, ChatGPT, Cursor, Claude Code, Gemini CLI or Codex, and the agent calls the platform APIs through InsightfulPipe when you ask a question.

The three steps

  1. Connect: click Connect on a platform, sign in, and assign the accounts to a brand.
  2. Add a server: add a platform server such as https://google-ads.insightfulmcp.com/, or the unified https://main.insightfulmcp.com/, to your AI client and click Authorize access in the browser.
  3. Ask: the agent looks up your accounts, reads data or runs the actions you allowed, and answers in the chat.

What happens behind a question

  • The agent calls query_contexts to find the workspace, brand and account to use.
  • It reads data with query_data, or runs a create, update or delete with execute_action.
  • InsightfulPipe checks your role, the account's allowed actions and the connection's access level, then calls the platform API live.
  • Platform tokens are stored encrypted, and API calls are recorded in the workspace activity log.

The building blocks

  • Workspace: your team's space, with members, roles and billing. See Workspaces.
  • Brands: groups of connections per client, product or region. See Brands.
  • Connections: authenticated platform accounts. See Connectors.
  • MCP servers: the URLs your AI client connects to. See MCP Protocol.
  • Prompts: reusable instructions for common analyses. See Prompts.

Plans start at $29.99/month with a 7-day free trial. Start with the Quickstart.

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.