Seekmodo developer docs
Reference for the REST shim, MCP JSON-RPC surface, and storefront connectors. Authenticate with HMAC; replay window is 5 minutes.
Model Context Protocol (MCP)
The gateway speaks JSON-RPC 2.0 at POST https://mcp.seekmodo.com/. Send tools/list to discover what your tenant can call, and tools/call to invoke a tool. Same HMAC headers as the REST shim.
POST / HTTP/1.1
Host: mcp.seekmodo.com
Content-Type: application/json
X-Seekmodo-Tenant: ten_...
X-Seekmodo-Timestamp: 1717000000
X-Seekmodo-Nonce: 9f3a...
X-Seekmodo-Signature: ...
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/list",
"params": {}
}Live tool catalog (refreshed every 5 minutes from /v1/tools/public; last refreshed 2026-05-27T02:25:01.921Z):
| Tool | Description | Mutates | Available |
|---|---|---|---|
| search | Full-text + vector search. | no | live |
| index | Upsert documents into the catalog. | yes | live |
| events | Submit click/impression/order events. | yes | live |
| tenant.handshake | Verify tenant + plan + vertical. | no | live |
| synonyms.list | Per-tenant synonym list (M5). | no | deferred |
| synonyms.add | Add a synonym pair (M5). | yes | deferred |
| synonyms.remove | Remove a synonym pair (M5). | yes | deferred |
| pins.list | Editorial pins (M5). | no | deferred |
| pins.set | Pin a doc for a query (M5). | yes | deferred |
| ab.list | List active A/B experiments (M6). | no | deferred |
| ab.create | Create an A/B experiment (M6). | yes | deferred |
| ab.promote | Promote a winning variant (M6). | yes | deferred |
| analytics.summary | Per-tenant analytics rollup (M5). | no | deferred |
| ltr.toggle | Toggle LTR mode (M7). | yes | deferred |
| bot_check.status | Per-tenant bot-check status (M5). | no | deferred |
| commerce.promotions.list | List active commerce promotions (M5). | no | deferred |
| commerce.boost_by_stock | Boost in-stock SKUs (M5). | yes | deferred |
| commerce.exclude_out_of_stock | Exclude OOS SKUs (M5). | yes | deferred |