> ## Documentation Index
> Fetch the complete documentation index at: https://marrow-docs.hologrow.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP

# What is Marrow MCP?

Marrow MCP is a hosted [Model Context Protocol](https://modelcontextprotocol.io) 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.

Marrow sits in the middle: you authorize commerce and ads accounts in Integrations, Marrow 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?

| Method                                  | Best for                                                                      | Notes                                                    |
| --------------------------------------- | ----------------------------------------------------------------------------- | -------------------------------------------------------- |
| **OAuth** (recommended where available) | Codex, Claude                                                                 | One-click from **AI Platforms** — no URL or key to paste |
| **MCP**                                 | ChatGPT, Cursor, Gemini CLI, Hermes Agent, Claude Code, and other MCP clients | Paste the Marrow MCP server URL (and key when required)  |

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](../Marrow%20Basics/Features/Integrations.md)
2. Confirm sync is healthy in [Data Explorer](../Marrow%20Basics/Features/Data%20Explorer.md)
3. Open **AI Hub → AI Platforms** to get the MCP server URL and create a key if needed — see [AI Platforms](../Marrow%20Basics/Features/AI%20Platforms.md)

## 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.marrow.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 Marrow MCP?

Once connected, your AI client can read the data Marrow 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](../Marrow%20Basics/Features/Skills.md) for common operator workflows
* Build reports or analyses inside the AI tools you already use

Marrow 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:

* [Using Codex](./Using%20Codex.md)
* [Using Claude](./Using%20Claude.md) (includes Claude Code)
* [Using ChatGPT](./Using%20ChatGPT.md)
* [Using Cursor](./Using%20Cursor.md)
* [Using Gemini CLI](./Using%20Gemini%20CLI.md)
* [Using Hermes Agent](./Using%20Hermes%20Agent.md)

### Generic MCP client

If your client is not listed, add Marrow as a remote MCP server:

* **URL**: `https://mcp.marrow.ai/mcp/v1`
* **Transport**: HTTP (streamable)
* **Auth**: Your MCP key from AI Platforms (typically as `Authorization: Bearer <YOUR_MCP_KEY>`)

```json theme={null}
{
  "mcpServers": {
    "marrow": {
      "url": "https://mcp.marrow.ai/mcp/v1",
      "headers": {
        "Authorization": "Bearer <YOUR_MCP_KEY>"
      }
    }
  }
}
```

Exact config shape varies by client — use the platform guides above when available.

## Security

* Marrow exposes **read-only** access to synced data.
* Marrow 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.

## Related

* [AI Platforms](../Marrow%20Basics/Features/AI%20Platforms.md) — OAuth, MCP URL, and keys in the product
* [Skills](../Marrow%20Basics/Features/Skills.md) — ready-made analyses for your AI clients
* [Integrations](../Marrow%20Basics/Features/Integrations.md) — connect store and ad accounts
* [Data Explorer](../Marrow%20Basics/Features/Data%20Explorer.md) — confirm sync health