gavel
Server Details
Oracle-free fixed-rate, fixed-term BTC credit on Arbitrum One. Data and unsigned blueprints.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- Repository
- JamieFrame/gavel-mcp
- GitHub Stars
- 0
- Server Listing
- gavel-mcp
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 21 tools
Most tools target a distinct resource+action, and the descriptions work hard to separate near-neighbors (get_loan_status for one loan vs get_user_positions for an address vs get_address_history for past actions vs check_wallet_status for funding readiness). The two 'moved' shims (get_mvrv, list_onchain_indicators) are dead endpoints but explicitly labelled as such, not confusable with live tools. Only mild friction remains between the several address-scoped read tools and between get_book/find_auctions_matching_criteria/list_comparables.
All names are snake_case following a verb_noun/verb_object pattern (get_*, list_*, prepare_*_calldata, find_auctions_matching_criteria), so the convention is stable throughout. The only slight wrinkle is the very long descriptive name find_auctions_matching_criteria versus the terser get_/list_ prefixes, but it is still perfectly readable and predictable.
At 21 tools this sits in the heavy band for a single DeFi protocol, and two of them (get_mvrv, list_onchain_indicators) are dead shims that only return a 'moved' error, contributing no function. The remaining tools are broadly justified (reads, catalogs, indicator discovery, and five calldata builders), but the set is larger than strictly necessary for the core workflow.
The lifecycle surface is strong: discovery (find_auctions, list_comparables), state reads (loan, positions, wallet, book, yield curve, protocol reference, verification bundle), and unsigned calldata builders for bid, create auction, repay, claim_collateral, and claim_refund. The main gap is the absence of a prepare_claim_repayment counterpart even though get_user_positions lists claim_repayment as a next action, plus no auction-cancel path, which could leave an agent at a dead end.
Available Tools
21 toolscheck_wallet_statusCheck Wallet ReadinessAInspect
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 creating auctions).
Useful for: onboarding flows where an LLM agent needs to verify a user's wallet is funded and approved before walking them through a transaction. The 'readiness.blockers' field is the high-leverage answer to "what's next?" — the LLM can quote it directly without reasoning from raw balances.
This tool reads the Arbitrum chain directly via RPC. It does not require any signed authorisation from the wallet owner — addresses and balances are public on-chain data.
Returns: { address, network, native_gas, tokens, active_positions, readiness }.
Inputs: address (required), network.
find_auctions_matching_criteriaFind Auctions Matching CriteriaAInspect
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, duration, and LTV preferences.
All filter parameters are optional. Unspecified parameters mean "no constraint on that dimension". When status is omitted, defaults to 'open' (actionable auctions only).
Returns: { matches: Auction[], match_count, total_inspected, criteria_echoed }.
Inputs: pair, limit, status, max_ltv, +6 more.
get_address_historyAddress history on the protocolAInspect
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. Any address may be queried by anyone; no authorisation is needed.
This is the supervisor page's data source — the read a person uses to check what an agent they supervise has actually done.
Inputs: address (required), network.
get_bookThe open bookAInspect
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 distinct lenders and borrowers over 30 days.
⚠ Fields that cannot be answered are null, not empty. positions_listed is null where marketplace listings are not indexed — an empty array would assert that nothing is listed.
Inputs: pair, network.
get_gavel_indicatorGet a Gavel IndicatorAInspect
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 current value (set include_history). History is free and unmetered on the same terms as the current value.
This is descriptive data; no recommendation is provided. An indicator that has no reading on this network says so explicitly rather than returning a null or a zero that could be mistaken for a value.
Inputs: id (required), to, from, include_history.
get_loan_statusGavel Loan StatusAInspect
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 each transaction, so the next step can be taken without guessing. 'lifecycle_summary' gives the borrower's and lender's view in plain English.
This is descriptive data; no recommendation is provided. Verify on-chain before acting on a reported maturity or default.
Returns: { loan_id, state, borrower, lender, principal, repayment, apr, matures_at, time_remaining_seconds, outcome, next_actions }.
Inputs: loan_id (required).
get_mvrvMoved — now served by the Bitcoin Credit StackAInspect
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.
Inputs: no named parameters.
get_protocol_referenceGavel Protocol ReferenceAInspect
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 needs to:
Look up a contract address before constructing a transaction
Get the function signature for placeBid, createAuction, repayLoan, etc.
Understand the tokenId convention for borrower vs lender position NFTs
Find an Etherscan link to verify a contract's source code
Confirm which loan tokens are whitelisted
This is descriptive data; no recommendation is provided. The agent is responsible for constructing, signing, and broadcasting any transactions via the user's own wallet. Aletheia never holds keys or dispatches transactions.
Returns: { network, chain_id, explorer, rpc_endpoints, status, contracts, tokens, key_functions, important_notes, abi_references }.
Inputs: network.
get_user_positionsGavel Positions for an AddressAInspect
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 counterparty, and 'next_action_available' — the one thing this address can do next (nothing, repay, claim_collateral, claim_repayment, claim_refund). 'lifecycle_summary' is a plain-English sentence you can quote to the user directly.
Reads public chain data via the Aletheia indexer; no signed authorisation is needed and anyone can query any address. The chain is authoritative — a transaction in the current block may not be indexed yet.
Returns: { address, network, positions[], count, settled_hidden }.
Inputs: address (required), include_settled.
get_verification_bundleVerification bundleAInspect
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 touch user funds, the audit reference, and five structural promises — each with the check that would falsify it and what that check returned.
⚠ Read the fields, not the impression. 'match' is "unchecked" where Aletheia has not compared deployed bytecode against verified source; a promise that did not settle says so; and mainnet and testnet return different answers because they run different builds. There is no safety score, rating or verified badge in this payload, and none will be added.
Inputs: network.
get_yield_curveGavel Yield CurveAInspect
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 trade, and the published tenor set extends past the deepest observation. Tenors with no underlying bin data are returned as fitted values and listed in 'extrapolated_tenors'; treat those as model output only. Read 'provenance' before using the curve as a market reference: it carries the observation count, the number of distinct counterparties, the external share, and a disclosure stating whether this is yet an independent market assessment. Check fit.r_squared and fit.fitted_to — R-squared is measured against bin means, not raw scatter, so at low observation counts it reflects smoothness rather than goodness of fit.
Useful for: comparing fixed-term BTC-collateralised borrow rates across maturities, deriving the term premium, sourcing the Gavel layer of the Bitcoin Credit Stack. This tool returns data; it does not advise.
Returns: { pair, computed_at, status, rates, extrapolated_tenors, fit_observation_count, provenance, fit: {r_squared, rmse, model, fitted_to} }. Note 'fit_observation_count' counts only the loans the fit was computed over (binning is active-loans-only, so settled loans are excluded), whereas 'provenance.observation_count' counts the full scatter — they legitimately differ. Optional 'include_points' returns the raw scatter backing the fit.
Inputs: pair, include_points.
list_comparablesComparable settled auctionsAInspect
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 originator was Aletheia's own account. Below MIN_COMPARABLES the rows are still returned, with the threshold and the observed count named — no aggregate is computed over them.
⚠ The own-account flag is null, not false, wherever it cannot be computed. Read provenance.own_account_attribution before treating a null as a "no".
Inputs: k, ltv, pair, network, +3 more.
list_fiat_onrampsFiat Onramp CatalogAInspect
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 narrow the catalog to providers that operate in the user's jurisdiction and accept their transaction size.
Useful for: an LLM agent helping a novice user fund their wallet from fiat USD/EUR/GBP. The LLM presents the catalog to the user; the user picks one and proceeds.
IMPORTANT — a cold-start user needs TWO purchases, not one. None of these providers delivers gas ETH alongside the USDC. A wallet holding only USDC cannot transact at all, and the failure is opaque (the transaction simply will not send). Surface the gas purchase to the user at the same time as the USDC purchase — see 'gas_requirement' in the response.
Returns: { providers: OnrampProvider[], gas_requirement, filter_echo, notes }.
Inputs: chain, country, amount_usd.
list_gavel_indicatorsGavel Indicator CatalogueAInspect
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 MVRV and SOPR), and 'market' (external context — DeFi rates, stablecoin supply, macro).
Use this to discover what is available, then call get_gavel_indicator with an id. This tool returns a catalogue; it does not rank indicators or advise which to use.
Inputs: family, live_only.
list_onchain_indicatorsMoved — now served by the Bitcoin Credit StackAInspect
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.
Inputs: no named parameters.
list_wallet_optionsCompatible Wallet CatalogAInspect
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 and user pick based on those.
Useful for: an LLM agent helping a user without an existing wallet choose one before onramping funds. The LLM should explain the custody-model and platform implications relevant to the user's situation, then let the user pick.
Returns: { wallets: WalletOption[], filter_echo, notes }.
Inputs: platform.
prepare_bid_calldataPrepare a Gavel BidAInspect
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 the call. It does not choose an auction, a rate or a size for you — use find_auctions_matching_criteria to filter by your own criteria first.
Bidding on Gavel is a reverse auction: a LOWER repayment is a more competitive bid and a lower yield to you as lender. Each bid must undercut the current best by at least the auction's bid step.
Returns an unsigned transaction blueprint for the requested intent. The user is responsible for reviewing, signing, and broadcasting via their own wallet. Aletheia does not hold keys or dispatch transactions.
Inputs: auction_id (required), lender_address (required), repayment_amount (required), network.
prepare_claim_collateral_calldataPrepare a Collateral ClaimAInspect
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 warns rather than asserts when the margin is thin.
Returns an unsigned transaction blueprint for the requested intent. The user is responsible for reviewing, signing, and broadcasting via their own wallet. Aletheia does not hold keys or dispatch transactions.
Inputs: loan_id (required), lender_address (required), network.
prepare_claim_refund_calldataPrepare a Refund ClaimAInspect
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 intent. The user is responsible for reviewing, signing, and broadcasting via their own wallet. Aletheia does not hold keys or dispatch transactions.
Inputs: token_address (required), claimant_address (required), network.
prepare_create_auction_calldataPrepare a Gavel AuctionAInspect
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 repayment you will accept, the loan duration, how long the auction runs, and the bid step. This tool encodes what you specify and warns about consequences; it does not propose terms, rates or a loan size.
Lenders bid DOWN from your maximum repayment, so max_repayment is your worst acceptable price — set it too low and the auction may attract no bids.
Returns an unsigned transaction blueprint for the requested intent. The user is responsible for reviewing, signing, and broadcasting via their own wallet. Aletheia does not hold keys or dispatch transactions.
Inputs: loan_token (required), loan_amount (required), max_repayment (required), borrower_address (required), +6 more.
prepare_repay_loan_calldataPrepare a Loan RepaymentAInspect
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 the current holder of the lender position. On a USDC loan it reverts if USDC refuses that holder or is paused (known issue KI-3); the blueprint then carries a warning saying so.
Returns an unsigned transaction blueprint for the requested intent. The user is responsible for reviewing, signing, and broadcasting via their own wallet. Aletheia does not hold keys or dispatch transactions.
Inputs: loan_id (required), borrower_address (required), network.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
The Bitcoin credit markets, measured. Cross-venue rates, venue criteria, chain indicators.
Agent credit issuance and scoring — programmable credit lines on Base L2
Fixed-cost loans on Robinhood Chain: quotes, and each transaction unsigned for your own wallet.
Borrow USDC against Base tokens with no liquidations, or lend USDC for fixed-term returns. Live quotes, token risk data and ready-to-sign transactions. No login, never holds keys.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceUndercollateralized credit lines for autonomous agents based on trust scoring, enabling on-chain credit scoring, agent-to-agent loans, and USDC settlement on Base L2.MIT
- FlicenseNot gradedqualityDmaintenanceNon-custodial Bitcoin DCA for agent treasuries on Celo: approve USDT once and an on-chain agent buys WBTC on schedule, straight back to your wallet. Budget capped by allowance, fees hard-capped on-chain.-
- AlicenseAqualityDmaintenanceP2P Crypto and Flashloans. Lets AI agents browse, quote and (optionally) transact with the FlashBank contracts — the P2P term-loan escrow and the flash-loan router — on Ethereum, Base, Arbitrum and the Sepolia playground.1564 npmMIT
- AlicenseNot gradedqualityDmaintenanceBroker-only credit/lending discovery shim for AI agents, surfacing real lending markets from licensed/established third-party protocols and routing applications.MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.