API & MCP

One layer for custom integrations and AI

MitoOps normalises orders, products, stock, shipments, analytics and reports across all of your stores. The same layer is open to your program over a REST API, to AI applications over the open Model Context Protocol (MCP), and it notifies your systems of events through signed webhooks. Reading only with the permissions you choose yourself.

MitoOps connected to Claude over MCP and OAuth: orders, shipping, analytics and products according to the granted scopes

What can you read over API & MCP?

Everything MitoOps keeps normalised across your stores — and nothing that would expose credentials.

Orders

Orders for a period or just today, per store, with items and the delivery country. Totals only with the reports permission; the customer's name, e-mail and address only with the sensitive personal-data permission.

Products and categories

Search by name, code, EAN or PLU, a product detail with the list price, categories with product counts and each store’s availability list (such as In stock or Backorder).

Stock and movements

Stock level of one or several items including the source of the value, and the stock movement history: when, what, how many, why and from where.

Shipping

Shipments with carrier, country and handover and delivery times, a detail with tracking events and statistics: delivery rate, median and p90.

Analytics

Sessions, orders, revenue and conversion from GA4, channels including ChatGPT and AI sources, Search Console queries and order coverage.

Documents and reports

Invoices with lines and credit notes, a financial summary for a period, sales by product and performance per order. Totals always cover the whole period. Purchase prices and margins only with the sensitive permission.

Customers

A customer directory with shops, country, language, counts and revenue per currency; purchase activity for a period alongside lifetime figures. Name, company, e-mail and phone only with the sensitive personal-data permission, revenue and LTV only with the reports permission. Customer analytics stays in pseudonyms.

Suppliers and claims

Suppliers with offers and cost components; claims and returns linked to the order, credit note and return shipment.

The interface returns operational data only. Credentials for your store, carriers or analytics can never be read through it. Customers' personal data leaves only with an explicitly granted sensitive scope.

How it works

Normalise first, connect AI second

Neither AI nor your program gets database access. They ask a business layer that already understands stores, permissions and what the data means.

  1. Stores send data to MitoOps

    Orders, products and documents arrive live from the connected platforms over webhooks and sync.

  2. MitoOps normalises it

    One data model for all markets, stores and currencies, bound to the model of customer spaces, stores and permissions.

  3. You decide what may be read

    An access key or an OAuth consent carries scopes and a list of stores. Sensitive data is never granted by default.

  4. Your program or AI reads through one layer

    REST API for your code, MCP for an assistant. Both paths call the same capabilities and return the same business data.

REST API, MCP or webhooks?

They are not three products. REST and MCP are two ways to ask for the same data; webhooks are the way to learn about an event without asking.

REST API for your program

For a reporting tool, Power BI, your own script or a system that calls a server.

  • /api/v1 on your application domain
  • Access key in the Authorization header
  • Machine-readable OpenAPI description
  • Cursor pagination and from–to periods
  • Uniform error shape with a request identifier

MCP for AI applications

For AI applications that support remote MCP with OAuth — Claude.ai is the production-verified example.

  • /api/mcp on your application domain
  • OAuth 2.1 with PKCE — no keys to copy
  • The assistant sees only the tools its scopes allow
  • Summary tools: delivery statistics, financial summary, channels
  • Works with an access key too, for your own agent

Webhooks for your systems

For accounting, warehouse, CRM or an automation platform that needs to learn about an event right away.

  • New order, payment, status change, shipment, delivery, stock, invoice, claim
  • HMAC-SHA256 signature with timestamp and event ID
  • Thin envelope with identifiers — read the detail over the REST API
  • Delivery retries with increasing back-off and a log of attempts
  • Events and stores selected per endpoint

The MCP tool list is generated from the same catalogue as REST: whatever is in one is in the other. Webhooks carry events from the same business layer.

Claude.ai

How do you connect Claude.ai to MitoOps?

No key, no Client ID, no secret. Claude.ai discovers everything from the interface address and you decide on the consent screen.

  1. In Claude.ai open Settings → Connectors and add a custom connector.
  2. Paste the MCP address from Settings → API & MCP in MitoOps.
  3. Press Connect. Your MitoOps login opens, second factor included.
  4. On the consent screen choose what Claude may read and which stores it applies to.
  5. Allow. Claude returns to its page and the connector is connected.
  6. Ask a question about your stores.

