three.ws Vanity

io.github.nirholasPublished by GitHub account nirholasv0.1.3Updated Oct 27, 2026

Read the three.ws vanity-address market: quote difficulty + USDC price, browse the board.

VerifiedSTDIODesktop onlyWeb Search & ScrapingFinance

Overview

AI-generated overview

Read-only MCP server for the three.ws Solana vanity-address bounty market: quote pattern difficulty and USDC prices, appraise addresses, browse the board.

What you can do
  • Quote a vanity pattern: expected attempts, rarity tier and suggested USDC bounty
  • Appraise any Solana address's rarity score, bits, tier and attempts
  • Browse the bounty board and the claimable open-bounty queue with filters and paging
  • Read live market stats, the top-grinder leaderboard and payout/asset config
  • Browse the proof-of-grind rarity gallery by tier, length or substring
When to use it
Useful when you want an assistant to price or compare Solana vanity-address patterns, judge how rare an address is, or survey the three.ws bounty market and gallery without leaving the chat. It is a read-only discovery surface, so it suits research and quoting rather than posting or claiming bounties.
Requirements
Node.js 20 or newer, run via npx or a local install over stdio. Network access to three.ws; the optional THREE_WS_BASE variable points at another base URL and THREE_WS_TIMEOUT_MS sets the per-request timeout. No API key, signer or payment is needed.
Before you install
All tools are read-only, so nothing can be posted, claimed or paid through this server. Requests go to the public three.ws API, so the patterns and addresses you query are sent to that third party. Pointing THREE_WS_BASE at a self-hosted or preview deployment sends your queries there instead.

Installation

In SourceWeft

  1. Open three.ws Vanity in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

[three.ws]

@three-ws/vanity-mcp

Read the three.ws vanity-address grind-bounty market + rarity gallery from any AI agent.

[npm] [license] [node] [MCP Registry] [three.ws]

A Model Context Protocol server that gives any AI assistant the read/discovery surface of the three.ws vanity-address grind-bounty market over stdio. Quote how hard a Solana vanity pattern is and what to escrow for it, appraise the rarity of any address, and browse the live bounty board, claimable queue, stats, leaderboard, config, and the proof-of-grind gallery.

The market is secret-blind: a requester escrows a USDC bounty for a pattern, a fleet of independent workers grinds it in parallel, and the first to submit a verified key matching the pattern is paid on-chain — yet the found secret is sealed to the requester, so the worker earns the bounty without ever seeing the wallet. Posting a bounty and claiming one are the x402-paid write paths on the HTTP API; this MCP exposes the read/discovery + rarity surface. No API key, no signer, no payment — every call hits the public /api/vanity endpoints.

Install

bash
npm install @three-ws/vanity-mcp

Or run with npx (no install):

bash
npx @three-ws/vanity-mcp

Quick start

Claude Code, one line:

bash
claude mcp add vanity -- npx -y @three-ws/vanity-mcp

Claude Desktop / Cursor (claude_desktop_config.json or mcp.json):

json
{	"mcpServers": {		"vanity": {			"command": "npx",			"args": ["-y", "@three-ws/vanity-mcp"]		}	}}

Inspect the surface with the MCP Inspector:

bash
npx -y @modelcontextprotocol/inspector npx @three-ws/vanity-mcp

Tools

ToolTypeWhat it does
vanity_quoteread-onlyPrice a pattern: expected attempts, rarity tier, and an honest suggested USDC bounty. Idempotent.
vanity_appraiseread-onlyAppraise any Solana address's rarity (pattern, score, bits, tier, attempts). Idempotent.
vanity_boardread-onlyBrowse the grind-bounty board — filter by status, sort by recency/reward/expiry, paginate.
vanity_openread-onlyList the claimable open-bounty queue workers poll.
vanity_statsread-onlyLive market totals: open count, USDC escrowed, USDC paid out.
vanity_leaderboardread-onlyTop grinders ranked by total USDC earned.
vanity_configread-onlyPayout availability + asset/network metadata (settlement asset, decimals, networks, pricing band).
vanity_galleryread-onlyBrowse the proof-of-grind rarity gallery — sort, filter by tier/length/substring, paginate.

vanity_quote and vanity_appraise are pure functions of their input (same pattern/address → same result), so they're marked idempotent. The other six read the live market and gallery.

Input parameters

vanity_quote — prefix (optional Base58 prefix), suffix (optional Base58 suffix), ignoreCase (bool, default false). At least one of prefix/suffix is required.

vanity_appraise — address (required, Base58 32–44 chars), prefixLen (int, optional), suffixLen (int, optional).

vanity_board — status (open | all | settled, default open), sort (recency | reward | expiry, default recency), limit (1–100, default 24), offset (default 0).

vanity_open — limit (1–100, default 30).

vanity_stats — no params.

vanity_leaderboard — limit (1–100, default 10).

vanity_config — no params.

vanity_gallery — sort (score | recency, default score), tier (string), minLength (int), contains (string), limit (1–100, default 24), offset (default 0).

Example

jsonc
// vanity_quote> { "prefix": "THREE" }{  "ok": true,  "pattern": { "prefix": "THREE", "suffix": null, "ignoreCase": false },  "difficulty": {    "expectedAttempts": 11308763834,    "rarityBits": 39,    "tier": "mythic",    "tierLabel": "Mythic",    "accent": "#ff5db1",    "expectedGrindSeconds": 7539  },  "oracle": {    "floorAtomics": 50000,    "suggestedAtomics": 2094216,    "generousAtomics": 5235540,    "maxAtomics": 5000000000,    "expectedAttempts": 11308763834,    "expectedGrindSeconds": 7539,    "model": "58^effectiveLength @ refRate"  },  "band": { "floorAtomics": 50000, "maxAtomics": 5000000000, "decimals": 6, "asset": "USDC" }}

Examples

Runnable examples live in examples/:

bash
node examples/list-tools.mjs           # every tool with its full input schemanode examples/quote-and-appraise.mjs   # config + quote + appraise + stats, live

Both spawn this server over stdio and read the live market. Every tool here is read-only, so nothing can be posted, claimed, or paid. See examples/README.md for expected output.

Requirements

  • Node.js >= 20.
  • Network access to https://three.ws (or your own THREE_WS_BASE).

Environment variables

VariableRequiredDefault
THREE_WS_BASEnohttps://three.ws
THREE_WS_TIMEOUT_MSno20000

Links

Part of the three.ws SDK suite — 3D AI agents, on-chain identity, and agent payments.
Website · Changelog · GitHub

Source: packages/vanity-mcp/README.md at commit c8f2cde

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

2
  1. v0.1.3LatestOct 10, 2026
  2. v0.1.2Sep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts