MCP server

OmniCommerce exposes a Model Context Protocol (MCP) server for agent hosts that speak JSON-RPC over HTTP.

Endpoint

Field	Value
Transport	HTTP JSON-RPC
Protocol version	`2025-06-18`
Endpoint	`https://omnicommerce.sg/api/mcp`
OAuth metadata	`https://omnicommerce.sg/.well-known/oauth-authorization-server`
OAuth token	`https://omnicommerce.sg/api/oauth/token`

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.	`content[]`, `structuredContent`, `isError?`
`resources/list`	Lists the versioned MCP Apps product-card UI resource.	`resources[]`
`resources/read`	Returns the product-card HTML resource (`text/html;profile=mcp-app`).	`contents[]`
`resources/templates/list`	Declared for MCP compatibility.	`resourceTemplates: []`
`prompts/list`	Declared for MCP compatibility. No prompts are published.	`prompts: []`

Tools

Public catalog discovery tools for tool-calling agents. Seller evaluate/sync/monitor stay on authenticated REST.

Tool	Wrapper	Description
`omni_search_catalog`	`searchPublicAgentProducts`	Searches catalog products with optional ACO filters and portable MCP Apps product cards when supported.
`omni_match_intent`	`discoverGeoProducts` + optional hydrate	Ranked ACO intent matching with optional catalog hydration and product cards.
`omni_discover_geo`	`discoverGeoProducts`	Canonical semantic ACO discovery without catalog hydration.

Examples

Initialize

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

Call a tool

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

Quickstart — overall developer surface
API reference — REST endpoints for seller write paths
Machine discovery: https://omnicommerce.sg/api/mcp

Get started

Guides

MCP

Endpoint

Methods

Tools

Examples

Initialize

Call a tool

​Endpoint

​Methods

​Tools

​Examples

​Initialize

​Call a tool

​Related

Endpoint

Methods

Tools

Examples

Initialize

Call a tool

Related