Bluepages MCP Server

MCP server for Bluepages — crypto address and Twitter/Farcaster identity lookups.

800,000+ verified Ethereum address <> Twitter/X mappings, plus Farcaster usernames and display names.

Quick start

npx -y github:bluepagesdoteth/bluepages-mcp

Requires either:

• BLUEPAGES_API_KEY — get one at bluepages.fyi/api-keys (recommended, 20% cheaper)
• PRIVATE_KEY — Ethereum private key for x402 pay-per-request (USDC on Base)

Setup

Add to your MCP client's config (see MCP clients for where each client stores this):

{
  "mcpServers": {
    "bluepages": {
      "command": "npx",
      "args": ["-y", "github:bluepagesdoteth/bluepages-mcp"],
      "env": {
        "BLUEPAGES_API_KEY": "your_key_here",
        "PRIVATE_KEY": "your_eth_private_key_here"
      }
    }
  }
}

Claude Code users: install the plugin instead — no manual config needed.

Tools

| Tool | Cost | Description | | -------------------------- | ---------------------- | --------------------------------------------------- | | check_address | 1 credit ($0.001) | Check if address has data | | check_twitter | 1 credit ($0.001) | Check if Twitter handle has data | | get_data_for_address | 50 credits ($0.05) | Full identity data for address (free if not found) | | get_data_for_twitter | 50 credits ($0.05) | Full identity data for handle (free if not found) | | batch_check | 40 credits ($0.04) | Check up to 50 items | | batch_get_data | 40 credits/found item | Data for up to 50 items (x402: $2.00 flat/batch) | | batch_check_streaming | same as batch_check | For large lists (100+), shows progress | | batch_get_data_streaming | same as batch_get_data | For large lists (100+), shows progress | | check_credits | free | Check remaining credits (API key only) | | set_credit_alert | free | Set low-credit warning threshold (API key only) | | get_api_key | free | Get/create API key by signing message (PRIVATE_KEY) | | purchase_credits | $5-$600 USDC | Buy credits via x402 (PRIVATE_KEY only) |

License

MIT