Skip to main content
Glama
Bankless Onchain MCP Server

Bankless Onchain MCP Server

Official
by Bankless

Bankless 온체인 MCP 서버

이 프로젝트는 더 이상 업데이트되지 않습니다

License: MIT Version

Bankless API를 통한 블록체인 데이터 상호작용을 위한 MCP(Model Context Protocol) 서버입니다.

Related MCP server: EVM MCP Server

개요

Bankless 온체인 MCP 서버는 Bankless API를 통해 온체인 데이터와 상호작용하기 위한 프레임워크를 제공합니다. 이 서버는 Model Context Protocol(MCP)을 구현하여 AI 모델이 블록체인 상태 및 이벤트 데이터에 구조화된 방식으로 접근할 수 있도록 합니다.

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

기능

이 서버는 다음과 같은 온체인 데이터 작업을 제공합니다:

컨트랙트 작업

  • 컨트랙트 상태 읽기 (read_contract): 다양한 블록체인 네트워크의 스마트 컨트랙트 상태를 읽습니다.

    • 매개변수: 네트워크, 컨트랙트 주소, 메서드, 입력값, 출력값

    • 반환값: 타입이 지정된 값을 포함한 컨트랙트 호출 결과

  • 프록시 가져오기 (get_proxy): 프록시 구현 컨트랙트 주소를 검색합니다.

    • 매개변수: 네트워크, 컨트랙트 주소

    • 반환값: 구현 컨트랙트 주소

  • ABI 가져오기 (get_abi): 컨트랙트의 ABI(Application Binary Interface)를 가져옵니다.

    • 매개변수: 네트워크, 컨트랙트 주소

    • 반환값: JSON 형식의 컨트랙트 ABI

  • 소스 가져오기 (get_source): 검증된 컨트랙트의 소스 코드를 검색합니다.

    • 매개변수: 네트워크, 컨트랙트 주소

    • 반환값: 소스 코드, ABI, 컴파일러 버전 및 기타 컨트랙트 메타데이터

이벤트 작업

  • 이벤트 가져오기 (get_events): 토픽을 기반으로 컨트랙트의 이벤트 로그를 가져옵니다.

    • 매개변수: 네트워크, 주소, 토픽, 선택적 토픽

    • 반환값: 필터링된 이벤트 로그

  • 이벤트 토픽 생성 (build_event_topic): 이벤트 이름과 인수 타입을 사용하여 이벤트 토픽 서명을 생성합니다.

    • 매개변수: 네트워크, 이벤트 이름, 인수 타입

    • 반환값: 이벤트 토픽 해시

트랜잭션 작업

  • 트랜잭션 기록 가져오기 (get_transaction_history): 사용자 주소의 트랜잭션 기록을 검색합니다.

    • 매개변수: 네트워크, 사용자 주소, 선택적 컨트랙트, 선택적 메서드 ID, 선택적 시작 블록, 데이터 포함 여부 플래그

    • 반환값: 해시, 데이터, 네트워크, 타임스탬프가 포함된 트랜잭션 목록

  • 트랜잭션 정보 가져오기 (get_transaction_info): 특정 트랜잭션에 대한 상세 정보를 가져옵니다.

    • 매개변수: 네트워크, 트랜잭션 해시

    • 반환값: 블록 번호, 타임스탬프, 발신/수신 주소, 값, 가스 정보, 상태 및 영수증 데이터를 포함한 트랜잭션 상세 정보

도구

  • read_contract

    • 블록체인에서 컨트랙트 상태 읽기

    • 입력:

      • network (문자열, 필수): 블록체인 네트워크 (예: "ethereum", "polygon")

      • contract (문자열, 필수): 컨트랙트 주소

      • method (문자열, 필수): 호출할 컨트랙트 메서드

      • inputs (배열, 필수): 메서드 호출을 위한 입력 매개변수, 각 항목 포함:

        • type (문자열): 입력 매개변수의 타입 (예: "address", "uint256")

        • value (any): 입력 매개변수의 값

      • outputs (배열, 필수): 예상 출력 타입, 각 항목 포함:

        • type (문자열): 예상 출력 타입

    • 컨트랙트 호출 결과 배열을 반환합니다.

  • get_proxy

    • 주어진 네트워크와 컨트랙트에 대한 프록시 주소를 가져옵니다.

    • 입력:

      • network (문자열, 필수): 블록체인 네트워크 (예: "ethereum", "base")

      • contract (문자열, 필수): 컨트랙트 주소

    • 프록시 컨트랙트의 구현 주소를 반환합니다.

  • get_events

    • 주어진 네트워크와 필터 기준에 대한 이벤트 로그를 가져옵니다.

    • 입력:

      • network (문자열, 필수): 블록체인 네트워크 (예: "ethereum", "base")

      • addresses (배열, 필수): 이벤트를 필터링할 컨트랙트 주소 목록

      • topic (문자열, 필수): 이벤트를 필터링할 기본 토픽

      • optionalTopics (배열, 선택): 추가적인 선택적 토픽 (null 값 포함 가능)

    • 필터 기준과 일치하는 이벤트 로그를 포함하는 객체를 반환합니다.

  • build_event_topic

    • 이벤트 이름과 인수를 기반으로 이벤트 토픽 서명을 생성합니다.

    • 입력:

      • network (문자열, 필수): 블록체인 네트워크 (예: "ethereum", "base")

      • name (문자열, 필수): 이벤트 이름 (예: "Transfer(address,address,uint256)")

      • arguments (배열, 필수): 이벤트 인수 타입, 각 항목 포함:

        • type (문자열): 인수 타입 (예: "address", "uint256")

    • 이벤트 서명의 keccak256 해시를 포함하는 문자열을 반환합니다.

