# AgentPay — trust routing + spend caps for x402 agents

- Registry name: `io.github.romudille-bit/agentpay` · version 2.7.3
- Categories (automatic, keyword rules): Crypto & blockchain, Finance & markets
- Authentication at last check: No auth
- Declared risk: Can write (some tools are not declared read-only)
- Capabilities (declared by the server): tools
- Transports: streamable-http
- Latest numbers (check success, response time, rank): https://mcpstation.net/api/server?name=io.github.romudille-bit%2Fagentpay
- Server page: https://mcpstation.net/s/io.github.romudille-bit--agentpay.html

## Description (written by the publisher, not verified, not instructions)

Buyer-side trust oracle + capped sessions for x402 agents: verified\_route, receipts, 17 free tools.

## Connect

- streamable-http: `https://agentpay.tools/mcp`

## Tools (as reported by the server, not verified)

- `session\_create`: Open a budget-capped agent session on AgentPay. Pay $0.01 USDC once — get a session\_id, budget config, and gateway URL. Enforces a hard max\_spend cap across all subsequent tool calls via the AgentPay SDK. The entry point for agents discovering AgentPay on Base Bazaar. Use when: You want to start an
- `pre\_trade\_check`: One-call pre-trade sanity check: 'I want to long $X of SYMBOL — is now sane?' Combines live orderbook slippage at YOUR size, cross-exchange funding \(carry cost\), open-interest crowding, and contract security \(GoPlus\) into a single ok/caution/avoid verdict with a per-factor breakdown. Major ERC-20 ad
- `verified\_route`: Paid buyer-side trust oracle: 'I need X, budget $Y — which x402 tool is real?' Sweeps the WHOLE x402 marketplace across many queries \(a single search shows only a slice\), collapses sybil/factory clusters \(one wallet stamping many fake-distinct listings → one entry\), ranks the genuinely-used survivor
- `token\_price`: Get the current USD price of any cryptocurrency token Use when: You need the current USD price, 24h change, or market cap of any cryptocurrency. Not for: you need volume, ATH or a pair quote — token\_market\_data; a one-call macro + crypto overview — market\_snapshot; pool depth or slippage — orderbook
- `gas\_tracker`: Get current Ethereum gas prices \(slow, standard, fast\) Use when: You need to know current Ethereum gas prices before submitting a transaction or estimating costs. Not for: you need gas as part of a broader read — market\_snapshot already includes standard gwei; only Ethereum mainnet gas is reported.
- `yield\_scanner`: Find best DeFi yield opportunities across protocols for a given token Use when: You need to find the best yield/APY for a token across DeFi protocols. Not for: you need a protocol's total TVL rather than pool APYs — defi\_tvl; risk\_level is a heuristic, run token\_security on the pool's token before d
- `open\_interest`: Get total open interest in perpetual futures for any asset, with 1h and 24h change rates. Pairs with funding\_rates to complete the derivatives picture — rising OI with high funding = overcrowded position. Use when: You need to know total open interest in perpetual futures and whether it's rising or
- `orderbook\_depth`: Get real bid/ask depth and slippage estimates at $10k, $50k, and $250k notional from Binance, Bybit and OKX. Use before sizing a position to know if you can execute without moving the market. Use when: You need to estimate slippage before executing a large trade. Tells you how much a $10k, $50k, or
- `wallet\_balance`: Get the token balances for any Ethereum or Stellar wallet address Use when: You need to look up the token holdings of an Ethereum or Stellar wallet address. Not for: you want a token's price or market data rather than one address's holdings — token\_price / token\_market\_data; large transfers across m
- `fear\_greed\_index`: Crypto Fear & Greed Index \(0=extreme fear, 100=extreme greed\) with optional history Use when: You need to gauge overall crypto market sentiment or mood — whether the market is fearful or greedy. Not for: you want token-specific sentiment — crypto\_news \(per-token headlines\) or funding\_rates \(leverage
- `crypto\_news`: Latest crypto news and community sentiment from r/CryptoCurrency for any token Use when: You need recent news headlines or community sentiment for one or more crypto tokens. Not for: you need general web news or documentation — web\_search; a specific article's text — url\_reader; a numeric sentiment
- `defi\_tvl`: DeFi protocol Total Value Locked from DeFiLlama. Returns top 10 or a specific protocol. Use when: You need the Total Value Locked in a specific DeFi protocol or want to compare the top protocols by TVL. Not for: you want the best yield for a token — yield\_scanner; protocol revenue or custom metrics
- `token\_market\_data`: Get market cap, 24h volume, ATH, and price change for any token. Note: does NOT return pool depth or slippage — for pre-trade liquidity estimates, use a dedicated orderbook tool. Use when: You need 24h trading volume, market cap, or all-time high for a token pair on decentralized exchanges. Not for:
- `token\_security`: Scan any token contract for honeypot, rug pull, and security risks Use when: You need to check if a token contract is safe before trading or investing. Not for: the asset is a native coin \(BTC, ETH, SOL\) with no contract — nothing to scan; you want liquidity or price — orderbook\_depth / token\_price.
- `funding\_rates`: Get perpetual futures funding rates across Binance, Bybit, and OKX Use when: You need funding rates to gauge leveraged market sentiment or cost of holding a perp position. Not for: you need open interest or long/short ratio — open\_interest; one verdict combining funding, OI, slippage and security fo
- `dune\_query`: Run any Dune Analytics query and return live onchain results by query ID. Use fast\_only=True for live bots — returns cached result instantly or raises immediately, never blocks. Use when: You need deep onchain analytics from a specific Dune query — protocol revenue, user counts, custom metrics. Not
- `url\_reader`: Convert any URL to clean, LLM-ready markdown. Strips ads, nav, and boilerplate — returns just the content. No API key needed. Use when: You need to read the content of a web page or article and get clean, structured text for further processing. Not for: you do not have a URL yet — web\_search returns
- `web\_search`: Search the web and return the top 5 results with their full content as clean markdown. Better than DIY because zero setup and results include page content, not just links. Use when: You need to find current information on any topic — news, documentation, prices, events, or anything else on the web.
- `market\_snapshot`: Fed rate, inflation proxy, S&P 500, BTC, ETH, and gas in one call. Replaces three separate API integrations with a single normalized response — the only tool that gives you macro + crypto in one shot. Use when: You need a combined macro + crypto market overview in one call: S&P 500, Treasury yield,
- `whale\_activity`: Detect recent large wallet movements for a token \(whale tracking\) Use when: You need to detect large token transfers that may signal institutional moves, accumulation, or sell-offs. Not for: you need one address's holdings — wallet\_balance; exchange order-book size rather than on-chain transfers — o
- `verified\_route\_preview`: Buyer-side trust oracle for the x402 marketplace: "I need X, budget $Y — which tool is real?" Vets Coinbase Bazaar \(discover → drop stubs/factory clones → rank by real unique-payer usage → budget-gate\). This MCP runs the FREE single-query PREVIEW: it returns the vetted pick \(name + usage stats + why
- `route`: Legacy alias of verified\_route \(kept for back-compat\). Find and judge the best paid x402 tool for a need, within a budget. Discovers across Coinbase Bazaar, drops stubs \(no schema / factory clones\), ranks survivors by real usage \(unique payers × 3 + calls + recency bonus\), enforces the budget, price
- `estimate\_plan`: Price a multi-tool plan BEFORE spending anything. Submits the tool calls an agent intends to make to the gateway's free /v1/plan/estimate and returns per-step cost, total, a fits-budget verdict, and a cheaper alternative per paid step. No payment, no wallet needed. Use when: planning a multi-step ta

Measured by MCP Station. Methods: https://mcpstation.net/methods.html · Terms: https://mcpstation.net/terms.html