@shanev/wallet-agent
v0.1.0
Published
MCP server for Web3 wallet interactions on EVM-compatible chains using Wagmi
Maintainers
Readme
Wallet Agent
MCP server for Web3 wallet interactions in AI assistants like Claude Code and Cursor. Supports mock wallets for testing and real wallets via private key import.
Quick Start
claude mcp add wallet-agent bunx @shanev/wallet-agentVerify with /mcp in Claude Code.
Core Features
- Wallets: Connect, sign messages, send transactions
- Chains: Switch networks, add custom EVMs
- Tokens: Transfer ERC-20/721, check balances
- Contracts: Read/write via Wagmi or built-in ABIs
Usage Examples
Basic Flow
"Connect to 0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266"
"Check my balance"
"Send 0.1 ETH to 0x70997970C51812dc3A010C7d01b50e0d17dc79C8"
"Switch to Polygon"Token Operations
"Transfer 100 USDC to 0x..."
"Get my USDT balance"
"Approve DAI spending for 0xDEX..."Custom Chains
"Add Base mainnet"
"Add local Anvil chain"
"Switch to Base"Real Wallets (Development Only)
⚠️ NEVER paste private keys in chat!
Option 1: Environment Variable
# When adding server
claude mcp add wallet-agent bunx @shanev/wallet-agent -e WALLET_PRIVATE_KEY=0x...
# Or in shell
export WALLET_PRIVATE_KEY="0x..."Then: "Import private key from WALLET_PRIVATE_KEY"
Option 2: Secure File
echo "0x..." > ~/.wallet-key
chmod 600 ~/.wallet-keyThen: "Import private key from ~/.wallet-key"
Workflow
- "Set wallet type to privateKey"
- "Connect to my wallet"
- Use normally
Mock Accounts
Pre-configured for testing:
0xf39Fd6e51aad88F6F4ce6aB8827279cffFb922660x70997970C51812dc3A010C7d01b50e0d17dc79C80x3C44CdDdB6a900fa2b585dd299e03d12FA4293BC
Development
git clone https://github.com/shanev/wallet-agent.git
cd wallet-agent
bun install
bun run devFor local testing:
claude mcp add wallet-agent bun /path/to/wallet-agent/dist/index.tsSecurity
- Private keys stored in memory only
- No network transmission of secrets
- Use testnets for development
- Audit code before mainnet use
