How do I install Agentpay?

Agentpay supports both local and remote installation. For local use, install it via npm (npx) and add the configuration to your AI app. For remote access, add the server URL to your MCP configuration.

Is Agentpay safe to use?

Yes. Agentpay passed MCP Marketplace's automated security scan with a score of 9.2/10 (low risk). Every server on MCP Marketplace is security-scanned before it's listed; see the full security report on this page for the findings and permissions.

What credentials does Agentpay need?

Agentpay requires the following credentials or environment variables: AGENTPAY_BASE_KEY, AGENTPAY_ENABLE_PAID, AGENTPAY_MAX_SPEND. You can find setup instructions on the server detail page.

What AI apps work with Agentpay?

Agentpay uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

Agentpay MCP Server

by romudille-bit

Developer ToolsLow Risk9.2LocalRemote

Free

Buyer-side trust oracle and hard spend caps for agents paying x402 APIs. 17 free tools, no keys.

About

Most agent-payment tools are a wallet: they move money. AgentPay is the layer that decides whether to spend it at all.

AgentPay gives an AI agent economic intelligence while it works, not after the bill arrives. Every session opens with a hard USDC budget cap enforced at the payment layer, before any payment is signed. Before paying for an x402 API, the agent can ask `verified_route` which provider is actually worth paying: it sweeps the x402 marketplace (Coinbase Bazaar and x402scan), collapses sybil and factory clones, ranks the survivors by real paying users and delivery, and returns one vetted recommendation with a ready-to-pay challenge. When the session ends, a receipt lists every call, every cost and every settlement transaction.

Out of the box you get 17 free crypto and market-data tools (prices, gas, funding rates, open interest, order-book depth, DeFi TVL, token security scans, whale transfers, Dune queries, web search, URL reader) with no API keys, no wallet and no account. Three paid tools cost $0.01 each and settle over x402 in USDC on Base: `session_create` (capped session with receipt), `pre_trade_check` (one-call trade verdict) and `verified_route` (the trust oracle). Spending is off by default and is bounded by `AGENTPAY_MAX_SPEND` when you turn it on.

Who it is for: developers running agents that buy data or compute from x402 APIs and want to know what a plan should cost and which provider to trust before money moves; trading and research agents that need a pre-trade risk verdict; anyone who wants a priced, receipted session instead of an open wallet.

Runs locally (`npx @romudille/agentpay-mcp`) or as a remote Streamable HTTP server at https://agentpay.tools/mcp (keyless set: 17 free tools, `verified_route_preview`, `estimate_plan`). A Python SDK (`pip install agentpay-x402`) exposes the same sessions with policy controls (allowed tools, per-tool caps, recipient allowlist, approval threshold) and settles in USDC on Base and Stellar or sBTC on Stacks.

Security Report

9.2

Low Risk9.2Low Risk

Valid MCP server (2 strong, 2 medium validity signals). 1 known CVE in dependencies ⚠️ Package registry links to a different repository than scanned source. Imported from the Official MCP Registry. 1 finding(s) downgraded by scanner intelligence.

23 tools verified · Open access · 2 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

Optional EVM private key for wallet mode: settle paid tools in-place (gasless EIP-3009 on Base). Keyless free-tools mode works without it.Required

Environment variable: AGENTPAY_BASE_KEY

Set 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.Optional

Environment variable: AGENTPAY_ENABLE_PAID

Hard per-session spend cap in USD when wallet mode is enabled (default 0.10).Optional

Environment variable: AGENTPAY_MAX_SPEND

How to Install & Connect

Available as Local & Remote

This plugin can run on your machine or connect to a hosted endpoint. during install.

Getting Started

Once installed, try these example prompts and explore these capabilities:

1"What's the current ETH price and 24h change?"
2"Check the Fear & Greed Index and the ETH funding rates across exchanges"
3"Before I go long $25k ETH, run a pre-trade check"
4"I need a token security scan API under $0.01 per call. Which x402 provider should I pay?"
5"Estimate what a plan of token_price, pre_trade_check and session_create would cost"
6Tool: verified_route — Find and vet the best paid x402 provider for a need within a budget; returns one recommendation plus the payment challenge. Use before paying any x402 API you have not used before.
7Tool: pre_trade_check — One-call risk verdict for a trade at your size and side. Use before placing an order.
8Tool: session_create — Open a budget-capped session with a receipt. Use when an agent will make several paid calls.
9Tool: estimate_plan — Price a multi-tool plan before spending. Free.
10Tool: token_price, gas_tracker, funding_rates, open_interest, orderbook_depth, defi_tvl, token_security, whale_activity — Free market data, no keys.

Reviews

No reviews yet

Be the first to review this server!

installs

New

no ratings yet

Uptime

Operational

30-day uptime99.68%

Avg latency (24h)210ms

Last checked06:45 AM

Use Cases

Hard per-session spend cap enforced before any payment is signed
not in prompt text an agent can ignore
`verified_route`: buyer-side trust oracle that vets x402 providers for a need and returns one ready-to-pay recommendation
Sybil and factory-clone collapse: listings from the same wallet or template are merged before ranking
Ranking by real paying users
call volume and recency rather than self-reported stats
`pre_trade_check`: one-call ok / caution / avoid verdict with slippage at your size
funding carry
open-interest crowding and optional token security
`estimate_plan`: price a whole multi-tool plan before spending anything
with cheaper alternatives
Session receipt: every call
cost
settlement chain and transaction hash
Anomaly flags for repeated identical paid calls
a single call taking half the cap
and unconfirmed settlements
17 free market-data tools with no API keys: prices
gas
funding
open interest
order-book depth
DeFi TVL
yields
token security
whale activity
wallet balances
crypto news
Dune queries
web search
URL reader
Gasless x402 settlement on Base (EIP-3009): no ETH needed
a rejected call moves no USDC
Spending off by default; the minted per-install wallet never holds more than you fund it with
Remote mode with no install for claude.ai
ChatGPT
Perplexity and other hosted MCP clients
Python SDK with policy parameters: allowed tools
per-tool caps
recipient allowlist
per-call maximum
approval callback above a threshold
Multi-chain settlement in the SDK: USDC on Base and Stellar
sBTC on Stacks mainnet
Listed in the official MCP Registry as `io.github.romudille-bit/agentpay`