Insight Oracle

io.github.imokokokv0.1.0Updated Oct 7, 2026

Pre-trade safety checks and 40 oracle data tools for AI agents, paid per call via x402.

VerifiedStreamable HTTPWeb executableSecurity & MonitoringFinanceData & Analytics

Overview

AI-generated overview

Gives an assistant cross-oracle price and risk checks, including pre-trade PASS/CAUTION/DANGER/BLOCK verdicts and Oracle Watch signals.

What it does
Insight exposes roughly 40 oracle data tools over a hosted MCP endpoint. It compares prices from ten oracle providers across many chains, evaluates deviation, freshness, source independence, stablecoin peg status, and protocol impact, and returns a pre-trade verdict with a recommended maximum position size. Oracle Watch gives a running NORMAL/CAUTION/DANGER signal with a proceed, proceed_with_caution, or halt recommendation, and signed EIP-712 attestations can be issued when signing is configured.
When to use it
Use it when an agent or application needs a safety check before a swap, borrow, lend, liquidation, or repayment, or wants to monitor oracle conditions between trades and pause on halt. It suits DeFi operators and developers who want cross-source oracle comparison and protocol risk context rather than a single feed.
Requirements
Remote streamable HTTP endpoint; no local runtime needed for the hosted server. Anonymous discovery calls work without credentials; metered calls need an X-API-Key drawing on a credit wallet, or x402 pay-per-call in USDC on Base. Local development requires Node.js 22 or later, Supabase credentials, CSRF_SECRET, JWT_SECRET, and ATTESTATION_SIGNER_PRIVATE_KEY for signed attestations.
Before you install
Metered calls spend from a credit wallet, and x402 calls settle payment in USDC on Base, so costs accrue per call. Signed attestations require ATTESTATION_SIGNER_PRIVATE_KEY, and a signature proves only who issued the fields, not that prices were correct or that a verdict was obeyed. Data is not real-time: snapshots are collected every 15 minutes, so check freshness and validity windows. Verdicts are advisory; the server does not execute trades.

Installation

In SourceWeft

  1. Open Insight Oracle in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "insight-oracle": {
      "type": "http",
      "url": "https://www.oracleinsight.xyz/api/mcp"
    }
  }
}

README

Insight — Oracle Transparency & Risk Intelligence

Insight helps DeFi applications, operators, developers, and AI agents inspect oracle prices and the risks of relying on them. It compares data from 10 oracle providers across 40+ blockchain networks, evaluates deviation, freshness, source independence, and protocol impact, and can issue signed evidence of its assessments.

text
Oracle observations → Cross-source comparison → Risk assessment → Verifiable evidence

Pre-Trade Safety Check assesses a proposed action. Oracle Watch monitors changing conditions between actions. The REST API, MCP server, Guard SDK, and independent verifier make these capabilities available to applications and agents. Insight also works independently of PriorSeal; see the product positioning guide for the combined assessment, authorization, execution, and review workflow.

Insight is not a real-time oracle tracker. Price snapshots and feed health are collected every 15 minutes, reputation scores are recalculated hourly, and data is aggregated into daily reports. Check each assessment's freshness and validity window before using it.

Start here

GoalWhere to go
Assess a trade from an application or agentGuard SDK or API reference
Verify a signed receipt with your own trusted keysIndependent verifier or browser demo
Explore the productWebsite or AI/MCP hub
Run the website and API locallyLocal development

What Insight provides

Pre-Trade Safety Check

Before a swap, borrow, lend, liquidation, or repayment, an application can request a cross-oracle assessment. The response combines price agreement, deviation, freshness, stablecoin peg status, reputation, and relevant protocol risk into a PASS, CAUTION, DANGER, or BLOCK verdict with a recommended maximum position size. Agents should not execute when the verdict is DANGER or BLOCK.

The verdict comes from deterministic rules; experimental ML scores provide additional context but do not drive it. Lending checks can freeze new borrowing when sustained oracle dispersion consumes the protocol's liquidation buffer. Successfully returned judgments are audit-logged before issuance; an audit-storage failure prevents a successful response.

When signing is configured, the check can include an EIP-712 attestation. A signature proves who issued the signed fields and whether they changed. It does not prove that the underlying prices were correct or that an agent obeyed the verdict. See the verifier's supported schemas for version-specific verification requirements.

Oracle Watch

Oracle Watch gives a running strategy a cross-oracle NORMAL, CAUTION, or DANGER signal and a proceed, proceed_with_caution, or halt recommendation. Applications can poll it between trades and pause on halt. It checks deviation, agreement, stale or outlying feeds, coverage, and independent source groups; it can also issue signed receipts when an attester key is configured.

