@semore/mcp-commerce

Reference Model Context Protocol (MCP) server surface for commerce — four tools that every agent-ready storefront should expose.

| Tool | Purpose | |------|---------| | search_products | Keyword / category / price search across a catalog | | build_cart | Compute total (subtotal + shipping + duty + tax) for a cart + destination | | create_order | Turn a priced cart into an order, returning a checkout URL | | get_policy | Fetch return / refund / shipping / privacy policy in requested language |

Source of Truth: this directory in the Semore monorepo until repo split. Production Semore MCP server lives at apps/api/src/routes/mcp.ts and is exposed at https://mcp.semore.net. This package ships the schemas + stub handlers so merchants can validate integrations locally before connecting to Semore.

Install

npm install @semore/mcp-commerce zod

Usage — schema-only

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

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

const result = await searchProductsTool.handler(parsed);

Usage — boot a minimal MCP server

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

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

// Then expose over your preferred transport (stdio, HTTP, SSE).

Directory listing

| Platform | Listing page | |----------|--------------| | Claude Desktop | mcp.semore.net manifest | | ChatGPT Apps | mcp.semore.net manifest | | Gemini Extensions | mcp.semore.net manifest |

Metadata is emitted by the production Semore server. This OSS package is the reference surface third-party merchants can fork to expose their own catalog under the same schema.

Reference

• MCP spec: https://modelcontextprotocol.io
• Semore production endpoint: https://mcp.semore.net
• Contact: [email protected] · GitHub @semore_hq

License

Apache-2.0 — see LICENSE.

Copyright (c) Semore Founding Team.