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

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

Expected response:

2. List Available Tools

You should see 60+ tools including:

  • connect_wallet

  • send_transaction

  • transfer_token

  • simulate_contract_call

  • And many more...

3. Try a Simple Operation

Expected response:

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:

  1. Check the Troubleshooting Guide

  2. Review Common Issues

  3. Open an issue on GitHub

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

PreviousOverviewNextQuick Start

Last updated