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