Bluepages
Skill bluepagesdoteth/agent-plugins/plugins/bluepages/skills/bluepages
Look up wallet <> social identity and label mappings via Bluepages.fyi. Use when asked who owns a crypto address, finding wallets for a social handle, identifying CEX/exchange wallets, or searching tweets mentioning an address.From its SKILL.md
npx -y skills add bluepagesdoteth/agent-plugins --skill bluepagesAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
3 things to look at
- reads credentialsReads from 2 credential sources: `BLUEPAGES_API_KEY` and 1 more.
- 1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
- fetches URLsInstructs the agent to fetch 1 URL, including https://bluepages.fyi.
SKILL.md
3.4 KB, 697 tokens by cl100k_base, as published. Nobody here has run it
Bluepages
Address <> identity + label lookups across ETH, BTC, SOL, TRON, XMR, TON, Celestia, and XRP.
Lookup strategy
The optimal workflow depends on the payment method:
API key users (per-result pricing)
Data endpoints only charge when data is found — call them directly, no check step needed.
- Single:
get_data_for_addressorget_data_for_identity. - Batch:
batch_get_data(up to 50 items). - Lists > 50:
batch_get_data_streamingfor automatic batching with progress.
x402 users (flat pricing per request)
Data requests charge a flat fee regardless of results — check first to filter.
- Single:
check_address/check_identity($0.001) →get_data_for_*($0.05) only if found. - Batch:
batch_check($0.04) →batch_get_data($2.00) on found items only. - Lists > 50:
batch_check_streaming→batch_get_data_streamingon found items.
No data? Try search_tweets — finds tweet mentions even when no identity record exists.
Tools
| Tool | Cost | Returns |
|---|---|---|
check_address | 1 credit | Whether address has data |
check_identity | 1 credit | Whether identity has data |
get_data_for_address | 50 (free if not found) | Identities, labels, sanctions, clusters |
get_data_for_identity | 50 (free if not found) | Addresses, labels, sanctions, clusters |
search_tweets | 50 (always charged) | Tweets mentioning the address |
batch_check | 40/batch | Which items have data |
batch_get_data | 40/found item | Full data, up to 50 items |
batch_check_streaming and batch_get_data_streaming exist for lists > 50.
Account tools (discoverable via MCP): check_credits, set_credit_alert, get_api_key, purchase_credits.
Supported inputs
Addresses: ETH, BTC (bech32 + base58), SOL, TRON, XMR, TON, Celestia, XRP — validated by the server.
Identities: twitter, farcaster, github, discord, telegram, email, linkedin, reddit, instagram, facebook, atproto, circles, ens, phone, name.
Authentication
BLUEPAGES_API_KEY— 20% cheaper, 2x rate limits. Get at bluepages.fyi/api-keys.PRIVATE_KEY— x402 pay-per-request (USDC on Base). Can also purchase an API key viaget_api_key+purchase_credits.
HTTP fallback
If MCP tools are unavailable, call https://bluepages.fyi directly with X-API-KEY header. Full docs: bluepages.fyi/docs
What ships with it
Read from the repository
Just SKILL.md. No reference files, no scripts.