M
MCP Directory CURATED DIRECTORY
911 MCP servers indexed
中文
← Back to directory
B

Bankless Onchain MCP Server

Community
MCP server for blockchain data interactions via the Bankless API.
How to install ↓ Compare GitHub source repository ↗
Category
Other #205 of 230
Stars
★ 79 Popular
Transport
stdio (local process)
Runtime
Node.js
Credentials
API key / credential required
Last commit
Tools
8
35FMRS · D

The project is no longer receiving updates but core functionality remains usable. Suitable for developers needing quick access to on-chain data, but note its read-only nature and reliance on an external API.

Strongest · Documentation 8/20 Weakest · Security and permissions 6/20

Reliability
7/20
Security and permissions
6/20
Maintenance
7/20
Documentation
8/20
Setup experience
7/20
Why each score
Reliability 7/20
No executable tests or CI configuration found in source, capping reliability at 12. However, README shows clear functionality and error handling types. But lack of run evidence means cannot verify stated vs actual behavior. Deduction for missing test evidence.
Security and permissions 6/20
API token required, and README includes configuration instructions. But no explicit token storage or least privilege guidance. Server makes external network calls, but no confirmation mechanism. No malicious behavior, but security best practices incomplete. Deduction for missing security hardening.
Maintenance 7/20
License (MIT) and version 0.6.2 present, but README explicitly says project no longer receives updates, so low activity. However, presence of license and versioning partially compensates. Main deduction for halted updates.
Documentation 8/20
README includes installation, usage, examples, and error handling. Documentation quality is good but missing troubleshooting and cost limits. Deduction for incomplete docs.
Setup experience 7/20
Install steps clear (npx command), environment variable example provided. Also includes client config JSON example. But no verifiable installation evidence (e.g., CI, tests). Deduction for lack of verification. However, setup is straightforward, so score is moderate.

Static review · not runListed 2026-08-07

Read the FMRS scoring method →

Fit and risk

What it can accessUses the network

Best for

  • Developers building AI agents that need on-chain data
  • Smart contract auditing and data analysis
  • Building DeFi dashboards or monitoring tools

Not for

  • Writing to or modifying blockchain state (read-only)
  • Scenarios requiring private chains or custom RPCs
  • Real-time transaction streaming (requires additional components)

Required permissions

  • Requires BANKLESS_API_TOKEN environment variable
  • Requires network access to call the Bankless API
  • Requires permission to read contract and transaction data

Risks and side effects

  • Using a third-party API may have availability and rate limit constraints
  • Careful when supplying contract addresses or method names to avoid security issues
  • API key leak could lead to costs or data misuse

Setup

Before you start

Runtime：Node.js

BANKLESS_API_TOKEN requiredsecret Access token for the Bankless API, required for the server to run; obtain it per https://docs.bankless.com/bankless-api/other-services/onchain-mcp.
  1. Set the BANKLESS_API_TOKEN environment variable. See https://docs.bankless.com/bankless-api/other-services/onchain-mcp for details.
  2. Run the server with npx @bankless/onchain-mcp.
  3. Configure the server in an MCP-compatible client as shown in install_config.
claude_desktop_config.json 
{
  "mcpServers": {
    "bankless": {
      "command": "npx",
      "args": [
        "@bankless/onchain-mcp"
      ],
      "env": {
        "BANKLESS_API_TOKEN": "your_api_token_here"
      }
    }
  }
}

Shown for Claude Desktop. Other clients may use a different file or key (VS Code uses "servers") — the configurator below converts it.

.vscode/mcp.json
{
  "servers": {
    "bankless": {
      "command": "npx",
      "args": [
        "@bankless/onchain-mcp"
      ],
      "env": {
        "BANKLESS_API_TOKEN": "your_api_token_here"
      }
    }
  }
}

Goes in your project's .vscode/mcp.json (VS Code uses a "servers" key).

Terminal
claude mcp add bankless -e BANKLESS_API_TOKEN=your_api_token_here -- npx @bankless/onchain-mcp

Run it in a terminal; replace any <…> placeholders with your own values first.

Generate and validate client config

Check that it works

After setup, tools like read_contract, get_abi, and get_events should appear in the client's tool list; calling get_proxy on a known proxy contract confirms the API token works.

Troubleshooting

  1. Check that BANKLESS_API_TOKEN is set correctly
  2. Ensure network connectivity to the Bankless API
  3. Verify contract address and network parameters are correct

Things to try

Once connected, you can ask your AI assistant things like:

  • Read the balanceOf method on contract 0x1234... on Ethereum with input address 0xabcd... and return the uint256 balance
  • Find the implementation address of proxy contract 0x1234... on Ethereum
  • Fetch the ABI and source code for a verified contract on Ethereum
  • Get the transaction history for address 0xabcd... on Ethereum

Tools 8

read_contract read-only
Read state from smart contracts on various blockchain networks.
get_proxy read-only
Retrieve the implementation contract address for a proxy contract.
get_abi read-only
Fetch the ABI (Application Binary Interface) for a contract.
get_source read-only
Retrieve the source code, ABI, compiler version, and other metadata for a verified contract.
get_events read-only
Fetch event logs for a contract based on topics.
build_event_topic read-only
Generate an event topic signature from event name and argument types.
get_transaction_history read-only
Retrieve transaction history for a user address.
get_transaction_info read-only
Get detailed information about a specific transaction.

Use cases

Reading Ethereum smart contract state in AI applications
Analyzing token transfers and event logs
Tracking transaction history for an address
Debugging contract interactions

Supported clients

Claude Desktop

Listed from the project's documentation, not tested by this site.

Overview

The Bankless Onchain MCP Server provides a framework for interacting with on-chain data via the Bankless API. It implements the Model Context Protocol (MCP) to allow AI models to access blockchain state and event data in a structured way. It supports contract operations (read state, get proxy, ABI, source), event operations (get logs, build topic), and transaction operations (history and details).

Similar servers

BioMCP 75 · B

One binary. One grammar. Evidence from the biomedical sources you already trust.

★ 654 · Tools 11 Compare with this →
Compare with other MCP servers

Source revision f81f69a14560 Data synced 2026-10-12 Read the FMRS scoring method