Analytics
thegavel.io
Provides on-chain data and analytics for the Gavel lending protocol, including yield curves, wallet readiness, and auction discovery.
ENDPOINT 1
https://mcp.thegavel.io/mcp
MCP server metadata
- Name
- aletheia-mcp
- Version
- 0.4.0
This server exposes Aletheia Analytics' data product for the Gavel Protocol: a fixed-rate, fixed-term, oracle-free BTC-collateralised credit market on Arbitrum One. Every tool here either returns observed data or returns an unsigned transaction blueprint. Nothing on this server signs, submits or broadcasts a transaction, and no tool takes custody of funds or receives a mandate — a blueprint is calldata the caller's own wallet may choose to sign. Read the provenance fields before treating any rate as a market reference. Gavel's mainnet book is small and currently predominantly own-account: responses carry the observation count, the distinct-counterparty count, the own-account share and a disclosure of whether the figure is yet an independent market assessment. Where a figure would be degenerate on the current book, the response returns a structured absence naming the threshold and the observed count rather than a zero. Nothing here is advice. Tools that return catalogues do not rank their entries; tools that return distributions report what was observed with the sample size, and do not forecast a fill, a rate, a time-to-fill or a return. Aletheia Analytics SASU operates this interface and data product; the Gavel Protocol is autonomous, permissionless code with no operating entity. Cross-venue credit data is served by the Bitcoin Credit Stack MCP at https://mcp.bitcoincreditstack.com/mcp.
Known tools 21
get_yield_curveReturns the current fitted Gavel yield curve for the requested collateral/loan pair.
Inferred read-onlyget_protocol_referenceReturns 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.
Inferred read-onlycheck_wallet_statusReturns 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).
Inferred read-onlyfind_auctions_matching_criteriaReturns Gavel auctions filtered by the criteria you supply.
Inferred read-onlylist_fiat_onrampsReturns a catalog of fiat-to-USDC onramps that deliver native USDC on the requested chain.
Inferred read-onlylist_wallet_optionsReturns a catalog of self-custody wallet apps compatible with Gavel (i.e., that support Arbitrum One).
Inferred read-onlyget_user_positionsReturns every Gavel position an address holds — as borrower, as winning lender, or as a bidder on an auction that has not closed.
Inferred read-onlyget_loan_statusReturns the current state of a single Gavel loan and what action, if any, is available to whom.
Inferred read-onlylist_gavel_indicatorsReturns 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.
Inferred read-onlyget_gavel_indicatorReturns the current value of a single Aletheia indicator by id, with its methodology reference.
Inferred read-onlyprepare_bid_calldataBuilds an unsigned transaction blueprint for placing a bid on a Gavel auction, including the prerequisite ERC-20 approval when the current allowance is short.
Inferred read-onlyprepare_create_auction_calldataBuilds 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.
Potential side effectsprepare_repay_loan_calldataBuilds an unsigned transaction blueprint for repaying a Gavel loan, including the prerequisite approval for the repayment amount.
Inferred read-onlyprepare_claim_collateral_calldataBuilds an unsigned transaction blueprint for a lender to claim the collateral on a defaulted Gavel loan.
Inferred read-onlyprepare_claim_refund_calldataBuilds an unsigned transaction blueprint for reclaiming funds held by the protocol after a losing bid.
Inferred read-onlylist_comparablesWhich recent auctions resemble these parameters, and how did each clear?
Inferred read-onlyget_verification_bundleWhat can be checked about the contracts, and what did the last check return?
Inferred read-onlyCONNECT WITH APPROVAL
Client installation
Review this server and its permissions before adding it. Secret placeholders must be set locally.
Codex
~/.codex/config.toml
[mcp_servers.aletheia-mcp]
url = "https://mcp.thegavel.io/mcp"
enabled = true
Claude Code
.mcp.json
{
"mcpServers": {
"aletheia-mcp": {
"type": "http",
"url": "https://mcp.thegavel.io/mcp"
}
}
}
Claude Desktop
Settings → Connectors → Add custom connector
Name: aletheia-mcp
Remote MCP URL: https://mcp.thegavel.io/mcp
Add this remote URL as a custom connector in Claude Desktop. Availability depends on the user plan and workspace policy.
Cursor
.cursor/mcp.json
{
"mcpServers": {
"aletheia-mcp": {
"url": "https://mcp.thegavel.io/mcp"
}
}
}
Visual Studio Code
.vscode/mcp.json
Add to Visual Studio Code{
"servers": {
"aletheia-mcp": {
"type": "http",
"url": "https://mcp.thegavel.io/mcp"
}
}
}
Generic MCP
Client-specific MCP configuration
{
"name": "aletheia-mcp",
"transport": "streamable-http",
"url": "https://mcp.thegavel.io/mcp"
}
MCP Inspector
Run the official MCP Inspector locally and enter the indexed Streamable HTTP endpoint.
TRUST AND VERIFICATION EVIDENCE
Loading Trust v2 evidence…
Checking the associated registrable domain. The BuiltWith key remains server-side.
Evidence is source-attributed and does not guarantee that a third-party server is safe. Risk labels are conservative metadata heuristics.