Skip to content

io.github.imokokok/insight-oracle

by imokokok · remote · no sign-in to list tools · v0.3.0 · published by GitHub user imokokok

Decision-input integrity for onchain AI agents: verify oracle prices before signing a trade.

Changes · 10
CompareRegistry entry

40 tools: 10 change things and 30 only read.

Scanned Oct 21, 2026

No check matched anything in the tool definitions. No finding is not a safety guarantee. How the checks work.

claude mcp add --transport http insight-oracle https://www.oracleinsight.xyz/api/mcp

Tools

Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.

40 tools

Changes things 10Claude Code: ask
  • agent_begin_tradeObtain oracle assessment evidence for a swap/DeFi intent BEFORE trading.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    Obtain oracle assessment evidence for a swap/DeFi intent BEFORE trading. Insight runs the oracle safety check and, if the verdict is PASS/CAUTION, returns a machine-readable "execution certification handle": preTradeUid, requestHash, CAIP-19 asset ids, the certified price (destination per source) and maxSlippageBps, plus a required operation-input check for both asset legs and a fresh Uniswap V3 on-chain route quote cross-checked by two Ethereum RPCs. If either input assessment is not SUFFICIENT, either route quote is stale or outside policy, or either oracle gate blocks, no execution handle is issued. The assessments are independently EIP-712 signed and linked to the receipt through both pre-trade UIDs. participant/source-group counts and the pre-trade signing time. Execute the trade with YOUR wallet, then call execution_receipt with this handle + txHash to obtain the signed, verifiable Execution Receipt. If the verdict is DANGER or BLOCK this tool refuses (do not trade). This is oracle assessment evidence, not principal authorization — pair it with execution_receipt.
  • assess_rwa_evidenceEvaluate supplied RWA/tokenized-stock evidence against an explicit policy.No findings

    Why it is in this group

    • The description's first verb is "evaluate": a word for a change.
    Description, as the server wrote it
    Evaluate supplied RWA/tokenized-stock evidence against an explicit policy. Unsigned diagnostic only: caller-supplied facts are not authenticated, and ALLOW does not authorize a trade. Existing pre-trade and authorization checks remain required.
  • check_liquidation_riskCheck protocol liquidation risk for a specific date.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    Check protocol liquidation risk for a specific date. Returns stress-test results based on representative benchmark positions.
  • check_position_safetyCheck the safety of a DeFi lending position against oracle deviation stress tests.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    Check the safety of a DeFi lending position against oracle deviation stress tests. Supports multi-asset or single-asset positions.
  • execution_receiptIssue signed execution-price evidence comparing an observed fill with the oracle-assessed quote and signed slippage band.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    Issue signed execution-price evidence comparing an observed fill with the oracle-assessed quote and signed slippage band. Provide the pre-trade fields (preTradeUid, requestHash, asset ids, chain, oracle gate counts) plus the settlement txHash. Insight collects the on-chain fill, signs a receipt paired to the pre-trade via preTradeUid + requestHash, and returns a FAITHFUL / DEVIATED / NOT_EXECUTED / UNDETERMINED verdict. This reports supported price/fill fidelity, not principal authorization or overall transaction safety. Pair it with pre_trade_safety_check and oracle_watch.
  • oracle_watchOngoing cross-oracle risk signal for an asset: current consensus deviation, agreement, quorum, outliers and staleness condensed into a NORMAL / CAUTION / DANGER verdict with a proc…No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    Ongoing cross-oracle risk signal for an asset: current consensus deviation, agreement, quorum, outliers and staleness condensed into a NORMAL / CAUTION / DANGER verdict with a proceed / proceed_with_caution / halt recommendation. Agents should gate long-running strategies (yield, keeper, portfolio) on this signal, not just one-off trades. Pair it with pre_trade_safety_check for the decision moment.
  • oracle_watch_historyRetrospective Oracle Watch trend for an asset: verdict stability, degraded-time ratio, worst deviation and mean credibility over the last N days, plus the recent series.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    Retrospective Oracle Watch trend for an asset: verdict stability, degraded-time ratio, worst deviation and mean credibility over the last N days, plus the recent series. Use it to judge whether a feed has been dependable, not just whether it is healthy this instant. History is guaranteed only for the committed universe (ETH/BTC/USDC/USDT x ethereum/arbitrum/base); other pairs return a live point signal from oracle_watch but no curve.
  • pre_trade_safety_checkPre-trade decision-input integrity checkpoint for AI agents.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    Pre-trade decision-input integrity checkpoint for AI agents. Call this BEFORE executing any on-chain swap/borrow/lend/liquidation/repay to verify that the price the action relies on can be trusted. First assessment domain: oracle risk — aggregates cross-oracle consensus prices, per-provider deviation, data freshness, stablecoin peg status, and reputation into a single verdict. An optional decisionInput object adds a separate Chainlink/CEX/DEX input-sufficiency assessment against the caller-supplied venue quote and explicit limits, with an independently verifiable EIP-712 signature when signing is enabled; it never changes the verdict. Verdicts are PASS / CAUTION / DANGER / BLOCK. AI agents MUST NOT execute trades when the verdict is DANGER or BLOCK. Also returns a recommended maximum position size. A PASS is not principal authorization or a guarantee of price correctness or economic safety.
  • recommend_oracle_setupRecommend oracle provider setup for an asset based on active feeds.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    Recommend oracle provider setup for an asset based on active feeds. Use this to decide which providers to include in price feeds or risk analysis.
  • verify_execution_pairVerify that a pre-trade oracle-safety attestation and an Execution Receipt describe the same assessed trade and that the certify → execute → prove loop closed.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    Verify that a pre-trade oracle-safety attestation and an Execution Receipt describe the same assessed trade and that the certify → execute → prove loop closed. Returns pairedValid, the closed-loop status (CLOSED_FAITHFUL / CLOSED_DEVIATED / CLOSED_NOT_EXECUTED / CLOSED_UNDETERMINED, PRICE_-prefixed on v3 receipts whose signed verdict is priceExecutionStatus, or PAIR_INVALID), and the binding assertions (preTradeUid, requestHash, destination gate + preTradeUidsHash on v3, chain, asset). On a v3 receipt that commits to a destination gate, pass destinationPreTradeAttestation or the pair cannot close. This checks assessment/price-evidence binding; it does not establish principal authorization, price correctness, or economic safety. Pair it with agent_begin_trade and execution_receipt.
Only reads 30Claude Code: allow
  • compare_oracle_deviationCompare historical price deviations across oracle providers for an asset.No findings

    Why it is in this group

    • The name "compare_oracle_deviation" says "compare": a word for reading.
    Description, as the server wrote it
    Compare historical price deviations across oracle providers for an asset. Helps identify which providers consistently diverge from consensus.
  • get_anomaliesGet aggregated oracle anomaly events over a lookback period (1-30 days), including top deviation events and risk impacts.No findings

    Why it is in this group

    • The name "get_anomalies" says "get": a word for reading.
    Description, as the server wrote it
    Get aggregated oracle anomaly events over a lookback period (1-30 days), including top deviation events and risk impacts.
  • get_consensus_priceGet the aggregated consensus price for an asset across multiple oracle providers.No findings

    Why it is in this group

    • The name "get_consensus_price" says "get": a word for reading.
    Description, as the server wrote it
    Get the aggregated consensus price for an asset across multiple oracle providers. Useful when you need a robust, manipulation-resistant reference price.
  • get_correlationCompute pairwise Pearson correlation of oracle provider deviations for an asset over a date range.No findings

    Why it is in this group

    • The name "get_correlation" says "get": a word for reading.
    Description, as the server wrote it
    Compute pairwise Pearson correlation of oracle provider deviations for an asset over a date range. Helps identify independent vs correlated providers.
  • get_coverageIdentify oracle coverage gaps and single-provider-risk symbols (assets served by only one oracle — a concentration risk).No findings

    Why it is in this group

    • The name "get_coverage" says "get": a word for reading.
    Description, as the server wrote it
    Identify oracle coverage gaps and single-provider-risk symbols (assets served by only one oracle — a concentration risk). Returns breakdowns by provider, chain, and symbol. Use this when assessing where coverage is thin. For ecosystem scale plus top reputable providers, use get_metrics instead.
  • get_cross_chain_spreadsGet pairwise price spreads across chains for a given provider and symbol.No findings

    Why it is in this group

    • The name "get_cross_chain_spreads" says "get": a word for reading.
    Description, as the server wrote it
    Get pairwise price spreads across chains for a given provider and symbol. Useful for cross-chain arbitrage and risk tracking.
  • get_daily_reportGet the full daily oracle/risk report for a specific date, including liquidation risks, anomalies, and market summary.No findings

    Why it is in this group

    • The name "get_daily_report" says "get": a word for reading.
    Description, as the server wrote it
    Get the full daily oracle/risk report for a specific date, including liquidation risks, anomalies, and market summary.
  • get_feed_freshnessScan current freshness/staleness across many active feeds, filterable by provider, symbol, or category.No findings

    Why it is in this group

    • The name "get_feed_freshness" says "get": a word for reading.
    Description, as the server wrote it
    Scan current freshness/staleness across many active feeds, filterable by provider, symbol, or category. Use this to find feeds needing attention right now. For a single feed by UUID use get_feed_health; for a dated ecosystem-wide report use get_oracle_health.
  • get_feed_healthGet detailed point-in-time health status for ONE specific oracle feed by its UUID (consecutive failures, last success/failure, status).No findings

    Why it is in this group

    • The name "get_feed_health" says "get": a word for reading.
    Description, as the server wrote it
    Get detailed point-in-time health status for ONE specific oracle feed by its UUID (consecutive failures, last success/failure, status). For ecosystem-wide health by date use get_oracle_health; to scan freshness across many feeds use get_feed_freshness.
  • get_feed_uptimeAnalyze feed data-delivery reliability over a date range: success rate, hours with data, coverage %, and average snapshots per day per provider+symbol.No findings

    Why it is in this group

    • The name "get_feed_uptime" says "get": a word for reading.
    Description, as the server wrote it
    Analyze feed data-delivery reliability over a date range: success rate, hours with data, coverage %, and average snapshots per day per provider+symbol. Use this to assess how completely a feed delivered data over time — distinct from get_feed_health (point-in-time status) and get_latency (speed).
  • get_feedsList oracle feeds from the registry with optional filters (provider, symbol, category, chain, active status).No findings

    Why it is in this group

    • The name "get_feeds" says "get": a word for reading.
    Description, as the server wrote it
    List oracle feeds from the registry with optional filters (provider, symbol, category, chain, active status). Useful for discovering available feeds and their metadata.
  • get_incidentsGet oracle incidents and deviation events within a date range.No findings

    Why it is in this group

    • The name "get_incidents" says "get": a word for reading.
    Description, as the server wrote it
    Get oracle incidents and deviation events within a date range. Filter by provider and minimum severity.
  • get_latencyAnalyze 15-minute oracle collector latency statistics (min, mean, p50, p90, p95, p99) over a date range, optionally filtered by provider or symbol.No findings

    Why it is in this group

    • The name "get_latency" says "get": a word for reading.
    Description, as the server wrote it
    Analyze 15-minute oracle collector latency statistics (min, mean, p50, p90, p95, p99) over a date range, optionally filtered by provider or symbol.
  • get_metricsCompact ecosystem overview: provider/feed/symbol/chain/category counts plus top providers ranked by reputation score.No findings

    Why it is in this group

    • The name "get_metrics" says "get": a word for reading.
    Description, as the server wrote it
    Compact ecosystem overview: provider/feed/symbol/chain/category counts plus top providers ranked by reputation score. Use this for a quick scale snapshot or provider ranking. To find coverage gaps and single-provider risk, use get_coverage instead.
  • get_oracle_healthGet the ecosystem-wide oracle health report for a specific date (uptime, staleness, and success rates across all providers).No findings

    Why it is in this group

    • The name "get_oracle_health" says "get": a word for reading.
    Description, as the server wrote it
    Get the ecosystem-wide oracle health report for a specific date (uptime, staleness, and success rates across all providers). Use this for a dated snapshot of overall health. For a single feed by UUID use get_feed_health; to scan current freshness across many feeds use get_feed_freshness.
  • get_oracle_priceFetch the latest price from a specific oracle provider for an asset.No findings

    Why it is in this group

    • The name "get_oracle_price" says "get": a word for reading.
    Description, as the server wrote it
    Fetch the latest price from a specific oracle provider for an asset.
  • get_oracle_prices_batchFetch prices for multiple assets/providers in a single request.No findings

    Why it is in this group

    • The name "get_oracle_prices_batch" says "get": a word for reading.
    Description, as the server wrote it
    Fetch prices for multiple assets/providers in a single request. Up to 20 queries.
  • get_price_historyGet historical price data for an asset from a specific oracle provider over a period (in hours).No findings

    Why it is in this group

    • The name "get_price_history" says "get": a word for reading.
    Description, as the server wrote it
    Get historical price data for an asset from a specific oracle provider over a period (in hours).
  • get_protocol_oracle_exposureAnalyze oracle provider concentration risk for a specific lending protocol.No findings

    Why it is in this group

    • The name "get_protocol_oracle_exposure" says "get": a word for reading.
    Description, as the server wrote it
    Analyze oracle provider concentration risk for a specific lending protocol. Shows which providers cover which assets and concentration metrics.
  • get_protocol_risk_paramsGet risk parameters for a specific DeFi protocol, including liquidation thresholds, LTV ratios, and collateral factors.No findings

    Why it is in this group

    • The name "get_protocol_risk_params" says "get": a word for reading.
    Description, as the server wrote it
    Get risk parameters for a specific DeFi protocol, including liquidation thresholds, LTV ratios, and collateral factors.
  • get_protocolsGet a list of lending protocols with dynamic data (TVL, asset counts, oracle providers used).No findings

    Why it is in this group

    • The name "get_protocols" says "get": a word for reading.
    Description, as the server wrote it
    Get a list of lending protocols with dynamic data (TVL, asset counts, oracle providers used). Optionally filter by name/slug query.
  • get_provider_reputationGet detailed reputation metrics for a specific oracle provider, optionally with historical trend.No findings

    Why it is in this group

    • The name "get_provider_reputation" says "get": a word for reading.
    Description, as the server wrote it
    Get detailed reputation metrics for a specific oracle provider, optionally with historical trend.
  • get_reputation_rankingsGet oracle provider reputation rankings with trend over a period (1-90 days).No findings

    Why it is in this group

    • The name "get_reputation_rankings" says "get": a word for reading.
    Description, as the server wrote it
    Get oracle provider reputation rankings with trend over a period (1-90 days).
  • get_risk_summaryGet a composite risk summary for an asset across selected oracle providers.No findings

    Why it is in this group

    • The name "get_risk_summary" says "get": a word for reading.
    Description, as the server wrote it
    Get a composite risk summary for an asset across selected oracle providers. Includes HHI concentration, volatility, correlation, freshness, manipulation resistance, and shared-dependency risk.
  • get_robinhood_rwa_contextGet Robinhood Stock Token issuer context: official asset identity, trading capabilities, halt state, corporate actions, multiplier-normalized reference price, and optional on-chain…No findings

    Why it is in this group

    • The name "get_robinhood_rwa_context" says "get": a word for reading.
    Description, as the server wrote it
    Get Robinhood Stock Token issuer context: official asset identity, trading capabilities, halt state, corporate actions, multiplier-normalized reference price, and optional on-chain ERC-8056 verification. First-party evidence only; it is not an independent oracle and never counts toward oracle quorum or authorizes a trade.
  • get_robinhood_rwa_instrumentResolve a Robinhood Stock Token to Insight committed master data, using share-class FIGI for the underlying and ISO 10383 MIC for its primary market, then cross-check issuer UID, I…No findings

    Why it is in this group

    • The name "get_robinhood_rwa_instrument" says "get": a word for reading.
    Description, as the server wrote it
    Resolve a Robinhood Stock Token to Insight committed master data, using share-class FIGI for the underlying and ISO 10383 MIC for its primary market, then cross-check issuer UID, ISIN and contract deployment. Reference/admission evidence only; it never counts toward price quorum or authorizes a trade.
  • get_stablecoin_listList all tracked stablecoin symbols.No findings

    Why it is in this group

    • The name "get_stablecoin_list" says "get": a word for reading.
    Description, as the server wrote it
    List all tracked stablecoin symbols.
  • get_stablecoin_pegCheck stablecoin peg status.No findings

    Why it is in this group

    • The name "get_stablecoin_peg" says "get": a word for reading.
    Description, as the server wrote it
    Check stablecoin peg status. Provide a symbol for a specific stablecoin, or omit it to get all tracked stablecoins.
  • get_symbolsList supported asset symbols.No findings

    Why it is in this group

    • The name "get_symbols" says "get": a word for reading.
    Description, as the server wrote it
    List supported asset symbols. Optionally filter by a search query. Use this when you are unsure whether a symbol is supported.
  • get_wrapped_asset_pegCheck wrapped asset (e.g.No findings

    Why it is in this group

    • The name "get_wrapped_asset_peg" says "get": a word for reading.
    Description, as the server wrote it
    Check wrapped asset (e.g. WBTC, wstETH) peg status. Provide a symbol for a specific asset, or omit it to get all tracked wrapped assets.

This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.

Install

Pinned to version 0.3.0. Values in angle brackets are yours to fill in.

claude mcp add --transport http insight-oracle https://www.oracleinsight.xyz/api/mcp

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.

.claude/settings.json
{
  "permissions": {
    "allow": [
      "mcp__insight-oracle__get_robinhood_rwa_instrument",
      "mcp__insight-oracle__get_robinhood_rwa_context",
      "mcp__insight-oracle__get_oracle_price",
      "mcp__insight-oracle__get_consensus_price",
      "mcp__insight-oracle__get_risk_summary",
      "mcp__insight-oracle__get_oracle_health",
      "mcp__insight-oracle__compare_oracle_deviation",
      "mcp__insight-oracle__get_stablecoin_peg",
      "mcp__insight-oracle__get_protocol_risk_params",
      "mcp__insight-oracle__get_symbols",
      "mcp__insight-oracle__get_stablecoin_list",
      "mcp__insight-oracle__get_oracle_prices_batch",
      "mcp__insight-oracle__get_price_history",
      "mcp__insight-oracle__get_cross_chain_spreads",
      "mcp__insight-oracle__get_wrapped_asset_peg",
      "mcp__insight-oracle__get_protocols",
      "mcp__insight-oracle__get_protocol_oracle_exposure",
      "mcp__insight-oracle__get_feed_freshness",
      "mcp__insight-oracle__get_feeds",
      "mcp__insight-oracle__get_feed_health",
      "mcp__insight-oracle__get_feed_uptime",
      "mcp__insight-oracle__get_reputation_rankings",
      "mcp__insight-oracle__get_provider_reputation",
      "mcp__insight-oracle__get_daily_report",
      "mcp__insight-oracle__get_incidents",
      "mcp__insight-oracle__get_latency",
      "mcp__insight-oracle__get_anomalies",
      "mcp__insight-oracle__get_correlation",
      "mcp__insight-oracle__get_coverage",
      "mcp__insight-oracle__get_metrics"
    ],
    "ask": [
      "mcp__insight-oracle__assess_rwa_evidence",
      "mcp__insight-oracle__check_liquidation_risk",
      "mcp__insight-oracle__recommend_oracle_setup",
      "mcp__insight-oracle__check_position_safety",
      "mcp__insight-oracle__pre_trade_safety_check",
      "mcp__insight-oracle__oracle_watch",
      "mcp__insight-oracle__oracle_watch_history",
      "mcp__insight-oracle__execution_receipt",
      "mcp__insight-oracle__agent_begin_trade",
      "mcp__insight-oracle__verify_execution_pair"
    ],
    "deny": []
  }
}

Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as insight-oracle. Review it before you use it.