Skip to content

Releases: dioptx/web3-docs

v0.2.0 — Cardano · Tezos · Sui · fork lookup

26 Apr 18:40
@dioptx dioptx
v0.2.0
f2ee2e7

Choose a tag to compare

View all tags
v0.2.0 — Cardano · Tezos · Sui · fork lookup Latest
Latest

One MCP server, eleven protocol-spec repos. 1,767 proposals · 10 chains · 19 contract registries — local SQLite + FTS5 ranked search.

Highlights

Three new chains

  • Cardano CIPs — cardano-foundation/CIPs
  • Tezos TZIPs — gitlab.com/tezos/tzip
  • Sui SIPs — sui-foundation/sips

New tool: list_fork_proposals(fork_name)

Maps a named fork to every proposal it activated. Answers questions like "what's in Cancun?" or "which BIPs activated with Taproot?". Handles consensus-layer aliases (Pectra → Prague, Dencun → Cancun, Shapella → Shanghai, The Merge → Paris).

Search quality

  • Optional chain= filter on resolve_proposal for keyword disambiguation when a term matches across chains (e.g. "staking" on ethereum vs cosmos).
  • Empty-index detection: tools now return a clear --sync hint instead of a misleading "No proposals found" reply on first run.

Packaging

  • Install with uvx --from git+https://github.com/dioptx/web3-docs web3-docs-mcp.
  • Hatchling-based wheel + sdist, full PyPI metadata, [project.scripts] entry point.
  • WEB3_DOCS_DATA_DIR env var; default ~/.cache/web3-docs-mcp/.

Docs

  • Agent-agnostic README — works with any MCP client (Claude Code, Cursor, Windsurf, Cline, Continue, Zed, Codex …).
  • Three animated demo GIFs covering install, contract lookup, and fork drill-down.

Stderr discipline

All 17 sync-time print() calls now route through a stderr logger; stdout is reserved for the JSON-RPC channel.

Stats

  • 98 tests passing
  • 11 upstream sources, fully indexed in ~2 min via --sync
  • ~10 MB index, ~500 MB sources (deletable after sync)

See CHANGELOG.md for the full diff.

Assets 2
Loading