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

1. Setup environment:

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

2. 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:

MCP Client Configuration

For stdio transport (local development):

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

See test/README.md for details.