EVIDIQ Signet MCP

flowchart TB
    agent["<b>AI agent / buyer</b><br/>MCP client"]
    request{"Tool call<br/>free or paid?"}
    agent -->|POST /signet/mcp| request

    free["Free preflight<br/>capabilities · estimate · preview<br/>verify_asset · check_font_license"]
    gate["x402 v2 gate<br/>EIP-3009 exact · pay per artefact"]
    xlayer[("X Layer<br/>USD₮0 · eip155:196")]
    request -->|free helper| free
    request -->|paid artefact| gate
    gate -. verify and settle .-> xlayer

    subgraph signet["EVIDIQ Signet trust boundary"]
        direction TB
        seed["1. Seed<br/>sha256(brand | mood | caller seed)"]
        palette["2. Palette (colour transforms)<br/>type pairing (curated + licenced)"]
        svg["3. SVG templates<br/>parameterised, no runtime randomness"]
        tokens["4. Tokens / CSS / manifest<br/>all derived from the same seed"]
        receipt["5. Receipt<br/>JCS digest · EIP-191 · revision chain"]
        seed --> palette
        seed --> svg
        palette --> tokens
        svg --> tokens
        tokens --> receipt
    end

    og[("0G Storage<br/>the WHOLE artefact · root hash<br/>chain 16661")]
    free --> seed
    gate --> seed
    receipt -. full artefact upload .-> og
    og -. root + tx .-> response

    response["<b>MCP response</b><br/>SVG + palette + tokens + manifest<br/>receiptId + digest + signature + anchor"]

    classDef client fill:#312e81,stroke:#a78bfa,color:#ffffff,stroke-width:2px;
    classDef payment fill:#052e16,stroke:#4ade80,color:#ffffff,stroke-width:2px;
    classDef core fill:#0f172a,stroke:#38bdf8,color:#ffffff,stroke-width:2px;
    classDef output fill:#4c1d95,stroke:#c4b5fd,color:#ffffff,stroke-width:2px;
    class agent,request client;
    class free,gate,xlayer,og payment;
    class seed,palette,svg,tokens,receipt core;
    class response output;
    style signet fill:#0f172a,stroke:#38bdf8,color:#e0f2fe,stroke-width:2px;

npm test (vitest)               → 20 passed / 20 (3 files), tsc clean
  test/determinism.test.ts  ( 4)  → byte-identical across two processes
  test/no-model.test.ts     ( 2)  → provider grep returns nothing; no fetch in generation
  test/server.test.ts      (14)  → all 10 tools, free bare {} → 200, mood vocabulary
                                    published, unrecognised mood answered plainly, each
                                    artefact valid on its own terms (SVG parses, CSS vars
                                    well-formed, token JSON has its schema), verify_asset
                                    detects a dropped revision, receipts signed + anchored

