Insight MCP API
The MCP API from Insight — 2 operation(s) for mcp.
The MCP API from Insight — 2 operation(s) for mcp.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/oracleinsight-xyz:oracleinsight-xyz-mcp-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Insight Decision-Input Trust MCP API
version: 1.0.0
contact:
name: YuTao Peng (Insight)
email: imokokok123@gmail.com
description: 'Decision-input trust for AI agents trading onchain, offered as four product functions: Oracle Evidence (inspect and record what price sources actually report), Risk Intelligence (prepaid continuous monitoring for live positions), Decision Integrity (per-action signed pre-trade verdicts across guard families), and Verify (independent, always-free offline re-verification of signed evidence). The REST pre-trade endpoint accepts API-key access and advertises configured x402/MPP payment rails. The MPP MCP pilot exposes pre_trade_safety_check on its dedicated endpoint; the full MCP tool catalog remains on /api/mcp.'
x-guidance: 'REST: GET /api/v1/safety/pre-trade for the full oracle assessment, or GET /api/v1/safety/preflight for the compact ALLOW/CAUTION/BLOCK action decision; both take asset, chainId, action, and tradeAmountUsd. An optional decisionInputCheck=1 adds an input-sufficiency assessment when the caller also supplies its price, venue quote, quote timestamp, and explicit tolerance limits; this does not change the oracle verdict or authorize execution. The full MCP catalog uses POST /api/mcp (x402 or API key). The MPP MCP pilot uses POST /api/mcp/mpp and only accepts pre_trade_safety_check. MPP offers are shown only when enabled; the runtime challenge is authoritative. Every paid result is settled only after the tool succeeds.'
servers:
- url: https://www.oracleinsight.xyz
description: Production
tags:
- name: MCP
paths:
/api/mcp:
post:
operationId: mcpToolCall
summary: Unified MCP entry to the four product functions — Oracle Evidence, Risk…
tags:
- MCP
description: Pay-per-call access to the Insight oracle tool catalog for agents without an API key. Price scales with the tool metering class (C1=$0.002, C2=$0.004, C3=$0.02, C4=$0.04). tools/list and initialize are free; paid calls settle only after success.
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
const: '2.0'
id:
type:
- integer
- string
method:
type: string
enum:
- tools/call
- tools/list
- initialize
params:
type: object
properties:
name:
type: string
examples:
- get_symbols
- pre_trade_safety_check
- get_risk_summary
arguments:
type: object
additionalProperties: true
required:
- name
additionalProperties: true
required:
- jsonrpc
- method
- params
additionalProperties: true
responses:
'200':
description: JSON-RPC response (paid via x402 or free method); paid tools/call responses include the EIP-712 attestation receipt in the tool result content
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
const: '2.0'
id:
type:
- integer
- string
result:
type: object
additionalProperties: true
error:
type: object
additionalProperties: true
additionalProperties: true
'402':
description: 'Payment Required: x402 v2 challenge in the PAYMENT-REQUIRED response header. The amount reflects the requested tool metering class.'
'429':
description: Rate limited (paid tier 60/min/IP)
x-x402-payment-info:
protocol: x402-v2
price:
currency: USD
min: '0.002'
max: '0.04'
unit: per tool call
x-payment-info:
protocols:
- x402: {}
price:
mode: dynamic
currency: USD
min: '0.002'
max: '0.04'
/api/mcp/mpp:
post:
operationId: mppMcpPreTradeSafetyCheck
summary: MPP-paid pre-trade safety check over MCP
tags:
- MCP
description: MPP pilot endpoint for the pre_trade_safety_check tool only. Payment is bound to the tool name and canonicalized arguments; validation happens before execution and settlement happens only after a successful tool result. MCP reports payment-required as JSON-RPC error -32042 with data.httpStatus=402; Streamable HTTP may carry that JSON-RPC response with HTTP 200.
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
const: '2.0'
id:
type:
- integer
- string
method:
type: string
const: tools/call
params:
type: object
properties:
name:
type: string
examples:
- get_symbols
- pre_trade_safety_check
- get_risk_summary
const: pre_trade_safety_check
arguments:
type: object
additionalProperties: true
required:
- name
additionalProperties: true
required:
- jsonrpc
- method
- params
additionalProperties: true
responses:
'200':
description: Successful JSON-RPC response. MPP-paid tool results include the receipt in result._meta["org.paymentauth/receipt"].
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
const: '2.0'
id:
type:
- integer
- string
result:
type: object
additionalProperties: true
error:
type: object
additionalProperties: true
additionalProperties: true
'402':
description: 'MPP Payment Required at the MCP protocol level: JSON-RPC error -32042 with the challenge in error.data.challenges and data.httpStatus=402.'
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
const: '2.0'
id:
type:
- integer
- string
error:
type: object
properties:
code:
const: -32042
'429':
description: Rate limited (paid tier 60/min/IP)
x-payment-info:
offers:
- intent: charge
method: evm
amount: '20000'
currency: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
description: $0.02 USDC per successful pre-trade safety check
protocols:
- mpp:
method: evm
intent: charge
currency: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
price:
mode: fixed
currency: USD
amount: '0.02'
x-service-info:
categories:
- ai
- data
docs:
homepage: https://www.oracleinsight.xyz/docs/x402
llms: https://www.oracleinsight.xyz/llms.txt
apiReference: https://www.oracleinsight.xyz/openapi.yaml