oxyo-mcp
by Eno654
README.md
<div align="center">
<a href="https://oxyo.si">
<img src="https://raw.githubusercontent.com/Eno654/oxyo-mcp/main/assets/oxyo-github-banner.png" alt="Oxyo (oxyo.si) — Cut Coding Quota Burn by 60%–72% via Shared XY Informational DNA" width="100%">
</a>
<br>
# Get `$200`-Tier Coding Capacity for `$100` + `$29` Oxyo.
**Pairing Claude Code, OpenAI Codex, Cursor, or Gemini with [Oxyo (`oxyo.si`)](https://oxyo.si) cuts 5-hour and weekly quota burn by `60%–72%` (`2.5×–3.6×` effective coding capacity) — backed by `7.7M–12.4M` managed standalone tokens, `$0` unlimited MCP calls, and `100.0%` (`23/23`) live deterministic Python verification.**
<p>
<a href="https://oxyo.si"><img src="https://img.shields.io/badge/Website-oxyo.si-22d3ee?style=for-the-badge&logo=safari&logoColor=white" alt="oxyo.si"></a>
<a href="https://oxyo.si/app?signup=1"><img src="https://img.shields.io/badge/Start_Free-50_Free_MCP_Calls-10b981?style=for-the-badge" alt="Start Free"></a>
<a href="https://oxyo.si/best-use"><img src="https://img.shields.io/badge/Quota_Multiplier-Save_%24852--%242%2C052%2Fyr-a855f7?style=for-the-badge" alt="Savings Proof"></a>
<a href="https://oxyo.si/benchmarks"><img src="https://img.shields.io/badge/Live_Benchmarks-23%2F23_(100.0%25)-f472b6?style=for-the-badge" alt="Benchmarks"></a>
<a href="https://oxyo.si/download/Oxyo-Setup.exe"><img src="https://img.shields.io/badge/Windows_App-.exe_Installer-3b82f6?style=for-the-badge&logo=windows&logoColor=white" alt="Windows App"></a>
</p>
**[🌐 Explore oxyo.si](https://oxyo.si)** · **[⚡ Savings Proof & Calculator](https://oxyo.si/best-use)** · **[📊 Head-to-Head Benchmarks](https://oxyo.si/benchmarks)** · **[🔌 1-Click Cursor & VS Code Install](https://oxyo.si/mcp)** · **[🔑 Developer API (`/v1`)](https://oxyo.si/developers)**
</div>
---
## 💰 Verified Subscription Math: Stop Overpaying for 5-Hour Quota Resets
Measured with `tiktoken` on a **112,247-token production repository** ([see full methodology & interactive calculator on `oxyo.si/best-use`](https://oxyo.si/best-use)): connecting **`https://oxyo.si/mcp`** to your coding agent eliminates repetitive repo re-reading and stale-spec debugging loops, while **[Oxyo Standalone (`oxyo.si/app`)](https://oxyo.si/app)** offloads live web research and file audits at **zero cost to your IDE quota**.
| Your Stack | Monthly Cost | Equivalent Coding Capacity | Annual Savings & Included Oxyo Compute |
| :--- | :---: | :---: | :--- |
| **`$20` Plan + `$19` Oxyo Core** | **`$39 / mo`** | **`~$50–$72 / mo` Equiv.** (`2.5×–3.6×` Pro) | **Saves `$732/yr` vs. `$100` Max 5×** · Delivers 50–72% of a `$100` plan + **`7.7M`** managed Oxyo tokens/mo + **Unlimited `$0` MCP calls** |
| **`$100` Plan + `$29` Oxyo Pro** ⭐ | **`$129 / mo`** | **`~$248–$360 / mo` Equiv.** (`12.4×–18×` Pro) | **Saves `$852/yr` vs. `$200` Tier** · Beats `$200` 10× plans by **`+24%` to `+80%`** + **`12.4M`** managed Oxyo tokens/mo + **Unlimited `$0` MCP calls** |
| **One `$200` Plan + `$29` Oxyo Pro** | **`$229 / mo`** | **`~$496–$720 / mo` Equiv.** (`24.8×–36×` Pro) | **Saves `$2,052/yr`** · **Replaces paying `$400/mo` for two `$200` seats** + **`12.4M`** managed Oxyo tokens/mo + **Unlimited `$0` MCP calls** |
### Why Token Burn Drops by `60%–72%` (Prompt-Cache Adjusted)
1. **Surgical MCP Recall (`$0` LLM Burn):** Instead of burning 6 exploratory turns (`35,000+` tokens) re-scanning files after every `/clear`, branch switch, or new IDE window, one `oxyo_session_pack` / `oxyo_recall` injects active project rules, ports, schemas, and causal root causes in **`~350–600` tokens** (`~110 ms`).
2. **Offload Non-Repo Work to Oxyo Standalone (`7.7M–12.4M` Managed Tokens Included):** Run `🌐 Live Web` searches, documentation lookups, screenshot (`Ctrl+V`) visual inspections, and CSV / Excel / PDF / ZIP audits directly inside **[`oxyo.si/app`](https://oxyo.si/app)** or the **[Windows Desktop App (`.exe`)](https://oxyo.si/download/Oxyo-Setup.exe)** — burning **`0` tokens** from your shared 5-hour Claude Code / Codex / Gemini pool.
3. **Deterministic Python Verification Instead of 5×-Weighted CoT Guessing:** Execute multi-currency `Decimal` math, reconciliations, combinatorics, and formal constraint proofs deterministically via `oxyo_verify_python` & `oxyo_prove_constraints` on the first pass instead of burning reasoning quota on trial-and-error loops.
---
## 🧬 Why Oxyo Beats Standard AI (`O · XY · O` Informational DNA)
Stop paying in time, quota lockouts, and broken code to re-explain your architecture every morning:
- **`0×` Context Re-Pasting** — Open a fresh session 6 months from now (or jump from browser to Cursor to Claude Code) and Oxyo already knows your stack, schemas, and invariants.
- **`−90%` Wasted Prompt Bloat** — Standard chats re-transmit `50k–200k` old tokens per turn ("context rot"). Oxyo retrieves only surgical, contradiction-free memory in milliseconds.
- **`100%` Contradiction-Free & Executed** — Outdated rules are superseded automatically when specs evolve (**Strand X**), and math/logic is executed in an isolated zero-network Python sandbox before replying (**Strand Y**).
| Real-World Challenge | Standard AI (ChatGPT, Claude, Raw APIs) | Oxyo Super Intelligence ([`oxyo.si`](https://oxyo.si)) |
| :--- | :--- | :--- |
| **Long Projects & Context Cost** | ✗ Re-sends `50k–200k` tokens on every turn (slow, expensive, context rot) — or total amnesia on New Chat. | ✓ **Never re-send context.** Stores everything in an isolated tenant vault and retrieves only the exact `~350–1k` tokens needed. |
| **Changing Decisions Over Time** | ✗ Basic memory & RAG pile old notes next to new ones — hallucinating deprecated ports, schemas, and old rules. | ✓ **Automatic Belief Revision** supersedes outdated claims on write — maintaining **`0` active contradictions** with a full revision log. |
| **Math, Financial Ledgers & Edge Cases** | ✗ Predicts numbers probabilistically token-by-token, sounding confident even when rounding or logic is wrong. | ✓ **Writes and executes real Python** inside an isolated sandbox + formal constraint prover — returning verified results. |
| **Switching Between Web, Desktop & IDEs** | ✗ Trapped in isolated tabs — Cursor, Claude Code, Codex, and browser chats have zero shared memory. | ✓ **One unified brain** across [Web Console](https://oxyo.si/app), Voice, Screenshot Paste, [Windows `.exe`](https://oxyo.si/download/Oxyo-Setup.exe), CLI, Cursor, Claude Code, Codex & VS Code. |
| **Learning From Production Bugs** | ✗ Stateless sessions repeat the exact same failure modes week after week. | ✓ Tracks **`Cause → Effect` causal graphs** and crystallizes **100%-tested reusable skills** that compound over time. |
| **Vendor & Model Lock-In** | ✗ Switching AI providers means abandoning months of chat history and custom instructions. | ✓ **Model-independent brain:** use all-inclusive managed compute or attach your own AES-encrypted **BYOK** key (`$99` Lifetime option). |
---
## 🌐 Best of Both Worlds: One Brain Across Every Surface
| Surface | What You Get | Link |
| :--- | :--- | :--- |
| **🖥️ Oxyo Web Console** | Full standalone workspace with `🌐 Live Web` search, Voice, `Ctrl+V` Screenshot Perception, CSV/XLSX/PDF/DOCX/ZIP file audits, and `7.7M–12.4M` managed tokens/mo. | **[oxyo.si/app →](https://oxyo.si/app)** |
| **🪟 Oxyo Desktop App (`.exe`)** | Native Windows 10/11 desktop app synced live to your XY Informational DNA vault. | **[Download `.exe` →](https://oxyo.si/download/Oxyo-Setup.exe)** |
| **🔌 Universal Remote MCP** | 15 persistent memory, Python sandbox, causal graph, and formal proving tools for Claude Code, Codex, Cursor, Windsurf, VS Code & Gemini. | **[oxyo.si/mcp →](https://oxyo.si/mcp)** |
| **⚙️ OpenAI-Compatible API** | Drop-in `https://oxyo.si/v1` (`oxyo-verified`, `oxyo-asi`, `oxyo-swarm`, `oxyo-deep`, `oxyo-fast`) for Python, TypeScript, Go, LangChain & Vercel AI SDK. | **[oxyo.si/developers →](https://oxyo.si/developers)** |
---
## ⚡ 30-Second IDE Setup (`https://oxyo.si/mcp` & `oxyo-mcp`)
> **Try Free in 10 Seconds:** Create a free Explorer account (**50 free MCP tool calls**, no credit card required) and generate your `oxy_live_...` key at **[https://oxyo.si/app?signup=1](https://oxyo.si/app?signup=1)** — or use **1-Click Install for Cursor & VS Code** on **[https://oxyo.si/mcp](https://oxyo.si/mcp)**.
### Option 1 — Claude Code (One-Liner, Zero Local Dependencies)
```bash
claude mcp add --transport http oxyo https://oxyo.si/mcp --header "Authorization: Bearer oxy_live_YOUR_KEY"
```
### Option 2 — Direct Streamable HTTP (Cursor / Windsurf / VS Code / Antigravity)
Add to `~/.cursor/mcp.json` or your IDE MCP settings:
```json
{
"mcpServers": {
"oxyo": {
"url": "https://oxyo.si/mcp",
"headers": {
"Authorization": "Bearer oxy_live_YOUR_KEY"
}
}
}
}
```
### Option 3 — Zero-Dependency Local `stdio` Bridge (Claude Desktop / Codex / Any Stdio Host)
This repository provides a **100% auditable, zero-dependency MIT stdio bridge** ([`bin/oxyo-mcp.mjs`](./bin/oxyo-mcp.mjs) for Node.js 18+ and [`oxyo_mcp/cli.py`](./oxyo_mcp/cli.py) for Python 3.10+):
```json
{
"mcpServers": {
"oxyo": {
"command": "npx",
"args": ["-y", "github:Eno654/oxyo-mcp"],
"env": {
"OXYO_API_KEY": "oxy_live_YOUR_KEY"
}
}
}
}
```
Verify live discovery anytime:
```bash
npx -y github:Eno654/oxyo-mcp --doctor
# Connected: 15 MCP tools discovered.
```
---
## 🏆 Tested Head-to-Head Against Frontier AI (`100.0%` Verified · `23 / 23` Live Checks)
Explore all interactive traces, raw prompts, latencies (`95–285 ms`), and downloadable audit datasets at **[https://oxyo.si/benchmarks](https://oxyo.si/benchmarks)**:
- **Test 01 · 45-Day Architecture Drift:** `3` overridden production configs superseded automatically; `4/4` active rules recalled in a brand-new session with **`0` re-pasted tokens** vs. `0%` stateless recall.
- **Test 02 · 36-Row Multi-Currency Financial Audit ([download `.csv`](https://oxyo.si/download/q4_gateway_ledger.csv)):** Deduplicates webhook retries, rejects orphaned refund `evt_1014`, and proves exact `ROUND_HALF_EVEN` settlement (**`$11,308.63`** + **`$520.30`** EU VAT escrow).
- **Test 03 · 22-Step Constrained Combinatorics:** Exact ternary frame count & modular prime digest where single-pass token prediction guesses — solved deterministically in Oxyo's Python sandbox.
- **Test 04 · 4-Hop Incident Root-Cause + Reusable Skills:** Traces `checkout_504` back to `redis_eviction_spike` and executes unit-tested SRE skills over `https://oxyo.si/mcp`.
### Live 8-Suite Zero-Contamination Production Matrix (`23 / 23 = 100.0%`)
| # | Production Verification Suite | Atomic Checks | Verified Score |
| :---: | :--- | :---: | :---: |
| 1 | **Multi-Ledger FX + VAT + Chargeback Audit** (`17,454.99 EUR` exact `Decimal`) | `4 / 4` | **100%** |
| 2 | **3-Wave Contradicting Spec Migration** (`0` stale-rule leaks across waves) | `4 / 4` | **100%** |
| 3 | **5-Hop Causal Root-Cause & Blast-Radius Graph** | `3 / 3` | **100%** |
| 4 | **Formal State-Machine Invariant Proving** (counterexample + repaired proof) | `3 / 3` | **100%** |
| 5 | **Constrained Discrete Resource Optimization** (provably optimal schedule) | `3 / 3` | **100%** |
| 6 | **Verified Reusable Skill Synthesis & Composition** (`20,764,477,188`) | `2 / 2` | **100%** |
| 7 | **Long-Horizon Goal DAG Dependency Propagation** | `2 / 2` | **100%** |
| 8 | **Adversarial Cognitive Trap & IEEE-754 Precision Immunity** | `2 / 2` | **100%** |
---
## 🧰 All 15 Persistent MCP Tools (`https://oxyo.si/mcp`)
| Strand / Domain | Tools Exposed to Your IDE |
| :--- | :--- |
| **Strand X — Contradiction-Free Memory** | `oxyo_session_pack` · `oxyo_recall` · `oxyo_remember_episode` · `oxyo_remember_belief` · `oxyo_belief_revisions` · `oxyo_consolidate` |
| **Strand Y — Python Sandbox & Formal Prover** | `oxyo_verify_python` · `oxyo_prove_constraints` · `oxyo_skill_register` · `oxyo_skill_invoke` · `oxyo_sleep_abstract` · `oxyo_self_play_distill` |
| **Causal World Graph & Goal DAG** | `oxyo_causal_record` · `oxyo_causal_infer` · `oxyo_goal` |
---
## 💎 Simple, Transparent Pricing ([`oxyo.si/#pricing`](https://oxyo.si/#pricing))
| Plan | Price | Included Compute & MCP Access | Best For |
| :--- | :---: | :--- | :--- |
| **Explorer (Free)** | **`$0`** | **50 free MCP tool calls** + isolated XY DNA vault | Testing in Claude Code / Cursor in 30s ([Start Free →](https://oxyo.si/app?signup=1)) |
| **Oxyo Core** | **`$19 / mo`** | **`~7.7M` managed tokens/mo** + **Unlimited `$0` MCP calls** + Web, Live Search & Visual Console | Pairing with `$20` plans → **`~$50–$72/mo` equiv.** ([Get Core →](https://oxyo.si/app?signup=1&plan=core_monthly)) |
| **Oxyo Pro** ⭐ | **`$29 / mo`** | **`~12.4M` managed tokens/mo** + Deep Verified Solver + Nightly Consolidation + **Unlimited `$0` MCP** | Pairing with `$100`/`$200` plans → **Save `$852–$2,052/yr`** ([Start Pro →](https://oxyo.si/app?signup=1&plan=pro_monthly)) |
| **Founding Annual** | **`$99 / yr`** | Just **`$8.25/mo`** (Save 71% · First 50) — 12 months all-inclusive compute + Unlimited `$0` MCP | Locked-in Founding Member rate ([Claim `$99/yr` →](https://oxyo.si/app?signup=1&plan=founding_annual)) |
| **Lifetime (BYOK)** | **`$99 once`** | **Pay once, use forever** with your own AES-encrypted Claude / OpenAI / OpenRouter key | Zero recurring subscription ever ([Buy Lifetime →](https://oxyo.si/app?signup=1&plan=lifetime_byok)) |
---
## 🔒 Security, GDPR & Zero-Dependency Architecture
- **100% Auditable Connector:** `oxyo-mcp` contains **zero third-party npm or PyPI dependencies** — only clean, readable standard-library HTTPS JSON-RPC forwarding to `https://oxyo.si/mcp`.
- **Strict Per-Tenant Isolation (EU / GDPR):** Operated in the European Union by **OMNIAMUS S.R.L.** ([Privacy Policy](https://oxyo.si/privacy) · [About](https://oxyo.si/about) · `contact@oxyo.si`). Every account runs in an isolated tenant vault; private prompts, code, and files are **never** used to train public models.
- **Machine-Readable Specs:** [OpenAPI 3.1 (`oxyo.si/openapi.json`)](https://oxyo.si/openapi.json) · [`llms.txt` (`oxyo.si/llms.txt`)](https://oxyo.si/llms.txt) · [MCP Server Card](https://oxyo.si/.well-known/mcp/server-card.json)
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessNo recent community issues