MCP Reference

OmniCommerce MCP Documentation

JSON-RPC contract for agent frameworks using the OmniCommerce Model Context Protocol server.

Endpoint

https://omnicommerce.sg/api/mcp

Transport

http-jsonrpc

Protocol Version

2025-06-18

OAuth Metadata

https://omnicommerce.sg/.well-known/oauth-authorization-server

JSON-RPC Methods

Method	Description	Returns
initialize	Negotiates protocol capabilities and returns server metadata, tool capability, and instructions.	protocolVersion, capabilities, serverInfo, instructions
ping	Health-style keepalive to verify MCP responsiveness.	empty JSON-RPC result
tools/list	Returns all callable OmniCommerce MCP tools.	tools[]
tools/call	Invokes a single tool with validated arguments and returns text + structuredContent payloads.	content[], structuredContent, isError?
resources/list	Declared for MCP compatibility. No resources are published.	resources: []
prompts/list	Declared for MCP compatibility. No prompts are published.	prompts: []

Tool Catalog

omni_search_catalog

GET /api/catalog

Searches catalog products with optional GEO filters (platform, country, language, score, pagination).

omni_match_intent

POST /api/geo/match

Runs ranked GEO intent matching with optional catalog hydration in each match.

omni_discover_geo

POST /api/geo/discover

Runs canonical semantic GEO discovery without catalog hydration.

omni_geo_feed

GET /api/geo/feed

Lists GEO-enriched catalog feed entries for marketplace-aware retrieval.

Initialize Example

Send once when your MCP client starts a new session.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2025-06-18",
    "capabilities": {},
    "clientInfo": {
      "name": "example-agent",
      "version": "1.0.0"
    }
  }
}

Tool Call Example

Example request for catalog search through MCP tools/call.

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "omni_search_catalog",
    "arguments": {
      "query": "lightweight laptop for travel",
      "platform": "lazada",
      "country": "sg",
      "language": "en",
      "limit": 5
    }
  }
}