Skip to content
MCP server

AgentPay — trust routing + spend caps for x402 agents

Budget-capped sessions, free market tools and receipts for agents paying over x402

Install
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/mcp

Add to Settings → Connectors → Add custom connector

https://agentpay.tools/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "agentpay": {
      "url": "https://agentpay.tools/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools