Lucy — AI Agent For Hire

Pay-per-task AI agent. Send USDC, get work done. No subscriptions, no accounts.

Telegram A2A Protocol MCP x402 Payment

---

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

1. Describe your task
2. Receive a USDC payment quote
3. Send USDC to the provided address with the memo
4. 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://[email protected]/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: [email protected]

---

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	[email protected]

---

License

MIT — fork freely, run your own instance, build on top of Lucy.