onchain-mcp

[](https://opensource.org/licenses/MIT)

MCP (Model Context Protocol) server for blockchain data interaction through the Bankless API.

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.

https://github.com/user-attachments/assets/95732dff-ae5f-45a6-928a-1ae17c0ddf9d

The server provides the following onchain data operations:

• Read Contract State (read_contract): Read state from smart contracts on various blockchain networks.
• Parameters: network, contract address, method, inputs, outputs
• Returns: Contract call results with typed values

• Get Proxy (get_proxy): Retrieve proxy implementation contract addresses.
• Parameters: network, contract address
• Returns: Implementation contract address

• Get ABI (get_abi): Fetch the ABI (Application Binary Interface) for a contract.
• Parameters: network, contract address
• Returns: Contract ABI in JSON format

• Get Source (get_source): Retrieve the source code for a verified contract.
• Parameters: network, contract address
• Returns: Source code, ABI, compiler version, and other contract metadata

• Get Events (get_events): Fetch event logs for a contract based on topics.
• Parameters: network, addresses, topic, optional topics
• Returns: Filtered event logs

• Build Event Topic (build_event_topic): Generate an event topic signature from event name and argument types.
• Parameters: network, event name, argument types
• Returns: Event topic hash

• Get Transaction History (`get_transaction_