> ## Documentation Index
> Fetch the complete documentation index at: https://docs.omnicommerce.ai/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](https://docs.omnicommerce.ai/quickstart.md) — overall developer surface
* [API reference](https://docs.omnicommerce.ai/api-reference.md) — REST endpoints for seller write paths
* Machine discovery: `https://omnicommerce.sg/api/mcp`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.