← Back to directory
E

Eth Labels MCP Server

Community
A public dataset of labeled crypto addresses for EVM chains
Category
Database #47 of 58
Stars
★ 302 Very popular
Transport
stdio (local process)
Runtime
Node.js 18+
Credentials
No credential needed
License
MIT
Last commit
Tools
3
47FMRS · D

The Eth Labels MCP server provides a simple and useful interface for EVM address label lookup. It relies on a public dataset, is easy to install, and supports multiple clients. Suitable for users needing quick label lookups, but note that data may not be real-time.

Strongest · Documentation 12/20 Weakest · Reliability 5/20

Reliability
5/20
Security and permissions
8/20
Maintenance
12/20
Documentation
12/20
Setup experience
10/20
Why each score
Reliability 5/20
Static review only; unable to verify server initialization or actual tool behavior. README claims MCP server via npm package, but no server source or tests in repo; tool list not confirmed. Depends on external API and optional scraper, but no test evidence. Score low.
Security and permissions 8/20
Public dataset and API; no special credential handling except optional scraper with ETHERSCAN_USERNAME/PASSWORD/COOKIE. No remote code execution or high-privilege ops. But no security audit or vulnerability disclosure channel, and scraper involves login/cookie handling, potential risk but not red-line.
Maintenance 12/20
Repository has recent commits and releases, MIT license clear. No changelog or security response channel; dependency update status unclear.
Documentation 12/20
README details installation, tools, examples, but lacks troubleshooting, error handling, and API pricing/limits. No MCP server architecture or config details.
Setup experience 10/20
Provides client config examples using npx, no clone. Requires Node.js 18+, no local verification steps, and no actual npm package or test verification.

Static review · not runListed 2026-08-07

Read the FMRS scoring method →

Fit and risk

What it can accessUses the network

Best for

  • Developers and researchers needing quick EVM address labels
  • AI assistants that interact with the Ethereum ecosystem
  • Users who want access to public dataset

Not for

  • Scenarios requiring real-time or dynamic label updates
  • Users needing non-public or proprietary address data
  • Users requiring advanced analytics or complex queries

Required permissions

  • No API key or authentication required
  • Only uses public data
  • Requires network access to fetch the dataset

Risks and side effects

  • Data may be incomplete or inaccurate
  • Dataset may not be updated in real-time
  • Labels may not reflect the latest state

Setup

Before you start

Runtime:Node.js 18+

ETHERSCAN_PASSWORD optionalsecret Used only by the automated scraper: your Etherscan login password; treat as a secret.
ETHERSCAN_COOKIE optionalsecret Used only by the automated scraper as a fallback: a cookie string copied from your Etherscan browser session; treat as a secret.
Other optional settings (1)
ETHERSCAN_USERNAME optional Used only by the automated scraper: your Etherscan login username, set in .env.
  1. Ensure Node.js 18 or higher is installed.
  2. Depending on your AI client, follow the setup instructions in the README to add the MCP server. For Claude Code, run: claude mcp add eth-labels-mcp -- npx -y eth-labels-mcp. For other clients, add a similar JSON configuration to the appropriate config file (using npx -y eth-labels-mcp).
  3. Restart the client, then test with a query like: 'Search for "uniswap" addresses'.
claude_desktop_config.json
{
  "mcpServers": {
    "eth-labels": {
      "command": "npx",
      "args": [
        "-y",
        "eth-labels-mcp"
      ]
    }
  }
}

Shown for Claude Desktop. Other clients may use a different file or key (VS Code uses "servers") — the configurator below converts it.

.vscode/mcp.json
{
  "servers": {
    "eth-labels": {
      "command": "npx",
      "args": [
        "-y",
        "eth-labels-mcp"
      ]
    }
  }
}

Goes in your project's .vscode/mcp.json (VS Code uses a "servers" key).

Terminal
claude mcp add eth-labels -- npx -y eth-labels-mcp

Run it in a terminal; replace any <…> placeholders with your own values first.

Check that it works

After configuring your client, ask it to 'Search for "uniswap" addresses'; if it returns labeled Uniswap addresses, the eth-labels MCP server is connected and working.

Troubleshooting

  1. Ensure Node.js version is 18 or higher
  2. Check MCP configuration for correct command and args
  3. If queries return empty, try different search terms or addresses

Things to try

Once connected, you can ask your AI assistant things like:

  • Search for "uniswap" addresses
  • Look up who owns 0xa6baaed2053058a3c8f11e0c7a9716304454b09e
  • Search labels for the USDC token symbol
  • Get dataset statistics for labeled accounts and tokens

Tools 3

lookup_address read-only
Look up any Ethereum/EVM address to get its label and name tag
search_labels read-only
Search by project name, label, or token symbol (e.g. 'uniswap', 'binance', 'USDC')
dataset_stats read-only
Get dataset statistics — 115k+ accounts, 54k+ tokens, 170k+ total entries

Use cases

Identify addresses or contracts involved in transactions
Find labels for project-related addresses
Get overall dataset size information

Supported clients

Claude Desktop
Claude Code
Cursor
Windsurf
GitHub Copilot
Cline

Listed from the project's documentation, not tested by this site.

Overview

The Eth Labels MCP server allows AI assistants to look up public labels for Ethereum and other EVM chain addresses and tokens. The dataset includes over 115,000 accounts and 54,000 tokens, totaling more than 170,000 entries, sourced from Etherscan. It provides three tools: address lookup, label search, and dataset statistics. It is available via the npm package eth-labels-mcp, no repository clone needed.

Similar servers

Source revision d9b21aefeded Data synced 2026-10-12 Read the FMRS scoring method