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 →Connect in 2 minutes
WORKS IN
ModernYOUR DATA LAYERClaudeCONNECTOR URLChatGPTCONNECTOR URLHermesMCP CONFIG + HEADEROpenClawMCP CONFIG + HEADER
Claude
Claude
ChatGPT
ChatGPT
Hermes
OpenClaw

…and any other client that speaks MCP over streamable HTTP.

1,000+
available connections, from native integrations to any documented API
19
read-only MCP tools on AI Pro and AI Enterprise
1
connector URL — no SDK, no warehouse, no pipeline
ANY MCP CLIENTMODERN CONNECTED
›

get_org_overview…
query_insights
query_advertising
query_calendar_events
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.

  1. 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.

  2. 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 either as a Bearer token in the Authorization header or as an api_key query parameter.

  3. 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.

THE EXACT CLICKS, PER CLIENT
Settings → Connectors → Add custom connector
  1. 1

    Generate an API key

    In Modern, open Account → API Keys and generate a key. It is shown once — copy it before you close the dialog. You can hold 3 active keys at a time and revoke any of them instantly.

  2. 2

    Add the connector

    In Claude, go to Settings → Connectors → Add custom connector. Name it Modern and paste this as the remote MCP server URL, with your key in place of YOUR_API_KEY.

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

    Ask it something

    Start a new chat and ask what organizations you have access to. Claude calls get_org_info, and you are connected.

    Which organizations do I have access to in Modern?
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

What the client calls first, so it never guesses at your business.

2 TOOLS
get_org_info

The organizations, IDs, and slugs this key can reach. Every other call is validated against this set.

get_org_overview

Which integrations are connected, how fresh each feed is, and trailing 12-month and 30-day GMV, net sales, orders, spend, and MER.

Acquisition

Spend, channels, and what the spend actually bought.

4 TOOLS
query_advertising

Ad performance from account down to creative — spend, impressions, clicks, conversions, platform-reported sales.

query_attribution

New customers, orders, and sales by attribution model and sales channel.

query_insights

Daily business performance — sales, customers, and ad metrics by platform and channel.

query_media_mix

One row per day with every channel as a column. Built for media-mix modeling, halo, and marginal-impact work.

Revenue and retention

Where the money comes from, and whether it comes back.

6 TOOLS
query_sales_items

Product-level sales — quantity, orders, revenue, and customer counts by product, variant, and SKU.

query_cohort

Monthly cohort retention — customer counts, retention rates, and revenue by cohort month and month index.

query_lifecycle_campaigns

Campaign sends with lifetime KPIs — recipients, delivery, opens, clicks, conversions.

query_lifecycle_flows

Automated flow performance as a daily timeseries per flow.

query_customer_service

Ticket volume, response and resolution times, and CSAT by day.

query_customer_service_messages

Message-level customer service data from Gorgias — the actual message text, subject, and sender, so you can read what customers are saying rather than only counting tickets.

TikTok Shop affiliate

The affiliate program, split three ways.

3 TOOLS
query_tiktok_affiliate_daily

Program-wide daily totals — GMV and estimated commission across creators, partners, and Shop Ads.

query_tiktok_affiliate_creator

Per-creator performance. Rank by attributed GMV or track one creator over time.

query_tiktok_affiliate_product

Per-product affiliate performance, with brand and category dimensions.

Business context

The layer a raw connector cannot reach — what you were doing, and what you were aiming at.

4 TOOLS
query_calendar_events

Promos, launches, price changes, and product drops overlapping a date range, with expected impact.

query_goals

Monthly goals by metric — CAC, net sales, spend.

query_goal_breakdowns

How each goal splits across platforms, so a miss can be traced to a channel.

query_additional_revenues

Wholesale, retail, and other revenue no API reports, with fees and notes.

03  //  THE DIFFERENCE

A raw connector hands the model your tables. Modern hands it the story.

Point an agent at a warehouse and it burns its reasoning on joins, duplicate channel names, and guessing why a week looks strange. Modern resolves all of that first, then adds the context no API returns.

Marketing calendar

Promos, launches, price changes, and product drops with expected impact. The model stops calling a planned sale an anomaly.

query_calendar_events

Goals, and their breakdowns

What the business is chasing this month and how it splits by platform, so a miss traces to a channel instead of a shrug.

query_goal_breakdowns

Revenue the APIs miss

Wholesale, retail, and everything off-platform, with fees. Blended math that matches the bank, not just Shopify.

query_additional_revenues

Integration truth

Which feeds are connected and how fresh each one is — checked before the answer, so nothing gets invented about a channel you do not run. 1,000+ available connections, from native integrations to any documented API.

get_org_overview
04  //  PROMPTS

Steal these.

Each one shows the tools your client reaches for. Copy it, or open it straight in Claude.

DIAGNOSIS

Why did blended ROAS drop last week?

get_org_overviewquery_insightsquery_advertisingquery_calendar_events
PRODUCT

Which SKUs are driving net sales growth, and which are quietly declining?

get_org_overviewquery_sales_items
FORECAST

Are we going to hit this month's net sales goal?

query_goalsquery_goal_breakdownsquery_insights
RETENTION

Which acquisition channel produces customers who actually come back?

query_attributionquery_cohort
TIKTOK SHOP

Rank our TikTok affiliate creators by GMV this quarter.

get_org_overviewquery_tiktok_affiliate_creator
MODELING

Build me a media-mix dataset for the last 18 months.

query_media_mix
PROMO

Did the spring promo actually pay for itself?

query_calendar_eventsquery_insightsquery_advertising
FINANCE

Where is my real revenue, including wholesale?

query_insightsquery_additional_revenues
LIFECYCLE

Which flows are worth keeping and which are dead weight?

query_lifecycle_flowsquery_lifecycle_campaigns
05  //  ACCESS CONTROL

An agent with a key still cannot reach what you did not give it.

Putting your whole business in one layer only works if that layer is held properly. Storage is ours to get right; access is yours to control.

Read-only against your data

Every analytics tool is a SELECT against your marts. Nothing in the connector you install can write to your data.

Scoped on every single call

Keys resolve to a person, not an organization. The server resolves that person's live memberships and rejects any organization ID outside them, so a key cannot reach a brand you were never added to.

Hashed, capped, revocable

Keys are stored as SHA-256 hashes and shown to you exactly once. Hold up to 3 at a time, revoke any of them the moment a laptop goes missing, and every key expires a year after it is issued.

Rate limited and logged

Per-key burst limits stop runaway agents, and every call is written to an append-only usage log.

06  //  QUESTIONS, ANSWERED

Got any questions left?

What is Modern MCP?

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.

Is my data safe?

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.

Two minutes from here to an AI that knows your business.

Generate a key, paste one URL, and ask the question you have been waiting on a report for.

Generate your key →See plans