Every change Wellknown observed on this MCP server, newest first, with what it was before and what it became. Tool-surface changes carry the definition diff. Nothing here is edited after the fact.
Added "basis_data" and "receipt_verify"; removed "basis_asset_footprint", "basis_bridge_flows", "basis_correlation" and 18 more; changed the definition of "basis_answer", "entity_read", "get_methodology" and 2 more (26 tools before, 7 now)
Ask the Basis Agent a question about attested risk state. Answerscome ONLY from attested substrate state, citedcitetoattestation hashes;queries the substrate cannotungroundablegroundqueries arerefused (identical envelope, refusals, and receipts as the REST transportrefused.—Neverthe agent neverrecommends positions,never forecasts, never executes). Every call is logged as an attributed protocolorread. Identity:forecasts.passPass your hub API keyon the /mcp HTTP request(``x-api-key``x-api-key headeror``?apikey=`` query param?apikey=)so reads are attributedtoyour service; keyless calls are attributedattributebyreads.IP.Multi-turn:the returned envelope carries ``session_id`` —passit back asthe``session_id`` argument on your next call to hold a session (follow-ups like "and its liquidity?" then inherit the session's entity). An ``X-Basis-Session`` header on the /mcp request works too; the explicit argument wins. Omit both and eachenvelope'scall is asession_idfreshbacksingle-turnassession.session_id. Parameters: query: The question (max 4000 chars). session_id: Session UUID from a previousbasis_answerenvelope(optional— enables multi-turn follow-ups).
before
{"properties":{"result":{"title":"Result","type":"string"}},"required":["result"],"title":"basis_answerOutput","type":"object"}after
—before
{"properties":{"result":{"title":"Result","type":"string"}},"required":["result"],"title":"entity_readOutput","type":"object"}after
—ReturnsThetheBasiscurrentmethodology.SIImode="summary"formula,(default):categoryindexweightslist,scoreversions, componentscalecounts. mode="full": the complete SII formula, weights and componentversionspecificationsinformation.(large).
Get currentCurrent SII scores (0-100) forallscored stablecoins. Use before any decision involving stablecoins.ReturnsParameters: limit:amaxcompactcoinssummaryreturned (default 25, max 500) fields: columns to return per coin (default id, symbol, name, issuer, score, grade, confidence,category scores).stale,Callcomputed_at);get_stablecoin_detailname "categories" forone coin's fullcategorybreakdown. Parameters:
before
{"properties":{"result":{"title":"Result","type":"string"}},"required":["result"],"title":"score_historyOutput","type":"object"}after
—Market, governance and risk data in one tool. Pick a kind: liquidity_depth (entity=coin id), yield_data (entity=protocol, optional), governance_activity (entity=protocol slug; window=days, 90), bridge_flows (entity=bridge id, optional), exchange_health (entity=exchange id, optional), volatility (entity=asset id), incidents (entity=entity id, optional), peg_monitor (summary of latest deviation + status per coin; detail=true with entity returns that coin's 5-minute series, window=hours, 24), venue_shift (entity=operator slug, optional), asset_footprint (entity=token…
Verify a receipt or citation hash from an envelope (basis_answer, entity_read). Resolves it against the attestation tables and returns what it attests to, or that it is unknown. ``source`` optionally restricts the table.
Where a collateral token is used across the lending venues we read: per venue and chain, supply and borrow against it and its share of the venue's supply. Supply/borrow are the markets' loan-side totals attributed to the collateral token (a footprint proxy, not collateral posted). Phantom / single-actor flagged markets are listed, not summed. A symbol matching several tokens returns them separately (ambiguous=true).
Directional bridge volume per chain pair. Shows where capital is flowing: "$50M Ethereum → Arbitrum, $12M back." Use to assess cross-chain liquidity routing and chain health. Parameters: bridge_id: Specific bridge ID (optional). Omit for aggregate flows.
Cross-entity correlation matrix. Shows which assets move together. When USDC depegs, which protocols lose TVL in sync? Use for portfolio construction and systemic risk assessment. Parameters: matrix_type: "sii_30d", "sii_90d", or "cross_90d"
Every data type available in the universal data layer. Returns per data type: description, freshness, history depth, update frequency, provenance status, row count. Use to discover what data is available for building custom risk indices.
Exchange trust score, volume, and reserve status. Returns CoinGecko trust scores, 24h volume, year established, and stablecoin-specific trading pair data for top exchanges. Parameters: exchange_id: CoinGecko exchange ID (e.g. "binance", "coinbase-exchange"). Omit for all.
Governance proposal counts, voter participation, and pass rates. Returns full proposal history with vote counts, quorum status, and voter concentration data. Use to assess DAO health and governance quality. Parameters: protocol: Protocol slug as used by the Basis protocol index (e.g. "aave", "lido", "curve-finance", "compound-finance", "uniswap"). Snapshot space names such as "aavedao" are not accepted. days: Lookback period in days (default 90)
Structured event history: exploits, depegs, oracle failures. Returns timeline of incidents with severity, affected entities, and resolution status. Use for due diligence and insurance risk assessment. Parameters: entity_id: Entity ID to filter by (optional). Omit for all recent incidents.
Per-asset, per-venue liquidity profile for any stablecoin. Returns DEX pool depth (Uniswap, Curve, etc.) and CEX ticker data (Binance, Coinbase, etc.) with bid/ask depth, spread, volume, and trade counts. Use before any large stablecoin transaction to check venue liquidity. Parameters: asset_id: Stablecoin ID (e.g. "usdc", "usdt", "dai")
5-minute peg resolution data for micro-depeg detection. Returns 5-minute price snapshots and deviation from $1.00. Catches micro-depegs that are invisible at hourly resolution. Early warning signal for peg instability. Parameters: stablecoin_id: Stablecoin ID (e.g. "usdc", "usdt") hours: Lookback period in hours (default 24)
Venue-shift findings: an operator's proposed venue markets overlapped against the markets its vaults currently allocate to. Each finding cites the proposal capture hash and the allocation-snapshot attestation it was computed from. Omit operator_slug to list all findings, sorted by share of venue supply.
Realized volatility, drawdown, and recovery time for any asset. Returns 1d/7d/30d/90d realized vol, max drawdown, and correlation with BTC/ETH. Use for risk-adjusted position sizing. Parameters: asset_id: Asset ID (e.g. "usdc", "usdt")
Pool-level yield, TVL, and utilization for any DeFi protocol. Returns APY, base APY, reward APY, TVL, and pool metadata for all tracked lending/vault pools. Use to evaluate yield sustainability and protocol health. Parameters: protocol: Protocol slug (e.g. "aave-v3", "compound-v3"). Omit for all protocols.
Composite risk assessment for a stablecoin transaction — evaluates asset, sender, and receiver.
Check for divergence signals before executing transactions. Detects capital-flow / quality mismatches: - Asset quality: stablecoin score declining while capital flows in - Wallet concentration: HHI rising while wallet value grows - Quality-flow: score declining with net inflows from wallet graph Call this BEFORE executing any stablecoin swap, deposit, or rebalance to check if capital is flowing toward deteriorating assets.
Wallets with the most capital at risk — lowest risk scores weighted by total value.
Unscored stablecoin assets ranked by total capital exposure across all indexed wallets.
Full score breakdown for a specific stablecoin including category scores and methodology version.
Get recent behavioral events from labeled treasury wallets. Detects: TWAP conversions, protocol rebalancing, concentration drift, quality shifts, and large transfers (>$1M) from known treasury wallets. Parameters: wallet_address: Filter to a specific wallet (optional) event_type: Filter by type: twap_conversion, rebalance, concentration_drift, quality_shift, large_transfer days: Lookback period in days (default 30)
Detailed holdings breakdown for an Ethereum wallet with per-asset SII scores.
Get risk profile for a specific Ethereum wallet — composite risk score, concentration, coverage quality.
Run a pre-built query template against the Basis risk database. Available templates: - high_risk_whales: Wallets with high value AND poor risk scores - contagion_hotspots: Wallets with the most counterparty connections - stablecoin_concentration: Per-stablecoin holder concentration - score_movers: Assets whose SII score changed most over N days - disclosure_gaps: Issuers with the oldest attestation documents - cross_chain_exposure: Wallets active on multiple chains Call GET /api/query/templates first to list the exact template names and their parameters; …
Added "entity_read" and "score_history" (24 tools before, 26 now)
Look up any entity by symbol, slug, contract/wallet address, operator or vault name. Returns {entity_type, id, score, grade, confidence, receipt_hash, links}. When nothing resolves returns {match: null, did_you_mean: [up to 5 candidates]} rather than an error.
Daily SII score history for a stablecoin: a list of {date, score, grade} only. Parameters: coin: symbol, slug or contract address (resolved like entity_read) days: lookback window, 1-365 (default 30)
Certificate changed, valid to 2027-01-06
Changed the definition of "basis_governance_activity" and "query_template"
⟨25 unchanged words⟩ health and governance quality. Parameters: protocol: Protocolnameslug as used by the Basis protocol index (e.g. "aavedaoaave", "comp-votelido", "lido-snapshotcurve-finance", "compound-finance", "uniswap"). Snapshot space names such as "aavedao" are not accepted. days: Lookback period in days (default 90)
Added "basis_asset_footprint" (23 tools before, 24 now)
Where a collateral token is used across the lending venues we read: per venue and chain, supply and borrow against it and its share of the venue's supply. Supply/borrow are the markets' loan-side totals attributed to the collateral token (a footprint proxy, not collateral posted). Phantom / single-actor flagged markets are listed, not summed. A symbol matching several tokens returns them separately (ambiguous=true).
Changed the definition of "get_stablecoin_scores"
Get current SII scores (0-100) for all scored stablecoins. Use before any decision involving stablecoins. Returns a compact summary per coin (score, grade, confidence, category scores). Call get_stablecoin_detail for one coin's full breakdown. Parameters: sort_by: "score_desc" (default), "score_asc", or "symbol" full: true returns every field per coin (large)
{"properties":{"full":{"default":false,"title":"Full","type":"boolean"},"sort_by":{"default":"score_desc","title": ⟨8 unchanged words⟩
Certificate recorded, valid to 2026-11-07
Authorization not required
Unknown → Live
First tool surface recorded: 23 tools (server version 1.28.1)
https://basisprotocol.xyz/mcp (mcp_streamable_http) — from mcp_registry, with the record
Showing the latest 11 events. The API returns up to 500 and filters by kind: ?kind=tool_surface_changed
{"properties":{"mode":{"default":"summary","title":"Mode","type":"string"}},"title":"get_methodologyArguments","type":"object"}
before
{"properties":{"result":{"title":"Result","type":"string"}},"required":["result"],"title":"get_methodologyOutput","type":"object"}after
—{"properties":{"fullfields":{"default":falsenull,"items":{"type":"string"},"title":"FullFields","type":"booleanarray"},"limit":{"default":25,"title":"Limit","type":"integer"},"sort_by":{"default":"score_desc", ⟨9 unchanged words⟩
before
{"properties":{"result":{"title":"Result","type":"string"}},"required":["result"],"title":"get_stablecoin_scoresOutput","type":"object"}after
—⟨56 unchanged words⟩ Wallets active on multiple chains Call GET /api/query/templatesforfirstfulltoparameterlistdocumentation.the exact template names and their parameters; an unknown name returns the list of valid names (do not invent names such as "basis protocol").