
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.
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
- Double-click the installer - A browser window will open automatically
- Enter your API credentials from Step 1
- Select your AI tools - The installer auto-detects what's installed
- Click "Install" - Installation completes in seconds
- 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:
- Open Windows Security ā Virus & threat protection
- Click Manage settings
- Scroll to Exclusions ā Add or remove exclusions
- Click Add an exclusion ā Folder
- Add:
%USERPROFILE%\.agent-payment
Option 2: Run Anyway (One-time) When Windows Defender warns you:
- Click More info
- Click Run anyway
Tools Not Showing Up
- Restart your AI tool completely - Close and reopen
- 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
- Claude Desktop: Open logs in
- Verify installation:
- Check that
~/.agent-payment/agent-payment-server
exists - Check that
~/.agent-payment/config.json
contains your API keys
- Check that
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:
-
Remove the MCP server:
rm -rf ~/.agent-payment
-
Remove from AI tool configs:
- Claude Desktop: Edit
claude_desktop_config.json
and removeagent-payment
section - Cursor: Edit
~/.cursor/mcp.json
and removeagent-payment
section - VS Code: Edit
mcp.json
in settings and removeagent-payment
section - Others: Similar process for each tool
- Claude Desktop: Edit
-
Restart your AI tools
Need Help?
- š Documentation: Installation Guide
- š Issues: GitHub Issues
- š Website: agentpmt.com
For Developers
Want to contribute or build from source? See docs/development/ for technical documentation.
License
MIT - See LICENSE
https://github.com/Apoth3osis-ai/agent-payment-mcp/releases/download/v1.0.1/agent-payment-server
# mcpb: https://github.com/Apoth3osis-ai/agent-payment-mcp/releases/download/v1.0.1/agent-payment-server
https://github.com/Apoth3osis-ai/agent-payment-mcp/releases/download/v1.0.1/agent-payment-server-darwin-amd64
# mcpb: https://github.com/Apoth3osis-ai/agent-payment-mcp/releases/download/v1.0.1/agent-payment-server-darwin-amd64
https://github.com/Apoth3osis-ai/agent-payment-mcp/releases/download/v1.0.1/agent-payment-server-darwin-arm64
# mcpb: https://github.com/Apoth3osis-ai/agent-payment-mcp/releases/download/v1.0.1/agent-payment-server-darwin-arm64
https://github.com/Apoth3osis-ai/agent-payment-mcp/releases/download/v1.0.1/agent-payment-server-windows-amd64.exe
# mcpb: https://github.com/Apoth3osis-ai/agent-payment-mcp/releases/download/v1.0.1/agent-payment-server-windows-amd64.exe