Insight MCP API

The MCP API from Insight — 2 operation(s) for mcp.

GitHub OpenAPI

Operations 2

POST /api/mcp Unified MCP entry to the four product functions — Oracle Evidence, Risk… #
POST /api/mcp/mpp MPP-paid pre-trade safety check over MCP #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • 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.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/oracleinsight-xyz:oracleinsight-xyz-mcp-api"
All apis
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.

Get an API 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 Specification

oracleinsight-xyz-mcp-api-openapi.yml Raw ↑
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