Pay-per-task AI agent. Send USDC, get work done. No subscriptions, no accounts.
What Lucy Does
Lucy is an autonomous AI micro-task agent. Give her a task, pay a small USDC fee, get back professional results. She works for both humans (via Telegram) and other agents (via A2A / MCP / x402).
Task Types & Pricing
| Task Type | Simple | Standard | Complex |
|---|---|---|---|
| Writing & editing | $0.50 | $1.00 | $3.00 |
| Research & analysis | $1.00 | $2.50 | $5.00 |
| Code & automation | $1.50 | $3.00 | $8.00 |
| File processing | $0.50 | $1.50 | $4.00 |
| DeFi & blockchain | $2.00 | $4.00 | $10.00 |
| Agent orchestration | $0.25 | $0.75 | $2.00 |
Payment accepted in USDC on Base L2 or Solana.
Channels
For Humans — Telegram
Chat directly with Lucy: @LucyAgentic_bot
- Describe your task
- Receive a USDC payment quote
- Send USDC to the provided address with the memo
- Lucy completes the task and sends results back
For Agents — A2A Protocol
Lucy is a fully compliant A2A agent. Discover her capabilities at:
GET /.well-known/agent.json
Submit a task:
curl -X POST https://lucyagentics@agentmail.to/a2a/task \ -H "Content-Type: application/json" \ -d '{"task": "Research the top 5 DeFi protocols by TVL", "agent_id": "your-agent-id"}'
Response:
{
"status": "quoted",
"task_id": "abc123",
"task_type": "research",
"price_usdc": 2.50,
"payment": {
"chain": "base",
"token": "USDC",
"address": "0x29Ee1f2fBD7EB8809350Fa0c42Ad55010e36CaC0",
"memo": "TASK-abc123"
}
}Poll for result:
curl https://your-lucy-url/a2a/task/abc123
For Agents — MCP Protocol
{
"mcpUrl": "https://your-lucy-url/mcp/tools",
"tools": ["submit_task", "get_task", "list_capabilities"]
}For Agents — x402 (HTTP 402 Pay-per-call)
curl -X POST https://your-lucy-url/x402/task \ -H "Content-Type: application/json" \ -H "X-Payment: <USDC-payment-proof>" \ -d '{"task": "Write a product description for my NFT collection"}'
Via Agentmail
Send task emails to: lucyagentics@agentmail.to
Payment Details
| Network | Address | Token |
|---|---|---|
| Base L2 | 0x29Ee1f2fBD7EB8809350Fa0c42Ad55010e36CaC0 |
USDC |
| Solana | H4Tcv1pEVYaJawAmnrXSwtegs2nrW1bFzyoMepvsPENL |
USDC |
Always include the payment memo from the task quote — this is how Lucy matches payments to tasks.
Running Lucy Yourself
git clone https://github.com/Woodman97/lucy-agent cd lucy-agent pip install -r agent_service/requirements.txt cp agent_service/.env.template agent_service/.env # Fill in your API keys in .env python start_lucy.py
start_lucy.py automatically:
- Starts a Cloudflare tunnel (free public HTTPS URL)
- Writes the live URL to
.env - Starts the FastAPI server
- Registers with agent directories
Architecture
Lucy Agent
├── channels/
│ ├── a2a.py # A2A REST + MCP endpoints
│ ├── telegram_bot.py # Telegram human interface
│ └── agentmail.py # Agentmail agent-to-agent email
├── x402.py # HTTP 402 pay-per-call
├── classifier.py # Task type + pricing engine
├── executor.py # Claude-powered task runner
├── payment.py # USDC verifier (Base + Solana)
├── database.py # SQLite task store
└── auto_register.py # Startup directory registration
Protocols Supported
| Protocol | Description | Endpoint |
|---|---|---|
| A2A | Agent-to-Agent REST | /a2a/task |
| MCP | Model Context Protocol | /mcp/tools, /mcp/call_tool |
| x402 | HTTP 402 USDC payment | /x402/task |
| Agentmail | Agent email protocol | lucyagentics@agentmail.to |
License
MIT — fork freely, run your own instance, build on top of Lucy.