metrecept-mcp

Slim MCP server for Metrecept: prompt cache replay, multi-provider model routing (BYOK), and compliant public-web fetch as Cursor tools — without installing the full gateway stack. Runs over stdio (default) or as a stateless remote streamable-HTTP server.

Install

pip install metrecept-mcp

Then run metrecept-mcp (ohm-mcp is the same binary, kept as an alias). ohm-mcp on PyPI is an unrelated third-party package — do not pip install ohm-mcp.

No local install: attach the hosted server at https://api.metrecept.co.uk/mcp with Authorization: Bearer sk-at-….

From this repo instead of PyPI:

pip install "git+https://github.com/iwasinnam2/metrecept-opensource.git#subdirectory=packages/ohm-mcp"

Cursor attach (stdio)

{
  "mcpServers": {
    "metrecept": {
      "command": "metrecept-mcp",
      "env": {
        "OHM_API_KEY": "sk-at-YOUR_ISSUED_KEY",
        "OHM_UPSTREAM_KEY": "sk-proj-optional-byok-key",
        "OHM_BASE_URL": "https://api.metrecept.co.uk/v1"
      }
    }
  }
}

Hosted streamable HTTP (no local install): https://api.metrecept.co.uk/mcp with Authorization: Bearer sk-at-…. Stdio remains the metrecept.co.uk/i one-click default.

Get a key from the $0 Intermediate seat at metrecept.co.uk/billing/intermediate.

Tools

• ohm_chat — chat through the pipe; identical prompts replay from Redis cache.
• ohm_fetch_web — compliant public URL fetch (robots-gated, PII-redacted, metered).
• ohm_usage — usage snapshot: cache hit ratio, fetches, estimated pipe rent.
• ohm_models — model ids the pipe routes to, including BYOK upstreams.
• ohm_cache_trees — list the tenant's cache-tree inventory (named exact-replay namespaces).
• ohm_cache_inventory — list cached entries in a tree: digest, model, TTL, size (metadata only).
• ohm_savings — cache savings snapshot: replayed prompts, estimated spend avoided.
• ohm_receipt — mint a public savings receipt (/r/…) from the savings snapshot.
• ohm_providers — upstream provider and failover status.
• ohm_policy — compliance policy: allowed web-fetch purposes and limits.
• ohm_register_api_service / ohm_api_services / ohm_api_call — audit-mode GET to registered business APIs.
• ohm_session — signed flight-recorder for one tagged session.

metrecept_* and metre_* names alias the same handlers.

Remote (stateless streamable HTTP)

OHM_MCP_TRANSPORT=http metrecept-mcp   # or: metrecept-mcp-http — serves POST /mcp on :8091

Production hosted endpoint: https://api.metrecept.co.uk/mcp.

Auth is per-request: clients send Authorization: Bearer sk-at-* (and optional X-Ohm-Upstream-Key) on the MCP HTTP request; OHM_API_KEY env is the stdio/local fallback.

Env

MIT licensed. The hosted service is commercial — see Pricing and Terms.

Note for maintainers: src/ohm_mcp/__init__.py in the monorepo root is the source of truth; run scripts/sync_ohm_mcp.ps1 before building this package.