# Bvcc Agent Wallet

> Bvcc Agent Wallet is an MCP server for finance and payments. Non-custodial on-chain wallet tools for AI agents: balances, swaps, lending and liquidity. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Platforms:** CLI
- **Repository:** https://github.com/blockventurechaincapital-crypto/bvcc-agent-mcp
- **MCP Registry name:** com.blockventurechaincapital/bvcc-agent-wallet
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments)
- **Listing updated:** 2026-11-14

## About

This stdio server (npm package @bvcc/agent-mcp) lets Claude Code, Cursor or the Claude desktop app operate a BVCC Agent Wallet on-chain. Beyond balances and transfers it covers Uniswap v3 and v4 swaps, liquidity positions including native-ETH pools, and Aave v3 lending with guided unwinding of positions. Each tool is generated from the @bvcc/agent-sdk capability catalog.

Security rests on the wallet contract, not the server: spend caps, allowed tokens and protocols, a recipient whitelist and a global pause are enforced on-chain, so the worst a tool can do is bounded by what the owner authorized. The agent's private key stays in the environment and is used only to sign locally. Setting BVCC_MCP_READONLY=true exposes only read and simulate tools, and BVCC_MCP_MODULES can limit modules to core or aave.

The README notes a 0.15% BVCC agent fee charged on-chain on agent actions, separate from gas. Default chain is set by CHAIN_ID, with Arbitrum, BNB Chain, Ethereum, Base and Polygon listed. The Aave unwinding tools can send several transactions in one call, so the README advises running the matching plan tool first. Built-in operating guides are exposed as tools and prompts.

## Features

- **Swaps and transfers:** Send native or token amounts and swap on Uniswap v3 or v4, with dry-run tools first.
- **Uniswap liquidity:** Open, collect from and close v3 and v4 positions using price ranges.
- **Aave v3 lending:** Supply, borrow, repay and unwind positions with plan tools for review.
- **On-chain limits:** Spend caps, token and protocol allow-lists and a pause live in the wallet contract.
- **Read-only mode:** An environment flag removes every fund-moving tool.
- **Built-in guides:** listGuides and getGuide return playbooks for swaps, lending and liquidity.

## Good for

- Check an agent wallet's balances and remaining spend headroom
- Simulate a swap before sending it
- Provide Uniswap liquidity within a price range
- Lend or borrow on Aave and later close the position
- Run a read-only monitoring agent for a wallet

## Install

### Claude Code (Terminal)

```sh
claude mcp add bvcc-agent-wallet --env AGENT_PRIVATE_KEY='<AGENT_PRIVATE_KEY>' --env WALLET_ADDRESS='<WALLET_ADDRESS>' --env CHAIN_ID='<CHAIN_ID>' -- npx -y @bvcc/agent-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "bvcc-agent-wallet": {
      "command": "npx",
      "args": [
        "-y",
        "@bvcc/agent-mcp"
      ],
      "env": {
        "AGENT_PRIVATE_KEY": "<AGENT_PRIVATE_KEY>",
        "WALLET_ADDRESS": "<WALLET_ADDRESS>",
        "CHAIN_ID": "<CHAIN_ID>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "bvcc-agent-wallet": {
      "command": "npx",
      "args": [
        "-y",
        "@bvcc/agent-mcp"
      ],
      "env": {
        "AGENT_PRIVATE_KEY": "<AGENT_PRIVATE_KEY>",
        "WALLET_ADDRESS": "<WALLET_ADDRESS>",
        "CHAIN_ID": "<CHAIN_ID>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "bvcc-agent-wallet": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@bvcc/agent-mcp"
      ],
      "env": {
        "AGENT_PRIVATE_KEY": "<AGENT_PRIVATE_KEY>",
        "WALLET_ADDRESS": "<WALLET_ADDRESS>",
        "CHAIN_ID": "<CHAIN_ID>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "bvcc-agent-wallet": {
      "command": "npx",
      "args": [
        "-y",
        "@bvcc/agent-mcp"
      ],
      "env": {
        "AGENT_PRIVATE_KEY": "<AGENT_PRIVATE_KEY>",
        "WALLET_ADDRESS": "<WALLET_ADDRESS>",
        "CHAIN_ID": "<CHAIN_ID>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "bvcc-agent-wallet": {
      "command": "npx",
      "args": [
        "-y",
        "@bvcc/agent-mcp"
      ],
      "env": {
        "AGENT_PRIVATE_KEY": "<AGENT_PRIVATE_KEY>",
        "WALLET_ADDRESS": "<WALLET_ADDRESS>",
        "CHAIN_ID": "<CHAIN_ID>"
      }
    }
  }
}
```

