# ClawBank

> Programmable AI agent wallets on Solana. Create isolated wallets for AI agents with API key auth, spend limits, and full audit trails.

ClawBank lets you provision a Solana wallet for each AI agent you run. Every wallet gets its own API key. Agents can check their balance and send SOL autonomously. Humans keep control via per-transaction and daily spend limits set in the dashboard.

## Who is this for

- AI agent developers who need their agents to pay for things on-chain
- AI coding tools (Claude Code, Cursor, Grok Build, Codex) building apps that need on-chain payments
- Automation builders (n8n, Zapier, Make) bridging Web2 workflows with Solana
- LLM orchestration frameworks (LangChain, CrewAI) needing a payment primitive
- Any software that needs to send SOL without a full wallet library

## Quick start

1. Sign up at https://clawbank.to
2. Create an agent — you receive a Solana wallet address and an API key
3. Fund the wallet by sending SOL to the provided address
4. Call the API with `Authorization: Bearer <api_key>`

## MCP server (Claude Desktop)

```json
{
  "mcpServers": {
    "clawbank": {
      "command": "npx",
      "args": ["-y", "@clawbank/mcp-server"],
      "env": { "CLAWBANK_API_KEY": "cb_your_key_here" }
    }
  }
}
```

Available MCP tools: `check_balance`, `send_sol`, `health_check`

## Agent API (Bearer token)

Base URL: https://clawbank.to/api

GET  /api/agent/balance
  → { data: { wallet_address, balance_sol, balance_lamports } }

POST /api/agent/transact
  Body: { to: string, amount_sol: number, memo?: string }
  → { data: { signature, amount_sol, fee_sol, to, explorer_url } }
  Note: 0.5% platform fee is deducted from amount_sol

## Management API (session / cookie auth)

GET    /api/agents                      — list your agents
POST   /api/agents                      — create agent { name, description? }
GET    /api/agents/:id                  — agent details
PATCH  /api/agents/:id                  — update name, description, limits, status
DELETE /api/agents/:id                  — deactivate agent
GET    /api/agents/:id/balance          — on-chain balance for a specific agent
GET    /api/agents/:id/transactions     — transaction history (limit, offset params)
POST   /api/agent/withdraw              — withdraw from agent to user wallet

## Health

GET /api/health → { status, timestamp, solana: { status, latency_ms }, network }

## Constraints

- Runs on Solana mainnet-beta
- Transactions are simulated before broadcast — insufficient balance fails fast
- max amount_sol per transact call: 1000 SOL
- max amount_sol per withdraw call: 10000 SOL
- API key is shown once at agent creation — store it securely

## Machine-readable spec

Full OpenAPI 3.0 spec: https://clawbank.to/openapi.json
Interactive API docs: https://clawbank.to/api-docs