mcp-server-plugin

blockscout/mcp-server-plugin

3.3

If you are the rightful owner of mcp-server-plugin and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The Model Context Protocol (MCP) server for Blockscout enables AI agents and tools to access and analyze blockchain data contextually through a flexible and extensible gateway.

The MCP Server Plugin for Blockscout is designed to bridge the gap between blockchain data and AI tools by providing a structured and context-aware API interface. This plugin wraps Blockscout APIs, allowing AI agents, IDEs, and automation tools to access blockchain data such as balances, tokens, NFTs, and contract metadata. By leveraging the Model Context Protocol, the server offers a seamless integration with Higress, a cloud-native gateway known for its advanced API management and traffic control capabilities. The plugin supports both single-chain and multi-chain configurations, making it versatile for various blockchain environments. With customizable tool configurations, users can tailor the descriptions and response templates to fit their specific needs, enhancing the contextual analysis of blockchain data.

Features

  • Contextual blockchain data access for AI tools
  • Multi-chain and single-chain support via configuration
  • Extensible tool configurations with customizable descriptions and response templates

Usages

usage with Higress

yaml
apiVersion: higress.io/v1
kind: MCPServer
metadata:
  name: blockscout-mcp
spec:
  mode: single-chain
  configFile: api-to-mcp-mainnet.yml

usage with local installation

markdown
# Local Installation Instructions

1. Clone the repository:
   bash
   git clone https://github.com/your-repo/blockscout-mcp.git
   cd blockscout-mcp
   

2. Install Higress locally:
   bash
   # Follow instructions in local-mcp.md
   

3. Start the MCP server:
   bash
   higress start -f api-to-mcp-mainnet.yml

Tools

  1. __get_instructions__

    Must be called before any other tool. Initializes the MCP server session.

  2. get_address_by_ens_name

    Converts an ENS domain name to its corresponding Ethereum address.

  3. lookup_token_by_symbol

    Searches for token addresses by symbol or name, returning multiple potential matches.

  4. get_contract_abi

    Retrieves the ABI (Application Binary Interface) for a smart contract.

  5. get_address_info

    Gets comprehensive information about an address including balance, ENS association, contract status, and token details.

  6. get_tokens_by_address

    Returns detailed ERC20 token holdings for an address with enriched metadata and market data.

  7. get_latest_block

    Returns the latest indexed block number and timestamp.

  8. get_transactions_by_address

    Gets transactions for an address within a specific time range with optional method filtering.

  9. get_token_transfers_by_address

    Returns ERC-20 token transfers for an address within a specific time range.

  10. transaction_summary

    Provides human-readable transaction summaries using Blockscout Transaction Interpreter.

  11. nft_tokens_by_address

    Retrieves NFT tokens owned by an address, grouped by collection.

  12. get_block_info

    Returns block information including timestamp, gas used, burnt fees, and transaction count.

  13. get_transaction_info

    Gets comprehensive transaction information with decoded input parameters and detailed token transfers.

  14. get_transaction_logs

    Returns transaction logs with decoded event data.

  15. get_address_logs

    Gets logs emitted by a specific address with decoded event data.