Substreams Search
Search, inspect, and analyze Substreams packages from the substreams.dev registry — from discovery to sink deployment.
Tools
- search_substreams — Search the substreams.dev package registry by keyword, sort order, and blockchain network
- inspect_package — Inspect a .spkg file to see its module graph (DAG), protobuf output types, dependencies, and a Mermaid diagram
- list_package_modules — Lightweight module listing with types and inputs/outputs
- get_sink_config — Analyze sink configuration, extract SQL schemas, and generate ready-to-run CLI commands
Requirements
- Runtime: Node.js >= 18 (runs via
npx) - Environment variables: None required. All searches and package inspections use public APIs — no API key needed.
Install
npx substreams-search-mcp
Network & Data Behavior
search_substreams scrapes the public substreams.dev registry pages (no API key required).inspect_package and get_sink_config fetch .spkg files from spkg.io URLs to parse protobuf metadata.- No local database or persistent storage is used.
- The SSE transport (
--http / --http-only) starts a local HTTP server on port 3849 (configurable via MCP_HTTP_PORT env var).
Use Cases
- Find Substreams packages for any blockchain (Ethereum, Solana, Arbitrum, Base, etc.)
- Inspect module graphs and understand data flow before deploying
- Get sink setup commands for PostgreSQL, ClickHouse, or subgraph entity sinks
- Discover sink-compatible modules in packages without embedded sink configs