# botwallet-co/mcp [Health: Active]

**Category:** 💰 Finance & Fintech  
**Repository:** https://github.com/botwallet-co/mcp  
**GitHub Stars:** 3  
**npm Downloads (last month):** 72  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/botwallet-co-mcp

## Description
Wallet for AI agents. Earn via invoices, spend on other agents and paid APIs, manage USDC on Solana with human-set spending limits and FROST 2-of-2 threshold signing.

## Tools
Capabilities this server exposes over MCP:

- **botwallet_ping** — Check API connectivity
- **botwallet_register** — Create a new wallet (FROST key generation)
- **botwallet_info** — Wallet metadata and status
- **botwallet_balance** — On-chain balance and remaining budget
- **botwallet_update_owner** — Set owner email
- **botwallet_rename** — Change display name
- **botwallet_wallet_list** — List local wallets
- **botwallet_wallet_use** — Switch active wallet
- **botwallet_lookup** — Check if a recipient exists
- **botwallet_can_i_afford** — Pre-flight check before paying
- **botwallet_pay** — Pay someone (auto-signs if within limits)
- **botwallet_confirm_payment** — Complete a payment after owner approval
- **botwallet_list_payments** — List outgoing payments
- **botwallet_cancel_payment** — Cancel a pending payment
- **botwallet_create_paylink** — Create a payment request or invoice
- **botwallet_send_paylink** — Send a paylink via email or bot inbox
- **botwallet_get_paylink** — Check paylink status
- **botwallet_list_paylinks** — List your paylinks
- **botwallet_cancel_paylink** — Cancel a pending paylink
- **botwallet_get_deposit_address** — Get the USDC deposit address
- **botwallet_request_funds** — Ask the human owner for funds
- **botwallet_list_fund_requests** — List past fund requests
- **botwallet_withdraw** — Withdraw USDC to an external Solana address
- **botwallet_confirm_withdrawal** — Complete a withdrawal after approval
- **botwallet_get_withdrawal** — Check withdrawal status
- **botwallet_x402_discover** — Search for paid APIs
- **botwallet_x402_fetch** — Probe a URL for payment requirements
- **botwallet_x402_pay_and_fetch** — Pay and retrieve content from an x402 API
- **botwallet_transactions** — Full transaction ledger
- **botwallet_my_limits** — View spending limits set by the owner
- **botwallet_pending_approvals** — List actions waiting for approval
- **botwallet_approval_status** — Check a specific approval
- **botwallet_events** — Wallet notifications
- **botwallet_wallet_export** — Export wallet to an encrypted .bwlt file
- **botwallet_wallet_import** — Import wallet from a .bwlt file
- **botwallet_wallet_backup** — Reveal the mnemonic backup phrase

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

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

## Documentation

## What botwallet-co/mcp does

The botwallet-co/mcp MCP server exposes wallet and payment operations to an AI agent through MCP. Agents can register or select a local wallet, inspect its status and balance, check spending limits, look up recipients, and review transaction history. The wallet uses USDC on Solana.

Payment workflows cover direct transfers, affordability checks, pending-payment cancellation, and owner-approved payments. Agents can also create invoices or payment requests as paylinks, send them through email or a bot inbox, and check or cancel their status. Funding tools provide a deposit address and let the agent request funds from its human owner. Withdrawals to external Solana addresses include a separate confirmation flow.

The server also supports x402 workflows: discovering paid APIs, checking a URL’s payment requirements, and paying for and retrieving content from an x402 endpoint.

## How it works

The botwallet-co/mcp MCP server runs on the agent’s machine and communicates with MCP clients through stdio using JSON-RPC. It calls the Botwallet API for co-signing and submits completed transactions to Solana. Local wallet data includes configuration under `~/.botwallet/` and agent-held seed shares under `~/.botwallet/seeds/`.

Wallet creation uses FROST 2-of-2 threshold signing. One key share remains local to the agent and the other is held by Botwallet; the complete private key is not assembled in one location. Transactions require both parties to co-sign. Spending rules are enforced server-side, and transactions outside the automatic approval threshold are sent to the human owner for approval.

## Setup and configuration

The botwallet-co/mcp MCP server can be added to an MCP client with the following stdio configuration:

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

The README specifically documents configuration for Claude Desktop, Cursor, Windsurf, and Cline. It also supports a global npm installation, after which `botwallet-mcp` is used as the command. The server reads `~/.botwallet/config.json`, which is shared with the Botwallet CLI.

`BOTWALLET_API_KEY` can provide an API key instead of configuration-file credentials. `BOTWALLET_WALLET` selects a wallet when several are present, and `BOTWALLET_BASE_URL` overrides the default API endpoint. The README marks all three environment variables as optional.

## Tools and capabilities

Capabilities include:

- Registering, listing, selecting, renaming, and inspecting wallets
- Checking balances, budgets, limits, connectivity, and recipient availability
- Paying recipients, handling approval-required payments, and reviewing payment history
- Creating, sending, checking, listing, and cancelling paylinks
- Getting deposit addresses and requesting funds from the owner
- Withdrawing USDC and completing approval-based withdrawals
- Discovering and paying for x402 APIs
- Viewing transactions, pending approvals, approval status, and wallet events
- Exporting, importing, and backing up wallet data

The server also exposes a `botwallet://status` resource containing a wallet summary with balance, budget, and seed-file status.

## Limitations and notes

The agent cannot bypass spending limits, and larger transactions require owner approval. Local key shares are intended to remain on the agent machine and are not sent over the network. The server depends on the Botwallet API for its co-signing flow and on Solana for on-chain transactions.

Wallet files are interoperable with the Botwallet CLI. The two tools share configuration and seed locations, and encrypted `.bwlt` exports can be exchanged between them. The README does not state service pricing or availability guarantees, so those details should be confirmed separately.

## Getting started with this botwallet-co/mcp MCP server
Always refer to the official documentation for the most accurate and up-to-date information.

_Full upstream README: https://allmcps.com/mcp/botwallet-co-mcp/readme_