Onchain MCP

🚀 Bankless Onchain MCP Server

Bankless Onchain MCP Server provides a powerful solution for on-chain data analysis and processing across multiple blockchain networks, enabling seamless access and parsing of transaction records and contract interactions.

🚀 Quick Start

📦 Installation

npm install @bankless/onchain-mcp

Initial Configuration

Include the following code in your project to start using the Bankless Onchain MCP service:

const { BanklessMCP } = require('@bankless/onchain-mcp');

// Initialize the MCP server
const mcpServer = new BanklessMCP({
  // Configuration options can be adjusted according to specific requirements
});

// Start the service
mcpServer.start().catch(console.error);

✨ Features

1. Bankless On-chain Data Processing

• Feature: Directly perform data read, write, and analysis on the blockchain without traditional financial intermediaries.
• Function:
  • Support multiple blockchain networks (e.g., Ethereum, BSC, Polygon, etc.).
  • Provide a unified API interface to simplify cross-chain operations.

2. On-chain Log Analysis

• Feature: Extract and analyze on-chain event data through log parsing technology.
• Function:
  • Automatically identify contract addresses and their related events.
  • Support complex queries, such as transaction records within a specific time range or for a particular address.

3. Smart Contract Decompilation

• Feature: Decompile the binary contract code deployed on the blockchain into readable source code.
• Function:
  • Provide support for multiple languages (e.g., Solidity).
  • Automatically generate ABI (Application Binary Interface) for easy invocation.

4. On-chain Price Data Aggregation

• Feature: Real-time acquisition and processing of on-chain token price data.
• Function:
  • Support market quotes for tokens across multiple platforms.
  • Provide historical data analysis tools to facilitate market trend research.

📚 Documentation

Building from Source Code

# Clone the repository
git clone https://github.com/Bankless/onchain-mcp.git
cd onchain-mcp

# Install dependencies
npm install

# Build the project
npm run build

Debug Mode

npm run debug

🔧 Technical Details

The server provides various error types to help you quickly locate issues:

• BanklessValidationError: Invalid input parameters.
• BanklessAuthenticationError: Authentication failure or API token issues.
• BanklessResourceNotFoundError: The requested resource was not found.
• BanklessRateLimitError: Exceeded the API call limit.

Integration with AI Models

To integrate this server into an AI application that supports MCP, add the following to your service configuration:

{
  "mcpServers": {
    "banklessOnchain": {
      "type": "BanklessMCP",
      "options": {
        // Fill in options according to specific requirements
      }
    }
  }
}

💡 Usage Tip

• Log Query Optimization: Use filters and aggregation functions to improve log processing efficiency.
• Cross-chain Operations: Make good use of the unified API interface to simplify multi-chain data management.

📄 License

The Bankless Onchain MCP Server is licensed under the MIT License, allowing you to freely use, modify, and distribute the code.