Summary
A reference implementation of the five canonical commerce tools Semore believes every agent-ready storefront should expose: product search across K-beauty, fashion, and pop categories; single SKU detail lookups with HS codes and lead times; cart creation with destination-aware quotes that break out shipping, duty, and import tax; pre-checkout requotes that return a signed CartMandate verifiable credential; and AP2 IntentMandate submission that hands back a checkout URL plus PaymentMandate. Ships as both a working MCP server you can npx straight into Claude Desktop and a schema-only package for validating your own integration against the spec. Semore runs the production version at mcp.semore.net and provides companion adapters for ACP, AP2, and UCP protocols.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
@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
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)
| 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.netEd25519 mandate signing (4-party card model preserved) - UCP:
/ucp/capabilityendpoint advertisescommerce.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.
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →Categories
Registryactive
Package@semore/mcp-commerce
TransportSTDIO
UpdatedApr 28, 2026
