Metadata-Version: 2.4
Name: oxyo-mcp
Version: 1.2.4
Summary: Continuously cut Claude Code, Codex, Cursor & VS Code token and quota burn by 60-72% via persistent contradiction-free memory, root-cause tracking & deterministic verification (oxyo.si).
Author-email: "OMNIAMUS S.R.L." <contact@oxyo.si>
License-Expression: MIT
Project-URL: Homepage, https://oxyo.si
Project-URL: Quota Savings Proof, https://oxyo.si/best-use
Project-URL: Documentation, https://oxyo.si/developers
Project-URL: Benchmarks, https://oxyo.si/benchmarks
Project-URL: Repository, https://github.com/Eno654/oxyo-mcp
Keywords: mcp,model-context-protocol,oxyo,claude-code,cursor,codex,ai-memory,python-sandbox,verification
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

<!-- mcp-name: io.github.Eno654/oxyo-mcp -->
<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` + `$49` Oxyo Pro (`$39/mo` Annual).

**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 `1.9M–7.5M` weekly managed standalone tokens (`7.7M–30M/mo`), `300–5,000` weekly MCP calls, encrypted Claude / OpenAI / OpenRouter BYOK Vault, 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://pypi.org/project/oxyo-mcp/"><img src="https://img.shields.io/pypi/v/oxyo-mcp?style=for-the-badge&color=10b981&label=PyPI_uvx" alt="PyPI"></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_%24612--%241%2C452%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 (or Annual `-20%`) | Equivalent Coding Capacity | Annual Savings & Included Oxyo Compute |
| :--- | :---: | :---: | :--- |
| **`$20` Plan + `$19` Oxyo Core** | **`$39 / mo`** (`$35/mo` annual) | **`~$50–$72 / mo` Equiv.** (`2.5×–3.6×` Pro) | **Saves `$732–$780/yr` vs. `$100` Max 5×** · Delivers 50–72% of a `$100` plan + **`~1.9M`** managed tokens/wk (`7.7M/mo`) + **`300` MCP calls/wk** |
| **`$100` Plan + `$49` Oxyo Pro** ⭐ | **`$149 / mo`** (`$139/mo` annual) | **`~$248–$360 / mo` Equiv.** (`12.4×–18×` Pro) | **Saves `$612–$732/yr` vs. `$200` Tier** · Beats `$200` 10× plans by **`+24%` to `+80%`** + **`~3.8M`** managed tokens/wk (`15M/mo`) + **`1,250` MCP calls/wk** |
| **One `$200` Plan + `$99` Oxyo Max** 🚀 | **`$299 / mo`** (`$279/mo` annual) | **`~$496–$720 / mo` Equiv.** (`24.8×–36×` Pro) | **Saves `$1,212–$1,452/yr`** · **Replaces paying `$400/mo` for two `$200` seats** + **`~7.5M`** managed tokens/wk (`30M/mo`) + **`5,000` MCP calls/wk** + Multi-Agent Swarm |

### Why Token Burn Drops by `60%–72%` (Prompt-Cache Adjusted)
1. **Surgical MCP Recall (`~350–600` Tokens Instead of `35,000+`):** Instead of burning 6 exploratory turns 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–30M` 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 **Anthropic Claude, OpenAI, or OpenRouter** BYOK key anytime. |

---

## 🌐 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–30M` 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 (or run the zero-dependency benchmark script [`examples/session_pack_demo.mjs`](./examples/session_pack_demo.mjs)):
```bash
npx -y github:Eno654/oxyo-mcp --doctor
# Connected: 15 MCP tools discovered.

node examples/session_pack_demo.mjs
```

---

## 🏆 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` |

---

## 💎 Calibrated Plans — Monthly or Save 20% Yearly ([`oxyo.si/#pricing`](https://oxyo.si/#pricing))

| Plan | Monthly | Yearly (`Save 20%`) | Weekly Quota & BYOK Vault | Best For |
| :--- | :---: | :---: | :--- | :--- |
| **Explorer (Free)** | **`$0`** | **`$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`** | **`$15 / mo`** (`$180/yr`) | **`300` MCP calls/wk** + **`~1.9M` managed tokens/wk** (`~7.7M/mo`) + Web, Live Search, Visual Console & BYOK Vault | Pairing with `$20` (`1×`) plans → **`~$50–$72/mo` equiv.** ([Get Core →](https://oxyo.si/app?signup=1&plan=core_annual)) |
| **Oxyo Pro** ⭐ | **`$49 / mo`** | **`$39 / mo`** (`$468/yr`) | **`1,250` MCP calls/wk** + **`~3.8M` managed tokens/wk** (`~15M/mo`) + Deep Verified Solver + Nightly Consolidation + BYOK Vault | Pairing with `$100` (`5×`) plans → **Beats `$200` tier · Save `$612–$732/yr`** ([Start Pro →](https://oxyo.si/app?signup=1&plan=pro_annual)) |
| **Oxyo Max** 🚀 | **`$99 / mo`** | **`$79 / mo`** (`$948/yr`) | **`5,000` MCP calls/wk** + **`~7.5M` managed tokens/wk** (`~30M/mo`) + Multi-Agent Swarm (`oxyo-swarm`) + Formal Constraint Prover + BYOK Vault | Pairing with `$200` (`10×`) & multi-IDE workflows → **Replaces `2× $200` seats · Save `$1,212–$1,452/yr`** ([Go Max →](https://oxyo.si/app?signup=1&plan=max_annual)) |

> ⚡ **Usage-Aware Upgrade Credit:** Outgrow your weekly quota early? Your remaining unused quota value is automatically deducted when you upgrade — e.g. finish Week 1 of **Oxyo Core** (`$19/mo`) in 2 days and upgrade to **Oxyo Pro** (`$49/mo`) for just **`$34.75` today (`-$14.25` unused credit)**.

---

## 🔒 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)
