Skip to content
MCP server

nuthatch

Index an EVM contract's history into a local SQL database your AI client can query

Runs locallyStatus and history
Install
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.0

Add to claude_desktop_config.json

{
  "mcpServers": {
    "nuthatch": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/nightswatchhq/nuthatch:4.0.0"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "nuthatch": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/nightswatchhq/nuthatch:4.0.0"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools