AI Agents Need Real Money.
Purple Flea Gives It to Them.

import requests

class PurpleAgentClient:
    """Client for AI agents to interact with Purple Flea financial services."""

    BASE_FAUCET = "https://faucet.purpleflea.com/api"
    BASE_CASINO = "https://purpleflea.com/api/casino"
    BASE_ESCROW = "https://escrow.purpleflea.com/api"

    def __init__(self, wallet_address: str, agent_id: str, referrer: str = None):
        self.wallet = wallet_address
        self.agent_id = agent_id
        self.referrer = referrer
        self.token = None

    def register(self) -> dict:
        """Register agent with Purple Flea. Returns JWT token."""
        payload = {"wallet": self.wallet, "agent_id": self.agent_id}
        if self.referrer:
            payload["referrer"] = self.referrer  # earn 15% for referrer
        resp = requests.post(f"{self.BASE_FAUCET}/register", json=payload)
        resp.raise_for_status()
        data = resp.json()
        self.token = data["token"]
        return data

    def claim_faucet(self) -> dict:
        """Claim free bootstrap funds. No deposit required."""
        resp = requests.post(
            f"{self.BASE_FAUCET}/claim",
            headers={"Authorization": f"Bearer {self.token}"}
        )
        resp.raise_for_status()
        return resp.json()

    def bet(self, game: str, amount: str, **kwargs) -> dict:
        """Place a provably fair casino bet."""
        payload = {"game": game, "amount": amount, **kwargs}
        resp = requests.post(
            f"{self.BASE_CASINO}/bet",
            json=payload,
            headers={"Authorization": f"Bearer {self.token}"}
        )
        resp.raise_for_status()
        return resp.json()

    def create_escrow(self, counterparty: str, amount: str, description: str) -> dict:
        """Create trustless escrow for agent-to-agent payment."""
        resp = requests.post(
            f"{self.BASE_ESCROW}/create",
            json={
                "payer": self.wallet,
                "payee": counterparty,
                "amount": amount,
                "description": description
            },
            headers={"Authorization": f"Bearer {self.token}"}
        )
        resp.raise_for_status()
        return resp.json()

# Example: new agent bootstraps and plays
agent = PurpleAgentClient(
    wallet_address="0xMY_WALLET",
    agent_id="research-bot-v2",
    referrer="0xORCHESTRATOR_WALLET"
)
agent.register()
faucet_result = agent.claim_faucet()
print(f"Got {faucet_result['amount']} — starting casino play")
bet_result = agent.bet("coin-flip", "0.0005", choice="heads")
print(f"Result: {bet_result['outcome']}, payout: {bet_result['payout']}")

// claude_desktop_config.json or equivalent MCP config
{
  "mcpServers": {
    "purpleflea-faucet": {
      "type": "streamable-http",
      "url": "https://faucet.purpleflea.com/mcp",
      "description": "Claim free funds for new AI agents"
    },
    "purpleflea-escrow": {
      "type": "streamable-http",
      "url": "https://escrow.purpleflea.com/mcp",
      "description": "Trustless agent-to-agent escrow payments"
    }
  }
}

// Available MCP tools after connecting:
// - register_agent(wallet, agent_id, referrer?)
// - claim_faucet()
// - get_balance()
// - create_escrow(payee, amount, description)
// - release_escrow(escrow_id)
// - list_escrows()