AgentPay — trust routing + spend caps for x402 agents
Budget-capped sessions, free market tools and receipts for agents paying over x402
- Pricing
- Freemium
- Platforms
- CLI, API
- Runs
- Locally or Remotely
- Version
- 2.9.0
- Listing updated
- 3 days ago
About AgentPay — trust routing + spend caps for x402 agents
AgentPay — trust routing + spend caps for x402 agents is a freemium MCP server for finance and payments. It can run locally on your machine or as a hosted remote server.
AgentPay positions itself as the layer that decides whether an agent should spend money, not a wallet that moves it. Each session opens with a hard cap enforced at the payment layer, before any payment is signed; the agent can see call costs, check what remains and switch to cheaper options, and a receipt lists every call, cost and timestamp.
The MCP package offers a keyless mode with free tools, including url_reader, web_search, market_snapshot, token_price, gas_tracker and fear_greed_index. Wallet mode is off by default: set AGENTPAY_ENABLE_PAID to settle paid tools from a wallet the server mints on first run, with AGENTPAY_MAX_SPEND defaulting to $0.10 per session. Payments settle in USDC on Base and Stellar, and sBTC on Stacks.
The README counts 22 tools (17 free) and lists a verified_route trust oracle. A Python SDK installs with pip install agentpay-x402 and its quickstart() registers an agent and returns a capped session.
Install
Run in a terminal
claude mcp add --transport http agentpay https://agentpay.tools/mcpAdd to Settings → Connectors → Add custom connector
https://agentpay.tools/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"agentpay": {
"url": "https://agentpay.tools/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"agentpay": {
"type": "http",
"url": "https://agentpay.tools/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"agentpay": {
"serverUrl": "https://agentpay.tools/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"agentpay": {
"type": "http",
"url": "https://agentpay.tools/mcp"
}
}
}Configuration
AGENTPAY_BASE_KEYOptional EVM private key for wallet mode: settle paid tools in-place (gasless EIP-3009 on Base). Keyless free-tools mode works without it.AGENTPAY_ENABLE_PAIDSet to 1 to settle paid tools from the wallet the server mints on first run (fund it with USDC on Base first). Off by default.AGENTPAY_MAX_SPENDHard per-session spend cap in USD when wallet mode is enabled (default 0.10).
Tools this server provides (7)
Taken from the project documentation; the running server may differ.
- url_reader
- Returns clean markdown for a web page URL.
- web_search
- Returns the top 5 results with full content.
- market_snapshot
- Returns S&P 500, Treasury yield, BTC, ETH and gas in one call.
- token_price
- Returns price, 24h change and market cap for a symbol.
- gas_tracker
- Returns slow, standard and fast gas prices and base fee.
- fear_greed_index
- Returns the fear and greed value, classification and history.
- token_market_data
- Returns market data for a token pair.
What it does
- Enforced spend cap
- Hard budget applied before payments are signed.
- Free tools
- Seventeen free tools for market data and web reading.
- Session receipts
- Itemized record of calls, costs and transactions.
- Opt-in wallet
- Paid tools settle only after enabling wallet mode.
- Multi-network
- USDC on Base and Stellar, sBTC on Stacks.
Good for
- Limit what an agent can spend per run
- Pull token prices and market snapshots without a wallet
- Audit what an agent paid for and why
- Route to the cheaper of two tools
Pricing
Freemium
17 free tools; 3 paid tools settled per call in USDC.
Prices change. Check agentpay.tools before you buy.
AgentPay — trust routing + spend caps for x402 agents FAQ
Do I need a wallet?
Not for the free tools; paid wallet mode is off by default.
What is the default cap?
$0.10 per session when wallet mode is enabled, via AGENTPAY_MAX_SPEND.
Which networks are supported?
Base and Stellar with USDC, and Stacks with sBTC.
How do I install the Python SDK?
pip install agentpay-x402.
Is AgentPay — trust routing + spend caps for x402 agents free?
AgentPay — trust routing + spend caps for x402 agents has a free plan, with paid plans for more usage or features.
How do I add AgentPay — trust routing + spend caps for x402 agents to Claude Code?
Run this command in your terminal: claude mcp add --transport http agentpay https://agentpay.tools/mcp
What are the best alternatives to AgentPay — trust routing + spend caps for x402 agents?
The closest alternatives to AgentPay — trust routing + spend caps for x402 agents are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.
Alternatives to AgentPay — trust routing + spend caps for x402 agents

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools