Skip to main content
Glama
deenesjakoruzh
semorehq

@semore/mcp-commerce

Official
by semorehq
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Hybrid

@semore/mcp-commerce

npm version license MCP Registry

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

Related MCP server: SlimWeb Client MCP

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.net Ed25519 mandate signing (4-party card model preserved)

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

Reference

License

Apache-2.0 — see LICENSE.

Copyright (c) Semore Founding Team.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessSyncing

Resources

Related MCP Connectors

Related MCP Servers