## Tools

- `getAgentStatus`: Reports the agent's status and limits.
- `getCapabilities`: Lists what the wallet supports on the network.
- `getNativeBalance`: Reads the native coin balance.
- `getTokenBalances`: Reads token balances.
- `getRemaining`: Shows remaining spend headroom.
- `buildSwapPlan`: Plans a swap.
- `dryRunSwapV3`: Simulates a Uniswap v3 swap.
- `swapV3`: Swaps on Uniswap v3.
- `swapV4`: Swaps on Uniswap v4.
- `sendNative`: Sends the native coin.
- `sendToken`: Sends a token.
- `approve`: Approves a token allowance.
- `wrapNative`: Wraps ETH into WETH.
- `unwrapNative`: Unwraps WETH into ETH.
- `getAavePositions`: Reads Aave positions.
- `aaveSupply`: Supplies to Aave.
- `aaveBorrow`: Borrows on Aave.
- `aaveRepay`: Repays Aave debt.
- `aaveClosePosition`: Closes an Aave position in safe steps.
- `addLiquidityV3`: Opens a Uniswap v3 liquidity position.
- `addLiquidityV4`: Opens a Uniswap v4 liquidity position.
- `collectFeesV3`: Collects v3 position fees.
- `listGuides`: Lists the how-to guides.
- `getGuide`: Returns the playbook for one area.

## FAQ

### Does BVCC hold my private key?

No. The key is read from the environment, used locally to sign and never transmitted.

### Can I stop it from moving funds?

Yes. Set BVCC_MCP_READONLY=true to expose only read and simulate tools.

### Which chains are supported?

Arbitrum, BNB Chain, Ethereum, Base and Polygon, plus Arbitrum Sepolia for testing.

### Is there a fee?

The README says a 0.15% BVCC agent fee is charged on-chain on agent actions, separate from gas.

### What setup is required?

Create a wallet, authorize the agent on-chain, fund it with gas, then configure the environment, as the QUICKSTART describes.

### How do I add Bvcc Agent Wallet to Claude Code?

Run this command in your terminal: claude mcp add bvcc-agent-wallet --env AGENT_PRIVATE_KEY='<AGENT_PRIVATE_KEY>' --env WALLET_ADDRESS='<WALLET_ADDRESS>' --env CHAIN_ID='<CHAIN_ID>' -- npx -y @bvcc/agent-mcp

### What are the best alternatives to Bvcc Agent Wallet?

The closest alternatives to Bvcc Agent Wallet are Agent Wallet MCP, Universal Blockchain MCP, Cloud Wallet by Ekubo, Agentgates Wallet and MCP Agentic Wallet — open-source session management for x402.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Agent Wallet MCP](https://ai-powered.com/mcp/agent-wallet-mcp): Agent Wallet MCP is a paid MCP server for finance and payments.
- [Universal Blockchain MCP](https://ai-powered.com/mcp/universal-blockchain-mcp): Universal Blockchain MCP is an open-source MCP server for finance and payments.
- [Cloud Wallet by Ekubo](https://ai-powered.com/mcp/cloud-wallet-by-ekubo): Cloud Wallet by Ekubo is an MCP server for finance and payments.
- [Agentgates Wallet](https://ai-powered.com/mcp/agentgates-wallet): Agentgates Wallet is a paid MCP server for finance and payments.
- [MCP Agentic Wallet — open-source session management for x402](https://ai-powered.com/mcp/mcp-agentic-wallet-open-source-session-management-for-x402): MCP Agentic Wallet — open-source session management for x402 is an open-source MCP server for finance and payments.
- [Splits](https://ai-powered.com/mcp/splits): Splits is an MCP server for finance and payments.
- [AgentPad](https://ai-powered.com/mcp/agentpad-2): AgentPad is a free MCP server for finance and payments.
- [Scdo Agent MCP](https://ai-powered.com/mcp/scdo-agent-mcp): Scdo Agent MCP is a free MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/bvcc-agent-wallet
