# Purple Flea

> AI-first infrastructure for autonomous agents. Tools that AI agents use, not humans.

Purple Flea builds APIs, SDKs, and MCP servers designed for AI agents to consume directly. No dashboards, no UIs — just programmable infrastructure for machine autonomy.

Website: https://purpleflea.com
GitHub: https://github.com/purpleflea
Contact: hello@purpleflea.com

## Products

### Agent Casino
Provably fair gambling API for AI agents.

### Burner Identity
Disposable email and phone numbers for AI agents.

## MCP Tools

### Agent Casino Tools

- `casino_flip`: Execute a provably fair coin flip bet. Parameters: `wager` (float), `currency` (string: ETH|BTC|USDC|SOL), `side` (string: heads|tails). Returns: `result`, `payout`, `proof_hash`, `server_seed`, `client_seed`.

- `casino_dice`: Roll provably fair dice with custom sides. Parameters: `wager` (float), `currency` (string), `sides` (int: 2-100), `target` (string: over|under|exact), `target_value` (int). Returns: `roll`, `result`, `payout`, `proof_hash`.

- `casino_custom_bet`: Create a bet with custom odds. Parameters: `wager` (float), `currency` (string), `odds` (float), `probability` (float). Returns: `outcome` (bool), `payout`, `proof_hash`.

- `casino_kelly_bet`: Calculate optimal bet size using the Kelly Criterion. Parameters: `bankroll` (float), `edge` (float), `odds` (float), `fraction` (float, optional, default: 1.0). Returns: `optimal_wager`, `expected_value`, `risk_of_ruin`.

- `casino_verify_proof`: Independently verify the fairness of any past bet. Parameters: `bet_id` (string), `server_seed` (string), `client_seed` (string), `nonce` (int). Returns: `valid` (bool), `expected_outcome`, `actual_outcome`.

- `casino_get_balance`: Check agent wallet balance. Parameters: `currency` (string, optional). Returns: `balances` (object).

- `casino_deposit`: Generate a deposit address for funding the agent wallet. Parameters: `currency` (string). Returns: `address`, `memo` (if applicable), `min_deposit`.

- `casino_withdraw`: Withdraw funds to an external wallet. Parameters: `amount` (float), `currency` (string), `address` (string). Returns: `tx_hash`, `status`, `estimated_confirmation`.

- `casino_history`: Retrieve past bet history with outcomes and proofs. Parameters: `limit` (int, optional, default: 50), `offset` (int, optional), `currency` (string, optional). Returns: `bets[]` (array of bet objects with full proof data).

### Burner Identity Tools

- `burner_create`: Create a new disposable identity with email and/or phone number. Parameters: `email` (bool), `phone` (string: country code, e.g., "US", "UK", "DE"), `ttl` (int: seconds until auto-destruction, default: 3600). Returns: `identity_id`, `email` (string|null), `phone` (string|null), `expires_at`.

- `burner_get_inbox`: Retrieve all emails received at a burner email address. Parameters: `identity_id` (string), `limit` (int, optional, default: 20). Returns: `messages[]` (array of `{from, subject, body, received_at}`).

- `burner_get_sms`: Retrieve all SMS messages received at a burner phone number. Parameters: `identity_id` (string), `limit` (int, optional, default: 20). Returns: `messages[]` (array of `{from, body, received_at}`).

- `burner_wait_for_otp`: Wait for and auto-extract a verification code from incoming email or SMS. Parameters: `identity_id` (string), `timeout` (int: seconds, default: 30), `source` (string: email|sms|any, default: any). Returns: `code` (string), `source` (string: email|sms), `raw_message` (string).

- `burner_extend`: Extend the TTL of an existing burner identity. Parameters: `identity_id` (string), `additional_ttl` (int: seconds). Returns: `new_expires_at`.

- `burner_destroy`: Immediately destroy a burner identity and all associated data. Parameters: `identity_id` (string). Returns: `destroyed` (bool), `messages_purged` (int).

- `burner_list`: List all active burner identities for the current API key. Parameters: `status` (string: active|expired|all, default: active). Returns: `identities[]` (array of identity objects).

## Authentication

All API calls require an API key passed via the `Authorization` header:
```
Authorization: Bearer sk_live_...
```

API keys can be created programmatically via the `/v1/keys` endpoint.

## SDKs

- Python: `pip install purpleflea`
- Node.js: `npm install @purpleflea/sdk`
- MCP Server: `npx @purpleflea/mcp`

## Rate Limits

- Free tier: 100 requests/minute
- Pro tier: 10,000 requests/minute
- Enterprise: Unlimited

## Base URL

```
https://api.purpleflea.com/v1
```