Getting Started with BotWallet

[kasrazunnaiyyer]

This guide walks you through creating your first BotWallet and making a payment. Takes about 3 minutes.

Option 1: CLI

Install the CLI and create a wallet:

npm install -g @botwallet/agent-cli
botwallet register --name "My Agent" --owner you@email.com

This runs a FROST key generation ceremony. Your agent's key share (S1) is saved locally at ~/.botwallet/seeds/. The server's share (S2) stays encrypted on BotWallet's server. The full private key never exists.

Check your wallet:

botwallet wallet balance
botwallet wallet deposit  # Get your Solana USDC deposit address

Earn money

Create an invoice and send it to someone:

botwallet paylink create 25.00 --desc "Research report"
botwallet paylink send <request_id> --to client@example.com

When they pay (by card or crypto), the USDC lands in your agent's wallet.

Spend money

Pay another agent or merchant:

botwallet pay @recipient 10.00
botwallet pay confirm <transaction_id>  # FROST co-signs and submits

If the amount exceeds your guard rails, it pauses for human approval.

Access paid APIs (x402)

Browse and pay for APIs on the fly:

botwallet x402 discover "weather"
botwallet x402 fetch https://api.example.com/forecast
botwallet x402 fetch confirm <fetch_id>

Request more funds

When the wallet runs low:

botwallet fund 50.00 --reason "API costs for the week"

Your human owner gets notified and can approve from the dashboard.

---

Option 2: MCP (Claude Desktop, Cursor, Windsurf, Cline)

Add this to your MCP client config:

{
  "mcpServers": {
    "botwallet": {
      "command": "npx",
      "args": ["-y", "@botwallet/mcp"]
    }
  }
}

Restart your client, then tell your agent:

"Create a BotWallet for yourself."

The agent runs botwallet_register, generates a key share locally, and comes back with a deposit address. From there, everything works through natural language:

"Send $5 to @acme-bot for the data report"

"Create an invoice for $25 for the consulting session"

"Find a speech-to-text API and use it"

The MCP server exposes 36 tools covering wallet management, payments, invoicing, x402 API access, guard rails, and more.

---

Set up guard rails

Visit app.botwallet.co to:

• Set per-transaction and daily spending limits
• Create merchant allowlists
• Configure approval thresholds
• Monitor all activity in real time

---

Useful links

• Full documentation
• CLI reference
• MCP server
• Cursor plugin
• Pricing

Questions? Open a discussion here or reach out on Twitter/X.