About Bluepages MCP
Bluepages MCP is an MCP server in the Social category: mCP server for Bluepages.fyi — look up Twitter/Farcaster identities for 800k+ Ethereum addresses.
Install
git clone https://github.com/bluepagesdoteth/bluepages-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (13)
batch_check40 credits ($0.04)
Parameters not published.
batch_check_streamingsame as batch_check
Parameters not published.
batch_get_data40 credits/found item
Parameters not published.
batch_get_data_streamingsame as batch_get_data
Parameters not published.
check_address1 credit ($0.001)
Parameters not published.
check_creditsfree
Parameters not published.
check_identity1 credit ($0.001)
Parameters not published.
get_api_keyfree
Parameters not published.
get_data_for_address50 credits ($0.05)
Parameters not published.
get_data_for_identity50 credits ($0.05)
Parameters not published.
Show all 13 tools
purchase_credits$5-$600 USDC
Parameters not published.
search_tweets50 credits ($0.05)
Parameters not published.
set_credit_alertfree
Parameters not published.
Ask AI
Ask AI about Bluepages MCP
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
README
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
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.