An OAuth consent is not an access key: it does not take a slot in your plan’s key limit. A Start customer with one key connects Claude.ai without revoking it.

What you can ask

  • „What was the carrier split in August and what was each carrier’s median delivery time?“
  • „How many orders and how much revenue came from ChatGPT and other AI sources?“
  • „Which Search Console queries had the highest CTR?“
  • „What is the margin on product X over the last month?“
  • „Here is the carrier invoice — compare it with the shipments for that month.“
Security

Is MCP safe for an ecommerce business?

Safety does not come from the protocol but from how the server handles access, permissions and the tools it exposes. In MitoOps, six layers apply to every connector.

Reading and narrow writes

REST has no operation that changes anything. MCP writes only behind sensitive scopes you tick: a disabled automation draft (a person has to enable it) and a revision of a running automation (a person publishes it), a discount coupon with a preview and confirmation, affiliate programme management, deciding one named commission behind its own scope, never payouts, a proposed availability change, which a person writes to the store by approving it in the app, and proposed changes to claims settings, claims return shipping and product and category texts, which a person also has to approve unless you deliberately switch on autonomous writing for that area. Not a request to the model — a property of the server, enforced at three levels.

The person’s permissions

The consent screen offers only the scopes the signed-in person has. Whoever cannot see purchase prices cannot hand them to AI.

Tenant and store isolation

Every customer has its own space and database. Access covers only the ticked stores and a new store never joins on its own.

Scopes and sensitive data

60 scopes, 32 of them sensitive (reports, purchase prices, personal data, purchasing, automation drafts, coupons, affiliate programme management, customer conversations with the chatbot, availability, claims settings and return shipping change proposals, product and category text proposals); never pre-selected.

OAuth 2.1 and keys

PKCE, resource binding, one-time key reveal, rotation and instant revocation. Only a hash is stored, never the secret.

Audit and limits

Every call is logged with an identifier. Technical rate limits protect against key guessing and overload.

Which plan includes API & MCP?

From the Start plan. Plans differ by the number of active access keys, not by what you can read.

Plan API & MCP Active access keys
Free trial — —
Beginner — —
Start yes 1
Growth yes 2
Pro yes 5
Custom yes by agreement

Connecting an AI assistant over OAuth does not use a key. A downgrade never revokes existing keys; a new one can be created once a slot is free.

Frequently asked questions about API & MCP

