Skip to content
MCP server

Bvcc Agent Wallet

Non-custodial on-chain wallet tools for AI agents: balances, swaps, lending and liquidity

Runs locally
Install
Platforms
CLI
Runs
Locally
Version
0.4.0
Listing updated
5 days ago

Similar MCP servers

About Bvcc Agent Wallet

Bvcc Agent Wallet is an MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a 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

Add to claude_desktop_config.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>"
      }
    }
  }
}

Add to ~/.cursor/mcp.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>"
      }
    }
  }
}

Add to .vscode/mcp.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>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.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>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "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>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • AGENT_PRIVATE_KEYAgent EOA private key (0x + 64 hex). Used locally to sign only; never transmitted.Required
  • WALLET_ADDRESSThe BVCC Agent Wallet address this agent operates (0x...).Required
  • CHAIN_IDDefault chain id: 42161 Arbitrum, 56 BNB Chain, 1 Ethereum, 8453 Base, 137 Polygon, 421614 Arbitrum Sepolia. Every tool also accepts an optional per-call network.Required
  • RPC_URLOptional custom RPC for the default chain (comma-separated list allowed for failover). Public default used otherwise. Per-chain override via RPC_URL_<chainId>.
  • BVCC_MCP_READONLYSet to 'true' to expose only read/simulate tools (no fund-moving writes).
  • BVCC_MCP_MODULESComma-separated capability modules to expose: core, aave. Unset exposes all.

Tools this server provides (24)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Pricing unknown

0.15% on-chain agent fee on agent actions, plus gas

Bvcc Agent Wallet 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.

How AIPoweredBot checks servers