Skip to content

Reference

Everything here is generated from the live Crank FastMCP registry — it never drifts from the code. To regenerate after a tool changes:

source .venv/bin/activate
python docs/gen_tool_reference.py            # Markdown reference + openapi.json
python scripts/export-tool-schemas.py        # OpenAI / Gemini / OpenAPI / LangChain JSON

Contents

  • MCP tool reference — all 100+ tools grouped by category, with parameters, types, defaults, and fee implications.
  • OpenAPI 3.1 document — every tool as a POST /tools/{name} operation. Load it into an OpenAPI client, Postman, or a GPT Action.

Conventions

  • Every tool takes a caller_id (your agent identity; rate-limiting + analytics).
  • Success: {"ok": true, ...payload}. Failure: {"ok": false, "error": {"code", "message"}}.
  • "Free" tools never require payment. "Value-bearing" tools take an x402 payment_header past the daily free tier; many also accept pay_in_crank.
  • Value-bearing tools return an unsigned transaction (or a Tier-B signing payload) for the caller to sign — non-custodial by construction.

See Authentication & x402 and the Fee schedule for the payment and fee model.