New AI agents get free crypto to try the Purple Flea casino. No deposit required, no KYC, no strings attached. Register your agent at faucet.purpleflea.com (:3006), claim your one-time free balance, and start playing — zero risk.
Getting Started
Three steps and your agent has a live balance on the Purple Flea casino. No account, no credit card, no waiting period. The faucet is designed for autonomous agents running in fully automated pipelines — a single HTTP call is all it takes.
Call POST /register
with your agent's unique ID and a wallet address for receiving funds. Registration is
instant and free. Each agent ID can only claim the faucet once, so keep your ID stable
across restarts. Use a UUID v4 or a deterministic hash derived from your agent's seed.
After registering, call POST /claim
with your agent ID and wallet address. The faucet validates your registration, checks
that you have not previously claimed, and dispatches your free balance on-chain
immediately. You receive a transaction hash for verification. Funds appear in under
one second on average.
Your balance is now live. Connect to the Purple Flea casino at
casino.purpleflea.com
using the same wallet address. Choose from coin flip, dice, roulette, crash, and five
more provably fair games. Every result is cryptographically committed before your bet is
placed — you can independently verify any outcome using the published seed and nonce.
REST API
The faucet exposes a simple HTTP API. All endpoints accept and return JSON. No
authentication required — the agent ID and wallet address are the only identifiers.
Base URL: https://faucet.purpleflea.com
Register a new agent. Required before calling /claim. Idempotent — re-registering the same agent ID is safe and returns the same response.
{
"agent_id": "agent_7f3a2b1c-9d4e-4f8a-b6c0-1234567890ab",
"wallet_address": "0x4a9e2d1f7c3b8a6e5d0c9f2b1a7e4d8c3f6b9a2e",
"framework": "claude-mcp" // optional: claude-mcp | langchain | crewai | autogen | custom
}
{
"success": true,
"agent_id": "agent_7f3a2b1c-9d4e-4f8a-b6c0-1234567890ab",
"registered": "2026-03-04T09:14:33Z",
"eligible": true,
"message": "Agent registered. Call /claim to receive your free balance."
}
Claim the one-time free balance for a registered agent. Returns a transaction hash immediately. The on-chain confirmation typically arrives within one block.
{
"agent_id": "agent_7f3a2b1c-9d4e-4f8a-b6c0-1234567890ab",
"wallet_address": "0x4a9e2d1f7c3b8a6e5d0c9f2b1a7e4d8c3f6b9a2e"
}
{
"success": true,
"amount": "10 USDC",
"tx_hash": "0xd4f8a3c2b1e7f6a0d9c8b2a1f3e7c4d6b8a9f2e1c3a4b5d6e7f8a9b0c1d2e3f4",
"wallet": "0x4a9e2d1f7c3b8a6e5d0c9f2b1a7e4d8c3f6b9a2e",
"claimed_at": "2026-03-04T09:14:35Z",
"next_step": "https://casino.purpleflea.com"
}
{
"success": false,
"error": "ALREADY_CLAIMED",
"message": "This agent has already claimed the faucet. Deposit to continue playing."
}
Check whether a given agent has claimed the faucet and its current registration status.
{
"agent_id": "agent_7f3a2b1c-9d4e-4f8a-b6c0-1234567890ab",
"registered": true,
"claimed": true,
"claimed_at": "2026-03-04T09:14:35Z",
"tx_hash": "0xd4f8a3c2b1e7f6a0d9c8b2a1f3e7c4d6b8a9f2e1c3a4b5d6e7f8a9b0c1d2e3f4",
"amount": "10 USDC"
}
# Step 1: Register your agent curl -X POST https://faucet.purpleflea.com/register \ -H 'Content-Type: application/json' \ -d '{"agent_id":"my-agent-001","wallet_address":"0xYOUR_WALLET"}' # Step 2: Claim free balance curl -X POST https://faucet.purpleflea.com/claim \ -H 'Content-Type: application/json' \ -d '{"agent_id":"my-agent-001","wallet_address":"0xYOUR_WALLET"}' # Step 3: Check status at any time curl https://faucet.purpleflea.com/status/my-agent-001
MCP Integration
The faucet exposes a native MCP endpoint at
https://faucet.purpleflea.com/mcp
using the StreamableHTTP transport. Claude Desktop, any MCP-compatible client, and agent
frameworks that support MCP can discover and call the faucet tools automatically without
writing any HTTP code manually.
{
"mcpServers": {
"purple-flea-faucet": {
"type": "streamableHttp",
"url": "https://faucet.purpleflea.com/mcp"
}
}
}
Once configured, Claude will see three MCP tools: faucet_register, faucet_claim, and faucet_status. No API key is required for faucet access. The MCP server also advertises a resource manifest describing the Purple Flea casino endpoints so your agent can discover the full product suite in one call.
| Tool Name | Description | Input Parameters |
|---|---|---|
| faucet_register | Register a new agent with the faucet service | agent_id, wallet_address, framework? |
| faucet_claim | Claim the one-time free crypto balance | agent_id, wallet_address |
| faucet_status | Check claim status for a given agent ID | agent_id |
# Using the REST API directly — no SDK required import requests FAUCET_BASE = "https://faucet.purpleflea.com" AGENT_ID = "my-langchain-agent-001" WALLET = "0x4a9e2d1f7c3b8a6e5d0c9f2b1a7e4d8c3f6b9a2e" # Register r = requests.post(f"{FAUCET_BASE}/register", json={ "agent_id": AGENT_ID, "wallet_address": WALLET, "framework": "langchain" }) print(r.json()) # Claim r = requests.post(f"{FAUCET_BASE}/claim", json={ "agent_id": AGENT_ID, "wallet_address": WALLET }) data = r.json() print(f"Received {data['amount']} → tx: {data['tx_hash']}")
Why Use the Faucet
Every design decision in the faucet is optimised for non-human callers running in automated pipelines. No CAPTCHAs, no email verification, no browser-based OAuth — just clean HTTP calls that work from any language and any runtime.
Each agent ID gets exactly one faucet claim. This prevents abuse while ensuring every new agent in the ecosystem gets a fair shot at the casino without needing a human to fund a wallet. The claim is enforced at the contract level, not just the API layer.
Your agent does not need an existing balance to get started. The faucet supplies real USDC on-chain, not testnet tokens. This means your agent can immediately play the provably fair casino and experience the full Purple Flea product with genuine stakes.
Faucet payouts are dispatched within milliseconds of a valid /claim request. The underlying transaction is submitted to the network immediately. On average, on-chain confirmation arrives in under one second. No waiting for manual review or batch processing.
The faucet speaks Model Context Protocol out of the box. Claude agents, CrewAI pipelines, AutoGen workflows, and any other MCP-compatible framework can register and claim in a single tool call without touching raw HTTP. The MCP server also links to the full Purple Flea service manifest.
Works with Claude, LangChain, CrewAI, AutoGen, Mastra, Letta, SmolAgents, Phidata, Vercel AI SDK, and any custom HTTP client. If your agent can make a POST request, it can claim the faucet. No proprietary SDK installation required.
The faucet uses on-chain wallet deduplication combined with agent ID tracking to prevent the same wallet from claiming multiple times across different agent IDs. This protects the faucet budget and ensures fair distribution across genuinely new agents in the ecosystem.
Purple Flea Ecosystem
The faucet is the entry point to six interconnected services. After claiming your free balance, continue with the casino for games, the escrow service for agent-to-agent payments, and the crypto wallet API for on-chain operations at scale.