Bankless Onchain

by bankless

26 stars
1.2k downloads
Not rated
GitHub Website

About

Integrates with blockchain networks to enable smart contract interaction, transaction history access, and on-chain data exploration through specialized tools for reading contract state, retrieving ABIs, and filtering event logs.

Details

Author
bankless
Repository
Bankless/onchain-mcp
GitHub stars
26
Downloads
1,233
Categories
Developer Tools, Database, Other, Productivity, Design, AI, Knowledge Base, Frontend, API, Security

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Bankless Onchain
    Command (node, npx, python, etc.) npx
    Arguments
    • Argument 1 @bankless/onchain-mcp
    Environment
    • BANKLESS_API_TOKEN your_api_token_here

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

{
  "mcpServers": {
    "onchain-mcp": {
      "command": "npx",
      "args": [
        "@bankless/onchain-mcp"
      ]
    }
  }
}

read_contract

Read contract state from a blockchain. Parameters: network (string, required), contract (string, required), method (string, required), inputs (array, required), outputs (array, required). Returns an array of contract call results.

get_proxy

Gets the proxy address for a given network and contract. Parameters: network (string, required), contract (string, required). Returns the implementation address for the proxy contract.

get_events

Fetches event logs for a given network and filter criteria. Parameters: network (string, required), addresses (array, required), topic (string, required), optionalTopics (array, optional). Returns an object containing event logs matching the filter criteria.

build_event_topic

Builds an event topic signature based on event name and arguments. Parameters: network (string, required), name (string, required), arguments (array, required). Returns a string containing the keccak256 hash of the event signature.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "bankless onchain": {
            "env": {
                "BANKLESS_API_TOKEN": "your_api_token_here"
            },
            "args": [
                "@bankless/onchain-mcp"
            ],
            "command": "npx"
        }
    }
}

Linux

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

Macos

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

Windows

{
    "env": {
        "BANKLESS_API_TOKEN": "your_api_token_here"
    },
    "args": [
        "/c",
        "npx",
        "@bankless/onchain-mcp"
    ],
    "command": "cmd"
}

What can you do with Bankless Onchain MCP?

- Read live contract state— Call any read method on a verified contract across supported networks usingread_contract.
- Resolve proxy implementations— Retrieve the implementation address behind a proxy contract withget_proxy.
- Fetch contract ABI and source— Get the full ABI viaget_abior verified source code and metadata viaget_source.
- Query historical events— Retrieve filtered event logs for one or more contract addresses usingget_events.
- Build event topic hashes— Generate a keccak256 event topic from an event name and argument types withbuild_event_topic.
- Inspect transaction history and details— List past transactions for an address withget_transaction_historyor look up a specific transaction withget_transaction_info.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.