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. Generate clients in TypeScript, Python, Go, or Ruby in one command.

API reference

Idempotent webhooks

Signed, retried, and replayable. Test webhooks locally with the Mercentia CLI before you ship.

Webhook guide

CLI & local dev

Spin up a sandbox store, mirror webhooks, scaffold apps, and deploy with a single command.

CLI docs

SDKs

Officially-supported SDKs in TypeScript, Python, and Ruby — type-safe, tree-shaken, and serverless-ready.

SDK guides

Workflows API

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

Workflows docs

MCP server

Expose your store to AI agents via the Model Context Protocol. Open source. Run it anywhere.

Read MCP docs

Agent commerce

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
Open source — 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

Build on a commerceplatform you can extend.