io.github.semorehq/mcp-commerce

Official

by semorehq · TypeScript

Semore K-Commerce

Semore K-product MCP server: search K-beauty/fashion/pop, cross-border carts, AP2-signed checkout.

Search K-beauty and fashion products with cross-border cart and checkout functionality.

README.md4 KBView on GitHub

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

#	Tool	Purpose
1	`search_product`	Keyword / category / price / locale search across the K-product catalog
2	`get_product`	Fetch a single SKU's full detail (i18n title/description, HS code, ship-from, lead time)
3	`create_cart`	Build cart with destination — returns itemized quote (subtotal + shipping + duty + import tax)
4	`quote_checkout`	Re-quote cart immediately before checkout (refresh FX/duty), returns canonical CartMandate VC
5	`submit_intent`	Submit AP2 IntentMandate VC + signed CartMandate, returns checkout URL + signed PaymentMandate

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

bash

npm install @semore/mcp-commerce zod

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

jsonc

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

Or discover via the official MCP Registry:

bash

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)

Adapter	Spec	Status
@semore/acp-adapter	ACP (Stripe / PayPal)	LIVE
@semore/ap2-adapter	AP2 (Google) — IntentMandate / CartMandate / PaymentMandate VC	LIVE
@semore/ucp-adapter	UCP (Google + Shopify)	LIVE
Visa TAP / MC Agent Pay	Network agentic standards	Phase 1 (signup)

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.

Install

claude_desktop_config.json

{
  "mcpServers": {
    "mcp-commerce": {
      "command": "npx",
      "args": [
        "-y",
        "@semore/mcp-commerce@0.4.2"
      ]
    }
  }
}