MCP Wallet

Appearance

Introduction to MCP Wallet ​

Welcome to MCP Wallet - the secure crypto wallet that brings AI assistance to blockchain transactions.

What is MCP Wallet? ​

MCP Wallet is a desktop cryptocurrency wallet designed for the AI era. It combines robust security with convenient AI integration, allowing AI assistants like Claude Code and Gemini CLI to help manage your crypto assets while you maintain complete control.

Key Features ​

🔐 Enterprise-Grade Security

  • AES-256-GCM encryption for private keys
  • Argon2id password hashing (memory-hard, GPU-resistant)
  • BIP39 seed phrase support
  • Keys never leave your device

🤖 AI Integration

  • OAuth 2.1 authentication with PKCE (S256)
  • One-time approval for controlled AI access
  • Support for Claude Code and Gemini CLI (more coming soon)
  • Secure API without exposing private keys

⚡ Fast & Intuitive

  • Clean, modern interface
  • Quick transaction signing
  • Real-time balance updates
  • Multi-account management

🌐 Multi-Chain Support

  • Binance Smart Chain (BSC) Mainnet
  • BSC Testnet
  • More chains coming soon (Ethereum, Polygon, Arbitrum)

Why MCP Wallet? ​

The Problem ​

Traditional crypto wallets require manual intervention for every transaction. AI assistants can help with blockchain tasks, but giving them direct access to your wallet is risky.

The Solution ​

MCP Wallet uses OAuth 2.1 to provide controlled AI access:

  • AI helps you - Let AI handle routine transactions
  • You stay in control - Approve access once, revoke anytime
  • No password sharing - AI never sees your keys or password
  • Revoke anytime - Disable AI access with one click

Real-World Use Cases ​

Portfolio Management

  • "Send 0.1 BNB to my savings wallet"
  • "Check my USDT balance"
  • "What's my total portfolio value?"

Regular Payments

  • "Send 50 USDT to Bob for lunch"
  • "Pay my monthly subscription (0.05 BNB)"

Testing & Development

  • "Send 1 testnet BNB to this contract"
  • "Check gas prices"
  • "Verify this transaction status"

How It Works ​

1. Traditional Wallet Functions ​

Use MCP Wallet like any normal wallet:

  • Create or import wallets
  • Send and receive tokens
  • View transaction history
  • Switch networks
  • Manage multiple accounts

2. AI Integration (Optional) ​

Enable AI access for enhanced functionality:

mermaid
graph LR
    A[AI Assistant] -->|OAuth 2.1| B[MCP Wallet]
    B -->|Verify Token| C{Token Valid?}
    C -->|Yes| D[Execute Transaction]
    C -->|No| E[Reject]
    D --> F[Blockchain]

Flow:

  1. User approves AI access once during OAuth authorization
  2. AI requests transaction via MCP protocol
  3. MCP Wallet verifies OAuth token
  4. Executes transaction if token valid
  5. Broadcasts to blockchain

Security Model ​

Three Layers of Protection ​

Layer 1: Encryption

  • Private keys encrypted with AES-256-GCM
  • Password never stored (only hash)
  • Keys stored in encrypted local database

Layer 2: OAuth 2.1

  • Industry-standard authorization
  • PKCE prevents code interception
  • Time-limited access tokens (1 hour)
  • Refresh tokens (30 days)
  • No password sharing with AI
  • Revocable access anytime

What AI Can Do ​

✅ With API Enabled:

  • Check balances
  • Read transaction history
  • Send transactions (user approved during authorization)
  • Check network status

❌ AI Cannot:

  • Access your password
  • View your seed phrase
  • Export private keys
  • Modify security settings
  • Continue after you revoke access

Getting Started ​

Ready to start? Follow these steps:

  1. Installation - Download and install MCP Wallet
  2. Quick Start - Create your first wallet
  3. AI Integration - Connect with AI assistants:
  4. Security Setup - Understand security features

Supported Networks ​

Currently Supported ​

