Bankless Onchain MCP Server

Official

Structured on-chain data: contract state, ABIs, source code, event logs, and transaction history.

Verified

stdio (local)

API key

TypeScript

View repo 120 Website npm

Add to your client

Copy the config for your MCP client and paste it into its config file.

Install / run

npx -y @bankless/onchain-mcp

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "bankless-onchain-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@bankless/onchain-mcp"
      ],
      "env": {
        "BANKLESS_API_TOKEN": "<your-bankless-api-token>"
      }
    }
  }
}

Step-by-step guides: Add to Claude Desktop · Add to Cursor · Add to Windsurf

Before you start

Node.js (LTS recommended) with npx available
A Bankless API token — sign up and generate one via the Bankless API onchain-mcp docs (set as BANKLESS_API_TOKEN)

About Bankless Onchain MCP Server

Bankless Onchain MCP Server is a stdio MCP server that exposes structured on-chain data through the Bankless API. It lets an LLM read contract state, fetch ABIs and verified source code, resolve proxy implementations, query event logs, and pull transaction history across supported EVM networks — without you writing RPC plumbing or parsing raw chain data yourself.

The server is read-only: it never signs or sends transactions, so it's safe to give an agent access to. It's a good fit for blockchain analytics, contract inspection, and debugging workflows where you want the model to answer questions like "what does this contract's owner return" or "what events did this address emit last week."

Note: the public GitHub repo is marked as no longer receiving updates, so treat it as stable-but-archived rather than actively maintained. The npm package @bankless/onchain-mcp remains installable via npx.

Tools & capabilities (8)

read_contract

Read smart-contract state (call view/pure functions) across supported networks

get_proxy

Resolve the implementation address behind a proxy contract

get_abi

Fetch the ABI (Application Binary Interface) for a contract

get_source

Retrieve verified contract source code and metadata

get_events

Fetch event logs matching filter criteria (address, topics, block range)

build_event_topic

Compute the keccak event topic/signature hash from an event name and argument types

get_transaction_history

Retrieve transaction history for an address

get_transaction_info

Get detailed information about a specific transaction

When to use it

Use it when you want an agent to read contract state (balances, owners, config) without writing RPC calls
Use it when inspecting or auditing a contract — pulling its ABI and verified source on demand
Use it when a dapp uses proxies and you need to resolve the real implementation address
Use it when analyzing on-chain activity by querying event logs or an address's transaction history
Use it when you need to compute an event topic hash to filter logs precisely

Quick setup

1Obtain a Bankless API token from the Bankless API onchain-mcp documentation
2Add the server to your MCP client config with command `npx` and args `["@bankless/onchain-mcp"]`
3Set the BANKLESS_API_TOKEN environment variable in the server's env block
4Restart your MCP client (Claude Desktop, Cursor, etc.) so it spawns the server
5Verify by asking the model to read a known contract's state or fetch its ABI

Security notes

Read-only on-chain data access with no transaction signing, so no funds are at risk; keep BANKLESS_API_TOKEN in env. Mind the ~10 req/min rate limit to avoid throttling.

Bankless Onchain MCP Server FAQ

Do I need an API key?

Yes. The server requires a BANKLESS_API_TOKEN from the Bankless API. All tools route through the Bankless API, so requests fail without a valid token.

Can it send transactions or sign anything?

No. It is strictly read-only — contract reads, ABIs/source, events, and transaction history. It never broadcasts or signs transactions.

Is this project still maintained?

The GitHub repo is marked as no longer receiving updates. The npm package still installs and runs, but don't expect new features or fixes.

Which networks are supported?

It covers the EVM networks exposed by the Bankless API; pass the chain/network when calling tools. Check the Bankless API docs for the current supported list.

What transport does it use?

stdio. You run it locally via npx (or npm install) and your MCP client communicates over standard input/output.

#blockchain #onchain-data #bankless #read-only #community

Alternatives to Bankless Onchain MCP Server

Compare all alternatives →

Stripe MCP Server (Agent Toolkit)

Finance & Payments

1.9k

Official Stripe server for payments, customers, subscriptions, invoices, and billing via natural language.

Featured

Verified

stdio (local)

API key

TypeScript

12 tools

Updated 1 month agoRepo

Coinbase AgentKit MCP Extension

Finance & Payments

900

Coinbase's AgentKit MCP extension for onchain actions: transfers, swaps, and contract calls.

Verified

stdio (local)

API key

TypeScript

9 tools

Updated 1 month agoRepo

Alpaca MCP Server

Finance & Payments

820

Alpaca's official trading server for stocks, ETFs, options, and crypto in plain English.

Verified

stdio (local)

API key

Python

12 tools

Updated 26 days agoRepo

Compare Bankless Onchain MCP Server with:

vs Stripe MCP Server (Agent Toolkit)vs Coinbase AgentKit MCP Extension vs Alpaca MCP Server vs EVM MCP Server