Repository avatar
AI Tools
v1.0.1
active

agent-payment-mcp

io.github.Abraxas1010/agent-payment-mcp

Secure USDC payments for AI agents on Base blockchain with budget controls and instant settlement.

Documentation

Agent Payment MCP

One-click installer to add 55+ premium AI tools to Claude Desktop, Cursor, VS Code, and other AI coding assistants.

Agent Payment MCP

What is This?

Agent Payment MCP lets your AI coding assistant (like Claude Desktop) access powerful tools for:

  • 🧮 Smart Math - Symbolic calculus, numerical computing, statistics
  • šŸ“Š Synthetic Data - Generate realistic test data (people, companies, families, e-commerce)
  • šŸ”§ Text Utilities - 30+ text transformation tools (case conversion, formatting, etc.)
  • šŸ Python Isolation - Run Python code with conflicting library versions safely
  • 🌐 Network Tools - WebSocket, MQTT, SMTP, Tor, IPFS access
  • šŸ’¾ Immutable Storage - TWINE cryptographic timestamping and decentralized storage
  • šŸŽ² Random Data - Cryptographically secure random bytes for keys and tokens

All tools are pay-per-use with transparent pricing (most $0.01 per execution).

Quick Install

Step 1: Get API Keys

Visit agentpmt.com and create an account to get:

  • API Key - Authenticates your requests
  • Budget Key - Controls spending limits

Step 2: Download Installer

Download the installer for your operating system:

Windows:

https://github.com/Apoth3osis-ai/agent-payment-mcp/releases/latest/download/agent-payment-installer-windows-amd64.exe

macOS (Apple Silicon - M1/M2/M3):

https://github.com/Apoth3osis-ai/agent-payment-mcp/releases/latest/download/agent-payment-installer-macos-arm64

macOS (Intel):

https://github.com/Apoth3osis-ai/agent-payment-mcp/releases/latest/download/agent-payment-installer-macos-intel

Linux:

https://github.com/Apoth3osis-ai/agent-payment-mcp/releases/latest/download/agent-payment-installer-linux-amd64

Step 3: Run Installer

  1. Double-click the installer - A browser window will open automatically
  2. Enter your API credentials from Step 1
  3. Select your AI tools - The installer auto-detects what's installed
  4. Click "Install" - Installation completes in seconds
  5. Restart your AI tool (Claude Desktop, Cursor, etc.)

That's it! All 55+ tools are now available in your AI assistant.

Supported AI Tools

The installer automatically detects and configures:

  • āœ… Claude Desktop - Anthropic's official desktop app
  • āœ… Claude Code CLI - Command-line interface
  • āœ… Cursor - AI-powered VS Code fork
  • āœ… VS Code - With GitHub Copilot or similar extensions
  • āœ… Windsurf - Codeium's AI IDE
  • āœ… Zed - Modern code editor with AI
  • āš™ļø JetBrains IDEs - Manual configuration required (IntelliJ, PyCharm, etc.)

Troubleshooting

Windows: "Windows Defender blocked this app"

This is normal for unsigned executables. To allow the installer:

Option 1: Add Exclusion (Automatic) The installer tries to do this automatically, but if it fails:

  1. Open Windows Security → Virus & threat protection
  2. Click Manage settings
  3. Scroll to Exclusions → Add or remove exclusions
  4. Click Add an exclusion → Folder
  5. Add: %USERPROFILE%\.agent-payment

Option 2: Run Anyway (One-time) When Windows Defender warns you:

  1. Click More info
  2. Click Run anyway

Tools Not Showing Up

  1. Restart your AI tool completely - Close and reopen
  2. Check MCP server status:
    • Claude Desktop: Open logs in %APPDATA%\Claude\logs\ (Windows) or ~/Library/Application Support/Claude/logs/ (macOS)
    • Look for [agent-payment] entries
  3. Verify installation:
    • Check that ~/.agent-payment/agent-payment-server exists
    • Check that ~/.agent-payment/config.json contains your API keys

Still Having Issues?

  • Check logs: Most AI tools have MCP logs showing connection errors
  • Verify API keys: Make sure they're copied correctly (no extra spaces)
  • Check network: Some tools require internet access to connect
  • Open an issue: GitHub Issues

What Gets Installed?

The installer creates:

~/.agent-payment/
ā”œā”€ā”€ agent-payment-server     # MCP server binary (6-8 MB)
└── config.json              # Your API credentials (encrypted)

And updates your AI tool's MCP configuration file(s).

Security & Privacy

  • āœ… API keys stored locally - Never sent to third parties
  • āœ… Open source - All code is auditable on GitHub
  • āœ… No telemetry - We don't track usage beyond API billing
  • āœ… Encrypted communication - All API calls use HTTPS
  • āœ… Budget controls - Set spending limits via Budget Key

Uninstall

To remove Agent Payment MCP:

  1. Remove the MCP server:

    rm -rf ~/.agent-payment
    
  2. Remove from AI tool configs:

    • Claude Desktop: Edit claude_desktop_config.json and remove agent-payment section
    • Cursor: Edit ~/.cursor/mcp.json and remove agent-payment section
    • VS Code: Edit mcp.json in settings and remove agent-payment section
    • Others: Similar process for each tool
  3. Restart your AI tools

Need Help?

For Developers

Want to contribute or build from source? See docs/development/ for technical documentation.

License

MIT - See LICENSE

MCPB
https://github.com/Apoth3osis-ai/agent-payment-mcp/releases/download/v1.0.1/agent-payment-server
Install Command
# mcpb: https://github.com/Apoth3osis-ai/agent-payment-mcp/releases/download/v1.0.1/agent-payment-server
Runtime: binary
MCPB
https://github.com/Apoth3osis-ai/agent-payment-mcp/releases/download/v1.0.1/agent-payment-server-darwin-amd64
Install Command
# mcpb: https://github.com/Apoth3osis-ai/agent-payment-mcp/releases/download/v1.0.1/agent-payment-server-darwin-amd64
Runtime: binary
MCPB
https://github.com/Apoth3osis-ai/agent-payment-mcp/releases/download/v1.0.1/agent-payment-server-darwin-arm64
Install Command
# mcpb: https://github.com/Apoth3osis-ai/agent-payment-mcp/releases/download/v1.0.1/agent-payment-server-darwin-arm64
Runtime: binary
MCPB
https://github.com/Apoth3osis-ai/agent-payment-mcp/releases/download/v1.0.1/agent-payment-server-windows-amd64.exe
Install Command
# mcpb: https://github.com/Apoth3osis-ai/agent-payment-mcp/releases/download/v1.0.1/agent-payment-server-windows-amd64.exe
Runtime: binary