Netmind Web3

Provides Web3 tools via MCP, enabling token lookups, market data, and DeFi insights through a configurable local or remote server.

python

0

GitHub Stars

python

Language

3 months ago

First Indexed

3 weeks 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": {
    "protagolabs-netmind-web3-mcp": {
      "command": "uvx",
      "args": [
        "git+https://github.com/protagolabs/netmind-web3-mcp.git"
      ],
      "env": {
        "MCP_TRANSPORT": "stdio",
        "BACKEND_BASE_URL": "***",
        "COINGECKO_API_KEY": "***"
      }
    }
  }
}

Netmind Web3 MCP Server provides Web3 tooling via the Model Context Protocol, enabling you to run a local or remote MCP server that exposes token lookups, news queries, market data, and DeFi insights. It’s designed for developers who want programmable access to Web3 data and tooling through a configurable MCP hub.

How to use

You run the MCP server locally or connect to a remote instance, then use an MCP client to interact with the available tools. The server can operate in different transport modes. By default, it starts in SSE mode at http://127.0.0.1:8000 and serves the MCP API at the /sse endpoint for client connections.

How to install

Prerequisites you need installed on your machine:

Python 3.8+ (for running the MCP server)
pip (Python package installer)
virtual environment support (optional but recommended)

Step-by-step setup and run flow you can follow exactly:

# 1) Create and activate a Python virtual environment (optional but recommended)
python3 -m venv .venv
source .venv/bin/activate

# 2) Install the MCP package in editable mode
pip install -e .

# 3) Prepare environment variables (example placeholder values)
cp env.example .env
# Edit .env to include BACKEND_BASE_URL, COINGECKO_API_KEY, and any Sugar-related keys if needed

# 4) Start the MCP server (default transport SSE on 127.0.0.1:8000)
python -m netmind_web3_mcp.server

Additional configuration and usage notes

You can customize how the server runs by configuring environment variables. The following options appear in the provided configuration example and are commonly used when starting the server in stdio mode (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"
      ]
    }
  }
}

Available 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

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_token_queries

Token queries, price data, pool information, and swap quotes within Sugar DeFi tools

sugar_price_data

Price data for tokens within Sugar DeFi tools

sugar_pool_information

Pool information for Sugar DeFi tools

sugar_swap_quotes

Swap quotes for Sugar DeFi pools