# three.ws Vanity

Inspect the Solana vanity-address market from an AI agent: estimate a pattern’s difficulty and USDC bounty, rate an address, and browse listings. Handy for market research without leaving your coding assistant.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 249
- Author: nirholas
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/nirholas/three.ws/tree/HEAD/packages/vanity-mcp
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/threews-vanity

## What it does

The server exposes read access to three.ws vanity-address data. Ask it to estimate the effort behind a Solana address pattern and suggest a USDC bounty, assess an address’s rarity, or browse open bounties, the claimable queue, market figures, grinder rankings, and the proof gallery. Board and gallery results can be filtered, sorted, and paged.

Every tool is read-only. The server cannot post or claim a bounty, or make a payment; those write actions use the HTTP API. You need Node.js >= 20 and network access to reach the market. Without either, the server cannot connect. `THREE_WS_BASE` and `THREE_WS_TIMEOUT_MS` let you configure the endpoint and request timeout.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `THREE_WS_BASE`, `THREE_WS_TIMEOUT_MS` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env THREE_WS_BASE=<THREE_WS_BASE> --env THREE_WS_TIMEOUT_MS=<THREE_WS_TIMEOUT_MS> --transport stdio vanity-mcp -- npx -y @three-ws/vanity-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add vanity-mcp --env THREE_WS_BASE=<THREE_WS_BASE> --env THREE_WS_TIMEOUT_MS=<THREE_WS_TIMEOUT_MS> -- npx -y @three-ws/vanity-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "vanity-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@three-ws/vanity-mcp"
            ],
            "env": {
                "THREE_WS_BASE": "<THREE_WS_BASE>",
                "THREE_WS_TIMEOUT_MS": "<THREE_WS_TIMEOUT_MS>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "vanity-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@three-ws/vanity-mcp"
            ],
            "env": {
                "THREE_WS_BASE": "<THREE_WS_BASE>",
                "THREE_WS_TIMEOUT_MS": "<THREE_WS_TIMEOUT_MS>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e THREE_WS_BASE=<THREE_WS_BASE> -e THREE_WS_TIMEOUT_MS=<THREE_WS_TIMEOUT_MS> vanity-mcp npx -y @three-ws/vanity-mcp
```
Replace <…> with your own values

## When to use it
- estimate the effort for a vanity pattern
- get a suggested USDC bounty for a pattern
- check the rarity of a Solana address
- browse open bounties and the claimable queue
- filter gallery entries by rarity or substring

## Example prompts
- Estimate the difficulty and suggested USDC bounty for a Solana address starting with `THREE`.
- Assess the rarity of this Solana address and show its score.
- Show open bounties, sorted by reward.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

From the same set: [nirholas/three.ws](https://affpapa.org/en/nevibecode/by/nirholas/three.ws.md) — 43 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md