Modern is the operating system for ecommerce businesses: every system you run — sales, ads, lifecycle, marketplace, support, finance — held in one secure, structured data layer. Modern MCP is the remote Model Context Protocol server that opens that layer to your AI client, read-only. Connect it once and Claude, ChatGPT, or any MCP-capable agent answers questions using your real numbers instead of a pasted spreadsheet.

Which AI clients can connect to Modern?

Any client that speaks the Model Context Protocol over streamable HTTP. Claude and ChatGPT connect by pasting a connector URL. Agent runtimes and editors such as Hermes, OpenClaw, and Cursor connect by adding Modern to their MCP server config with an Authorization header.

How do I connect Modern to Claude?

Generate an API key at Account → API Keys in Modern, then in Claude open Settings → Connectors → Add custom connector and paste https://mcp.modern.ai/mcp?api_key=YOUR_API_KEY as the remote MCP server URL. Ask which organizations you have access to and you are connected.

What can it actually see?

Nineteen tools across your structured data layer: advertising down to the creative, attribution, daily insights, media mix, product-level sales, cohort retention, lifecycle flows and campaigns, customer service down to the text of individual messages, TikTok Shop affiliate performance, plus the business context most tools miss — your marketing calendar, goals and goal breakdowns, and revenue no API reports, like wholesale.

Yes. Every analytics tool is a SELECT against your marts, and nothing in the connector you install can write to your data. API keys are stored as SHA-256 hashes, are scoped to you rather than to an organization, and the server checks your live organization memberships before it returns anything. Keys expire a year after they are issued and can be revoked instantly, calls are rate limited, and usage is written to an append-only audit log.

Do I need an API key from Anthropic or OpenAI?

No. You use your own Claude or ChatGPT subscription, and Modern issues the key that authorizes access to your data. There is nothing to configure on the model provider's side.

Which plan includes MCP access?

MCP access is part of AI Pro and AI Enterprise. Free Reporting covers dashboards and 12 months of history but does not include MCP.

How is this better than pointing AI at a raw database or a CSV export?

A raw connector hands the model unmodelled tables and hopes for the best. Modern resolves entities, reconciles channels, and carries the context that explains the numbers — your promo calendar, your goals, your costs, your off-platform revenue. The model spends its reasoning on your question instead of on cleaning your data.

What if my data lives somewhere Modern does not natively integrate?

Modern has 1,000+ available connections. Anything with a documented API can be connected and modelled into the same structured layer, so it reaches your AI client through the same tools as everything else — no bespoke connector to build and maintain.

Can I connect more than one brand?

Yes. Keys are scoped to you, not to a single organization, so one key reaches every organization you belong to and the client can compare them in a single answer. Agencies and portfolio operators use this to ask one question across a whole book of business.

MODERN MCP

All your company's data, inside the AI you already use.

Modern is the operating system for ecommerce businesses: sales, ads, lifecycle, marketplace, support, finance, and whatever else you run, held in one secure, structured layer. One connector URL opens that layer to your AI client, read-only. No exports. No context stuffing. No analyst acting as the API.

CONNECTOR URL https://mcp.modern.ai/mcp Generate your key →

Claude

ChatGPT Hermes OpenClaw …any client that speaks MCP over streamable HTTP

available connections, from native integrations to any documented API

read-only MCP tools on AI Pro and AI Enterprise

connector URL. No SDK, no warehouse, no pipeline

CONNECTION AT A GLANCE

Connector URLs to manage1

Read-only tools19

Rate limit, published60 / min

SDK or warehouse needednone

Available onAI Pro & Enterprise

01 // CONNECT

Three steps. Then ask it anything.

Modern issues the key. You keep your own Claude or ChatGPT subscription. There is nothing to configure on the model provider's side.

STEP 1

Generate a Modern API key

Open Account → API Keys in Modern and generate a key. The full key is shown once, so copy it before closing the dialog.

STEP 2

Add Modern as a connector

In your AI client, add a custom MCP connector pointing at https://mcp.modern.ai/mcp, passing your key as a Bearer token in the Authorization header or as an api_key query parameter.

STEP 3

Ask your first question

Start a chat and ask which organizations you have access to. The client calls get_org_info and you are connected.

CLAUDE · SETTINGS → CONNECTORS

Add a custom connector named Modern with this remote MCP server URL, your key in place of YOUR_API_KEY:

https://mcp.modern.ai/mcp?api_key=YOUR_API_KEY

HERMES / OPENCLAW · MCP SERVER CONFIG

Header auth preferred; the URL query form works in clients that cannot set headers:

{ "mcpServers": { "modern": { "url": "https://mcp.modern.ai/mcp", "headers": { "Authorization": "Bearer YOUR_API_KEY" } } } }

02 // SURFACE AREA

19 tools. Every one of them yours.

Not a generic SQL escape hatch. Each tool is a modelled surface with named metrics, filterable dimensions, and a description the model can reason about before it calls anything.

ORIENTATION · 2 TOOLS

get_org_info · the organizations, IDs, and slugs this key can reach. get_org_overview · connected integrations, feed freshness, trailing GMV, net sales, orders, spend, and MER.

ACQUISITION · 4 TOOLS

query_advertising, query_attribution, query_insights, query_media_mix · spend to creative, attribution models, daily performance, and media-mix rows built for halo and marginal-impact work.

REVENUE AND RETENTION · 6 TOOLS

query_sales_items, query_cohort, query_lifecycle_campaigns, query_lifecycle_flows, query_customer_service, query_customer_service_messages · SKU-level sales, monthly cohorts, lifecycle KPIs, and the actual text customers send.

TIKTOK SHOP AFFILIATE · 3 TOOLS

query_tiktok_affiliate_daily, query_tiktok_affiliate_creator, query_tiktok_affiliate_product · the affiliate program split by day, creator, and product.

BUSINESS CONTEXT · 4 TOOLS

query_calendar_events, query_goals, query_goal_breakdowns, query_additional_revenues · the layer a raw connector cannot reach: what you were doing, and what you were aiming at. The model stops calling a planned sale an anomaly.