IntentusNet — Deterministic MCP Gateway (Foundation)

[Balchandar]

This release introduces the Deterministic MCP Gateway, a transparent execution layer that can wrap any MCP server and record deterministic execution with WAL-backed persistence and replay support.

This is a foundation release focused on stability, execution recording, and developer adoption.

---

Highlights

Deterministic MCP Gateway

• Transparent MCP proxy (stdio + HTTP)
• Deterministic execution recording
• WAL-backed persistence (crash-safe, atomic commit)
• Deterministic seed capture
• Execution indexing and recovery
• No changes required to MCP clients or servers
• No protocol modification

---

Fast Replay (Playback)

Replay recorded executions instantly using WAL-backed playback.

• Returns stored execution result (no re-execution yet)
• Deterministic seed and execution metadata preserved
• Stable and crash-safe

intentusnet replay <execution-id>

---

CLI Commands

New gateway-related commands:

intentusnet gateway --wrap <cmd>
intentusnet gateway --http <url>
intentusnet replay <execution-id>
intentusnet executions
intentusnet status

---

Runnable Example

A minimal runnable example is included:

examples/basic-mcp-server/

Demonstrates:

• Running a simple MCP server
• Wrapping with IntentusNet Gateway
• Recording execution
• Replaying execution

Designed to run in minutes.

---

Documentation

• Quickstart with runnable example
• Deterministic MCP Gateway overview
• Replay explanation
• CLI usage
• Architecture overview (Client → Gateway → Server)
• Direction (capabilities in progress, no version roadmap)
• First-run verification guidance

---

Stability

• No breaking changes
• Fully backward compatible
• Crash-safe WAL persistence
• Execution index rebuild verified
• Thread-safe execution recording

---

Current Scope

Included

• Deterministic execution recording
• Fast replay (WAL playback)
• Deterministic MCP Gateway foundation

Not included

• Deterministic re-execution
• Undo / rollback
• One-line installer
• Dashboard / UI
• Enterprise / compliance features

---

Direction

IntentusNet is evolving toward a fully deterministic execution layer for MCP-based systems, including:

• Deterministic re-execution
• Execution rollback / undo
• Determinism validation
• One-line deterministic gateway installer
• Advanced execution tracing and debugging

---

Feedback

Feedback, issues, and discussions are welcome via GitHub Issues and Discussions.

---

This discussion was created from the release IntentusNet — Deterministic MCP Gateway (Foundation).