diff --git a/readme.md b/readme.md
index fc96619e..d12d43a7 100644
--- a/readme.md
+++ b/readme.md
@@ -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.
+
+
+Claude Code
+
```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`:
+
+
+
+Claude Desktop
+
+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.
+
+
+
+
+Cursor
+
+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"]
+ }
+ }
+}
+```
+
+
+
+
+Windsurf
+
+Add to `~/.codeium/windsurf/mcp_config.json`:
+
+```json
+{
+ "mcpServers": {
+ "eth-labels": {
+ "command": "npx",
+ "args": ["-y", "eth-labels-mcp"]
+ }
+ }
+}
+```
+
+
+
+
+VS Code (GitHub Copilot)
+
+Add to `.vscode/settings.json` in your project:
+
+```json
+{
+ "mcp": {
+ "servers": {
+ "eth-labels": {
+ "command": "npx",
+ "args": ["-y", "eth-labels-mcp"]
+ }
+ }
+ }
+}
+```
+
+
+
+
+Cline
+
+Open **Cline → MCP Servers → Configure**, then add:
+
+```json
+{
+ "mcpServers": {
+ "eth-labels": {
+ "command": "npx",
+ "args": ["-y", "eth-labels-mcp"]
+ }
+ }
+}
+```
+
+
+
+### 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