Historical coverage is guaranteed for ETH, BTC, USDC, and USDT on Ethereum, Arbitrum, and Base. Other pairs can return a current signal without a historical curve; check meta.historyGuaranteed rather than treating an empty series as evidence of no incidents. Use the AI/MCP hub or GET /api/v1/oracle-watch?symbol=ETH&chain=ethereum to explore the signal.

Explore oracle and protocol risk

The web app also provides cross-oracle price comparison, feed health and reputation, position safety and liquidation analysis, Peg Risk for stablecoins and wrapped assets, and daily reports. Researchers can inspect source timestamps and export results; developers can use the corresponding API endpoints.

Integrated providers include Chainlink, API3, RedStone, DIA, WINkLink, Supra, Uniswap V3 TWAP, Reflector, Flare, and Band. Position safety supports selected Aave V3, Compound V3, Morpho Blue, Venus, and BENQI markets. Coverage varies by asset and chain, so confirm the available sources and protocol parameters for the position being assessed.

SDK, API, MCP, and verifier

  • Guard SDK — TypeScript integration for assessment, monitoring, and supported execution-price evidence. assessSwap() supports an assessment-only workflow; optional helpers can gate transaction submission and request execution receipts. The SDK uses the Insight API and its credit wallet.
  • REST API — versioned /api/v1/ endpoints for prices, risk, safety checks, and Oracle Watch. Metered calls use an X-API-Key; public receipt-verification endpoints do not require one. The API reference has request and response details.
  • MCP server — exposes the same services to compatible agents through stdio, HTTP, or the app's /api/mcp endpoint. See the AI/MCP hub for client configuration and tools.
  • Independent verifier — verifies receipt signatures and signed fields locally without depending on the Insight API. Consumers must independently establish trust in the attester key or key registry; successful signature verification is not an endorsement of a trade or verdict.

REST, MCP, and SDK calls draw from the same API-key credit wallet. Plans add credit capacity rather than separate feature tiers. See current pricing for plans and per-call costs.

MCP endpoint (production)

The hosted MCP server is live at https://www.oracleinsight.xyz/api/mcp (streamable HTTP).

  • Anonymous discovery: initialize, tools/list, and ping work without credentials, so agents can browse the 40-tool oracle catalog before committing.
  • Authenticated calls: pass an API key and calls draw from the credit wallet.
  • x402 pay-per-call: a single unauthenticated tools/call receives an x402 v2 402 quote priced by the tool's metering class (USDC on Base), then verify → execute → settle. A failed tool result is never settled.
  • One-click install (Cursor): Install Insight Oracle
  • Discovery surfaces: llms.txt, /.well-known/x402, /.well-known/mcp/server-card.json, and openapi.json at the site root.
  • Registry listing: published to the official MCP registry as io.github.imokokok/insight-oracle.

Local development

Requires Node.js 22 or later. From the repository root:

bash
npm installnpm run dev

See .env.local.example and src/lib/config/serverEnv.ts for environment configuration. Development can run with safe defaults for missing secrets; production requires Supabase credentials, CSRF_SECRET, and JWT_SECRET. Signed pre-trade attestations require ATTESTATION_SIGNER_PRIVATE_KEY.

To run the MCP server separately:

bash
npm run mcp:stdio   # local stdio transportnpm run mcp:http    # HTTP transport at http://127.0.0.1:3001/mcp

The application is built with Next.js, React, TypeScript, Tailwind CSS, and Supabase. App routes and API handlers live in src/app/; core oracle, risk, attestation, and billing logic lives in src/lib/; MCP code lives in src/mcp/. Database migrations are under supabase/.

Documentation

TopicDetails
Product scope and PriorSeal relationshipProduct positioning and Guard SDK
Receipt schemas and independent verificationVerifier README and registry release policy
Partner protocol and release isolationMainline partner isolation and protocol README
Operations and data collectionProduction readiness, cron dispatcher, and integration reliability
Database changesSQL inventory and execution order
Experimental RWA workRWA v1, RWA v2, and instrument registry

RWA/tokenized-equity adaptations remain opt-in research; no production RWA signer or authorization policy is activated. The optional Robinhood Stock Token issuer context is read-only and does not count as an independent oracle source.

License

See LICENSE.

Source: README.md at commit 980a262

Tools

0
Tool metadata has not been indexed yet.

Version history

1
  1. v0.1.0LatestOct 7, 2026