Skip to content

IntentusNet — Deterministic MCP Gateway (Foundation)

Latest

Choose a tag to compare

@Balchandar Balchandar released this 13 Feb 16:17
· 5 commits to main since this release
0b52572

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.