AgentPay — trust routing + spend caps for x402 agents
Buyer-side trust oracle + capped sessions for x402 agents: verified_route, receipts, 17 free tools.
| Endpoint | https://agentpay.tools/mcp (streamable-http) |
|---|---|
| Registry version | 2.8.1 |
| Now | 25 tools · grade D (60) · pin ts_49a73a6f98be05ffd313cbf431aab08a · protocol 2025-06-18 |
| First / last listed | 2026-11-15 00:22 UTC / 2026-11-15 00:22 UTC |
| Grade over time | 2026-11-15: D (60), 25 tools |
Is this your server? Own a server? ToolFit hosted watch re-checks it every 24 h ($0.25 per 30 days) or 6 h ($0.60) and sends you an HMAC-signed webhook when its tools or grade change: POST https://api.youraitools.co/toolfit/v1/watch. To opt out, see About & opt-out.
Tools: session_create pre_trade_check verified_route funding_spread sbtc_peg token_price gas_tracker yield_scanner open_interest orderbook_depth wallet_balance fear_greed_index crypto_news defi_tvl token_market_data token_security funding_rates dune_query url_reader web_search market_snapshot whale_activity verified_route_preview route estimate_plan
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 AgentPay session with a hard spend cap and get a session_id for tracking.
Not for: you only need a params: agent_address, max_spend, label |
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 addresses (LINK, UNI, ARB, OP, AAVE, PEPE, SHIB) resolve automatically; native assets (BTC, ETH, SOL, params: symbol*, size_usd, side, venue, token_address |
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 survivors by real unique-payer usage, and returns ONE vetted recommendation with a ready-to-pay x402 challen params: need*, budget_usd, chain |
funding_spread | Cross-venue perp funding divergence for one asset — the basis/carry read, not the raw rates. Reads Binance, Bybit, OKX, Gate.io, Bitget, Hyperliquid, dYdX, MEXC and KuCoin in parallel, normalises every rate to a per-8h figure (hourly venues scaled), and returns the spread (max minus min, cheapest and dearest venue, deviation from the median), its percentile against the last 7 days of cross-venue s params: symbol*, notional_usd |
sbtc_peg | The sBTC peg as an agent-readable feed — the one dataset only Stacks state can answer. Live sBTC supply (and share of the peg cap), peg-in and peg-out flows for 24h and 7d (sats, counts, unique recipients, net), in-flight bridge requests (pending and accepted deposits with the oldest pending age, pending withdrawals, 24h failures), the last peg events with Bitcoin txids, the signer set and signatu params: none |
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_depth.
Returns: price_usd, change_24h_pct, market_cap_usd, coin_id
Example response: {"symbol":"ET params: symbol* |
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.
Returns: slow_gwei, standard_gwei, fast_gwei, base_fee_gwei, estimated confirmation times
Example r params: none |
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 depositing.
Returns: list of pools with protocol, apy, tvl_usd, chain, risk_level sorted by APY desc params: token*, chain, min_tvl |
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 falling. Combine with funding_rates for a full derivatives picture.
Not for: you need the funding c params: asset |
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 $250k order will move the market.
Not for: you need market cap or 24h volume — token_market_data; a params: asset* |
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 many wallets — whale_activity. Ethereum addresses are 0x…, Stellar addresses G…; no other chains.
Re params: address*, chain* |
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 (leveraged positioning).
Returns: value (0–100), value_classification (e.g. 'Greed'), optional history[]
Exa params: limit |
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 gauge — fear_greed_index.
Returns: headlines[] with title, url, sentiment (bullish/neutral/bearish) params: currencies, filter |
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 — dune_query.
Returns: tvl, change_1h, change_1d, change_7d, chains[], category for the protocol (o params: protocol |
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: you only need the spot price — token_price is lighter; you need pool depth or slippage — orderbook params: token_a*, token_b* |
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. Ethereum and BSC contracts only.
Returns: risk_level, is_honeypot, buy_tax, sell_tax, holder_count params: contract_address*, chain |
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 for a trade — pre_trade_check.
Returns: funding_rate_pct, annualized_rate_pct, sentiment (bullish/neu params: asset |
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 for: you have no Dune query ID — the other tools cover prices, derivatives, TVL and security withou params: query_id*, query_parameters, limit, fast_only |
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 pages with content; the page requires a login or renders only in a browser.
Returns: content (mark params: url* |
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.
Not for: you already have the URL — url_reader; you want crypto headlines with sentiment — crypto_n params: query* |
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, BTC, ETH, and Ethereum gas.
Not for: you need one asset in depth — token_price, gas_tracker or fund params: none |
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 — orderbook_depth. Ethereum ERC-20 transfers only.
Returns: large_transfers[] with from, to (full addr params: token*, min_usd |
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) and survivor count to PROVE a real provider exists, but WITHHOLDS the provider URL + ready-to-pay params: need*, budget_usd, chain |
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- tiebreaks quality-equal candidates. Returns ranked candidates + a recommendation + ready-to-pay de params: need*, budget |
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 task with paid tools, "what would this cost", "does this plan fit my budget", or before committing a params: steps*, budget |
Entries describe changes in tool definitions. They are not statements about a server, its quality or its author. The grade measures how the tool definitions fit model providers (token cost, schema compatibility, confusable names) as scored by the ToolFit engine at the time of the listing. JSON: append .json. Opt-out: how or hello@youraitools.co.