> ## Documentation Index
> Fetch the complete documentation index at: https://docs.omnicommerce.sg/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP server

> OmniCommerce Model Context Protocol server: transport, JSON-RPC methods, and tool contracts.

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

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

### Call a tool

```json theme={null}
{
  "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
    }
  }
}
```

## Related

* [Quickstart](/quickstart) — overall developer surface
* [API reference](/api-reference) — REST endpoints for seller write paths
* Machine discovery: `https://omnicommerce.sg/api/mcp`