eth-labels

# eth-labels

Look up 170,000+ labeled crypto addresses and tokens across EVM chains (Ethereum, Base, Arbitrum, Optimism, BSC, and more). Identify who owns an address, search for labeled accounts, check balances, and discover token metadata — all via the eth-labels MCP server.

When to use

Use this skill when:

Setup

Install via GitHub (recommended)

Clone the repository and build the MCP server:

git clone https://github.com/dawsbot/eth-labels.git
cd eth-labels/mcp
npm install
npm run build

Then add to your MCP client config (e.g., Claude Desktop `~/Library/Application Support/Claude/claude_desktop_config.json`):

{
  "mcpServers": {
    "eth-labels": {
      "command": "node",
      "args": ["/path/to/eth-labels/mcp/dist/index.js"]
    }
  }
}

Replace `/path/to/eth-labels` with the actual path where you cloned the repo.

Alternative: Run directly from source

For development or testing, you can run the MCP server directly without building:

cd eth-labels/mcp
npx tsx index.ts

Add to MCP config:

{
  "mcpServers": {
    "eth-labels": {
      "command": "npx",
      "args": ["tsx", "/path/to/eth-labels/mcp/index.ts"]
    }
  }
}

Available tools (via MCP)

The MCP server provides these tools:

`lookup_account`

Look up an address to find its label and metadata.

**Parameters:**

**Returns:** Array of account labels with chain info

`lookup_token`

Look up a token contract address to get metadata (name, symbol, website, image).

**Parameters:**

**Returns:** Array of token metadata

`search_labels`

Search for addresses by label/name (e.g., "Coinbase", "Uniswap").

**Parameters:**

**Returns:** Array of matching accounts

`get_balance`

Check ETH balance for an address on any EVM chain.

**Parameters:**

**Returns:** Balance in ETH (formatted)

Supported chains

View all labeled accounts by chain at: https://eth-labels.com/accounts

Public API alternative

If you prefer REST API over MCP, use the public API:

Data sources

Labels are scraped from blockchain explorers (Etherscan, Basescan, Arbiscan, Optimistic Etherscan, BscScan) and refreshed regularly.

Examples

**Look up Vitalik's address:**

lookup_account(address="0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045", chainId=1)

**Search for Coinbase addresses:**

search_labels(query="Coinbase", limit=10)

**Check balance on Base:**

get_balance(address="0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045", chainId=8453)

Repository

https://github.com/dawsbot/eth-labels

License

MIT