Block

Provides a multi-blockchain MCP server offering wallet balances, Frax transactions, gas prices, crypto conversion, and Telegram updates.

typescript

GitHub Stars

typescript

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "collindex-block-mcp": {
      "command": "uv",
      "args": [
        "run",
        "fastmcp",
        "dev",
        "main.py"
      ],
      "env": {
        "FRAXSCAN_API_KEY": "YOUR_FRAXSCAN_API_KEY",
        "TELEGRAM_CHAT_ID": "YOUR_CHAT_ID",
        "COINGECKO_API_KEY": "YOUR_COINGECKO_API_KEY",
        "TELEGRAM_BOT_TOKEN": "YOUR_BOT_TOKEN"
      }
    }
  }
}

You are deploying a Block MCP Server that enables AI agents to interact with multiple blockchain networks, retrieve real-time data, and send notifications via Telegram. This server aggregates practical tools for wallet balances, Frax transactions, gas prices, crypto conversions, and Telegram updates, making it easier to build multi-chain automation and monitoring workflows.

How to use

To start using the Block MCP Server, run the provided runtime options from your development environment and connect your MCP client to the local process. You can launch the server using the Makefile target for an in-process inspector or run the dedicated runtime command with uv. Once the server is running, you can invoke the available tools from your MCP client to query balances, fetch Frax transactions, estimate gas, convert values, and post Telegram messages.

How to install

Prerequisites are required before you install and run the server.

Follow these steps to set up the project locally.

Prerequisites

Ensure you have the following installed before proceeding.

Configuration and runtime

Create a local environment file to supply credentials for Telegram, Frax, and optional services. The values shown are placeholders; replace them with your actual credentials.

# Telegram Configuration
TELEGRAM_BOT_TOKEN=your_bot_token_from_botfather
TELEGRAM_CHAT_ID=your_numeric_chat_id

# Blockchain API Keys
FRAXSCAN_API_KEY=your_fraxscan_api_key

# Optional: CoinGecko API Key
COINGECKO_API_KEY=your_api_key

Run the server

You have two common options to start the MCP server during development. Use the Makefile target to launch the built-in MCP Inspector, or start the runtime directly with uv.

# Option 1: Use the Makefile target to launch the MCP Inspector
make dev

# Option 2: Run the MCP server directly with uv
uv run fastmcp dev main.py

Available tools

Wallet Balance Checker

Retrieves native token balances for any wallet across Ethereum, Polygon, Arbitrum, Optimism, and Base using public RPC nodes.

Frax Transactions

Fetches the latest Frax network transactions, including native transfers and ERC-20 events.

Gas Price Estimator

Provides real-time gas price estimates in Gwei across supported networks.

Crypto Converter

Converts cryptocurrency and fiat values using real-time market rates.

Telegram Bot

Posts updates and automated notifications to a Telegram chat or channel

Built by

VeilStrat

AI signals for GTM teams