@semore/mcp-commerce

@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: [e-mail] · GitHub @semore_hq

License

Apache-2.0 — see LICENSE.

Copyright (c) Semore Founding Team.