Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
126 changes: 115 additions & 11 deletions readme.md
Original file line number Diff line number Diff line change
Expand Up @@ -62,40 +62,144 @@ A public API to consume this data is available for free. You can [use it remotel

## MCP Server

Use eth-labels as a tool in Claude Code, Cursor, Windsurf, or any MCP-compatible AI assistant. Ask your AI to identify any crypto address or search for known wallets.
Give your AI the ability to identify any crypto address. Works with Claude, Cursor, Windsurf, VS Code, and any MCP-compatible client.

**170k+ labeled addresses and tokens across EVM chains. No clone. No build. Just install.**

> **Requires:** Node.js 18+

### Setup

Pick your AI client and follow the instructions. Every option uses the [eth-labels-mcp](https://www.npmjs.com/package/eth-labels-mcp) npm package — no need to clone this repo.

<details open>
<summary><b>Claude Code</b></summary>

```sh
# Clone and build
git clone https://github.com/dawsbot/eth-labels.git
cd eth-labels/mcp
npm install
npm run build
claude mcp add eth-labels-mcp -- npx eth-labels-mcp
```

### Add to Claude Code
Done.

Add to your `~/.claude/claude_desktop_config.json`:
</details>

<details>
<summary><b>Claude Desktop</b></summary>

Edit your config file:

| OS | Path |
|----|------|
| macOS | `~/Library/Application Support/Claude/claude_desktop_config.json` |
| Windows | `%APPDATA%\Claude\claude_desktop_config.json` |
| Linux | `~/.config/Claude/claude_desktop_config.json` |

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

Restart Claude Desktop after saving.

</details>

<details>
<summary><b>Cursor</b></summary>

Add to `.cursor/mcp.json` in your project root (or open **Settings → Features → MCP Servers → Add**):

```json
{
"mcpServers": {
"eth-labels": {
"command": "npx",
"args": ["-y", "eth-labels-mcp"]
}
}
}
```

</details>

<details>
<summary><b>Windsurf</b></summary>

Add to `~/.codeium/windsurf/mcp_config.json`:

```json
{
"mcpServers": {
"eth-labels": {
"command": "npx",
"args": ["-y", "eth-labels-mcp"]
}
}
}
```

</details>

<details>
<summary><b>VS Code (GitHub Copilot)</b></summary>

Add to `.vscode/settings.json` in your project:

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

</details>

<details>
<summary><b>Cline</b></summary>

Open **Cline → MCP Servers → Configure**, then add:

```json
{
"mcpServers": {
"eth-labels": {
"command": "npx",
"args": ["-y", "eth-labels-mcp"]
}
}
}
```

</details>

### Verify it works

Once configured, ask your AI:

```
Search for "uniswap" addresses
```

If it returns labeled Uniswap addresses — you're in. 🎉

### Tools

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

### Example

Expand Down