Free Tools (HTTP 200)
  signet_capabilities {}        → 200 ✓ (10 moods, 4 template families, no-model contract)
  preview_tokens (Northwind…)   → 200 ✓ (seed 06aeddfa…, primary #22AAC3 — same as paid)
  check_font_license (Inter)    → 200 ✓ (commercialPermitted true, SIL OFL 1.1, source)
  verify_asset (signet-4)       → 200 ✓ (digestMatch + signatureValid + anchored, chainOk)
Paid Tools (200 here because the bypass was on)
  palette_tokens                → 200 ✓ (receipt signet-7, primary #22AAC3, anchored)
  logo_svg                      → 200 ✓ (receipt signet-8, monogram "NL", SVG begins <svg)
  social_kit                    → 200 ✓ (receipt signet-9, favicon+avatar+OG, anchored)
  kit_revision                  → 200 ✓ (receipt signet-11, diff tech→luxury, chained)
  brand_kit                     → 200 ✓ (receipt signet-12, 6-font manifest, whole kit on 0G)
Public route                    → /signet/health 200 · /signet/skill.md 200 · /signet/mcp 200 ✓

empty POST (with content-type)                     → (measure)
POST without content-type                          → (measure)
HEAD /mcp                                          → (measure)
all 5 paid tools, bare {}                          → (measure)
all 5 free tools, bare {}                          → (measure)
onchainos payment quote --tool <name>              → (measure)
OKX.AI registration                                → (operator)

# Read the public Skill document
curl -s https://mcp.evidiq.dev/signet/skill.md

# Inspect current x402 pricing discovery
curl -s https://mcp.evidiq.dev/signet/x402

# Try the free preview — the hook
curl -s -X POST https://mcp.evidiq.dev/signet/mcp -H "content-type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"preview_tokens","arguments":{"brandName":"Northwind Labs","mood":"tech"}}}'

# Connect remote MCP server (OpenClaw)
openclaw mcp add evidiq-signet --transport streamable-http --url https://mcp.evidiq.dev/signet/mcp

# Connect remote MCP server (Claude Code)
claude mcp add --transport http evidiq-signet https://mcp.evidiq.dev/signet/mcp

# FREE — signet_capabilities (bare {})
curl -s -X POST https://mcp.evidiq.dev/signet/mcp -H "content-type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"signet_capabilities","arguments":{}}}'

# FREE — estimate_cost
curl -s -X POST https://mcp.evidiq.dev/signet/mcp -H "content-type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"estimate_cost","arguments":{"tool":"brand_kit"}}}'

# FREE — preview_tokens (the hook; same generator as the paid tools)
curl -s -X POST https://mcp.evidiq.dev/signet/mcp -H "content-type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"preview_tokens","arguments":{"brandName":"Northwind Labs","mood":"tech","seed":"demo-1"}}}'

# FREE — check_font_license (bare {} lists the whole sourced table)
curl -s -X POST https://mcp.evidiq.dev/signet/mcp -H "content-type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"check_font_license","arguments":{"font":"Inter"}}}'

# FREE — verify_asset (receipt id from any paid call)
curl -s -X POST https://mcp.evidiq.dev/signet/mcp -H "content-type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"verify_asset","arguments":{"receiptId":"signet-0"}}}'

# PAID — palette_tokens
curl -s -X POST https://mcp.evidiq.dev/signet/mcp -H "content-type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"palette_tokens","arguments":{"brandName":"Northwind Labs","mood":"tech","seed":"demo-1"}}}'

# PAID — logo_svg
curl -s -X POST https://mcp.evidiq.dev/signet/mcp -H "content-type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"logo_svg","arguments":{"brandName":"Northwind Labs","mood":"tech","seed":"demo-1"}}}'

# PAID — social_kit
curl -s -X POST https://mcp.evidiq.dev/signet/mcp -H "content-type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"social_kit","arguments":{"brandName":"Northwind Labs","mood":"tech","seed":"demo-1"}}}'

# PAID — kit_revision (revise a kit by its receipt id)
curl -s -X POST https://mcp.evidiq.dev/signet/mcp -H "content-type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"kit_revision","arguments":{"receiptId":"signet-0","brandName":"Northwind Labs","mood":"luxury"}}}'

# PAID — brand_kit (the full bundle; whole kit uploaded to 0G)
curl -s -X POST https://mcp.evidiq.dev/signet/mcp -H "content-type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"brand_kit","arguments":{"brandName":"Northwind Labs","mood":"tech","seed":"demo-1"}}}'

docker build -t evidiq-signet:latest .
docker run -d --env-file .env -p 3023:3023 evidiq-signet:latest
# Endpoint: http://localhost:3023/mcp
# Receipts + revision chain: SIGNET_DB_PATH (mounted volume).

import { SignetClient } from "./sdk/index.js";

const client = new SignetClient(); // endpoint defaults to https://mcp.evidiq.dev/signet/mcp

// free
const caps = await client.callTool("signet_capabilities", {});

// paid — settle the 402 challenge via the constructor's pay hook, or omit it
// to receive a PaymentRequiredError carrying the full x402 v2 challenge
const result = await client.callTool("some_paid_tool", { arg: "value" });