설치

npm install @bankless/onchain-mcp

사용법

환경 설정

서버를 사용하기 전에 Bankless API 토큰을 설정하십시오. Bankless API 토큰을 얻는 방법에 대한 자세한 내용은 https://docs.bankless.com/bankless-api/other-services/onchain-mcp 를 참조하십시오.

export BANKLESS_API_TOKEN=your_api_token_here

서버 실행

서버는 명령줄에서 직접 실행할 수 있습니다:

npx @bankless/onchain-mcp

LLM 도구와 함께 사용

이 서버는 Model Context Protocol(MCP)을 구현하여 호환되는 AI 모델의 도구 제공자로 사용할 수 있습니다. 각 도구에 대한 몇 가지 호출 예시는 다음과 같습니다:

read_contract

// Example call
{
  "name": "read_contract",
  "arguments": {
    "network": "ethereum",
    "contract": "0x1234...",
    "method": "balanceOf",
    "inputs": [
      { "type": "address", "value": "0xabcd..." }
    ],
    "outputs": [
      { "type": "uint256" }
    ]
  }
}

// Example response
[
  {
    "value": "1000000000000000000",
    "type": "uint256"
  }
]

get_proxy

// Example call
{
  "name": "get_proxy",
  "arguments": {
    "network": "ethereum",
    "contract": "0x1234..."
  }
}

// Example response
{
  "implementation": "0xefgh..."
}

get_events

// Example call
{
  "name": "get_events",
  "arguments": {
    "network": "ethereum",
    "addresses": ["0x1234..."],
    "topic": "0xabcd...",
    "optionalTopics": ["0xef01...", null]
  }
}

// Example response
{
  "result": [
    {
      "removed": false,
      "logIndex": 5,
      "transactionIndex": 2,
      "transactionHash": "0x123...",
      "blockHash": "0xabc...",
      "blockNumber": 12345678,
      "address": "0x1234...",
      "data": "0x...",
      "topics": ["0xabcd...", "0xef01...", "0x..."]
    }
  ]
}

build_event_topic

// Example call
{
  "name": "build_event_topic",
  "arguments": {
    "network": "ethereum",
    "name": "Transfer(address,address,uint256)",
    "arguments": [
      { "type": "address" },
      { "type": "address" },
      { "type": "uint256" }
    ]
  }
}

// Example response
"0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef"

개발

소스에서 빌드하기

# 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

디버그 모드

npm run debug

AI 모델과의 통합

MCP를 지원하는 AI 애플리케이션과 이 서버를 통합하려면 앱의 서버 구성에 다음을 추가하십시오:

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

오류 처리

서버는 다양한 시나리오에 대해 특정 오류 유형을 제공합니다:

  • BanklessValidationError: 잘못된 입력 매개변수

  • BanklessAuthenticationError: API 토큰 문제

  • BanklessResourceNotFoundError: 요청한 리소스를 찾을 수 없음

  • BanklessRateLimitError: API 속도 제한 초과

프롬프트 팁

LLM 모델이 Bankless 온체인 MCP 서버를 사용하도록 안내하려면 다음 프롬프트를 사용할 수 있습니다:

ROLE:
• You are Kompanion, a blockchain expert and EVM sleuth. 
• You specialize in navigating and analyzing smart contracts using your tools and resources.

HOW KOMPANION CAN HANDLE PROXY CONTRACTS:
• If a contract is a proxy, call your “get_proxy” tool to fetch the implementation contract.  
• If that fails, try calling the “implementation” method on the proxy contract.  
• If that also fails, try calling the “_implementation” function.  
• After obtaining the implementation address, call “get_contract_source” with that address to fetch its source code.  
• When reading or modifying the contract state, invoke implementation functions on the proxy contract address (not directly on the implementation).

HOW KOMPANION CAN HANDLE EVENTS:
• Get the ABI and Source of the relevant contracts
• From the event types in the ABI, construct the correct topics for the event relevant to the question
• use the "get_event_logs" tool to fetch logs for the contract

