Seekmodo developer docs

Reference for the REST shim, MCP JSON-RPC surface, and storefront connectors. Authenticate with HMAC; replay window is 5 minutes.

Quick start

  1. Sign up and pick a plan at seekmodo.com/pricing.
  2. Pair your storefront with the connector for your platform — see the Connectors tab.
  3. Hit the gateway at https://mcp.seekmodo.com. Every authenticated request carries an HMAC envelope (see REST).

Surfaces

  • REST — drop-in compatibility shim. Same body shape as the underlying tools, just over plain JSON over HTTP.
  • MCP — JSON-RPC 2.0 at POST /. Implements tools/list and tools/call.
  • Sandbox — try requests live in your browser; we sign with a sample key server-side and stream the response.

Authentication

Send these four headers on every authenticated request:

  • X-Seekmodo-Tenant — your tenant id
  • X-Seekmodo-Timestamp — Unix timestamp (seconds)
  • X-Seekmodo-Nonce — random 16-byte hex string
  • X-Seekmodo-Signature — HMAC-SHA256 of <tenant>\n<timestamp>\n<nonce>\n<sha256(body)> using your shared secret.

See REST for the full request / response reference, rendered live from the OpenAPI 3.1 spec.