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

Auth Header

Authorization: Bearer omni_sk_...

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 ACO filters (platform, country, language, score, pagination).

omni_match_intent

POST /api/geo/match

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

omni_discover_geo

POST /api/geo/discover

Runs canonical semantic ACO discovery without catalog hydration.

omni_geo_feed

GET /api/geo/feed

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

omni_evaluate_sku

POST /api/v1/evaluate

Scores SKU readiness across agentic commerce engines and returns fix recommendations.

omni_sync_sku

POST /api/v1/sync

Updates commercial fields and queues marketplace sync workers.

omni_monitor_visibility

POST /api/v1/monitor

Queues AI Shelf Share monitoring and replay workflows.

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
    }
  }
}