@semore/mcp-commerce

Reference Model Context Protocol (MCP) server for K-product cross-border commerce — five canonical tools that every agent-ready storefront should expose.

Canonical 5-tool surface per the Semore MCP commerce spec. Production Semore MCP server runs at https://mcp.semore.net. This OSS package ships schemas + reference handlers so merchants can validate integrations locally.

Install

npm install @semore/mcp-commerce zod

Use the published MCP server (Claude Desktop / ChatGPT / Gemini)

// Claude Desktop config — `claude_desktop_config.json`
{
  "mcpServers": {
    "semore": {
      "command": "npx",
      "args": ["-y", "@semore/mcp-commerce"]
    }
  }
}

Or discover via the official MCP Registry:

curl "https://registry.modelcontextprotocol.io/v0/servers?search=semore"
# → io.github.semorehq/mcp-commerce@0.4.2

Usage — schema-only (validate integrations)

import { searchProductTool } from "@semore/mcp-commerce/tools/search-product";

const parsed = searchProductTool.inputSchema.parse({
  q: "sunscreen",
  lang: "en",
  category: "kbeauty",
  limit: 10,
});

const result = await searchProductTool.handler(parsed);

Usage — boot a minimal MCP server

import { createMcpServer } from "@semore/mcp-commerce";

const server = createMcpServer({
  // Wire your own catalog / cart / order resolvers here.
  // Default skeleton resolvers return deterministic fixtures useful for local tests.
});

// Then expose over your preferred transport (stdio, streamable-http, SSE).

Companion adapters (5-protocol multi-adapter)

Compliance & trust

• PCI: SAQ-A (no PAN/CVV transit through the MCP server)

• PIPA §28-8: cross-border consent flow active

• AP2: did:web:semore.net Ed25519 mandate signing (4-party card model preserved)

• UCP: /ucp/capability endpoint advertises commerce.search/commerce.cart/commerce.checkout

Reference

• MCP spec: https://modelcontextprotocol.io

• Official MCP Registry: https://registry.modelcontextprotocol.io

• Semore production endpoint: https://mcp.semore.net

• Whitepaper (v0.1 in progress): https://semore.net/docs/whitepaper/v0.1

• Contact: semore.hq@gmail.com · GitHub @semorehq

License

Apache-2.0 — see LICENSE.

Copyright (c) Semore Founding Team.