Vibe Wallet Server

The protocol layer of the Vibe Stack. This server bridges AI agents (Claude, OpenCode) with the Vibe Wallet browser extension using Model Context Protocol (MCP).

🛡️ Zero-Config Isolation

This server implements Smart IP Pairing. It automatically identifies and pairs AI clients with browser extensions based on their public IP address. This ensures a private, isolated session for every user without requiring manual keys or registration.

🚀 Architecture

AI Agent (Claude/OpenCode) ──SSE──▶ Server (IP Pairing) ──WebSocket──▶ Extension ──RPC──▶ Blockchain

🌐 Cloud Deployment

The server is optimized for Fly.io but can run on any Docker-compatible platform.

# Deploy to Fly.io
cd mcp-wallet/server
fly deploy

🛠️ AI Configuration

Add this to your claude_desktop_config.json or OpenCode settings:

{
  "mcpServers": {
    "vibe-wallet": {
      "url": "https://vibe-wallet-mcp.fly.dev/sse"
    }
  }
}

📦 Available Tools

• Connectivity: wallet_listInstances, wallet_selectInstance, wallet_getStatus
• Account: wallet_listAccounts, wallet_selectAccount, wallet_createAccount, wallet_importAccount, wallet_deleteAccount
• Assets: wallet_getAddress, wallet_getBalance, wallet_getTokenBalance, wallet_sendTransaction, wallet_sendToken, wallet_approveToken
• Blockchain: wallet_getNetwork, wallet_switchNetwork, wallet_getBlockNumber, wallet_getGasPrice
• Advanced: wallet_callContract, wallet_estimateGas, wallet_signMessage

📜 License

MIT