Eth Labels

Look up labeled crypto addresses, token metadata, and balances across major EVM chains including Ethereum, Base, Arbitrum, Optimism, and BSC.

Security Scan

The skill's requirements and runtime instructions are coherent with its stated purpose (address/token lookup) — it is instruction-only and points to a GitHub repo and a public API, but you should review any code you build/run locally before trusting it.

Purpose & Capability

Name/description (lookup labeled crypto addresses, tokens, balances) align with the provided tools (lookup_account, lookup_token, search_labels, get_balance) and with the public API endpoints and repo. No unrelated credentials, binaries, or config paths are requested.

Instruction Scope

SKILL.md stays within scope: it documents MCP RPC methods, example calls, and where to find the public REST API. It also instructs the user to clone/build/run the eth-labels MCP server locally and to add it to an MCP client config — these actions are expected for this skill but do instruct running third-party code on the host.

Install Mechanism

There is no built-in install spec (lowest risk), but the README recommends cloning and running code from GitHub (npm install / npm run build / npx tsx), which will execute unreviewed code if you follow the instructions. This is expected for a repo-based MCP server but warrants manual review before running.

Credentials

The skill declares no required environment variables, no credentials, and no config paths beyond instructing how to add the local MCP server to an MCP client config. That matches the described functionality; nothing requests unrelated secrets.

Persistence & Privilege

always is false and model invocation is allowed (platform default). The skill does not request permanent presence or modifications to other skills. The only persistent action suggested is adding a local MCP server to the client's config, which is reasonable for this type of integration.

Assessment

This skill appears to do what it says: lookups via an MCP server or the public API. If you plan to run the recommended MCP server, review the GitHub repo (package.json, build scripts, and server code) before running npm install / node / npx tsx. Prefer using the documented public API (https://eth-labels.com/swagger) if you don't want to run third-party code locally. When running the server locally, avoid running as root, check network activity, and ensure the MCP client config references the correct path. If you need a higher assurance level, ask for a link to a specific release tarball or a signed release rather than cloning an arbitrary main branch.

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:

• User asks "who owns this address" or "what is this address"
• Looking up wallet labels (exchanges, protocols, DAOs, known entities)
• Identifying token contracts and metadata
• Searching for addresses by label/name
• Checking balances across EVM chains
• Researching crypto transactions or addresses

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:

• address (string, required): Ethereum address (0x...)
• chainId (number, optional): Chain ID to filter results (1=Ethereum, 8453=Base, 42161=Arbitrum, 10=Optimism, 56=BSC)

Returns: Array of account labels with chain info

lookup_token

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

Parameters:

• address (string, required): Token contract address (0x...)
• chainId (number, optional): Chain ID to filter results

Returns: Array of token metadata

search_labels

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

Parameters:

• query (string, required): Search term (case-insensitive, partial match supported)
• chainId (number, optional): Chain ID to filter results
• limit (number, optional): Max results to return (default: 20)

Returns: Array of matching accounts

get_balance

Check ETH balance for an address on any EVM chain.

Parameters:

• address (string, required): Address to check
• chainId (number, optional): Chain ID (default: 1 for Ethereum mainnet)
• rpcUrl (string, optional): Custom RPC endpoint

Returns: Balance in ETH (formatted)

Supported chains

• Ethereum (chainId: 1)
• Base (chainId: 8453)
• Arbitrum (chainId: 42161)
• Optimism (chainId: 10)
• Binance Smart Chain (chainId: 56)

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:

• Swagger docs: https://eth-labels.com/swagger
• View labeled accounts: https://eth-labels.com/accounts?chainId=1

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