{"id":"io.github.romudille-bit/agentpay","slug":"io-github-romudille-bit-agentpay","title":"AgentPay — trust routing + spend caps for x402 agents","description":"Buyer-side trust oracle + capped sessions for x402 agents: verified_route, receipts, 17 free tools.","version":"2.9.2","publisher":{"kind":"github","id":"romudille-bit","label":"@romudille-bit on GitHub","url":"https://github.com/romudille-bit"},"website":"https://agentpay.tools","repository":"https://github.com/romudille-bit/agentpay","remotes":[{"type":"streamable-http","url":"https://agentpay.tools/mcp"}],"packages":[{"registryType":"npm","identifier":"@romudille/agentpay-mcp","version":"2.9.2","transport":{"type":"stdio"},"environmentVariables":[{"description":"Optional EVM private key for wallet mode: settle paid tools in-place (gasless EIP-3009 on Base). Keyless free-tools mode works without it.","format":"string","isSecret":true,"name":"AGENTPAY_BASE_KEY"},{"description":"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.","format":"string","name":"AGENTPAY_ENABLE_PAID"},{"description":"Hard per-session spend cap in USD when wallet mode is enabled (default 0.10).","format":"string","name":"AGENTPAY_MAX_SPEND"}]}],"published":"2026-11-18","updated":"2026-11-18","status":"online","auth":"","latency_ms":1587,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"session_create","title":"Session Create","description":"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.\n\nUse when: You want to start an AgentPay session with a hard spend cap and get a session_id for tracking.\nNot for: you only need a ","read_only":false},{"name":"pre_trade_check","title":"Pre Trade Check","description":"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, ","read_only":false},{"name":"verified_route","title":"Verified Route","description":"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","read_only":false},{"name":"funding_spread","title":"Funding Spread","description":"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","read_only":false},{"name":"sbtc_peg","title":"Sbtc Peg","description":"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","read_only":false},{"name":"token_price","title":"Token Price","description":"Get the current USD price of any cryptocurrency token\n\nUse when: You need the current USD price, 24h change, or market cap of any cryptocurrency.\nNot 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.\nReturns: price_usd, change_24h_pct, market_cap_usd, coin_id\nExample response: {\"symbol\":\"ET","read_only":true},{"name":"gas_tracker","title":"Gas Tracker","description":"Get current Ethereum gas prices (slow, standard, fast)\n\nUse when: You need to know current Ethereum gas prices before submitting a transaction or estimating costs.\nNot for: you need gas as part of a broader read — market_snapshot already includes standard gwei; only Ethereum mainnet gas is reported.\nReturns: slow_gwei, standard_gwei, fast_gwei, base_fee_gwei, estimated confirmation times\nExample r","read_only":true},{"name":"yield_scanner","title":"Yield Scanner","description":"Find best DeFi yield opportunities across protocols for a given token\n\nUse when: You need to find the best yield/APY for a token across DeFi protocols.\nNot 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.\nReturns: list of pools with protocol, apy, tvl_usd, chain, risk_level sorted by APY desc","read_only":true},{"name":"open_interest","title":"Open Interest","description":"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.\n\nUse 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.\nNot for: you need the funding c","read_only":true},{"name":"orderbook_depth","title":"Orderbook Depth","description":"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.\n\nUse 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.\nNot for: you need market cap or 24h volume — token_market_data; a","read_only":true},{"name":"wallet_balance","title":"Wallet Balance","description":"Get the token balances for any Ethereum or Stellar wallet address\n\nUse when: You need to look up the token holdings of an Ethereum or Stellar wallet address.\nNot 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.\nRe","read_only":true},{"name":"fear_greed_index","title":"Fear Greed Index","description":"Crypto Fear & Greed Index (0=extreme fear, 100=extreme greed) with optional history\n\nUse when: You need to gauge overall crypto market sentiment or mood — whether the market is fearful or greedy.\nNot for: you want token-specific sentiment — crypto_news (per-token headlines) or funding_rates (leveraged positioning).\nReturns: value (0–100), value_classification (e.g. 'Greed'), optional history[]\nExa","read_only":true},{"name":"crypto_news","title":"Crypto News","description":"Latest crypto news and community sentiment from r/CryptoCurrency for any token\n\nUse when: You need recent news headlines or community sentiment for one or more crypto tokens.\nNot for: you need general web news or documentation — web_search; a specific article's text — url_reader; a numeric sentiment gauge — fear_greed_index.\nReturns: headlines[] with title, url, sentiment (bullish/neutral/bearish)","read_only":true},{"name":"defi_tvl","title":"Defi Tvl","description":"DeFi protocol Total Value Locked from DeFiLlama. Returns top 10 or a specific protocol.\n\nUse when: You need the Total Value Locked in a specific DeFi protocol or want to compare the top protocols by TVL.\nNot for: you want the best yield for a token — yield_scanner; protocol revenue or custom metrics — dune_query.\nReturns: tvl, change_1h, change_1d, change_7d, chains[], category for the protocol (o","read_only":true},{"name":"token_market_data","title":"Token Market Data","description":"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.\n\nUse when: You need 24h trading volume, market cap, or all-time high for a token pair on decentralized exchanges.\nNot for: you only need the spot price — token_price is lighter; you need pool depth or slippage — orderbook","read_only":true},{"name":"token_security","title":"Token Security","description":"Scan any token contract for honeypot, rug pull, and security risks\n\nUse when: You need to check if a token contract is safe before trading or investing.\nNot 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.\nReturns: risk_level, is_honeypot, buy_tax, sell_tax, holder_count","read_only":true},{"name":"dune_query","title":"Dune Query","description":"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.\n\nUse when: You need deep onchain analytics from a specific Dune query — protocol revenue, user counts, custom metrics.\nNot for: you have no Dune query ID — the other tools cover prices, derivatives, TVL and security withou","read_only":true},{"name":"url_reader","title":"Url Reader","description":"Convert any URL to clean, LLM-ready markdown. Strips ads, nav, and boilerplate — returns just the content. No API key needed.\n\nUse when: You need to read the content of a web page or article and get clean, structured text for further processing.\nNot 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.\nReturns: content (mark","read_only":true},{"name":"web_search","title":"Web Search","description":"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.\n\nUse when: You need to find current information on any topic — news, documentation, prices, events, or anything else on the web.\nNot for: you already have the URL — url_reader; you want crypto headlines with sentiment — crypto_n","read_only":true},{"name":"funding_rates","title":"Funding Rates","description":"Get perpetual futures funding rates across Binance, Bybit, and OKX\n\nUse when: You need funding rates to gauge leveraged market sentiment or cost of holding a perp position.\nNot 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.\nReturns: funding_rate_pct, annualized_rate_pct and a contrarian sentim","read_only":true},{"name":"market_snapshot","title":"Market Snapshot","description":"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.\n\nUse when: You need a combined macro + crypto market overview in one call: S&P 500, Treasury yield, BTC, ETH, and Ethereum gas.\nNot for: you need one asset in depth — token_price, gas_tracker or fund","read_only":true},{"name":"whale_activity","title":"Whale Activity","description":"Detect recent large wallet movements for a token (whale tracking)\n\nUse when: You need to detect large token transfers that may signal institutional moves, accumulation, or sell-offs.\nNot 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.\nReturns: large_transfers[] with from, to (full addr","read_only":true},{"name":"verified_route_preview","title":"Verified Route (x402 trust oracle, preview)","description":"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","read_only":true},{"name":"route","title":"Route (x402 marketplace routing, legacy)","description":"Legacy alias of the free verified_route preview (kept for back-compat). Vets one Coinbase Bazaar search for a need within a budget: drops stubs, down-ranks factory clones and one-wallet or one-call-per-wallet usage, ranks on distinct payers, and names a pick only above a confidence floor (otherwise verdict no_confident_pick). Returns the pick's name, usage stats and reason; the provider URL and re","read_only":true},{"name":"estimate_plan","title":"Estimate Plan (pre-flight plan pricing)","description":"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 ","read_only":true}],"server_info":{"name":"agentpay","version":"2.9.2"},"category":"crypto","tags":["travel","data","ecommerce"],"kind":"remote","source":"registry","submitted":{},"first_party":false,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-08-12","stars":0,"badges":[],"sponsor":null,"page":"https://agentsindex.org/agents/io-github-romudille-bit-agentpay/"}