Bankless Onchain MCP Server

What does “Bankless Onchain” MCP Server do?

The Bankless Onchain MCP Server is a Model Context Protocol (MCP) server designed to facilitate structured access to blockchain data via the Bankless API. By implementing MCP, it empowers AI assistants and developer tools to seamlessly interact with on-chain data, such as smart contract state, events, and transaction histories, across multiple blockchain networks. This server enables AI-powered workflows and automations that require reading contract state, fetching contract ABIs, retrieving event logs, and analyzing transaction data. By exposing these blockchain operations as standardized MCP tools, the Bankless Onchain MCP Server enhances developer productivity and enables the construction of intelligent, data-driven blockchain applications and agents.

List of Prompts

No prompt templates are specified in the repository.

List of Resources

No explicit resources are documented in the repository.

List of Tools

• read_contract
  • Reads contract state from a blockchain by calling specified methods with given parameters and returns the result.
• get_proxy
  • Retrieves the current implementation address for a proxy contract on a given network.
• get_abi
  • Fetches the Application Binary Interface (ABI) for a smart contract, allowing clients to understand available methods and events.
• get_source
  • Retrieves the verified source code, ABI, compiler version, and metadata for a contract.
• get_events
  • Fetches event logs for specified contracts and topics, enabling event-driven queries and analysis.
• build_event_topic
  • Generates an event topic signature hash from an event name and argument types for log filtering.
• get_transaction_history
  • Retrieves a list of transactions for a user address, possibly filtered by contract, method, and time.
• get_transaction_info
  • Provides detailed information about a specific transaction, including block, participants, value, gas, and status.

Use Cases of this MCP Server

• Smart Contract State Queries
  • Developers and AI agents can programmatically read the current state of any smart contract on supported blockchains, useful for dashboards, monitoring bots, or DeFi analytics.
• Block Explorer Automation
  • Automate retrieval of contract source, ABI, and proxy information, facilitating code analysis, auditing, or reverse engineering tools.
• Event Monitoring and Alerting
  • Set up AI agents or services to fetch and process on-chain events for real-time notifications, compliance monitoring, or trading signals.
• Transaction Analysis
  • Access detailed transaction histories and information for addresses, enabling wallet analytics, KYC/AML routines, or chain activity summaries.
• Developer Tooling and AI-Driven Workflows
  • Integrate blockchain data access into developer IDEs or AI copilots, boosting productivity for smart contract development and testing.

How to set it up

Windsurf

1. Ensure you have Node.js installed and the MCP server package available.
2. Locate or create your .windsurf/config.json configuration file.
3. Add the Bankless Onchain MCP Server to your mcpServers section:

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

4. Save the configuration file.
5. Restart Windsurf and verify the server is running.

Securing API Keys: If the Bankless API requires authentication, use environment variables:

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

Claude

1. Install Node.js if not already installed.
2. Open Claude’s server configuration file.
3. Add the Bankless Onchain MCP Server in the mcpServers section as shown:

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

4. Save and restart Claude to pick up the new server.

Securing API Keys: Add your API keys in the env object as above.

Cursor

1. Install Node.js and ensure your development environment can run MCP servers.
2. Open Cursor’s configuration settings.
3. Add the following MCP server entry:

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

4. Save the configuration and restart Cursor.

Securing API Keys: Include API keys securely using the env section.

Cline

1. Make sure Node.js is installed on your machine.
2. Open the Cline configuration JSON.
3. Add the MCP server configuration:

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

4. Save and restart Cline.

Securing API Keys: Use the env property to securely provide API keys.

How to use this MCP inside flows

Using MCP in FlowHunt

To integrate MCP servers into your FlowHunt workflow, start by adding the MCP component to your flow and connecting it to your AI agent:

Click on the MCP component to open the configuration panel. In the system MCP configuration section, insert your MCP server details using this JSON format:

{
  "bankless-onchain": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Once configured, the AI agent is now able to use this MCP as a tool with access to all its functions and capabilities. Remember to change “bankless-onchain” to whatever the actual name of your MCP server is and replace the URL with your own MCP server URL.

Overview

Based on the tables above, the Bankless Onchain MCP Server covers the core tooling and setup for blockchain data access, but lacks specified prompt templates, resource definitions, and mentions of roots or sampling. This makes it a solid but basic MCP server, especially for blockchain data. I’d rate it a 6 out of 10 for general MCP completeness.

MCP Score