Get started
Developer platform

Build on a commerce
platform you can extend.

Mercentia is API-first from the data model up. Typed REST endpoints with RLS-enforced tenant isolation, idempotency on every mutating call, signed webhooks with at-least-once delivery, an MCP server that ships agentic checkout out of the box — and per-tool rate limits that fail loudly rather than silently.

Read the docs App marketplace
create-product.tswebhook-handler.tsmcp-tool.ts
"hl-k">import { Mercentia } "hl-k">from '@mercentia/sdk'

"hl-k">const sf = "hl-k">new Mercentia({ apiKey: "hl-k">process.env.SF_KEY })

"hl-k">const product = "hl-k">await sf.products.create({
  title: 'Single-origin · Ethiopia Yirgacheffe',
  vendor: 'Ember Roastery',
  variants: [
    { sku: 'EMB-ETH-12OZ', price: 22.00, weight: 0.34 },
    { sku: 'EMB-ETH-2LB',  price: 60.00, weight: 0.91 },
  ],
  tags: ['single-origin', 'light-roast'],
})

"hl-k">console.log(product.id) "hl-c">// "prd_2WJ..."

Typed REST + GraphQL

Every endpoint typed end-to-end, idempotent on writes, RLS-isolated per tenant. TypeScript client today (Python, Go & Ruby planned). GraphQL is in beta.

API reference

Idempotent webhooks

Signed (HMAC), retried with backoff, dead-lettered on terminal failure, and replayable. Test them locally with the Mercentia CLI before you ship.

Webhook guide

CLI & local dev

Sign in, switch stores, pull and push themes with live reload, and scaffold apps — all from `npm i -g @mercentia/cli`.

CLI docs

TypeScript SDK

A type-safe, tree-shaken storefront SDK with React bindings — serverless-ready. Python and Ruby SDKs are on the roadmap.

SDK guides

Workflows API Coming soon

Trigger workflows from your code, run agent steps with shared memory, observe every run.

Workflows docs

MCP server Beta

Expose your store to AI agents via the Model Context Protocol. Self-hostable. Run it anywhere.

Read MCP docs
Agent commerce Beta

An MCP server that turns your store into an AI tool.

The Mercentia MCP server lets Claude, ChatGPT, and any MCP-compatible agent search products, place orders, and run workflows on your behalf — securely scoped to your workspace.

  • Tool-use compatible with Claude, OpenAI, and Anthropic Agent SDK
  • Typed inputs and outputs for every commerce primitive
  • Per-agent permissions with audit logs
  • Self-hostable — run it on your own infrastructure
mercentia-mcp 4 tools available
products.searchSearch products by name, SKU, tag, or vendor.
orders.createPlace a new order on behalf of a customer.
customers.readFetch a customer profile, order history, LTV.
workflows.runTrigger a saved workflow with structured inputs.
App marketplace Coming soon

Build apps for Mercentia merchants.

We're opening the marketplace to developers soon. Build, list, and monetize apps while Mercentia handles billing, security review, and distribution — you focus on the product.

Built-in billing
We bill merchants and pay you out — no payments code.
Security review
Every app vetted before listing, so installs are trusted.
Developer-first revenue share
Pricing built to reward builders. Final terms at launch.
Instant distribution
List once, reach every Mercentia merchant.
Join the developer waitlist Get notified at launch
Ready when you are

Start with a free workspace.
Scale it however you need.

Connect your existing Shopify, BigCommerce, Magento, Wix, or WooCommerce store in one click. We'll bring your catalog, customers, and order history across — and your URLs keep working via auto-generated 301s.

Start 14-day free trial See pricing