Netmind Web3 MCP Server

This is an MCP (Model Context Protocol) server that provides Web3 tools.

Components

Tools

Backend Tools:

query_token_addressList - Query token addresses by name or address (supports multiple values)
query_reply_by_news_summary - Query news by Web3 entity name

CoinGecko Tools:

query_coingecko_market_data - Market data with 7-day historical charts
query_coingecko_top_token_traders - Top token traders analysis (requires Analyst plan)
query_coingecko_pool_trades - Past 24h trades by pool address
query_coingecko_token_trades - Past 24h trades by token address (requires paid plan)

Sugar DeFi Tools:

Token queries, price data, pool information, and swap quotes (8 tools)

Environment Variables

All environment variables should be configured in the .env file in the project root.

Required:

BACKEND_BASE_URL: The backend base URL (domain only, route path is appended in code).
COINGECKO_API_KEY: CoinGecko Pro API Key (format: CG-xxxxx).
SUGAR_PK: Private key for the Sugar service (required for Sugar tools).
SUGAR_RPC_URI_8453: RPC URI for Base chain (required for Sugar tools).

Optional:

MCP_TRANSPORT: Transport mode - "stdio" or "sse" (default: sse).
MCP_HOST: Server host for SSE transport (default: 127.0.0.1).
MCP_PORT: Server port for SSE transport (default: 8000).

See env.example for all available configuration options.

Quick Start

Setup environment:

source .venv/bin/activate
pip install -e .  # or: uv pip install -e .
cp env.example .env
# Edit .env with your API keys

Start server:
```
python -m netmind_web3_mcp.server
```
Server starts in SSE mode on http://127.0.0.1:8000 by default.

Usage

Basic usage:

# Start with SSE transport (default: 127.0.0.1:8000)
python -m netmind_web3_mcp.server

# Start with SSE transport on custom host and port
MCP_HOST=0.0.0.0 MCP_PORT=9000 python -m netmind_web3_mcp.server

# Start with stdio transport
MCP_TRANSPORT=stdio python -m netmind_web3_mcp.server

MCP Client Configuration

For stdio transport (local development):

{
  "mcpServers": {
    "netmind-web3-mcp": {
      "env": {
        "BACKEND_BASE_URL": "***",
        "COINGECKO_API_KEY": "***",
        "MCP_TRANSPORT": "stdio"
      },
      "command": "uvx",
      "args": [
        "git+https://github.com/protagolabs/netmind-web3-mcp.git"
      ]
    }
  }
}

For SSE transport (remote connections), connect to the SSE endpoint:

Default: http://127.0.0.1:8000/sse
Custom: http://your-host:your-port/sse

Debugging with MCP Inspector

Access the built-in Inspector at http://127.0.0.1:8000/inspector after starting the server.

Alternative: Use mcp dev test/test_mcp_inspector.py (automatically starts server in background).

Testing

python test/test_local_stdio.py  # stdio transport
python test/test_sse.py         # SSE transport

See test/README.md for details.