{"id":49029182,"url":"https://github.com/Whatsonyourmind/oraclaw","last_synced_at":"2026-04-20T01:00:47.536Z","repository":{"id":346689988,"uuid":"1191152641","full_name":"Whatsonyourmind/oraclaw","owner":"Whatsonyourmind","description":"Decision intelligence for AI agents. 19 algorithms, 12 MCP tools, sub-25ms. Zero LLM cost.","archived":false,"fork":false,"pushed_at":"2026-04-19T21:51:06.000Z","size":2860,"stargazers_count":7,"open_issues_count":17,"forks_count":2,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-04-19T23:36:43.776Z","etag":null,"topics":["ai-agents","algorithms","api","bandits","decision-intelligence","fastify","machine-learning","mcp","optimization","typescript"],"latest_commit_sha":null,"homepage":"https://web-olive-one-89.vercel.app","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Whatsonyourmind.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"custom":["https://buy.stripe.com/4gw5kJcFR1J63LO288"]}},"created_at":"2026-03-25T01:02:22.000Z","updated_at":"2026-04-19T21:51:10.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Whatsonyourmind/oraclaw","commit_stats":null,"previous_names":["whatsonyourmind/oraclaw"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/Whatsonyourmind/oraclaw","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Whatsonyourmind%2Foraclaw","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Whatsonyourmind%2Foraclaw/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Whatsonyourmind%2Foraclaw/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Whatsonyourmind%2Foraclaw/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Whatsonyourmind","download_url":"https://codeload.github.com/Whatsonyourmind/oraclaw/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Whatsonyourmind%2Foraclaw/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32028547,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-20T00:18:06.643Z","status":"ssl_error","status_checked_at":"2026-04-20T00:17:31.068Z","response_time":55,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agents","algorithms","api","bandits","decision-intelligence","fastify","machine-learning","mcp","optimization","typescript"],"created_at":"2026-04-19T09:00:40.487Z","updated_at":"2026-04-20T01:00:47.527Z","avatar_url":"https://github.com/Whatsonyourmind.png","language":"TypeScript","funding_links":["https://buy.stripe.com/4gw5kJcFR1J63LO288"],"categories":["Data Analysis \u0026 Exploration Mcp Servers","Plugins","📊 Data Analysis \u0026 Business Intelligence","📦 Other"],"sub_categories":["All Plugins"],"readme":"# OraClaw\n\n[![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)\n[![Tests](https://img.shields.io/badge/tests-1%2C077_passing-brightgreen)](mission-control)\n[![MCP](https://img.shields.io/badge/MCP-12_tools-green)](https://modelcontextprotocol.io)\n[![Algorithms](https://img.shields.io/badge/algorithms-19-orange)](web/lib/algorithms.ts)\n[![Latency](https://img.shields.io/badge/latency-%3C25ms-blue)](mission-control/scripts/benchmark-all.ts)\n[![npm](https://img.shields.io/badge/npm-%40oraclaw-blue)](https://www.npmjs.com/org/oraclaw)\n[![API Status](https://img.shields.io/badge/API-live-brightgreen)](https://oraclaw-api.onrender.com)\n[![Implementations](https://img.shields.io/badge/field_implementations-12-brightgreen)](CHANGELOG.md)\n\n**MCP Optimization Tools for AI Agents** -- 12 tools, 19 algorithms, sub-25ms. Zero LLM cost.\n\nYour 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.\n\n---\n\n## Validation\n\nOraClaw's math has been independently implemented in **12 open-source projects** across AI agent orchestration, time-series tracking, vector search, MIP optimization, and production ML systems -- all within the first 8 days after public launch.\n\n**Selected field implementations** (see [`CHANGELOG.md`](CHANGELOG.md) for the full list):\n\n- [`chernistry/bernstein`](https://github.com/chernistry/bernstein) -- 84⭐ agent orchestration framework. LinUCB contextual router with α=0.3, shadow-evaluation path, interpretable decision reasons. Shipped in `codex/issue-367-linucb-router` 1h40m after the spec correction.\n- [`stxkxs/nanohype`](https://github.com/nanohype/nanohype) -- contextual bandit routing, pluggable strategy registry (hash / sliding-TTL / semantic), cost anomaly detection, LinUCB on roadmap. *\"Your input shaped a lot of what actually shipped.\"*\n- [`rfivesix/hypertrack`](https://github.com/rfivesix/hypertrack) -- Bayesian/Kalman-style adaptive calorie estimator with phase-aware kcal/kg ramp. Shipped in 0.8.0-beta. *\"At this point I think the mathematical model is in a very strong place.\"*\n- [`AlanHuang99/pyrollmatch`](https://github.com/AlanHuang99/pyrollmatch) -- entropy balancing (Hainmueller 2012) with moment constraints + `max_weight` cap. Shipped in v0.1.3.\n- [`stffns/vstash`](https://github.com/stffns/vstash) -- IDF-sigmoid relevance weighting. Shipped in v0.17.0.\n\n**Marketplace distribution:**\n\n- ✓ [`punkpeye/awesome-mcp-servers`](https://github.com/punkpeye/awesome-mcp-servers) (84K⭐) -- merged\n- ✓ [`TensorBlock/awesome-mcp-servers`](https://github.com/TensorBlock/awesome-mcp-servers) -- merged\n- ✓ MCP Registry, Glama (AAA rating), PulseMCP, Smithery, toolsdk-ai -- listed\n\n**Maintainer relationships** (warm technical correspondence): Qdrant, Milvus, NetworkX, Apache DataFusion, DuckDB, pymc-labs.\n\n---\n\n## Quick Start\n\n### 1. MCP Server (recommended for AI agents)\n\nAdd to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"oraclaw\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@oraclaw/mcp-server\"]\n    }\n  }\n}\n```\n\nThen ask your agent:\n\n\u003e \"I have 3 email subject line variants. Which should I send next?\"\n\nThe agent calls `optimize_bandit` and gets a statistically optimal selection in 0.01ms.\n\n### 2. REST API (no install)\n\n```bash\ncurl -X POST https://oraclaw-api.onrender.com/api/v1/optimize/bandit \\\n  -H 'Content-Type: application/json' \\\n  -d '{\n    \"arms\": [\n      {\"id\": \"A\", \"name\": \"Option A\", \"pulls\": 10, \"totalReward\": 7},\n      {\"id\": \"B\", \"name\": \"Option B\", \"pulls\": 10, \"totalReward\": 5},\n      {\"id\": \"C\", \"name\": \"Option C\", \"pulls\": 2, \"totalReward\": 1.8}\n    ],\n    \"algorithm\": \"ucb1\"\n  }'\n```\n\nResponse (\u003c1ms):\n\n```json\n{\n  \"selected\": { \"id\": \"C\", \"name\": \"Option C\" },\n  \"score\": 1.876,\n  \"algorithm\": \"ucb1\",\n  \"exploitation\": 0.9,\n  \"exploration\": 0.976,\n  \"regret\": 0.1\n}\n```\n\nFree tier: 25 calls/day, no API key needed.\n\n### 3. npm SDK\n\n```bash\nnpm install @oraclaw/bandit\n```\n\n```typescript\nimport { OraBandit } from '@oraclaw/bandit';\n\nconst client = new OraBandit({ baseUrl: 'https://oraclaw-api.onrender.com' });\nconst result = await client.optimize({\n  arms: [\n    { id: 'A', name: 'Short Subject', pulls: 500, totalReward: 175 },\n    { id: 'B', name: 'Long Subject', pulls: 300, totalReward: 126 },\n  ],\n  algorithm: 'ucb1',\n});\n```\n\n14 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`\n\n---\n\n## Why?\n\nLLMs 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.\n\n---\n\n## MCP Tool Catalog (12 tools)\n\n| Tool | What It Does | Latency |\n|------|-------------|---------|\n| `optimize_bandit` | A/B test selection via UCB1, Thompson Sampling, Epsilon-Greedy | 0.01ms |\n| `optimize_contextual` | Context-aware personalized selection via LinUCB | 0.05ms |\n| `optimize_cmaes` | Black-box continuous optimization (CMA-ES) | 12ms |\n| `solve_constraints` | LP/MIP/QP optimization via HiGHS solver | 2ms |\n| `solve_schedule` | Energy-matched task scheduling | 3ms |\n| `analyze_decision_graph` | PageRank, Louvain communities, bottleneck detection | 0.5ms |\n| `analyze_portfolio_risk` | VaR and CVaR (Expected Shortfall) | \u003c2ms |\n| `score_convergence` | Multi-source agreement scoring | 0.04ms |\n| `score_calibration` | Brier score and log score for prediction quality | 0.02ms |\n| `predict_forecast` | ARIMA and Holt-Winters time series forecasting | 0.08ms |\n| `detect_anomaly` | Z-Score and IQR anomaly detection | 0.01ms |\n| `plan_pathfind` | A* pathfinding with k-shortest paths | 0.1ms |\n\n14 of 17 REST endpoints respond in under 1ms. All under 25ms.\n\n---\n\n## Try It Now\n\nThe API is live. No signup required.\n\n```bash\n# Bayesian inference\ncurl -X POST https://oraclaw-api.onrender.com/api/v1/predict/bayesian \\\n  -H 'Content-Type: application/json' \\\n  -d '{\"prior\": 0.3, \"evidence\": [{\"factor\": \"positive_test\", \"weight\": 0.9, \"value\": 0.05}]}'\n\n# Monte Carlo simulation\ncurl -X POST https://oraclaw-api.onrender.com/api/v1/simulate/montecarlo \\\n  -H 'Content-Type: application/json' \\\n  -d '{\"simulations\": 1000, \"distribution\": \"normal\", \"params\": {\"mean\": 100, \"stddev\": 15}}'\n\n# Anomaly detection\ncurl -X POST https://oraclaw-api.onrender.com/api/v1/detect/anomaly \\\n  -H 'Content-Type: application/json' \\\n  -d '{\"data\": [10, 12, 11, 13, 50, 12, 11, 10], \"method\": \"zscore\", \"threshold\": 2.0}'\n```\n\n---\n\n## Pricing\n\n| Tier | Calls | Price | Auth |\n|------|-------|-------|------|\n| **Free** | 25/day | $0 | None |\n| **Pay-per-call** | 1K/day | $0.005/call | API key |\n| **Starter** | 10K/mo | $9/mo | API key |\n| **Growth** | 100K/mo | $49/mo | API key |\n| **Scale** | 1M/mo | $199/mo | API key |\n\n**x402 USDC:** AI agents pay $0.01-$0.15 per call with USDC on Base. No subscription, no API key.\n\n---\n\n## Source Code\n\n| Component | Path |\n|-----------|------|\n| **MCP Server** | [`mission-control/packages/mcp-server/`](mission-control/packages/mcp-server/) |\n| **REST API** | [`mission-control/apps/api/`](mission-control/apps/api/) |\n| **Algorithms** | [`mission-control/apps/api/src/services/oracle/algorithms/`](mission-control/apps/api/src/services/oracle/algorithms/) |\n| **SDK Packages** | [`mission-control/packages/sdk/`](mission-control/packages/sdk/) |\n| **LangChain Tools** | [`mission-control/integrations/langchain/oraclaw_tools.py`](mission-control/integrations/langchain/oraclaw_tools.py) |\n| **Mobile App** | [`mission-control/apps/mobile/`](mission-control/apps/mobile/) |\n| **Dashboard (Next.js)** | [`web/`](web/) |\n\n---\n\n## Building with OraClaw?\n\nWe'd love to hear what you're working on. Share your use case, ask questions, or request features:\n\n- [Tell us what you're building](https://github.com/Whatsonyourmind/oraclaw/discussions/1)\n- [Report an issue](https://github.com/Whatsonyourmind/oraclaw/issues)\n- [Join the conversation on Moltbook](https://www.moltbook.com/u/oraclaw)\n\n---\n\n## Links\n\n- **Live API:** https://oraclaw-api.onrender.com\n- **Dashboard:** https://web-olive-one-89.vercel.app\n- **npm:** https://www.npmjs.com/org/oraclaw\n- **Demo:** https://web-olive-one-89.vercel.app/demo\n- **GitHub:** https://github.com/Whatsonyourmind/oracle\n\n---\n\nIf this saved your agent from hallucinating math, star us :star:\n\n## License\n\n[MIT](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FWhatsonyourmind%2Foraclaw","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FWhatsonyourmind%2Foraclaw","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FWhatsonyourmind%2Foraclaw/lists"}