AgentAuth MCP Wallet (@agentauth/wallet) - The payment-enabled MCP gateway for your AI agents

AgentAuth MCP Wallet is a payment-enabled MCP gateway with native x402 protocol support and interactive user approval.

Connect 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.

🚀 Key Features

• 🔥 Payment-Enabled MCP Proxy: Connect to any MCP server, including ones with paid tools and resources
• 🛡️ Interactive Payment Approval: You approve every payment through the agent - your wallet, you're in control
• ⚡ Native x402 Support: Works with any x402-protected server out of the box
• 🔐 No Accounts Required: Uses AgentAuth for seamless agent-native identification
• 🌐 Multi-Chain Ready: Supports USDC on Base mainnet and Base Sepolia testnet
• 🔮 Multi-Protocol: Built for x402 with support for emerging protocols like AgentPay

🛡️ Safe Payment Flow

1. Request premium content in Claude/Cursor
2. agentauth-wallet detects payment requirement
3. → YOU GET PROMPTED: "Pay $0.01 USDC to access premium news?"
4. You approve → payment executes → content delivered
5. You decline → operation cancelled safely

No surprise charges. You're always in control.

⚡ Quick Start

1. Install

npm install -g @agentauth/wallet

2. Generate Your Identity

agentauth-wallet generate

This creates your unique AgentAuth identity, including a private key and wallet address. Save the output - you'll need it!

3. Add to Your MCP Client

For Claude Desktop, add to your claude_desktop_config.json:

{
  "mcpServers": {
    "premium-news": {
      "command": "agentauth-wallet",
      "args": ["connect", "https://mcp-server.example.com/mcp"]
    }
  }
}

For Cursor/Windsurf, add to your MCP configuration similarly.

4. Start Using Premium Services

Open Claude and request premium content. When payment is required, you'll see:

💳 Payment Required
📄 Service: Premium News Article
💰 Amount: $0.01 USDC
🏦 Your Balance: $5.23 USDC

Approve this payment?

Tell the agent what you'd like to do. It's that simple!

🎯 Try It Now - Live Demo Server

Want to see it in action? We have a live demo news server ready for testing!

Quick Test Setup

1. Install and generate your wallet (if you haven't already):

npm install -g @agentauth/wallet
agentauth-wallet generate
# Save your AGENTAUTH_TOKEN!

Note: You can also import an existing EVM private key instead of generating a new one, if you'd prefer.

2. Add to Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "news-demo": {
      "command": "agentauth-wallet",
      "args": ["connect", "https://mcp-news-dev-production.up.railway.app/mcp"],
      "env": {
        "AGENTAUTH_TOKEN": "your-token-or-private-key"
      }
    }
  }
}

3. Fund your wallet with a small amount of USDC and ETH on Base mainnet

4. Start using it in Claude:

   • "Get me the latest tech news" (free)
   • "Get me (such and such) article" (some articles require payment - you'll see the payment request and approval prompt!)

Demo Server Details

• URL: https://mcp-news-dev-production.up.railway.app/mcp
• Network: Base mainnet
• Free tools: Basic news search, articles from certain sources
• Paid tools: Premium articles from paid sources

💡 Common Use Cases

Premium News & Research

Access paid content from news services, research databases, and premium APIs through Claude.

AI Model Access

Pay per request for specialized AI models and computational resources.

Data & Analytics

Access premium datasets, market data, and analytics services on-demand.

Developer Tools

Use paid developer APIs and services through your MCP-enabled editor.

🔧 CLI Reference

Generate New Identity

agentauth-wallet generate

Creates a new AgentAuth identity and wallet address.

Derive Address from Key

agentauth-wallet derive <private-key>

Get your wallet address from an existing private key.

Connect to Server

agentauth-wallet connect <server-url>

Connect to any MCP server, just like you normally would.

Connection Options

agentauth-wallet connect <server-url> --header "Authorization: Bearer token"

Add custom headers for authentication.

⚙️ Configuration

Environment Variables

• AGENTAUTH_TOKEN: Your private key (aa-prefixed, 0x-prefixed, or raw)

Wallet Setup

The wallet automatically detects which network (Base mainnet/testnet) each server uses.

Your wallet needs USDC and ETH for payments on that network:

• USDC: For actual payments to services
• ETH: For transaction fees (gas)

🔍 Troubleshooting

"Payment Required" but No Prompt Appears

• Check that your AGENTAUTH_TOKEN is set correctly
• Verify the server supports x402 protocol
• Try with agentauth-wallet connect <server-url> --debug for detailed logs

"Insufficient Funds" Error

• Check your USDC balance: you need enough for the payment amount
• Check your ETH balance: you need ~$0.01 ETH for transaction fees
• Ensure that your funds are on the right network!
• Use agentauth-wallet derive <your-key> to see your wallet address

Connection Issues

• Verify the server URL is correct and accessible
• Check if the server requires custom headers
• Ensure your MCP client configuration is correct

Payment Stuck/Failed

• Payments are atomic - they either complete fully or fail safely
• Check the blockchain explorer for your transaction status
• Contact the service provider if payments succeed but content isn't delivered

🌟 Supported Protocols

x402 Protocol (Primary)

Industry standard for agentic payments. Works with any x402-protected MCP server automatically.

AgentAuth Integration

Seamless crypto-native identification without accounts or login flows.

AgentPay (Early Support)

Emerging protocol for agent-to-agent payments. Limited adoption currently.

🔮 Coming Soon

• Payment Policies: Set spending limits and auto-approve small payments
• Multi-Asset Support: Pay with different tokens on different chains
• Agentic Wallet Functionality: Manage your wallet with the agent, like any other MCP server
• Additional Payment Protocols: Support for emerging protocols including Google's AP2

📚 Learn More

• x402 Protocol Specification
• AgentAuth Documentation
• Model Context Protocol

📄 License

MIT License - see LICENSE file for details.

AgentAuth -- collaboration infrastructure for AI agents.