Installation

Install WalletAgent as an MCP server in your AI agent. The process is simple and takes just a few minutes.

Requirements

AI Agent: Claude Code, Cursor, or Windsurf with MCP support
Operating System: macOS, Linux, or Windows
Your AI agent will handle all technical requirements automatically

Installation Methods

The easiest way to install WalletAgent:

claude mcp add wallet-agent bunx wallet-agent@latest

Verify Installation

Check that WalletAgent is running:

/mcp

You should see wallet-agent listed among your MCP servers.

Alternative: Manual Installation

If you prefer manual setup:

# Download and configure manually
claude mcp add wallet-agent bunx wallet-agent@latest

Troubleshooting Claude Code

"Command not found":

Ensure Claude Code CLI is installed and updated
Follow Claude Code installation instructions from official documentation

"MCP server failed to start":

Check your AI agent's MCP configuration
Restart your AI agent and try again

Add WalletAgent to your Cursor MCP configuration:

1. Open MCP Configuration

Edit your MCP configuration file:

# macOS/Linux
~/.cursor/mcp.json

# Windows  
%APPDATA%\Cursor\mcp.json

2. Add WalletAgent

{
  "mcpServers": {
    "wallet-agent": {
      "command": "bunx",
      "args": ["wallet-agent"]
    }
  }
}

3. Restart Cursor

Close and reopen Cursor to load the MCP server.

4. Verify Installation

In Cursor, try a simple command:

List available MCP tools

You should see WalletAgent tools in the response.

Troubleshooting Cursor

"Server failed to start":

Ensure your system meets requirements
Restart Cursor and try again
Check Cursor logs for detailed error messages

"MCP not responding":

Restart Cursor completely
Verify the configuration file syntax
Try removing and re-adding the server configuration

Advanced Setup

For advanced users or contributors who want to customize WalletAgent behavior, see the Developer Guide for detailed setup instructions.

Advanced Configuration

For advanced configuration including private key management and custom settings, see the Security Guide and Advanced Topics sections.

Verification

Test that WalletAgent is working correctly:

1. Basic Connection Test

Get wallet info

Expected response:

🔧 Wallet Configuration
- Type: Mock (safe for testing)
- Available Accounts: 3
- Current Chain: Anvil (31337)

2. List Available Tools

What MCP tools are available?

You should see 60+ tools including:

connect_wallet
send_transaction
transfer_token
simulate_contract_call
And many more...

3. Try a Simple Operation

Connect to 0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266

Expected response:

✅ Connected to wallet successfully!
📍 Address: 0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266
⛓️ Chain: Anvil (Chain ID: 31337)
💰 Balance: 10000.0 ETH

Next Steps

Great! WalletAgent is now installed and running. Let's try some basic operations:

👉 Continue to Quick Start →

Troubleshooting

Common Issues

"Module not found" errors:

Ensure your AI agent is properly configured
Try restarting your AI agent

"Permission denied" errors:

Check your system permissions
Try running your AI agent with appropriate permissions

MCP server startup failures:

Check that your AI agent supports MCP
Verify WalletAgent was installed correctly
Restart your AI agent

Getting Help

If you encounter issues:

Need help? The community is here to support you! 💪

PreviousOverview NextQuick Start

Last updated 5 months ago

Good morning

hashtagRequirements

hashtagInstallation Methods

hashtagVerify Installation

hashtagAlternative: Manual Installation

hashtagTroubleshooting Claude Code

hashtag1. Open MCP Configuration

hashtag2. Add WalletAgent

hashtag3. Restart Cursor

hashtag4. Verify Installation

hashtagTroubleshooting Cursor

hashtagAdvanced Setup

hashtagAdvanced Configuration

hashtagVerification

hashtag1. Basic Connection Test

hashtag2. List Available Tools

hashtag3. Try a Simple Operation

hashtagNext Steps

hashtagTroubleshooting

hashtagCommon Issues

hashtagGetting Help