How do I install Oraclaw?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Oraclaw need an API key?

The publisher lists these environment variables: ORACLAW_API_KEY.

What transport does Oraclaw use?

Oraclaw runs locally over stdio.

When was Oraclaw last checked?

Last checked 2026-11-09. Decision intelligence MCP — 17 tools (optimize, simulate, predict, score, graph). Sub-25ms.

Oraclaw MCP server

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

npx -y @oraclaw/[email protected]

Credentials from the publisher

ORACLAW_API_KEY — Optional API key for premium tools (CMA-ES, LP/MIP solver, graph analytics, risk VaR/CVaR, forecasting, anomaly detection). Free tier (11 tools) works without it.

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1ORACLAW_API_KEY=<secret> claude mcp add io.github.whatsonyourmind-oraclaw -- npx -y @oraclaw/mcp-server@1.5.1

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.whatsonyourmind-oraclaw": {4      "command": "npx",5      "args": [6        "-y",7        "@oraclaw/[email protected]"8      ],9      "env": {10        "ORACLAW_API_KEY": "<secret>"11      }12    }13  }14}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 1.5.1
API key

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

OraClaw

MCP Optimization Tools for AI Agents -- 17 tools (11 free, no key), sub-25ms. Zero LLM cost.

Your AI agent can't do math. OraClaw gives it deterministic optimization, simulation, forecasting, and risk analysis through the Model Context Protocol. Every tool returns structured JSON, runs in under 25ms, and costs nothing to compute.

🚀 Using OraClaw in production — or want managed hosting, premium tools, or priority support? Tell me about your use case → — I read every one.

💬 Building something with it? Star the repo and say hi in Discussions — what you build steers what I ship next.

What this solves

LLMs generate plausible text, not mathematically optimal answers. OraClaw gives an AI agent a set of deterministic numerical tools it can call instead of guessing — each returns structured JSON from a real algorithm, with no token spend on reasoning. Concretely:

Your agent needs to pick the next variant to try (A/B test arm, ad/email copy, recommendation) and balance exploration against exploitation — without hand-rolling a bandit or letting the model eyeball it. Call optimize_bandit (or optimize_contextual when the best choice depends on per-call features).
Your agent needs a provably optimal allocation or schedule under hard constraints (budget split, integer counts, capacity caps) — without the model hallucinating constraints. Call solve_constraints (LP/MIP/QP via HiGHS) or solve_schedule for task-to-slot fitting.
Your agent needs to quantify uncertainty around an outcome — project a value under an uncertain input, or measure VaR/CVaR on a weighted multi-asset book with auditable assumptions — without a Monte Carlo loop in the prompt. Call simulate_montecarlo, simulate_scenario, or analyze_risk.
Your agent needs a point forecast or an outlier flag on a time series (demand, KPIs, sensor/metric streams) — without inventing trend math. Call predict_forecast (ARIMA / Holt-Winters) or detect_anomaly (Z-score / IQR).
Your agent needs to fuse or score probability signals — combine model outputs, measure how much independent sources agree, or check whether past predictions were well-calibrated. Call predict_ensemble, score_convergence, or score_calibration.
Your agent needs to reason over a graph — rank influential nodes, cluster a dependency/knowledge graph, find a critical path, or route between two nodes. Call analyze_graph or plan_pathfind.

Where the algorithms have been used

OraClaw's algorithms have informed implementations in several open-source projects -- through contributed routing specs, algorithm guidance, and shared math -- spanning AI agent orchestration, time-series tracking, vector search, and optimization.

Selected contributions (see CHANGELOG.md for the full list):

chernistry/bernstein -- agent orchestration framework. LinUCB contextual router (α=0.3) with shadow-evaluation path and interpretable decision reasons, shipped in codex/issue-367-linucb-router after a contributed spec correction.
stxkxs/nanohype -- contextual bandit routing, pluggable strategy registry (hash / sliding-TTL / semantic), cost anomaly detection. "Your input shaped a lot of what actually shipped."
rfivesix/hypertrack -- Bayesian/Kalman-style adaptive estimator with phase-aware ramp. Shipped in 0.8.0-beta.
AlanHuang99/pyrollmatch -- entropy balancing (Hainmueller 2012) with moment constraints + max_weight cap. Shipped in v0.1.3.
stffns/vstash -- IDF-sigmoid relevance weighting. Shipped in v0.17.0.

Marketplace distribution:

✓ punkpeye/awesome-mcp-servers -- merged
✓ TensorBlock/awesome-mcp-servers -- merged
✓ MCP Registry, Glama (score A/A/B), PulseMCP, toolsdk-ai -- listed

Quick Start

1. MCP Server (recommended for AI agents)

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "oraclaw": {
      "command": "npx",
      "args": ["-y", "@oraclaw/mcp-server"]
    }
  }
}

Then ask your agent:

"I have 3 email subject line variants. Which should I send next?"

The agent calls optimize_bandit and gets a statistically optimal selection in 0.01ms.

2. REST API (no install)

curl -X POST https://oraclaw-api.onrender.com/api/v1/optimize/bandit \
  -H 'Content-Type: application/json' \
  -d '{
    "arms": [
      {"id": "A", "name": "Option A", "pulls": 10, "totalReward": 7},
      {"id": "B", "name": "Option B", "pulls": 10, "totalReward": 5},
      {"id": "C", "name": "Option C", "pulls": 2, "totalReward": 1.8}
    ],
    "algorithm": "ucb1"
  }'

Response (<1ms):

{
  "selected": { "id": "C", "name": "Option C" },
  "score": 1.876,
  "algorithm": "ucb1",
  "exploitation": 0.9,
  "exploration": 0.976,
  "regret": 0.1
}

Free tier: 25 calls/day, no API key needed.

3. npm SDK

npm install @oraclaw/bandit

import { OraBandit } from '@oraclaw/bandit';

const client = new OraBandit({ baseUrl: 'https://oraclaw-api.onrender.com' });
const result = await client.optimize({
  arms: [
    { id: 'A', name: 'Short Subject', pulls: 500, totalReward: 175 },
    { id: 'B', name: 'Long Subject', pulls: 300, totalReward: 126 },
  ],
  algorithm: 'ucb1',
});

14 SDK packages: @oraclaw/bandit, @oraclaw/solver, @oraclaw/simulate, @oraclaw/risk, @oraclaw/forecast, @oraclaw/anomaly, @oraclaw/graph, @oraclaw/bayesian, @oraclaw/ensemble, @oraclaw/calibrate, @oraclaw/evolve, @oraclaw/pathfind, @oraclaw/cmaes, @oraclaw/decide

Why?

LLMs generate plausible text, not optimal solutions. Ask GPT to pick the best A/B test variant and it applies a heuristic that ignores the exploration-exploitation tradeoff. Ask it to solve a linear program and it hallucinates constraints. OraClaw gives your agent access to real algorithms -- bandits, solvers, forecasters, risk models -- that return mathematically correct answers in sub-millisecond time, without burning tokens on reasoning.

MCP Tool Catalog (17 tools)

Free tier (11 tools, no API key — 25 calls/day per IP):

Tool	What It Does	Latency
`optimize_bandit`	UCB1 / Thompson / Epsilon-Greedy arm selection	0.01ms
`optimize_contextual`	Context-aware LinUCB bandit	0.05ms
`optimize_evolve`	Genetic algorithm for discrete + multi-objective problems	<10ms
`solve_schedule`	Energy-matched task scheduling	3ms
`score_convergence`	Multi-source probability consensus (Hellinger)	0.04ms
`score_calibration`	Brier + log score for forecaster accuracy	0.02ms
`predict_bayesian`	Beta posterior update from weighted evidence	0.05ms
`predict_ensemble`	Multi-model consensus + uncertainty decomposition	0.1ms
`plan_pathfind`	A* + Yen's k-shortest paths	0.1ms
`simulate_montecarlo`	Single-factor Monte Carlo (6 distributions)	<2ms
`simulate_scenario`	What-if comparison + sensitivity ranking	<5ms

Premium tier (6 tools, requires ORACLAW_API_KEY):

Tool	What It Does	Latency
`optimize_cmaes`	CMA-ES continuous black-box optimization	12ms
`solve_constraints`	LP / MIP / QP solver via HiGHS (provably optimal)	2ms
`analyze_graph`	PageRank, Louvain communities, bottleneck detection	0.5ms
`analyze_risk`	VaR and CVaR (Expected Shortfall)	<2ms
`predict_forecast`	ARIMA + Holt-Winters time series forecasting	0.08ms
`detect_anomaly`	Z-Score + IQR anomaly detection	0.01ms

14 of 18 REST endpoints respond in under 1ms. All under 25ms.

Try It Now

The API is live. No signup required.

# Bayesian inference
curl -X POST https://oraclaw-api.onrender.com/api/v1/predict/bayesian \
  -H 'Content-Type: application/json' \
  -d '{"prior": 0.3, "evidence": [{"factor": "positive_test", "weight": 0.9, "value": 0.05}]}'

# Monte Carlo simulation
curl -X POST https://oraclaw-api.onrender.com/api/v1/simulate/montecarlo \
  -H 'Content-Type: application/json' \
  -d '{"simulations": 1000, "distribution": "normal", "params": {"mean": 100, "stddev": 15}}'

# Monte Carlo with a non-normal distribution
curl -X POST https://oraclaw-api.onrender.com/api/v1/simulate/montecarlo \
  -H 'Content-Type: application/json' \
  -d '{"simulations": 1000, "distribution": "triangular", "params": {"min": 80, "mode": 100, "max": 140}}'

Premium tools (detect_anomaly, predict_forecast, analyze_risk, solve_constraints, analyze_graph, optimize_cmaes) need an API key or an x402 payment — see Pricing below.

Pricing

Tier	Calls	Price	Auth
Free	25/day	$0	None
Pay-per-call	1K/day	$0.005/call	API key
Starter	50K/mo	$9/mo	API key
Growth	500K/mo	$49/mo	API key
Scale	5M/mo	$199/mo	API key

x402 (for autonomous agents): pay $0.001/call in USDC on Base — no signup, no API key. Send a signed PAYMENT-SIGNATURE header on any premium endpoint; the API verifies, meters, and settles per call. Get a key instead with a one-line POST /api/v1/auth/signup ({"email":"you@…"}) — instant, no card.

Source Code

Component	Path
MCP Server	`mission-control/packages/mcp-server/`
REST API	`mission-control/apps/api/`
Algorithms	`mission-control/apps/api/src/services/oracle/algorithms/`
SDK Packages	`mission-control/packages/sdk/`
LangChain Tools	`mission-control/integrations/langchain/oraclaw_tools.py`
Mobile App	`mission-control/apps/mobile/`
Dashboard (Next.js)	`web/`

Building with OraClaw?

We'd love to hear what you're working on. Share your use case, ask questions, or request features:

License

MIT

Oraclaw

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Oraclaw?

Does Oraclaw need an API key?

What transport does Oraclaw use?

When was Oraclaw last checked?

Documentation

OraClaw

What this solves

Where the algorithms have been used

Quick Start

1. MCP Server (recommended for AI agents)

2. REST API (no install)

3. npm SDK

Why?

MCP Tool Catalog (17 tools)

Try It Now

Pricing

Source Code

Building with OraClaw?

Links

License