Frequently Asked Questions

General Questions

What is MCP Wallet?

MCP Wallet is a secure desktop crypto wallet that integrates with AI assistants like Claude Code via OAuth 2.1. It allows AI assistants to help manage your crypto assets while you maintain full control through spending limits and transaction approvals.

Is MCP Wallet safe?

Yes, MCP Wallet implements multiple security layers:

• Private keys encrypted with AES-256-GCM
• OAuth 2.1 authentication for AI access
• Transaction monitoring - all AI transactions labeled
• Revocable access - disable API anytime
• Future open source - code will be publicly auditable

What blockchains are supported?

Currently supported:

• Binance Smart Chain (BSC) Mainnet
• BSC Testnet

Coming soon:

• Ethereum
• Polygon
• Arbitrum

AI Integration

Which AI assistants work with MCP Wallet?

Currently supported:

• ✅ Claude Code - Full support

Coming soon:

• 🔜 Cursor - In development
• 🔜 GitHub Copilot - Planned

Do I need an AI assistant to use MCP Wallet?

No! MCP Wallet works as a standalone wallet. AI integration is optional.

Can the AI send transactions without my approval?

After you approve AI access during OAuth authorization, AI can execute transactions. However:

• You approve once during initial OAuth authorization
• You can disable API access anytime to stop all AI transactions
• All transactions are logged and labeled as AI-initiated
• Use dedicated account with limited funds for better control
• Coming soon: Spending limits for additional safeguards

How do I revoke AI access?

1. Go to Settings → Accounts
2. Toggle "Enable API" to OFF
3. Done! AI can no longer access your wallet

Security

What if I lose my seed phrase?

If you lose your seed phrase, you cannot recover your wallet. There is no "forgot password" feature in crypto. This is why it's crucial to:

• Write down your seed phrase
• Store it in multiple secure locations
• Never share it with anyone

What if I forget my password?

Your password encrypts your wallet on your device. If you forget it:

• You can recover using your seed phrase
• Import your wallet with the seed phrase
• Set a new password

Can MCP Wallet developers access my funds?

No. Your private keys are:

• Encrypted with your password
• Stored only on your device
• Never sent to any server
• Only you have access

What's the difference between password and seed phrase?

• Password: Encrypts your wallet on your device only. Used to unlock the app.
• Seed phrase: Master key that can recreate your wallet anywhere. Used for recovery.

Transaction Control

How do I control what AI can do?

You control AI access through:

• OAuth authorization: Approve access once during initial setup
• API toggle: Enable/disable API access anytime in Settings
• Dedicated account: Use separate account with limited funds (recommended)
• Transaction monitoring: Review all AI-initiated transactions in history
• Coming soon: Spending limits (per-transaction and daily)

Can I stop AI from making transactions?

Yes. Go to Settings → Accounts and toggle "Enable API" to OFF. This immediately revokes AI access.

How do I monitor AI activity?

Check the Transactions tab and filter by "AI-initiated" to see all AI transactions. Each transaction shows timestamp, amount, and recipient.

Technical Questions

What is OAuth 2.1?

OAuth 2.1 is an industry-standard protocol for secure authorization. It allows AI assistants to access your wallet without seeing your private keys or password.

What is PKCE?

PKCE (Proof Key for Code Exchange, pronounced "pixie") is a security extension to OAuth that prevents authorization code interception attacks. MCP Wallet uses PKCE (S256) for maximum security.

How long do access tokens last?

• Access tokens: 1 hour
• Refresh tokens: 30 days

After expiration, you'll need to re-authorize the AI assistant.

Can I use MCP Wallet on multiple devices?

Yes, but each device needs:

• The same seed phrase (to access the same wallet)
• Separate OAuth authorization per device

Is there a mobile version?

Not yet, but it's on our roadmap! Currently available:

• macOS
• Windows
• Linux

Transactions

Why was my transaction rejected?

Common reasons:

1. Insufficient funds - Need more balance + gas fees
2. Wrong network - Check you're on correct network (testnet vs mainnet)
3. API disabled - Enable API in account settings
4. Invalid OAuth token - Re-authorize your AI assistant

How long do transactions take?

• BSC: ~3-5 seconds per block
• Confirmation: Usually 1-2 blocks (~5-10 seconds)
• During network congestion: May take longer

Can I cancel a transaction?

Once a transaction is broadcast to the blockchain, it cannot be canceled. However:

• Pending transactions (not yet broadcast) can be canceled
• You can try to "speed up" stuck transactions with higher gas

What are gas fees?

Gas fees are network fees paid to blockchain validators. For BSC:

• Typical fee: ~0.0005 BNB per transaction
• Paid in: BNB (always, even for USDT transfers)
• Not controlled by: MCP Wallet (set by network)

Troubleshooting

My wallet won't unlock

Try:

1. Check your password (case-sensitive)
2. Restart MCP Wallet
3. Check if database file is corrupt
4. Recover with seed phrase if needed

AI can't connect to my wallet

Check:

1. Wallet unlocked?
2. API enabled? Settings → Accounts
3. MCP server running? Settings → MCP Server
4. Correct OAuth config? Check Claude Code config

Transaction is stuck

For stuck transactions:

1. Wait - Network may be congested
2. Check block explorer - Verify transaction status
3. Contact support - If stuck for >1 hour

Balance not updating

Try:

1. Refresh - Click refresh button in wallet
2. Wait - Blockchain confirmations may be pending
3. Check network - Verify you're on correct network
4. Check block explorer - Confirm transaction confirmed

Getting Help

Where can I get support?

• 📢 Telegram Community - Community discussion and support
• 📖 Documentation - Comprehensive guides
• 🐛 GitHub Issues - Bug reports and feature requests

How do I report a bug?

1. Go to GitHub Issues
2. Click "New Issue"
3. Choose "Bug Report" template
4. Fill in details:
   • Steps to reproduce
   • Expected behavior
   • Actual behavior
   • Screenshots if applicable

How can I contribute?

We welcome community input!

• Report bugs via GitHub Issues
• Suggest features
• Provide feedback
• Help improve documentation

Note: The code is currently closed source but will be open sourced in the future.

Is there a bug bounty program?

Not yet, but security researchers are welcome to report vulnerabilities responsibly to security@example.com.

Fees & Costs

Does MCP Wallet charge fees?

No. MCP Wallet is free. You only pay:

• Blockchain gas fees (paid to network validators)
• No subscription fees
• No transaction fees to MCP Wallet

Why do I need BNB for USDT transfers?

BNB is needed to pay gas fees on Binance Smart Chain, even when transferring USDT. Always keep some BNB in your wallet for gas.

Updates

How do I update MCP Wallet?

Updates are announced on:

• GitHub Releases
• Telegram

Download the latest version and install. Your wallet data is preserved across updates.

Will updates affect my wallet?

No. Your wallet data (seed phrase, accounts) is stored separately and preserved across updates.

Miscellaneous

Can I use MCP Wallet for business?

Yes! MCP Wallet can be used for:

• Personal use
• Commercial use

Note: The wallet is currently closed source but will be released as open source under MIT License in the future.

Where is my data stored?

All data is stored locally on your device:

• macOS: ~/Library/Application Support/com.mcp-wallet.app/
• Windows: %APPDATA%\com.mcp-wallet.app\
• Linux: ~/.config/com.mcp-wallet.app/

Nothing is sent to external servers except blockchain transactions.

---

Still have questions?

Join our Telegram Community or open an issue!