nuthatch
Index an EVM contract's history into a local SQL database your AI client can query
- Pricing
- Open source
- Platforms
- CLI, macOS, Linux
- Runs
- Locally
- Version
- 4.0.0
- Listing updated
- 1 day ago
About nuthatch
nuthatch is an open-source MCP server for databases. It runs locally on your machine and is started by your AI client.
Nuthatch is a single Rust binary that reads an EVM contract's events over JSON-RPC and turns them into tables you query with SQL. It resolves the ABI from Sourcify or Etherscan, generates the schema and decoders, and keeps everything in a local directory it calls a nest, so there is no subgraph to write and no Postgres or Docker to run.
Under the hood a hot store answers point reads at the chain tip, while finalized ranges are sealed into Parquet segments and read by an embedded DataFusion-based query engine. Repeated, expensive aggregates can be declared as entities that the indexer maintains as blocks arrive, and reorgs are handled as retractions. The same blocks always give the same rows, so a nest can be re-run and checked.
The MCP server is built in and works against your local nest, started with the nuthatch dev command; the registry entry packages it as an OCI image. You supply an RPC endpoint, and the bundled public ones are only meant for trying it out. Telemetry is opt-in and limited to a head count.
Install
Run in a terminal
claude mcp add nuthatch -- docker run -i --rm ghcr.io/nightswatchhq/nuthatch:4.0.0Add to claude_desktop_config.json
{
"mcpServers": {
"nuthatch": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/nightswatchhq/nuthatch:4.0.0"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"nuthatch": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/nightswatchhq/nuthatch:4.0.0"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"nuthatch": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/nightswatchhq/nuthatch:4.0.0"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"nuthatch": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/nightswatchhq/nuthatch:4.0.0"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"nuthatch": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/nightswatchhq/nuthatch:4.0.0"
]
}
}
}What it does
- ABI-generated tables
- Creates per-event tables from the contract's ABI with no handler code.
- Local SQL queries
- Run analytical SQL over both the live tip and sealed history.
- Parquet history
- Finalized ranges are stored as Parquet segments read by an embedded engine.
- Maintained entities
- Declare an entity in entities.toml and it is kept up to date as blocks arrive.
- Built-in MCP server
- Lets Claude or another MCP client query the nest.
- Reproducible output
- The same blocks always produce the same rows, so results can be re-checked.
- Opt-in telemetry
- No account or tokens; the only thing it can send is a head count after you agree.
Good for
- Counting token transfers for a contract without writing a subgraph
- Letting an AI assistant answer questions about a contract's events
- Running a local copy of a protocol's history for dashboards
- Building self-hosted Etherscan-style history for chains without a free tier
Pricing
Open source
MIT OR Apache-2.0; a hosted option is mentioned as free
Prices change. Check nuthatch-indexer.com before you buy.
nuthatch FAQ
What licence is it under?
The site lists MIT OR Apache-2.0.
Does it need a database server?
No. Embedded mode needs no Postgres, Docker or IPFS.
How much memory does it use?
The site says at most 2 GB of RAM per chain, and its largest production nest peaked under 1.8 GiB.
Do I need an RPC endpoint?
Yes. It reads over JSON-RPC, and the bundled public endpoints are for trying it out; a long backfill wants your own archive-capable node.
How does it compare with The Graph and Ponder?
Unlike The Graph it needs no subgraph, and unlike Ponder it needs no handler code; it complements The Graph rather than replacing it.
Is nuthatch free?
Yes. nuthatch is open source, so you can use and self-host it for free.
How do I add nuthatch to Claude Code?
Run this command in your terminal: claude mcp add nuthatch -- docker run -i --rm ghcr.io/nightswatchhq/nuthatch:4.0.0
What are the best alternatives to nuthatch?
The closest alternatives to nuthatch are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.
Alternatives to nuthatch

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools