Are you an LLM? Read llms.txt for a summary of the docs, or llms-full.txt for the full context.
Skip to content

Quickstart

Two integration paths. Pick the one that matches how you'll call oculr - then follow the dedicated guide.

oculr is hosted at mpp.oculr.xyz. No server to run, no API key to manage. You bring a wallet funded with USDC.e on Tempo, and an MPP client like mppx handles the payment handshake on every request.

Which path?

Use as an agentCall the oculr MPP
ForAI agents - coding CLIs, sub-agents, anything that already speaks LLM tool-useApps, scripts, services calling the API directly from code
SetupOne-line prompt or one fetch of /tool-spec.jsonnpm install mppx viem, init once at boot
Time~30 seconds~5 minutes
GuideUse as an agent →Call the oculr MPP →

Both paths hit the same endpoints and get back the same ExplanationResult JSON.

What you need either way

  • An EVM wallet with USDC.e on Tempo (contract 0x20C000000000000000000000b9537d11c60E8b50). Top up the wallet however you normally move tokens on Tempo. Charges cluster into two bands: routine transactions run roughly $1 to $2, exploit and incident investigations usually around $3-4 - measured across 48 analyses of oculr's own benchmark corpus to 2026-07-29 on claude-opus-5, at the contract price. Size against the top of the range, not an average: the suggested deposit of $16 covers even the worst case on record. Set your client's maxDeposit to '32' - above the deposit, never equal to it, or the channel opens on its own ceiling and can never be topped up. See Pricing.
  • mppx, the MPP/x402 client library. It intercepts the 402 payment challenge and pays it transparently. Install with npm install mppx viem - viem is an mppx peer dependency (>=2.54.0) that the code samples import directly. If you only want the CLI, npm install -g mppx.

That's it. Pick a path above and follow the guide.

Just want to eyeball one transaction?

Skip the integration entirely. Paste the hash into oculr.xyz/app - the web app handles the streaming workflow, summary, trace, and flow diagram. No code, no install: connect a wallet to sign in, then top up your balance with USDC sent from any wallet or exchange. See Use the web app.

Related

  • Use as an agent - skill mode, sub-agent tool-use mode, raw API tutorial
  • Call the oculr MPP - mppx setup and first request from code
  • Core concepts - pipeline, confidence levels, sync vs async
  • Pricing - the metered formula and real production costs
  • FAQ - wallet funding, supported chains, troubleshooting