three.ws Vanity — Claude Code MCP server: features and setup
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.
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-mcpWhat three.ws Vanity 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.
What it helps with
- 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 for the agent
- 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.
How to install three.ws Vanity
Platform CLI
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-mcpReplace <…> with your own values
Platform CLI
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-mcpReplace <…> with your own values
Config file
{
"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
Config file
{
"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
Platform CLI
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-mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about three.ws Vanity
How do I install three.ws Vanity in Claude Code?
Run claude mcp add vanity-mcp -- npx -y @three-ws/vanity-mcp. The server requires Node.js >= 20 and network access.
What does three.ws Vanity do?
It gives an agent read access to Solana vanity-market data, including pattern estimates, address rarity, bounty listings, statistics, rankings, and a gallery.
Can I post or claim a bounty through this MCP server?
No. Its tools are read-only; posting and claiming are paid write operations on the HTTP API.
