{"_id":"@agentauth/wallet","name":"@agentauth/wallet","dist-tags":{"latest":"0.0.1"},"versions":{"0.0.1":{"name":"@agentauth/wallet","version":"0.0.1","description":"A crypto wallet-enabled MCP proxy for seamless blockchain payments and authentication.","main":"dist/proxy.js","types":"dist/proxy.d.ts","bin":{"agentauth-wallet":"dist/proxy.js"},"scripts":{"build":"tsc && node -e \"const fs = require('fs'); const path = './dist/proxy.js'; if (process.platform !== 'win32') { fs.chmodSync(path, '755'); }\"","dev":"tsc -w","test":"vitest run","test:unit":"vitest run src/","test:integration":"vitest run tests/integration/","test:all":"npm run test:unit && npm run test:integration","validate":"npm run build && npm run test:all"},"keywords":["agentauth","wallet","crypto","blockchain","ethereum","payments","authentication","identity","mcp","mcp-clients","mcp-servers","proxy","cli","command-line","terminal","connector","ai-agents","model-context-protocol"],"author":{"name":"AgentAuth Team"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/agentauthco/mcp-wallet.git"},"homepage":"https://github.com/agentauthco/mcp-wallet#readme","bugs":{"url":"https://github.com/agentauthco/mcp-wallet/issues"},"type":"module","dependencies":{"@agentauth/core":"0.1.1","@modelcontextprotocol/sdk":"^1.12.3","ethers":"^6.13.0","yargs":"^18.0.0"},"devDependencies":{"@types/node":"^20.0.0","@types/yargs":"^17.0.33","typescript":"^5.8.3","vitest":"^1.6.0"},"engines":{"node":">=18.0.0"},"publishConfig":{"access":"public"},"_id":"@agentauth/wallet@0.0.1","gitHead":"abeda334f3087a1fd5118a3b5ec931ee55b16b87","_nodeVersion":"23.3.0","_npmVersion":"10.9.0","dist":{"integrity":"sha512-OnNEAG5Sr1rxMqhsBb+K7hgbSomoN45/b24NOpnjfYiKnOtnnp1JNmnAO5WEyamwkm//NTxdKan45FbvWtygIA==","shasum":"e48f67cc75fb52fe51a33ea1bf79faad341c3d0c","tarball":"https://registry.npmjs.org/@agentauth/wallet/-/wallet-0.0.1.tgz","fileCount":27,"unpackedSize":140138,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIBDnpUJZU+voWWx7vhKNz3ymO+teKS5+72VPWpZDmeNvAiEAmGNqslf6bNe95H//NPNYOsEJc07QqVuWOOnjiDYF7zY="}]},"_npmUser":{"name":"agentauthdev","email":"developers@agentauth.co"},"directories":{},"maintainers":[{"name":"agentcoredev","email":"developers@agentcore.me"},{"name":"agentauthdev","email":"developers@agentauth.co"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/wallet_0.0.1_1758091482384_0.889444195177177"},"_hasShrinkwrap":false}},"time":{"created":"2025-09-17T06:44:42.299Z","0.0.1":"2025-09-17T06:44:42.575Z","modified":"2025-09-17T06:44:42.853Z"},"maintainers":[{"name":"agentcoredev","email":"developers@agentcore.me"},{"name":"agentauthdev","email":"developers@agentauth.co"}],"description":"A crypto wallet-enabled MCP proxy for seamless blockchain payments and authentication.","homepage":"https://github.com/agentauthco/mcp-wallet#readme","keywords":["agentauth","wallet","crypto","blockchain","ethereum","payments","authentication","identity","mcp","mcp-clients","mcp-servers","proxy","cli","command-line","terminal","connector","ai-agents","model-context-protocol"],"repository":{"type":"git","url":"git+https://github.com/agentauthco/mcp-wallet.git"},"author":{"name":"AgentAuth Team"},"bugs":{"url":"https://github.com/agentauthco/mcp-wallet/issues"},"license":"MIT","readme":"# AgentAuth MCP Wallet (@agentauth/wallet) - The payment-enabled MCP gateway for your AI agents\n\n[![npm version](https://img.shields.io/npm/v/@agentauth/wallet.svg)](https://www.npmjs.com/package/@agentauth/wallet)\n[![npm downloads](https://img.shields.io/npm/dm/%40agentauth%2Fwallet)](https://www.npmjs.com/package/@agentauth/wallet)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![GitHub stars](https://img.shields.io/github/stars/agentauthco/mcp-wallet?style=social)](https://github.com/agentauthco/mcp-wallet)\n\n**AgentAuth MCP Wallet is a payment-enabled MCP gateway with native x402 protocol support and interactive user approval.**\n\nConnect AI agents in Claude, Cursor, Windsurf, etc. to any MCP server and empower them to make payments for premium tools and resources, while you remain in control with interactive payment approval - no friction, and no surprises.\n\n## 🚀 Key Features\n\n- **🔥 Payment-Enabled MCP Proxy**: Connect to any MCP server, including ones with paid tools and resources\n- **🛡️ Interactive Payment Approval**: You approve every payment through the agent - your wallet, you're in control\n- **⚡ Native x402 Support**: Works with any x402-protected server out of the box\n- **🔐 No Accounts Required**: Uses AgentAuth for seamless agent-native identification\n- **🌐 Multi-Chain Ready**: Supports USDC on Base mainnet and Base Sepolia testnet\n- **🔮 Multi-Protocol**: Built for x402 with support for emerging protocols like AgentPay\n\n## 🛡️ Safe Payment Flow\n\n```\n1. Request premium content in Claude/Cursor\n2. agentauth-wallet detects payment requirement\n3. → YOU GET PROMPTED: \"Pay $0.01 USDC to access premium news?\"\n4. You approve → payment executes → content delivered\n5. You decline → operation cancelled safely\n```\n\n**No surprise charges. You're always in control.**\n\n## ⚡ Quick Start\n\n### 1. Install\n\n```bash\nnpm install -g @agentauth/wallet\n```\n\n### 2. Generate Your Identity\n\n```bash\nagentauth-wallet generate\n```\n\nThis creates your unique AgentAuth identity, including a private key and wallet address. Save the output - you'll need it!\n\n### 3. Add to Your MCP Client\n\n**For Claude Desktop**, add to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"premium-news\": {\n      \"command\": \"agentauth-wallet\",\n      \"args\": [\"connect\", \"https://mcp-server.example.com/mcp\"]\n    }\n  }\n}\n```\n\n**For Cursor/Windsurf**, add to your MCP configuration similarly.\n\n### 4. Start Using Premium Services\n\nOpen Claude and request premium content. When payment is required, you'll see:\n\n```\n💳 Payment Required\n📄 Service: Premium News Article\n💰 Amount: $0.01 USDC\n🏦 Your Balance: $5.23 USDC\n\nApprove this payment?\n```\n\nTell the agent what you'd like to do. It's that simple!\n\n## 🎯 Try It Now - Live Demo Server\n\nWant to see it in action? We have a live demo news server ready for testing!\n\n### Quick Test Setup\n\n1. **Install and generate your wallet** (if you haven't already):\n```bash\nnpm install -g @agentauth/wallet\nagentauth-wallet generate\n# Save your AGENTAUTH_TOKEN!\n```\n\nNote: You can also import an existing EVM private key instead of generating a new one, if you'd prefer.\n\n2. **Add to Claude Desktop** (`claude_desktop_config.json`):\n```json\n{\n  \"mcpServers\": {\n    \"news-demo\": {\n      \"command\": \"agentauth-wallet\",\n      \"args\": [\"connect\", \"https://mcp-news-dev-production.up.railway.app/mcp\"],\n      \"env\": {\n        \"AGENTAUTH_TOKEN\": \"your-token-or-private-key\"\n      }\n    }\n  }\n}\n```\n\n3. **Fund your wallet** with a small amount of USDC and ETH on **Base mainnet**\n\n4. **Start using it** in Claude:\n   - \"Get me the latest tech news\" (free)\n   - \"Get me (such and such) article\" (some articles require payment - you'll see the payment request and approval prompt!)\n\n### Demo Server Details\n- **URL**: `https://mcp-news-dev-production.up.railway.app/mcp`\n- **Network**: Base mainnet\n- **Free tools**: Basic news search, articles from certain sources\n- **Paid tools**: Premium articles from paid sources\n\n## 💡 Common Use Cases\n\n### Premium News & Research\nAccess paid content from news services, research databases, and premium APIs through Claude.\n\n### AI Model Access\nPay per request for specialized AI models and computational resources.\n\n### Data & Analytics\nAccess premium datasets, market data, and analytics services on-demand.\n\n### Developer Tools\nUse paid developer APIs and services through your MCP-enabled editor.\n\n## 🔧 CLI Reference\n\n### Generate New Identity\n```bash\nagentauth-wallet generate\n```\nCreates a new AgentAuth identity and wallet address.\n\n### Derive Address from Key\n```bash\nagentauth-wallet derive <private-key>\n```\nGet your wallet address from an existing private key.\n\n### Connect to Server\n```bash\nagentauth-wallet connect <server-url>\n```\nConnect to any MCP server, just like you normally would.\n\n### Connection Options\n```bash\nagentauth-wallet connect <server-url> --header \"Authorization: Bearer token\"\n```\nAdd custom headers for authentication.\n\n## ⚙️ Configuration\n\n### Environment Variables\n\n- `AGENTAUTH_TOKEN`: Your private key (aa-prefixed, 0x-prefixed, or raw)\n\n### Wallet Setup\n\nThe wallet automatically detects which network (Base mainnet/testnet) each server uses.\n\nYour wallet needs USDC and ETH for payments on that network:\n- **USDC**: For actual payments to services\n- **ETH**: For transaction fees (gas)\n\n## 🔍 Troubleshooting\n\n### \"Payment Required\" but No Prompt Appears\n- Check that your AGENTAUTH_TOKEN is set correctly\n- Verify the server supports x402 protocol\n- Try with `agentauth-wallet connect <server-url> --debug` for detailed logs\n\n### \"Insufficient Funds\" Error\n- Check your USDC balance: you need enough for the payment amount\n- Check your ETH balance: you need ~$0.01 ETH for transaction fees\n- Ensure that your funds are on the right network!\n- Use `agentauth-wallet derive <your-key>` to see your wallet address\n\n### Connection Issues\n- Verify the server URL is correct and accessible\n- Check if the server requires custom headers\n- Ensure your MCP client configuration is correct\n\n### Payment Stuck/Failed\n- Payments are atomic - they either complete fully or fail safely\n- Check the blockchain explorer for your transaction status\n- Contact the service provider if payments succeed but content isn't delivered\n\n## 🌟 Supported Protocols\n\n### x402 Protocol (Primary)\nIndustry standard for agentic payments. Works with any x402-protected MCP server automatically.\n\n### AgentAuth Integration\nSeamless crypto-native identification without accounts or login flows.\n\n### AgentPay (Early Support)\nEmerging protocol for agent-to-agent payments. Limited adoption currently.\n\n## 🔮 Coming Soon\n\n- **Payment Policies**: Set spending limits and auto-approve small payments\n- **Multi-Asset Support**: Pay with different tokens on different chains\n- **Agentic Wallet Functionality**: Manage your wallet with the agent, like any other MCP server\n- **Additional Payment Protocols**: Support for emerging protocols including Google's AP2\n\n## 📚 Learn More\n\n- [x402 Protocol Specification](https://www.x402.org)\n- [AgentAuth Documentation](https://agentauth.dev)\n- [Model Context Protocol](https://modelcontextprotocol.io)\n\n## 📄 License\n\nMIT License - see [LICENSE](LICENSE) file for details.\n\n---\n\n**AgentAuth -- collaboration infrastructure for AI agents.**","readmeFilename":"README.md","_rev":"1-1b5e4e4c60a9242afddff8cf832a3bfc"}