@purpleflea/identity-mcp

MCP server for Purple Flea Identity — disposable email & phone numbers for AI agents.

Purple Flea is blue chip infrastructure for autonomous AI agents. Create disposable email addresses and rent real phone numbers on demand. OTP and verification codes are auto-extracted from incoming messages. Identities self-destruct after TTL expires.

Built on the Model Context Protocol (MCP), this package gives any MCP-compatible AI agent (Claude, GPT, Gemini, open-source) instant access to identity infrastructure.

Why Purple Flea?

• First mover in disposable identity infrastructure for AI agents

• Auto-extracts OTP codes from email and SMS — no regex needed

• Self-destructing identities — set TTL, forget about cleanup

• Real phone numbers in 6 countries (US, CA, GB, DE, FR, NL)

• One-call verification — wait_for_otp handles the entire flow

• 10% referral commission — agents earn passive income by referring other agents

• Crypto funding — deposit on Base, Ethereum, Solana, Bitcoin, Monero, and more

• Free tier — 5 emails/day, 2 SMS/day, 3 verifications/day, no payment required

Related MCP server: UnCorreoTemporal

Quick Start

Install via npx (no install needed)

npx @purpleflea/identity-mcp

Or install globally

npm install -g @purpleflea/identity-mcp

Claude Desktop Configuration

Add to your Claude Desktop claude_desktop_config.json:

{
  "mcpServers": {
    "purpleflea-identity": {
      "command": "npx",
      "args": ["-y", "@purpleflea/identity-mcp"],
      "env": {
        "PURPLE_FLEA_API_KEY": "your-api-key-here"
      }
    }
  }
}

Cursor / VS Code Configuration

Add to your MCP settings:

{
  "purpleflea-identity": {
    "command": "npx",
    "args": ["-y", "@purpleflea/identity-mcp"],
    "env": {
      "PURPLE_FLEA_API_KEY": "your-api-key-here"
    }
  }
}

Environment Variables

Tools

register

Register a new AI agent account. Returns API key, agent ID, and referral code. Call this first if you don't have an API key.

create_identity

Create a disposable email address or rent a real phone number.

Pricing:

• Email: $0.05 (or free, 5/day)

• Phone: $0.30 (10min) / $0.50 (1hr) / $1.00 (24hr) / $5.00 (30 days)

get_inbox

Check the email inbox. Returns all messages with auto-extracted verification codes.

get_sms

Check SMS inbox of a rented number. Returns messages with auto-extracted codes.

wait_for_otp

All-in-one verification. Creates a disposable email or rents a phone, waits for a verification code, and returns it. One tool call handles the entire flow.

Pricing: Email $0.10, SMS $0.50

poll_verification

Poll for the result of a pending wait_for_otp request (when called with wait=false).

extend_ttl

Update the webhook URL for a disposable email address.

destroy_identity

Immediately destroy a disposable email or release a rented phone number. All messages are permanently deleted.

list_identities

List all active (non-expired) identities.

referral_stats

View your referral program stats: referral code, referred agents, and total earnings.

No parameters required.

check_balance

Check account balance, tier, deposits, spending, and referral earnings.

No parameters required.

check_usage

Check today's API usage against tier limits.

No parameters required.

send_sms

Send an outbound SMS from a rented number. $0.02 per message.

get_deposit_address

Get a crypto deposit address to fund your account.

Referral Program

Earn 10% commission on all service fees from agents you refer. The commission is automatic — when a referred agent pays for any service, 10% is credited to your balance instantly.

1. Get your referral code from referral_stats or register

2. Share it with other agents

3. They register with register(referral_code="YOUR_CODE")

4. You earn 10% on everything they spend, forever

Example Workflows

Sign up for a service with email verification

1. create_identity(type="email")           → gets disposable address
2. [use the address to sign up for a service]
3. get_inbox(address="...", codes_only=true) → gets the OTP code
4. [enter the code to complete verification]
5. destroy_identity(type="email", identifier="...")

One-call verification (recommended)

1. wait_for_otp(method="email")  → creates address, waits, returns code
2. [enter the code]

SMS verification for a US service

1. create_identity(type="phone", country="US")  → gets phone number
2. [enter number on service]
3. get_sms(number="...", codes_only=true)        → gets OTP
4. destroy_identity(type="phone", identifier="...")

Pricing

License

MIT