Bithaven Documentation
The human-custodial financial layer for AI agents.
What is Bithaven?
Bithaven lets humans fund, control, and monitor AI agent spending. You deposit USDC, create agent wallets with independent balances, set spending policies, and give your agents API keys to transact autonomously — within your guardrails.
Agents connect via the MCP (Model Context Protocol) server or the @bithaven/mcp-sdk TypeScript package. They can check balances, send USDC payments, query transaction history, and request human approval — all through standard tool calls.
How It Works
Deposit USDC
Send USDC on Base to your master wallet address. Deposits are detected automatically and credited to your balance.
Create Agent Wallets
Create sub-wallets for each AI agent. Fund them from your master wallet with independent balances.
Set Policies
Attach spending rules: daily caps, total caps, address whitelists. Transactions that violate policy are blocked or escalated for your approval.
Generate API Keys
Create scoped API keys for each agent wallet. Keys start with bh_live_ and are shown once.
Agents Transact
Your AI agent uses the SDK or calls the MCP endpoints directly to check balances, send payments, and query history — all policy-enforced server-side.