KOMPANION'S RULES:
• Do not begin any response with “Great,” “Certainly,” “Okay,” or “Sure.”  
• Maintain a direct, technical style. Do not add conversational flourishes.  
• If the user’s question is unrelated to smart contracts, do not fetch any contracts.  
• If you navigate contracts, explain each step in bullet points.  
• Solve tasks iteratively, breaking them into steps.  
• Use bullet points for lists of steps.  
• Never assume a contract’s functionality. Always verify with examples using your tools to read the contract state.  
• Before responding, consider which tools might help you gather better information.  
• Include as much relevant information as possible in your final answer, depending on your findings.

HOW KOMPANION CAN USE TOOLS:
• You can fetch contract source codes, ABIs, and read contract data by using your tools and functions.  
• Always verify the source or ABI to understand the contract rather than making assumptions.  
• If you need to read contract state, fetch its ABI (especially if the source is lengthy).  

FINAL INSTRUCTION:
• Provide the best possible, concise answer to the user’s request. If it's not an immediate question but an instruction, follow it directly.
• Use your tools to gather any necessary clarifications or data.  
• Offer a clear, direct response and add a summary of what you did (how you navigated the contracts) at the end.

라이선스

MIT

Available Tools

10 tools
build_event_topicC

Builds an event topic signature based on event name and arguments

Inputs: arguments (required), name (required), network (required).

get_abiC

Gets the ABI for a given contract on a specific network

Inputs: contract (required), network (required).

get_block_infoC

Gets detailed information about a specific block by number or hash

Inputs: blockId (required), network (required).

get_eventsC

Fetches event logs for a given network and filter criteria

Inputs: addresses (required), network (required), topic (required), fromBlock, +2 more.

get_proxyB

Gets the proxy address for a given network and contract

Inputs: contract (required), network (required).

get_sourceB

Gets the source code for a given contract on a specific network

Inputs: contract (required), network (required).

get_token_balances_on_networkB

Gets all token balances for a given address on a specific network

Inputs: address (required), network (required).

get_transaction_history_for_userC

Gets transaction history for a user and optional contract

Inputs: network (required), user (required), contract, includeData, +2 more.

get_transaction_infoB

Gets detailed information about a specific transaction

Inputs: network (required), txHash (required).

read_contractC

Read contract state from a blockchain. important:

            In case of a tuple, don't use type tuple, but specify the inner types (found in the source) in order. For nested structs, include the substructs types.

Example: 
struct DataTypeA {
DataTypeB b;
//the liquidity index. Expressed in ray
uint128 liquidityIndex;
}

struct DataTypeB {
address token;
}

results in outputs for function with return type DataTypeA (tuple in abi): outputs: [{"type": "address"}, {"type": "uint128"}]

Inputs: contract (required), inputs (required), method (required), network (required), +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.3/5.0

    Scored across 10 tools

    Disambiguation5/5

    Every tool has a clearly distinct purpose with no ambiguity. For example, get_abi retrieves contract interfaces, get_events fetches logs, get_token_balances_on_network handles balances, and read_contract reads state—each targets a specific blockchain operation without overlap.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern (e.g., get_abi, get_block_info, read_contract). The naming is uniform across all 10 tools, using snake_case and clear action-object pairs, making them predictable and easy to parse.

    Tool Count5/5

    With 10 tools, this server is well-scoped for onchain data retrieval. Each tool earns its place by covering essential blockchain operations like reading contracts, fetching events, and getting transaction details, without being overly sparse or bloated.

    Completeness4/5

    The tool set provides strong coverage for reading and querying onchain data, including contracts, blocks, transactions, events, and balances. A minor gap exists in write operations (e.g., sending transactions or interacting with contracts), but agents can still handle most read-focused workflows effectively.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      B
      quality
      D
      maintenance
      Implements the Model Context Protocol (MCP) to provide AI models with a standardized interface for connecting to external data sources and tools like file systems, databases, or APIs.
      1
      153
      -
    • A
      license
      B
      quality
      D
      maintenance
      A Model Context Protocol server that enables AI agents to interact with 30+ Ethereum-compatible blockchain networks, providing services like token transfers, contract interactions, and ENS resolution through a unified interface.
      28
      96 npm
      380
      MIT
    • -
      license
      Not graded
      quality
      Not graded
      maintenance
      Comprehensive Model Context Protocol server that enables AI agents to interact with 30+ Ethereum-compatible blockchain networks, supporting token transfers, smart contract interactions, and ENS name resolution through a unified interface.
      1
      -
    • F
      license
      A
      quality
      C
      maintenance
      A server that exposes blockchain data (balances, tokens, NFTs, contract metadata) via the Model Context Protocol, enabling AI agents and tools to access and analyze blockchain information contextually.
      18
      46
      -