Binance Smart Chain (BSC)

  • Mainnet (Chain ID: 56)
  • Testnet (Chain ID: 97)
  • Native token: BNB
  • Supported tokens: BNB, USDT (BEP-20)

Coming Soon ​

  • Ethereum (Mainnet, Sepolia)
  • Polygon (Mainnet, Mumbai)
  • Arbitrum
  • Optimism

Supported AI Assistants ​

Currently Supported ​

Claude Code ✅

Gemini CLI ✅

Coming Soon ​

Cursor 🔜

  • In development
  • Expected Q2 2025

GitHub Copilot 🔜

  • Planned
  • Expected Q3 2025

Supported Tokens ​

Currently Supported ​

BNB (Native)

  • Send, receive, check balance
  • Used for gas fees

USDT (BEP-20)

  • Send, receive, check balance
  • Requires BNB for gas

Coming Soon ​

  • USDC
  • BUSD
  • More ERC-20 tokens
  • Custom token support

Technology Stack ​

MCP Wallet is built with modern technologies:

Frontend

  • React + TypeScript
  • Vite for fast development
  • TailwindCSS for styling

Backend

  • Rust for cryptographic operations
  • Tauri for desktop app framework
  • SQLite for local storage

Blockchain

  • ethers.js for blockchain interaction
  • BIP39/BIP44 for wallet generation
  • EIP-1559 for gas optimization

Security

  • AES-256-GCM encryption
  • Argon2id password hashing
  • OAuth 2.1 with PKCE (S256)

Future Open Source Release ​

MCP Wallet will be open sourced in the future:

Why Open Source (Coming Soon)? ​

  • Transparency - Community will be able to review code
  • Security - Enable security audits
  • Trust - No hidden backdoors
  • Community - Improve together

Philosophy ​

MCP Wallet is built on these principles:

1. Security First ​

Your funds' security is never compromised for convenience. Every feature is designed with security in mind.

2. User Control ​

You remain in complete control. AI is your assistant, not your master. You set the boundaries.

3. Transparency ​

Open source code, clear documentation, honest communication about risks and limitations.

4. Privacy ​

Your data stays on your device. No analytics, no tracking, no data collection.

5. Simplicity ​

Powerful features with simple interfaces. Complexity hidden, power accessible.

Community ​

Join our growing community:

Roadmap ​

Q1 2025 ✅ ​

  • ✅ BSC Mainnet support
  • ✅ BSC Testnet support
  • ✅ Claude Code integration
  • ✅ Gemini CLI integration
  • ✅ OAuth 2.1 implementation

Q2 2025 🔜 ​

  • Spending limits (per-transaction and daily)
  • Ethereum support
  • Polygon support
  • Cursor integration
  • Hardware wallet support
  • Open source release
  • Mobile app (iOS/Android)

Q3 2025 📅 ​

  • Arbitrum support
  • Optimism support
  • GitHub Copilot integration
  • Multi-sig support
  • Token swap integration

Q4 2025 📅 ​

  • DeFi integrations
  • NFT support
  • Cross-chain bridges
  • Advanced AI features

FAQ Preview ​

Is MCP Wallet safe? Yes. Military-grade encryption, and your keys never leave your device. Code will be open sourced for community review.

Can AI steal my funds? AI can only execute transactions after you approve access during OAuth authorization. You can revoke access anytime by disabling the API.

Do I need AI to use MCP Wallet? No. AI integration is optional. MCP Wallet works perfectly as a standalone wallet.

Is MCP Wallet free? Yes. Free and open source. You only pay blockchain gas fees.

What if I lose my password? You can recover using your 12-word seed phrase. If you lose both, funds are permanently inaccessible.

See full FAQ for more questions.

Next Steps ​

Ready to get started?

  1. Download & Install - Get MCP Wallet on your device
  2. Create Wallet - Set up your first wallet
  3. Connect AI - Integrate with AI assistants:
  4. Learn Security - Understand security best practices

Need Help?

Welcome to the future of crypto wallets! 🚀

MCP Wallet - Secure crypto wallet with AI integration

Copyright © 2025 MCP Wallet