{"_id":"@agentauth/mcp","_rev":"7-5dd9cc536c9fbc37fa635aa5d2aae94f","name":"@agentauth/mcp","dist-tags":{"latest":"0.2.1"},"versions":{"0.1.0":{"name":"@agentauth/mcp","version":"0.1.0","keywords":["agentauth","authentication","identity","mcp","mcp-clients","mcp-servers","proxy","cli","command-line","terminal","connector","ai-agents","model-context-protocol"],"author":{"name":"AgentAuth Team"},"license":"MIT","_id":"@agentauth/mcp@0.1.0","maintainers":[{"name":"agentpaydev","email":"developers@agentpay.me"},{"name":"agentcoredev","email":"developers@agentcore.me"}],"homepage":"https://github.com/agentcorelabs/agentauth#readme","bugs":{"url":"https://github.com/agentcorelabs/agentauth/issues"},"bin":{"agentauth-mcp":"dist/proxy.js"},"dist":{"shasum":"c90e246a1323cb3d05f2b35173fe77fe30f82f80","tarball":"https://registry.npmjs.org/@agentauth/mcp/-/mcp-0.1.0.tgz","fileCount":9,"integrity":"sha512-ej4XEy+KZqu6uZqB1pLti5BPlCINoWH8ZGvwj+6KIqPiHvhWGhVIRhWCxID4mX75UPSWfeZ5IL7/vN+anG7vTQ==","signatures":[{"sig":"MEYCIQChB48MIuASwiat5EQZ5ZZg/meW2vpe5fygnncyjkyqDgIhAPEvj83t/ul7+Rhel9NoZsPqOblvstTJQbZPWYrOzBLc","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":34411},"main":"dist/proxy.js","type":"module","types":"dist/proxy.d.ts","engines":{"node":">=18.0.0"},"gitHead":"b16d39338eb279939fbf127a619ef323dee449b3","scripts":{"dev":"tsc -w","test":"vitest run","build":"tsc && node -e \"const fs = require('fs'); const path = './dist/proxy.js'; if (process.platform !== 'win32') { fs.chmodSync(path, '755'); }\""},"_npmUser":{"name":"agentcoredev","actor":{"name":"agentcoredev","type":"user","email":"developers@agentcore.me"},"email":"developers@agentcore.me"},"repository":{"url":"git+https://github.com/agentcorelabs/agentauth.git","type":"git","directory":"packages/agentauth-mcp"},"_npmVersion":"10.9.0","description":"A universal proxy for remote MCP server connections, with and without authentication.","directories":{},"_nodeVersion":"23.3.0","dependencies":{"yargs":"^18.0.0","@agentauth/core":"0.1.0","@modelcontextprotocol/sdk":"^1.12.3"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"@types/yargs":"^17.0.33"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.1.0_1750628514896_0.7661275532508405","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@agentauth/mcp","version":"0.1.1","keywords":["agentauth","authentication","identity","mcp","mcp-clients","mcp-servers","proxy","cli","command-line","terminal","connector","ai-agents","model-context-protocol"],"author":{"name":"AgentAuth Team"},"license":"MIT","_id":"@agentauth/mcp@0.1.1","maintainers":[{"name":"agentcoredev","email":"developers@agentcore.me"},{"name":"agentauthdev","email":"developers@agentauth.co"}],"homepage":"https://github.com/agentcorelabs/agentauth#readme","bugs":{"url":"https://github.com/agentcorelabs/agentauth/issues"},"bin":{"agentauth-mcp":"dist/proxy.js"},"dist":{"shasum":"2cca24cca402b7e53dfe2f190a18f4e4db000014","tarball":"https://registry.npmjs.org/@agentauth/mcp/-/mcp-0.1.1.tgz","fileCount":9,"integrity":"sha512-M8CjFEpc6gLBoTXw8/Faif9YJyaHsBf39Jv6lZTMHou2fro/eVBonKfYwYWgxul6H8MfG4kl4qSwkH5no0w8MA==","signatures":[{"sig":"MEQCIDb6ciaTpnpf9DIQeaKUd4xDXJPy98u0wATSEY7TCRvUAiBuSR/98h+CMdGPG8moxA9UueRBVLI0t/K1/ORHUQFpwg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":36268},"main":"dist/proxy.js","type":"module","types":"dist/proxy.d.ts","engines":{"node":">=18.0.0"},"gitHead":"bd9fb7af453d65d36762dc2b1de17a8159d1753c","scripts":{"dev":"tsc -w","test":"vitest run","build":"tsc && node -e \"const fs = require('fs'); const path = './dist/proxy.js'; if (process.platform !== 'win32') { fs.chmodSync(path, '755'); }\""},"_npmUser":{"name":"agentauthdev","actor":{"name":"agentauthdev","type":"user","email":"developers@agentauth.co"},"email":"developers@agentauth.co"},"repository":{"url":"git+https://github.com/agentcorelabs/agentauth.git","type":"git","directory":"packages/agentauth-mcp"},"_npmVersion":"10.9.0","description":"A universal proxy for remote MCP server connections, with and without authentication.","directories":{},"_nodeVersion":"23.3.0","dependencies":{"yargs":"^18.0.0","@agentauth/core":"0.1.1","@modelcontextprotocol/sdk":"^1.12.3"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"@types/yargs":"^17.0.33"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.1.1_1751572971305_0.9922931859473865","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@agentauth/mcp","version":"0.1.2","keywords":["agentauth","authentication","identity","mcp","mcp-clients","mcp-servers","proxy","cli","command-line","terminal","connector","ai-agents","model-context-protocol"],"author":{"name":"AgentAuth Team"},"license":"MIT","_id":"@agentauth/mcp@0.1.2","maintainers":[{"name":"agentcoredev","email":"developers@agentcore.me"},{"name":"agentauthdev","email":"developers@agentauth.co"}],"homepage":"https://github.com/agentcorelabs/agentauth#readme","bugs":{"url":"https://github.com/agentcorelabs/agentauth/issues"},"bin":{"agentauth-mcp":"dist/proxy.js"},"dist":{"shasum":"c69a52bdc8f402444126c117e96f879c4936fb60","tarball":"https://registry.npmjs.org/@agentauth/mcp/-/mcp-0.1.2.tgz","fileCount":9,"integrity":"sha512-2JzzINmZBVsrUuRhfSgggeK38izP6egfNEHLawS5I4QMFEqAzNjEkPg1tKWPbXcB9zsgDY2v7Kq1fB9jZ4aoNA==","signatures":[{"sig":"MEQCIDHxIZyyncEbSZmakMdodCCewssSH4XplrUdejNtXjMLAiAs9AXzACg/y0Fgikak3M58geCOToYwf9cBaZbM9YnNkA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":42620},"main":"dist/proxy.js","type":"module","types":"dist/proxy.d.ts","engines":{"node":">=18.0.0"},"gitHead":"c846292bf1d64fffa430d13c4a020c19e3c017a1","scripts":{"dev":"tsc -w","test":"vitest run","build":"tsc && node -e \"const fs = require('fs'); const path = './dist/proxy.js'; if (process.platform !== 'win32') { fs.chmodSync(path, '755'); }\""},"_npmUser":{"name":"agentauthdev","actor":{"name":"agentauthdev","type":"user","email":"developers@agentauth.co"},"email":"developers@agentauth.co"},"repository":{"url":"git+https://github.com/agentcorelabs/agentauth.git","type":"git","directory":"packages/agentauth-mcp"},"_npmVersion":"10.9.0","description":"A universal proxy for remote MCP server connections, with and without authentication.","directories":{},"_nodeVersion":"23.3.0","dependencies":{"yargs":"^18.0.0","@agentauth/core":"0.1.1","@modelcontextprotocol/sdk":"^1.12.3"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"@types/yargs":"^17.0.33"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.1.2_1751913686636_0.2582519901872742","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@agentauth/mcp","version":"0.2.0","keywords":["agentauth","mcp","gateway","payments","authentication","identity","wallet","crypto","blockchain","ethereum","base","ai-agents","mcp-clients","mcp-servers","model-context-protocol"],"author":{"name":"AgentAuth Team"},"license":"MIT","_id":"@agentauth/mcp@0.2.0","maintainers":[{"name":"agentcoredev","email":"developers@agentcore.me"},{"name":"agentauthdev","email":"developers@agentauth.co"}],"homepage":"https://github.com/agentauthco/mcp-gateway#readme","bugs":{"url":"https://github.com/agentauthco/mcp-gateway/issues"},"bin":{"agentauth-mcp":"dist/proxy.js"},"dist":{"shasum":"0887a8529d7a535ec3a6396f1bee594fd3b27f03","tarball":"https://registry.npmjs.org/@agentauth/mcp/-/mcp-0.2.0.tgz","fileCount":27,"integrity":"sha512-4AEdGb0UOgOlmjKNSNU7Ro8bgOxBvt9+4OTRn1IBDJharGvwf9wUNmrP45oiEoZmwc5GqSf0DKVghZlCl0Ijgw==","signatures":[{"sig":"MEQCIA1A9B+3OyKH1iUMUq37kyt2EXRNQ71puDQy3DW4ur17AiB5Qimwa/Ck9Z2xFxm6mF/mJlIe+0U5fiasJK5PZ0Q/Ww==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":140401},"main":"dist/proxy.js","type":"module","types":"dist/proxy.d.ts","engines":{"node":">=18.0.0"},"gitHead":"c3785a19aa9f160a64b4a67e2765fc7e1f21645b","scripts":{"dev":"tsc -w","test":"vitest run","build":"tsc && node -e \"const fs = require('fs'); const path = './dist/proxy.js'; if (process.platform !== 'win32') { fs.chmodSync(path, '755'); }\"","test:all":"npm run test:unit && npm run test:integration","validate":"npm run build && npm run test:all","test:unit":"vitest run src/","test:integration":"vitest run tests/integration/"},"_npmUser":{"name":"agentauthdev","email":"developers@agentauth.co"},"repository":{"url":"git+https://github.com/agentauthco/mcp-gateway.git","type":"git"},"_npmVersion":"10.9.0","description":"Universal payment-enabled MCP gateway for AI agents with native x402 protocol support.","directories":{},"_nodeVersion":"23.3.0","dependencies":{"yargs":"^18.0.0","ethers":"^6.13.0","@agentauth/core":"0.1.1","@modelcontextprotocol/sdk":"^1.12.3"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^1.6.0","typescript":"^5.8.3","@types/node":"^20.0.0","@types/yargs":"^17.0.33"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.2.0_1758096706262_0.6018772485378092","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@agentauth/mcp","version":"0.2.1","description":"Universal payment-enabled MCP gateway for AI agents with native x402 protocol support.","main":"dist/proxy.js","types":"dist/proxy.d.ts","bin":{"agentauth-mcp":"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","mcp","gateway","payments","authentication","identity","wallet","crypto","blockchain","ethereum","base","ai-agents","mcp-clients","mcp-servers","model-context-protocol"],"author":{"name":"AgentAuth Team"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/substrates-ai/mcp-gateway.git"},"homepage":"https://github.com/substrates-ai/mcp-gateway#readme","bugs":{"url":"https://github.com/substrates-ai/mcp-gateway/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/mcp@0.2.1","gitHead":"2bb9572bf2014b9a6eebdae7b4b11cffdb452acc","_nodeVersion":"23.3.0","_npmVersion":"10.9.0","dist":{"integrity":"sha512-aVaPaZSyCSOxAQrAtEebJ5upF4NFmUoByHrDZsNIym933csqQ0ZiRnFBvRH0iVl2tTQKi/QSoarYyYjTcGXACw==","shasum":"fd73531ea00b076a45cd5aa6433c5bd1cf182527","tarball":"https://registry.npmjs.org/@agentauth/mcp/-/mcp-0.2.1.tgz","fileCount":27,"unpackedSize":151476,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIFAS/ebgKoSA2oiNiBQCQrIexMNbN8SiuPODnAOp5yVXAiAlsHwH7Ed6ErinjtRgvlrv7BV5J0wAHbor3SBiaCb/6Q=="}]},"_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/mcp_0.2.1_1762962927706_0.7651040141604655"},"_hasShrinkwrap":false}},"time":{"created":"2025-06-22T21:41:54.778Z","modified":"2025-11-12T15:55:28.065Z","0.1.0":"2025-06-22T21:41:55.091Z","0.1.1":"2025-07-03T20:02:51.499Z","0.1.2":"2025-07-07T18:41:26.868Z","0.2.0":"2025-09-17T08:11:46.450Z","0.2.1":"2025-11-12T15:55:27.875Z"},"bugs":{"url":"https://github.com/substrates-ai/mcp-gateway/issues"},"author":{"name":"AgentAuth Team"},"license":"MIT","homepage":"https://github.com/substrates-ai/mcp-gateway#readme","keywords":["agentauth","mcp","gateway","payments","authentication","identity","wallet","crypto","blockchain","ethereum","base","ai-agents","mcp-clients","mcp-servers","model-context-protocol"],"repository":{"type":"git","url":"git+https://github.com/substrates-ai/mcp-gateway.git"},"description":"Universal payment-enabled MCP gateway for AI agents with native x402 protocol support.","maintainers":[{"name":"agentcoredev","email":"developers@agentcore.me"},{"name":"agentauthdev","email":"developers@agentauth.co"}],"readme":"# AgentAuth MCP Gateway (@agentauth/mcp) - Universal MCP gateway for AI agents, with MCP-native auth and agentic payments\n\n[![npm version](https://img.shields.io/npm/v/@agentauth/mcp.svg)](https://www.npmjs.com/package/@agentauth/mcp)\n[![npm downloads](https://img.shields.io/npm/dm/%40agentauth%2Fmcp)](https://www.npmjs.com/package/@agentauth/mcp)\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/substrates-ai/mcp-gateway?style=social)](https://github.com/substrates-ai/mcp-gateway)\n\n**AgentAuth MCP Gateway is an auth- and 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 (with or without authentication), 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- **🔐 Universal Authentication**: Works with free, auth-required, and payment-enabled MCP servers\n- **🔥 Agentic Payments**: Frictionless access to paid tools and resources with agentic payments\n- **🛡️ Payment Approvals**: Approve all payments made by the agent - you're in control\n- **⚡ Native x402 Support**: Works with any x402-enabled payments out of the box\n- **👤 No Accounts Required**: Uses AgentAuth for seamless agent-native identification and authentication\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 and Google AP2 (coming soon)\n\n## ⚡ Quick Start\n\n### 1. Install\n\n```bash\nnpm install -g @agentauth/mcp\n```\n\n### 2. Generate Your Identity\n\n```bash\nagentauth-mcp generate\n```\n\nThis creates a unique AgentAuth identity for your agent, including a private key, wallet address, and ID. Save the output - you'll need it later!\n\nNote: You can also use an existing EVM private key instead of generating a new one, if you'd prefer.\n\n### 3. Configure 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-mcp\",\n      \"args\": [\"connect\", \"https://mcp-server.example.com/mcp\"],\n      \"env\": {\n        \"AGENTAUTH_TOKEN\": \"your-token-or-private-key\"\n      }\n    }\n  }\n}\n```\n\n**For Cursor/Windsurf**, add to your MCP configuration similarly.\n\nNote: The AGENTAUTH_TOKEN field is only required if you want to use agentauth-mcp with an MCP server which requires payments or AgentAuth authentication.\n\n### 4. Start Using Premium MCP Servers\n\nOpen Claude and request premium content from an MCP server. When payment is required, your agent will show you something like this:\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\nThen tell 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 agent identity** (if you haven't already):\n```bash\nnpm install -g @agentauth/mcp\nagentauth-mcp generate\n# Remember to save your AGENTAUTH_TOKEN!\n```\n\nNote: You can also use 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-mcp\",\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 agent's wallet address** 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-mcp generate\n```\nCreates a new AgentAuth token, wallet address, and agent ID.\n\n### Derive Address from Key\n```bash\nagentauth-mcp derive <private-key>\n```\nGet your wallet address and agent ID from an existing private key.\n\n### Connect to Server\n```bash\nagentauth-mcp connect <server-url>\n```\nConnect to any MCP server, just like you normally would.\n\n### Connection Options\n```bash\nagentauth-mcp connect <server-url> --header \"Authorization: Bearer token\"\n```\nAdd custom headers, e.g. 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 built-in wallet automatically detects which network (Base mainnet/testnet) each server uses.\n\nYour wallet address 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-mcp 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-mcp 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 agent-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- [Substrates.ai](https://substrates.ai)\n- [x402 Protocol Specification](https://www.x402.org)\n- [AgentAuth Documentation](https://agentauth.co)\n- [Model Context Protocol](https://modelcontextprotocol.io)\n\n## 📄 License\n\nMIT License - see [LICENSE](LICENSE) file for details.\n\n---\n\n**Substrates -- collaboration infrastructure for AI agents.**\n","readmeFilename":"README.md"}