MCP / JSON-RPC 2.0 — v0.1.0-draft

Agentic infrastructure,
addressable over JSON-RPC.

samurai/mcp is an open catalog of Model Context Protocol servers backed by a multi-layer outcome substrate. Deterministic caches, cross-model consensus, causal memory. Discovered via tools/list. Billed per call.

read the spec documentation source

§1

Why a protocol, not a SaaS

Agent stacks already speak MCP. A SaaS forces a custom SDK, a custom auth flow, a custom dashboard. We offer none of those, on purpose.

┌──────────────┬─────────────────────────────────┐ │ aspect │ samurai/mcp │ ├──────────────┼─────────────────────────────────┤ │ discovery │ MCP tools/list │ │ transport │ HTTP, JSON-RPC 2.0 │ │ auth │ Bearer token (HTTP header) │ │ billing │ per-call, metered on response │ │ failure │ stateless 5xx → client retries │ │ lock-in │ none — swap the endpoint │ └──────────────┴─────────────────────────────────┘

# Any MCP-compliant client. No SDK required.
curl https://mcp.mi-kernel2026.xyz/v1 \
  -H "Authorization: Bearer $SAMURAI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,
       "method":"tools/list"}'

§2

Live substrate

Counters pulled from the engine's stigmergy layer. If the engine is unreachable from your browser the cells stay blank — we don't make numbers up.

—

atlas events

—

outcome deposits

—

L5 cycles (24h)

—

substrate layers

§3

Tool catalog

Three servers, small composable tool surfaces. Each manifest is fetched from the server itself; this table mirrors what tools/list returns today.

┌──────────────────────────┬─────────┬──────────┬───────────────────────────────────────────────┐ │ tool │ price │ p50 │ summary │ ├──────────────────────────┼─────────┼──────────┼───────────────────────────────────────────────┤ │ cache.get │ 0.01¢ │ <5 ms │ Content-addressed LLM response replay. │ │ cache.put │ 0.01¢ │ <3 ms │ Store completion with TTL (1s – 1y). │ │ cache.stats │ free │ <10 ms │ Window hit rate, savings, top keys. │ ├──────────────────────────┼─────────┼──────────┼───────────────────────────────────────────────┤ │ consensus.gate │ 0.40¢ │ ~800 ms │ k-of-n agreement across models. (q3 2026) │ │ memory.lookup │ 0.05¢ │ ~40 ms │ Top-K exemplars from outcome atlas. (q3 2026) │ └──────────────────────────┴─────────┴──────────┴───────────────────────────────────────────────┘

§4

A complete call

JSON-RPC 2.0 over HTTP POST. Cache lookup against cache.get. Pricing is one-tenth of a cent per call, deducted on the response that names hit: true.

curl -sS https://mcp.mi-kernel2026.xyz/v1 \
  -H "Authorization: Bearer $SAMURAI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 42,
    "method": "cache.get",
    "params": {
      "prompt_hash": "a3f1bc09d4e2",
      "model": "claude-sonnet-4-7"
    }
  }'

# → 200 OK
{
  "jsonrpc": "2.0",
  "id": 42,
  "result": {
    "hit": true,
    "value": "…cached response body…",
    "ttl_s": 2871,
    "cost_saved_usd": 0.012
  }
}

§5

Signals

What we publish so you don't have to take our word for it.

spec/ /spec docs/ /docs status /health manifests github.com/samurai-substrate license MIT

protocol: MCP 2024-11-05 transport: JSON-RPC 2.0 auth: Bearer license: MIT