What is an ecommerce MCP server?
MCP (Model Context Protocol) is an open standard that lets an AI application discover and call tools of another system. The ecommerce MCP server in MitoOps exposes business data — orders, products, stock, shipments, analytics and reports — as tools over a normalised layer that already joins several stores — 213 tools across 60 permission scopes today.
Do I need an API key for Claude.ai?
No. Claude.ai connects over OAuth: you give it the MCP address, sign in to MitoOps and choose scopes and stores on the consent screen. A key is only needed by your own program or an agent that calls the server.
Can AI change anything over MCP?
Not orders, documents, refunds, shipments or stock quantities: no tools exist for that. Writes concern fourteen things and all sit behind sensitive scopes that are never pre-selected on the consent screen: a disabled automation draft, which only a person in the app can enable, or a revision of a running automation, which only a person loads and publishes (the running version stays unchanged until then); a discount coupon from the parameters you give it — creation never overwrites an existing coupon, explicit update and deletion have a preview and confirmation, deletion also has its own scope, and a coupon with a live dependency is not deleted; likewise with a preview and confirmation it turns on or adjusts the box that shows the price after the code next to products on your website, and the discount rule for campaigns (the store’s maximum discount); and affiliate programme management — approving or suspending a partner account, portal texts and help articles, templates, campaigns, document policy and a partner’s store access; new legal wording arrives only as a draft you publish in the app. Deciding a commission has its own sensitive scope: the assistant may approve, reject or cancel one specific commission you name (rejection with a reason, a paid commission is never reverted); bulk approval and payouts stay in the app only. The fifth is a change to a store’s availability list, such as a new Preorder availability or different delivery hours: the assistant only proposes it with a preview, and a person with the right permissions writes it to the store by approving the proposal in the app. The sixth is a change to the claims settings, meaning processes, statuses, tags and e-mail or document templates: the assistant only proposes it with a preview, and a person with the right permissions writes it by approving it under Claims, Settings. The seventh is a claims return shipping route and the eighth product and category descriptions and SEO texts: the assistant only proposes them with a preview (it cannot change price, stock or code this way) and a person writes them by approving them; if you deliberately switch on autonomous writing for that area, they are written immediately on behalf of the person who granted access and only with their permissions. The ninth is the shop heart, the brand profile the AI tools write by: the assistant may read it and propose a change, which applies only after a person approves it in the AI centre; there is no autonomous writing for it. The tenth is a reply to a review: the assistant prepares a proposal in the store’s language and only a person allowed to reply publishes it under Warehouse, Reviews; autonomously, if you deliberately switch it on, only replies to 4 or 5 star reviews and at most 50 a day; with a preview and confirmation it also turns on the block of reviews from your other stores on the product page, writing nothing to the store. The eleventh is store category management and the product gallery: the assistant shows a preview (before and after), creates a category hidden, shows or hides it, schedules it from–to or deletes only an empty one, and in the gallery adds an image from an address, changes the order or main image or removes an image; it writes only after a person approves, and from outside only if you deliberately switch on Autonomous execution for this area. The twelfth is reports: the assistant writes manual costs (create, edit, retire), the report note and the export layout after a preview and approval, from outside only in Autonomous execution mode; it generates a report whose file is downloaded with a hash, and it does not change automatic advertising costs, orders or documents. The thirteenth is products: the assistant writes text and identity edits, prices, availability, the main category and visibility on the website with a from–to schedule, each behind its own sensitive scope, and creates a product that is always hidden, after a preview and approval, from outside only in Autonomous execution mode for that area; it does not change the stock quantity. The fourteenth is funnels in Analytics (for example a quiz on your website): the assistant creates, edits, pauses or archives a funnel after a preview and approval, from outside only in Autonomous execution mode for Funnels; it changes only the measurement settings in the application, not the store or GA4. The assistant also only proposes availability matching between stores, and only a person switches synchronisation on. The capability kernel, a closed catalogue and the adapters hold the line, and the REST API has no write at all. For each area you choose Manual approval (AI prepares a proposal that is written only after you approve it in the app) or Autonomous execution (AI runs the permitted change right away, on behalf of the person who granted access); every step is in the AI change log.
Will AI see purchase prices and margins?
Only if a person who has that right allows it explicitly: the scopes for reports and purchase prices are sensitive and not pre-selected on the consent screen. Without them, purchase price, gross profit and margin never appear in a response.
Does it work across several stores at once?
Yes. MitoOps is built for several stores, markets and currencies. One connection reads from every store you ticked at consent or when issuing the key.
From which plan is API & MCP available?
From the Start plan with one active access key. Growth has two, Pro five, Custom by agreement. The free trial and Beginner do not include the interface.
How does the REST API differ from MCP?
REST is called by your program, which decides what to read and when. With MCP, the AI model discovers and calls tools. Both paths sit on the same capabilities and return the same business data.
Does every AI model support MCP?
MCP has to be supported by the application the model runs in (the client), not by the model itself. MitoOps provides a standard remote MCP server with OAuth; Claude.ai is the production-verified client. Any other application that supports remote MCP with OAuth connects the same way.
What are outbound webhooks for?
So that your system learns about an event immediately, without polling: a new order, a payment, a status change, a created or delivered shipment, a stock movement, an invoice or a claim. You pick the events and stores per endpoint; failed deliveries are retried and every attempt is visible in the log.
What is the difference between the REST API, MCP and webhooks?
The REST API and MCP are reads on request: your program or AI application asks and gets an answer. A webhook goes the other way: MitoOps sends your system a short signed message that something happened, with identifiers. Your system then reads the detail over the REST API.
How are webhooks signed?
Every delivery carries an HMAC-SHA256 signature over the timestamp and body, plus the event ID and timestamp in headers. The endpoint secret is shown once and can be rotated at any time. The receiver verifies the signature with a constant-time comparison and rejects messages older than five minutes — the exact procedure and code samples are in the documentation.

Connect your systems and AI to your ecommerce data

Fourteen days free, no card required. Enable the interface under Settings → API & MCP.