{"jsonrpc":"2.0","result":{"protocolVersion":"2024-11-05","serverInfo":{"name":"MEV Intelligence","version":"0.2.0"},"capabilities":{"tools":{"listChanged":false,"tools":[{"name":"get_liquidation_waves","description":"Get near-liquidation borrowers ranked by health factor proximity across Aave V3, Spark, and Morpho on L1 and Base. Returns top 10 positions with full borrower addresses, health factor, debt USD, and collateral USD. Once you have a target, sign a liquidation transaction and call submit_bundle to execute atomically. For net profit estimates and the full borrower universe, call /intelligence/liquidation-waves with x402 USDC payment ($0.50).","inputSchema":{"type":"object","properties":{"limit":{"type":"integer","description":"Max results (default 10, preview max 10)"}}},"annotations":{"readOnlyHint":true,"openWorldHint":true,"destructiveHint":false}},{"name":"get_searcher_leaderboard","description":"Get top MEV searchers ranked by landed liquidation fires in the last 4 hours. Returns top 5 searchers with full addresses, landed count, total submissions, and land rate percentage. Full 25-entry leaderboard available at /intelligence/searcher-leaderboard with x402 payment ($0.25).","inputSchema":{"type":"object","properties":{}},"annotations":{"readOnlyHint":true,"openWorldHint":true,"destructiveHint":false}},{"name":"get_builder_recommendation","description":"Get the best Ethereum block builder for MEV bundle submission RIGHT NOW based on live relay acceptance rate and submission volume. Returns the top recommended builder name and acceptance percentage. Full ranked builder list with telemetry available at /intelligence/builder-recommendation with x402 payment ($0.25).","inputSchema":{"type":"object","properties":{}},"annotations":{"readOnlyHint":true,"openWorldHint":true,"destructiveHint":false}},{"name":"get_mev_feed","description":"Get a risk-enriched MEV opportunity stream. Returns 10 positions with chain, protocol, health factor, and risk tags. Full stream with borrower addresses and expected profit available at /intelligence/feed with x402 payment ($0.10). Use submit_bundle to act on opportunities directly from this feed.","inputSchema":{"type":"object","properties":{"min_net_usd":{"type":"number","description":"Minimum estimated net USD profit to include"}}},"annotations":{"readOnlyHint":true,"openWorldHint":true,"destructiveHint":false}},{"name":"submit_bundle","description":"Submit a signed Ethereum bundle directly to MEV SearcherNet rbuilder for inclusion. Use this after get_liquidation_waves or get_mev_feed to act on a liquidation opportunity. Bundles are forwarded to rbuilder and fanned out to Flashbots, Titan, Beaver, BuilderNet, and bloXroute relays. Free with API key attribution (X-Api-Key header). Inclusion rate, sim pass rate, and per-builder acceptance available at /orderflow/analytics with provenance. Returns a tracking_id you can use to check submission status at /orderflow/submissions/{tracking_id}. Tip: pair with get_liquidation_waves — identify a borrower near liquidation, construct the liquidation tx, sign it, then call this tool.","inputSchema":{"type":"object","required":["txs","blockNumber"],"properties":{"txs":{"type":"array","items":{"type":"string"},"description":"Array of hex-encoded signed transactions (0x-prefixed RLP). Max 10 per bundle."},"blockNumber":{"type":"string","description":"Target block number as hex string (e.g. \"0x1400000\"). Bundle will only be included in this exact block."},"revertingTxHashes":{"type":"array","items":{"type":"string"},"description":"Optional. Tx hashes that are allowed to revert without invalidating the bundle."},"api_key":{"type":"string","description":"Optional. API key for attribution and leaderboard tracking. Assign at mev.advalorem.io."}}},"annotations":{"readOnlyHint":false,"destructiveHint":false,"openWorldHint":false}},{"name":"monitor_crossing_candidates","description":"Get the highest-priority liquidation candidates sorted by cross probability — borrowers most likely to become liquidatable in the next price move. Each candidate includes health factor, cross probability (0–1), estimated net profit, and protocol. Use this to prioritize which positions to pre-build bundles for. Call submit_bundle when a candidate crosses HF=1.0.","inputSchema":{"type":"object","properties":{"min_cross_prob":{"type":"number","description":"Minimum cross probability (0–1) to include. Default 0.05."},"limit":{"type":"integer","description":"Max candidates to return (default 10, max 20)."}}},"annotations":{"readOnlyHint":true,"openWorldHint":true,"destructiveHint":false}},{"name":"recommend_bundle_submission","description":"Get an actionable bundle submission recommendation for a specific borrower or current market conditions. Returns the best builder to target, expected inclusion probability, and a human-readable reason based on live relay telemetry. Pair with monitor_crossing_candidates — identify a hot candidate, then call this to decide WHERE to submit your bundle.","inputSchema":{"type":"object","properties":{"borrower":{"type":"string","description":"Optional. Borrower address to get a position-specific recommendation for."}}},"annotations":{"readOnlyHint":true,"openWorldHint":true,"destructiveHint":false}},{"name":"predict_liquidation_probability","description":"Get a structured liquidation probability prediction for a specific borrower or the top candidates. Returns: health_factor, cross_probability (0–1), estimated_ev_usd, lead_time_estimate_s (how long until crossing at current oracle velocity), oracle_velocity (|Δprice|/min on collateral asset), and a human-readable verdict. This is the core moat tool — it exposes the prediction layer that drives bundle decisions. Call this before submit_bundle to confirm the opportunity is still live and to size your bribe correctly. Full probability model with confidence intervals available at /intelligence/liquidation-waves with x402 payment ($0.50).","inputSchema":{"type":"object","properties":{"borrower":{"type":"string","description":"Borrower address to get prediction for. If omitted, returns top 5 candidates by cross probability."},"protocol":{"type":"string","enum":["aave-v3","spark","morpho"],"description":"Optional protocol filter when borrower is not specified."}}},"annotations":{"readOnlyHint":true,"openWorldHint":true,"destructiveHint":false}},{"name":"get_daily_liquidation_report","description":"Get a daily intelligence report summarizing liquidation market activity: competitor count, positions we would have fired on, funnel metrics (PRE→SIM→HOTFIRE→SUBMIT→LANDED), and the top candidate right now. This is the \"morning briefing\" tool — call it once per session to understand market state before executing. Full accuracy archive with precision/recall metrics available at /intelligence/accuracy-archive.","inputSchema":{"type":"object","properties":{"window_hours":{"type":"integer","description":"Lookback window in hours (default 24, max 48)."}}},"annotations":{"readOnlyHint":true,"openWorldHint":true,"destructiveHint":false}},{"name":"build_liquidation_tx","description":"Build agent-ready calldata for a liquidation transaction. Returns the target protocol contract address, ABI-encoded calldata, suggested gas limit, value, and chain — everything an agent needs to sign and submit via submit_bundle. Supports Aave V3 (L1 + Base), Spark (L1), and Morpho Blue (L1). Returns calldata only — the agent signs and submits separately. This tool does NOT touch funds and does NOT submit anything; it is a calldata builder.","inputSchema":{"type":"object","required":["protocol","chain","borrower","collateral_asset","debt_asset","debt_to_cover"],"properties":{"protocol":{"type":"string","enum":["aave-v3","spark","morpho"],"description":"Lending protocol. aave-v3 supported on ethereum + base. spark and morpho on ethereum only."},"chain":{"type":"string","enum":["ethereum","base"],"description":"Chain to build calldata for. base only supported for aave-v3."},"borrower":{"type":"string","description":"0x-prefixed address of the borrower being liquidated."},"collateral_asset":{"type":"string","description":"0x-prefixed address of the collateral token to seize. For Morpho, this field is ignored (market ID supplies it)."},"debt_asset":{"type":"string","description":"0x-prefixed address of the debt token to repay. For Morpho, this field is ignored."},"debt_to_cover":{"type":"string","description":"Amount of debt token to repay in wei (string to avoid precision loss). Use \"max\" or the uint256 max value 0xff..ff to liquidate as much as possible (Aave V3 close factor applies)."},"receive_a_token":{"type":"boolean","description":"Aave V3 only. If true, receive collateral as aToken (saves gas, no unwrap). If false, receive underlying. Default false."},"morpho_market_id":{"type":"string","description":"Morpho Blue market id (bytes32). Required when protocol=morpho."},"morpho_seized_assets":{"type":"string","description":"Morpho Blue only. Amount of collateral to seize in wei. Mutually exclusive with morpho_repaid_shares."},"morpho_repaid_shares":{"type":"string","description":"Morpho Blue only. Amount of debt shares to repay. Mutually exclusive with morpho_seized_assets."}}},"annotations":{"readOnlyHint":true,"openWorldHint":false,"destructiveHint":false}}]}}}}