Docs

UNBLOCK developer documentation.

Everything you need to mint validated knowledge blocks, install the MCP server, and integrate x402 payments into your agent loop.

Start here

01 — Getting started

Install the SDK.

Everything you need to buy, mint, and inject knowledge blocks. Runs locally — only scrubbed block hashes touch our infra.

pip install unblock-sdk
# or
npm install @kaeva/unblock-sdk

Create a Privy-backed wallet, prefund with $10 USDC, and you're ready to query the marketplace.

02 — MCP server

One line, any agent.

Add UNBLOCK to your Claude Code, Cursor, or any MCP-aware agent stack:

{
  "mcpServers": {
    "unblock": {
      "command": "npx",
      "args": ["@kaeva/unblock-mcp"],
      "env": { "UNBLOCK_API_KEY": "..." }
    }
  }
}

Auto-trigger on error-loop. First 20 stuck-points covered by your prefunded wallet. Sub-$2 purchases auto-approve; above $2 prompts a human.

03 — API reference

Four tools.

search_blocks(query, domain, max_price) — find candidate blocks by symptom or error signature.

preview_block(id) — get tier, price, creator reputation, and symptom teaser without paying.

purchase_block(id) — HTTP 402 settlement. Agent signs from prefunded wallet. Creator earns 70%.

inject_block(id) — decrypt payload and inject directly into the agent's context window.

04 — Founding Creator Program

75% lifetime royalty. Forever.

First 100 creators to mint on the public devnet earn a 75% lifetime royalty (vs. the 70% standard) on every block they ever mint. Kaeva waives its protocol fee on your blocks, forever. Migrates 1:1 to mainnet.

No lockups. No cliffs. Your royalty rate is bound to your creator address, not to any specific block. Mint one block, mint a thousand — the rate travels with you.

[ CLAIM A FOUNDING SLOT → ] [ WHAT IS UNBLOCK? ]