Getting Started

Welcome to MCP Wallet! This guide will help you set up your wallet and connect it to AI assistants in just a few minutes.

Installation

Download

Choose your platform:

macOS

# Download the .dmg file
# Coming soon: Direct download link

Windows

# Download the .exe installer
# Coming soon: Direct download link

Linux

# Download the .AppImage
# Coming soon: Direct download link

Build from Source

If you prefer to build from source:

# Clone the repository
git clone https://github.com/teamtaoist/mcp-wallet.git
cd mcp-wallet

# Install dependencies
npm install

# Run in development mode
npm run dev

# Or build for production
npm run build

See the Developer Guide for detailed build instructions.

First-Time Setup

1. Create Your Wallet

When you first launch MCP Wallet, you'll see the setup wizard:

1. Welcome Screen

   • Click "Get Started"

2. Create or Import

   • Choose "Create New Wallet" (or "Import Existing" if you have a seed phrase)

3. Save Your Seed Phrase

   • You'll receive a 12-word seed phrase
   • Write it down and store it safely!
   • This is the ONLY way to recover your wallet

4. Confirm Seed Phrase

   • Enter your seed phrase to confirm you saved it

5. Set Password

   • Create a strong password
   • This encrypts your wallet on this device

Important

Never share your seed phrase with anyone!

• Anyone with your seed phrase can access your funds
• Store it offline in a secure location
• MCP Wallet will never ask for your seed phrase

2. Configure Network

Choose which blockchain network to use:

1. Go to Settings → Network

2. Select network:

   • BSC Testnet (recommended for testing)
   • BSC Mainnet (for real transactions)

First Time Users

Start with BSC Testnet to familiarize yourself with the wallet without risking real funds!

3. Get Test Funds (Testnet Only)

If you're using BSC Testnet, get some test BNB:

1. Copy your wallet address:

   • Click Receive button
   • Copy the address shown

2. Visit BSC Testnet Faucet

3. Paste your address and request testnet BNB

4. Wait 1-2 minutes for the transaction to confirm

4. Set Up AI Integration

To allow AI assistants to access your wallet:

1. Enable API Access

   • Go to Settings → Accounts
   • Toggle "Enable API" for your account

2. Monitor Activity (recommended)

   • Review transaction history regularly
   • All AI transactions are labeled "AI-initiated"

3. Start MCP Server

   • Go to Settings → MCP Server
   • Server starts automatically when wallet is unlocked

4. Connect Your AI Assistant

   • See Claude Code Integration
   • More AI assistants coming soon!

Basic Operations

Sending Transactions

1. Click Send in the main wallet view
2. Enter recipient address
3. Enter amount
4. Select token (BNB or USDT)
5. Review and click Send
6. Confirm with your password

Receiving Funds

1. Click Receive in the main wallet view
2. Share your address or QR code
3. Wait for confirmation
4. Check transaction in History

Viewing Transaction History

1. Go to Transactions tab
2. Filter by:
   • All transactions
   • Manual (sent by you)
   • AI-initiated (sent by assistants)
3. Click any transaction to see details

What's Next?

Now that your wallet is set up:

• 📱 Connect to Claude Code
• 🛡️ Configure Security Settings
• 💰 Learn About Transactions
• ❓ Read the FAQ

Need Help?

• 📢 Telegram Community - Community discussion and support
• 📖 Check the Troubleshooting Guide
• 🐛 GitHub Issues - Bug reports and feature requests