io.thegavel/gavel

io.thegavel/gavel · v0.4.0 · crypto-web3

io.thegavel/gavel is healthy: it completed an MCP handshake in 1573 ms and exposes 21 tools.

Oracle-free fixed-rate, fixed-term BTC credit on Arbitrum One. Data and unsigned blueprints.

Endpoint: https://mcp.thegavel.io/mcp (streamable-http)

Facts

Users (last 30 days)	0
Handshake	Healthy
Auth needed	None
Tool count	21
Latency	1573 ms
Last checked (UTC)	2026-10-15T11:55:11.094Z

Health history

Checked (UTC)	Status	Latency	Error
2026-10-15T11:55:11.094Z	Healthy	1573

Tools (21)

`get_yield_curve`	Returns the current fitted Gavel yield curve for the requested collateral/loan pair. Rates are oracle-free, derived from auctions in The Gavel Protocol. The curve is a log-quadratic fit through binned midpoints. IMPORTANT — every rate returned is an evaluation of the fitted curve, not an observed t
`get_protocol_reference`	Returns the Gavel Protocol's complete on-chain reference data for the requested network: contract addresses, supported tokens (collateral and loan), key function signatures, operational conventions (like the Position NFT tokenId formula), and Etherscan/ABI references. Use this tool when an agent ne
`check_wallet_status`	Returns a structured readiness report for the given wallet address: native ETH balance for gas, relevant ERC-20 balances (USDC, USDT, WBTC), current allowances against the Gavel LoanProtocol and ListingService, and a precomputed list of blockers (what's stopping the wallet from placing bids or creat
`find_auctions_matching_criteria`	Returns Gavel auctions filtered by the criteria you supply. Does not rank, score, or recommend a specific auction — only filters by the parameters provided. The user chooses what to act on. Useful for: an agent helping a user narrow a long auction list down to the subset matching their stated yield
`list_fiat_onramps`	Returns a catalog of fiat-to-USDC onramps that deliver native USDC on the requested chain. Does not rank or endorse a specific provider — entries are listed alphabetically so the response is deterministic. The user chooses which onramp to use. Filter by country (ISO 3166 alpha-2) and amount to narr
`list_wallet_options`	Returns a catalog of self-custody wallet apps compatible with Gavel (i.e., that support Arbitrum One). Does not rank wallets by quality. Each entry has a 'suitability_tags' list describing the typical user fit as factual attributes ('beginner', 'mobile_first', 'hardware', 'multisig', etc.) — the LLM
`get_user_positions`	Returns every Gavel position an address holds — as borrower, as winning lender, or as a bidder on an auction that has not closed. Each position carries its lifecycle state (auction_open, bid_placed, bid_lost, active, matured_unclaimed, repaid, defaulted), the maturity date and time remaining, the c
`get_loan_status`	Returns the current state of a single Gavel loan and what action, if any, is available to whom. Designed to be re-called during a long conversation so lifecycle changes can be surfaced to the user. 'next_actions' is an array of {actor, action, calldata_tool} tuples naming the tool that prepares eac
`list_gavel_indicators`	Returns the catalogue of Aletheia indicators computed from The Gavel Protocol and the Bitcoin chain: id, name, family, units, description, and whether the indicator is currently live on this network. Three families: 'credit' (credit-market assessments), 'onchain' (commodity chain metrics such as MV
`get_gavel_indicator`	Returns the current value of a single Aletheia indicator by id, with its methodology reference. This server serves this protocol's own indicator set, including those anchored on its rate. Call list_gavel_indicators first to discover valid ids. Optionally returns the historical series instead of the
`prepare_bid_calldata`	Builds an unsigned transaction blueprint for placing a bid on a Gavel auction, including the prerequisite ERC-20 approval when the current allowance is short. You supply the auction and the repayment amount you are willing to accept; this tool validates them against live auction state and encodes t
`prepare_create_auction_calldata`	Builds an unsigned transaction blueprint for creating a borrow auction — you post collateral and ask lenders to compete to lend against it — including the prerequisite collateral approval. Every term is yours to set: which collateral and how much, which loan token and how much, the maximum repaymen
`prepare_repay_loan_calldata`	Builds an unsigned transaction blueprint for repaying a Gavel loan, including the prerequisite approval for the repayment amount. Validates that the loan is live and that you are its borrower. Repay before maturity or the lender may claim your collateral. The repayment is transferred directly to t
`prepare_claim_collateral_calldata`	Builds an unsigned transaction blueprint for a lender to claim the collateral on a defaulted Gavel loan. Validates that you are the lender and that the loan has passed maturity without repayment. Chain state is authoritative — a repayment in the current block may not be indexed yet, so this tool wa
`prepare_claim_refund_calldata`	Builds an unsigned transaction blueprint for reclaiming funds held by the protocol after a losing bid. When you are outbid, your funds stay claimable rather than being pushed back automatically. This encodes the claim for a given token. Returns an unsigned transaction blueprint for the requested i
`list_comparables`	Which recent auctions resemble these parameters, and how did each clear? Returns the individual observations so the caller can reason from them directly. Nearest-k settled auctions by normalised distance on loan amount, LTV and tenor. Every row carries its clearing APR, bid count, and whether its o
`get_address_history`	What has this address done on the protocol? Public chain events only, with no enrichment beyond them. Auctions originated, bids placed, positions open and closed, and a summary of outcomes. No clustering, no labelling and no inferred identity: nothing in the response is not already public on-chain.
`get_book`	What is open right now — auctions, bids and positions listed? Current chain state, with counts rather than a characterisation of depth. Open auctions with their best bid and time remaining, those closing within 24 hours, and totals: open auction count, principal outstanding, collateral locked, and
`get_verification_bundle`	What can be checked about the contracts, and what did the last check return? Observations with their block heights; the verdict is the reader's. Contract addresses and their implementations, the bytecode hash of each, the upgradeability position, the privileged-function map with whether each can to
`list_onchain_indicators`	This tool has moved. Cross-venue credit data is served by the Bitcoin Credit Stack MCP at https://mcp.bitcoincreditstack.com/mcp, where this tool is called `list_onchain_indicators`. Calling it here returns a structured 'moved' error naming the host. This shim is temporary and will be removed.
`get_mvrv`	This tool has moved. Cross-venue credit data is served by the Bitcoin Credit Stack MCP at https://mcp.bitcoincreditstack.com/mcp, where this tool is called `get_mvrv`. Calling it here returns a structured 'moved' error naming the host. This shim is temporary and will be removed.