Skip to main content

​
What is Hologrow MCP?

Hologrow MCP is a hosted Model Context Protocol server that exposes your synced store and ad data to AI clients. Connect once, then ask questions or run Skills from Codex, Claude, ChatGPT, Cursor, Gemini CLI, Hermes Agent, and other MCP-compatible tools. Hologrow sits in the middle: you authorize commerce and ads accounts in Integrations, Hologrow syncs the data, and MCP (or OAuth) makes that data available inside the AI tools you already use.

​
When should I use MCP vs OAuth?

If you already connected a platform via OAuth, you do not need to connect the same platform again via MCP.

​
Prerequisites

Before you connect any AI client:
  1. Authorize at least one store or ad account in Integrations
  2. Confirm sync is healthy in Data Explorer
  3. Open AI Hub → AI Platforms to get the MCP server URL and create a key if needed — see AI Platforms

​
How do I get the MCP URL and key?

  1. Go to AI Platforms.
  2. Under Standard connection: MCP, copy the MCP server URL: https://mcp.hologrow.ai/mcp/v1
  3. For headless clients (CLI agents, IDE configs, scripts), create an MCP key:
    • Click New key, give it a name, and create.
    • Copy the full key immediately — it is shown only once.
    • Rotate or revoke keys anytime from the keys table.
Treat MCP keys like passwords. Store them securely; never commit them to git or share them in chat logs.

​
What can I do with Hologrow MCP?

Once connected, your AI client can read the data Hologrow has already synced — for example sales, ads performance, and account-level metrics across the platforms you authorized. You can:
  • Ask plain-language questions about your store and ad performance
  • Run Skills for common operator workflows
  • Build reports or analyses inside the AI tools you already use
Hologrow is read-only. It never posts on your behalf and never changes campaigns, listings, budgets, or settings in your connected platforms.

​
Platform guides

Pick your AI client and follow the setup steps:

​
Generic MCP client

If your client is not listed, add Hologrow as a remote MCP server:
  • URL: https://mcp.hologrow.ai/mcp/v1
  • Transport: HTTP (streamable)
  • Auth: Your MCP key from AI Platforms (typically as Authorization: Bearer <YOUR_MCP_KEY>)
Exact config shape varies by client — use the platform guides above when available.

​
Security

  • Hologrow exposes read-only access to synced data.
  • Hologrow does not change campaigns, listings, budgets, or settings in your commerce or ad platforms.
  • Treat MCP keys like passwords. Rotate if a client is compromised or retired.
  • Revoke OAuth sessions from the OAuth sessions table on AI Platforms when a user or device should lose access.