Command Palette

Search for a command to run...

UnylyUnyly
Browse all

Nephis

FreeMaintained

Unified Developer Platform & MCP Server for Nephis: Sub-6ms MicroVM Sandboxes, Zero-Copy Postgres Branching, Multi-Agent CLIs, Python & TypeScript SDKs

GitHubEmbed

About

Unified Developer Platform & MCP Server for Nephis: Sub-6ms MicroVM Sandboxes, Zero-Copy Postgres Branching, Multi-Agent CLIs, Python & TypeScript SDKs

README

The Unified MCP Control Plane for Autonomous AI Coding Agents.
Provides sub-6ms hardware KVM microVM sandboxes, 30ms zero-copy PostgreSQL branching, in-memory AST compiler pipelines, and kernel infrastructure to LLMs (Claude Desktop, Cursor, Windsurf, Devin, Antigravity).

MCP Protocol npm version License Tools Count


⚡ Architecture Overview

🌐 Canonical Production Gateway: https://nephis.theeducode.com
⚡ Eschaton Online Judge (Sub-38ms): https://eschaton.theeducode.com
💻 Thanaton MicroVM Studio (Sub-6ms): https://thanaton.theeducode.com
🗄️ Mnemon-DB Postgres Studio (31ms CoW): https://mnemon.theeducode.com
💳 Centralized Billing & Refill Hub: https://nephis.theeducode.com/billing
🚀 Single-Command Agent Launch: npx -y nephis-mcp-server


⚡ Autonomous Zero-Human PoW Self-Bootstrap (500 Free Credits • 30-Day Trial)

When an autonomous AI agent launches nephis-mcp-server without an explicit NEPHIS_API_KEY:

  1. The server automatically computes a local machine fingerprint (MAC, CPU, host) and requests a cryptographic Proof-of-Work challenge from the gateway.
  2. In < 80 milliseconds, it solves the challenge and claims an active 500 Starter Credit Developer Session (mrd_live_...).
  3. Credentials are saved locally to ~/.nephis/credentials.json with automatic session renewal.
  4. Zero human logins, zero credit cards, zero browser popups required. Human developers can also claim their session with 1-click GitHub OAuth on nephis.theeducode.com to upgrade to 2,000 monthly credits.

The NEPHIS MCP Server connects LLMs and autonomous coding assistants directly to bare-metal compute and database substrates across 4 core pillars:

  1. THANATON (33 Tools): Hardware KVM microVM sandboxes, sub-6ms boot, scale-to-zero stasis ($0 idle RAM), PTY terminals, Layer 4 port forwards, project deployments, custom domains, crons, webhooks, and SIEM drains.
  2. MNEMON-DB (14 Tools): 30ms zero-copy PostgreSQL 16 branching (XFS CoW reflinks), embedded vector search, schema diffing, and WAL rewind.
  3. ESCHATON & NEPHIS (4 Tools): Sub-38ms parallel online code judging, in-memory AST hazard detection (<50µs), 50-testcase fast-batch execution, and tenant whoami introspection.
  4. KERNEL INFRASTRUCTURE (12 Tools): Kernel systems, eBPF connection pooling, zero-copy S3 streaming pipes, tombstone crash autopsy, and live socket migration.
┌────────────────────────────────────────────────────────┐
│ Autonomous AI Coding Agent (Cursor / Claude / Devin)   │
└───────────────────────────┬────────────────────────────┘
                            │ JSON-RPC 2.0 (stdio / SSE)
                            ▼
┌────────────────────────────────────────────────────────┐
│ NEPHIS Unified MCP Server (92 Production Tools)        │
└───────┬───────────────────┬───────────────────┬────────┘
        │                   │                   │
        ▼                   ▼                   ▼
┌──────────────┐    ┌──────────────┐    ┌──────────────┐
│   THANATON   │    │  MNEMON-DB   │    │   ESCHATON   │
│ MicroVMs &   │    │  Zero-Copy   │    │ Sub-38ms AST │
│ KVM Compute  │    │  PostgreSQL  │    │ Polyglot CI  │
└──────────────┘    └──────────────┘    └──────────────┘

🚀 10-Second Setup for Coding Agents

Option 1: Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "nephis": {
      "command": "npx",
      "args": ["-y", "nephis-mcp-server"],
      "env": {
        "NEPHIS_API_KEY": "mrd_live_YOUR_KEY",
        "NEPHIS_BASE_URL": "https://nephis.theeducode.com"
      }
    }
  }
}

Option 2: Cursor (.cursor/mcp.json or Global Settings)

{
  "mcpServers": {
    "nephis": {
      "command": "npx",
      "args": ["-y", "nephis-mcp-server"],
      "env": {
        "NEPHIS_API_KEY": "mrd_live_YOUR_KEY",
        "NEPHIS_BASE_URL": "https://nephis.theeducode.com"
      }
    }
  }
}

Option 3: Windsurf (~/.codeium/windsurf/mcp_config.json)

{
  "mcpServers": {
    "nephis": {
      "command": "npx",
      "args": ["-y", "nephis-mcp-server"],
      "env": {
        "NEPHIS_BASE_URL": "https://nephis.theeducode.com"
      }
    }
  }
}

Option 4: Cline / Roo Code (cline_mcp_settings.json)

{
  "mcpServers": {
    "nephis": {
      "command": "npx",
      "args": ["-y", "nephis-mcp-server"],
      "env": {
        "NEPHIS_BASE_URL": "https://nephis.theeducode.com"
      }
    }
  }
}

Option 5: Google Antigravity & Gemini CLI

Add nephis to your project's antigravity.json or run npx nephis-mcp-server directly via stdio transport.


📋 Tool Navigation Summary

Category Count Focus Areas
THANATON (Compute, Deploy & Edge) 33 MicroVM boot, PTY, ports, secrets, volumes, projects, WAF, domains, crons, hooks, routes, drains, wallet, invoices
MNEMON-DB (Databases & Vector) 14 30ms CoW branching, SQL queries, schema diff, pgvector, WAL rewind
ESCHATON & NEPHIS (Execution & Identity) 4 AST preflight, 50-testcase fast-batch, compiler pipeline, whoami
Total Production Tools 63 100% Machine-Readable & Standardized

🛠 Exhaustive Catalog of All 92 MCP Tools

THANATON • Hardware KVM MicroVMs & Compute Sandboxes

Contains 24 production tools specifically designed for agent autonomy.

1. thanaton_exec_command

Description: Execute an arbitrary shell command (bash, sh) inside an isolated, hardware-virtualized MicroVM sandbox. Returns stdout, stderr, exit code, and execution latency.

Parameter Specification:

Parameter Type Required Default Details & Constraints
command string ✅ Yes - The shell command to execute inside the MicroVM (e.g., 'python3 -c "print(2+2)"', 'npm test', 'git status')
sandbox_id string ❌ No - Optional existing sandbox ID. If omitted, an ephemeral sub-6ms sandbox will be provisioned automatically.
timeout_ms number ❌ No - Maximum execution timeout in milliseconds (default: 15000)

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "thanaton_exec_command",
    "arguments": {
      "command": "uname -a && free -m",
      "sandbox_id": "sbx-kvm-9f82d1",
      "timeout_ms": 10000
    }
  },
  "id": 1
}

2. thanaton_run_code

Description: Directly run a standalone, single-file code snippet in an ephemeral, stateless microVM sandbox (automatically destroyed after execution). For stateful multi-step terminal interactions, filesystem persistence, or long-running processes, use 'thanaton_spawn_sandbox' followed by 'thanaton_exec_command' passing the 'sandbox_id'.

Parameter Specification:

Parameter Type Required Default Details & Constraints
language string ✅ Yes - Programming language runtime (Enum: [python, javascript, typescript, go, rust, c, cpp, bash])
code string ✅ Yes - The complete source code snippet to compile and execute
timeout_ms number ❌ No - Timeout in milliseconds (default: 10000)

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "thanaton_run_code",
    "arguments": {
      "language": "python",
      "code": "print('Executed safely via Nephis')",
      "timeout_ms": 10000
    }
  },
  "id": 2
}

3. thanaton_spawn_sandbox

Description: Provision a new hardware-isolated KVM MicroVM or Silicon isolate. Supports scale-to-zero, memory snapshots, and optional embedded PostgreSQL database.

Parameter Specification:

Parameter Type Required Default Details & Constraints
runtime string ❌ No - Runtime environment type (default: 'microvm') (Enum: [microvm, silicon, node, python])
memory_mb number ❌ No - Allocated RAM in MiB (default: 256)
with_db boolean ❌ No - Whether to bundle an isolated PostgreSQL database inside the sandbox

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "thanaton_spawn_sandbox",
    "arguments": {
      "runtime": "microvm",
      "memory_mb": 256,
      "with_db": true
    }
  },
  "id": 3
}

4. thanaton_list_sandboxes

Description: List all active, sleeping, and managed MicroVM sandboxes across the current tenant.

Parameter Specification:

No input parameters required.

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "thanaton_list_sandboxes",
    "arguments": {}
  },
  "id": 4
}

5. thanaton_wake_sandbox

Description: Instantly wake a sleeping/hibernated MicroVM from NVMe memory snapshot in sub-6ms (<2ms with UFFD lazy-paging).

Parameter Specification:

Parameter Type Required Default Details & Constraints
sandbox_id string ✅ Yes - The ID of the sleeping sandbox to wake

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "thanaton_wake_sandbox",
    "arguments": {
      "sandbox_id": "sbx-kvm-9f82d1"
    }
  },
  "id": 5
}

6. thanaton_sleep_sandbox

Description: Scale a MicroVM to zero (hibernates RAM to NVMe snapshot, 0% CPU consumption, $0 cost).

Parameter Specification:

Parameter Type Required Default Details & Constraints
sandbox_id string ✅ Yes - The ID of the running sandbox to put to sleep

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "thanaton_sleep_sandbox",
    "arguments": {
      "sandbox_id": "sbx-kvm-9f82d1"
    }
  },
  "id": 6
}

7. thanaton_destroy_sandbox

Description: Terminate processes, tear down TAP network interface, cgroups, and reclaim all sandbox resources.

Parameter Specification:

Parameter Type Required Default Details & Constraints
sandbox_id string ✅ Yes - The ID of the sandbox to destroy

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "thanaton_destroy_sandbox",
    "arguments": {
      "sandbox_id": "sbx-kvm-9f82d1"
    }
  },
  "id": 7
}

8. thanaton_list_projects

Description: List all Thanaton serverless application projects and their live domains.

Parameter Specification:

No input parameters required.

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "thanaton_list_projects",
    "arguments": {}
  },
  "id": 8
}

9. thanaton_create_project

Description: Create a new project/application deployment target in Thanaton.

Parameter Specification:

Parameter Type Required Default Details & Constraints
name string ✅ Yes - Project name
slug string ❌ No - Optional custom project slug
runtime string ❌ No - Application runtime (default: nodejs) (Enum: [nodejs, python, go, rust, docker])
app_port number ❌ No - Internal HTTP listening port (default: 3000)

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "thanaton_create_project",
    "arguments": {
      "name": "sample_name",
      "slug": "sample_slug",
      "runtime": "nodejs",
      "app_port": 8080
    }
  },
  "id": 9
}

10. thanaton_manage_env

Description: List, set, or delete project environment variables.

Parameter Specification:

Parameter Type Required Default Details & Constraints
project_id string ✅ Yes - Target project ID
action string ✅ Yes - Action to perform (Enum: [list, set, delete])
key string ❌ No - Environment variable key
value string ❌ No - Variable value (for set action)
environment string ❌ No - Target environment (Enum: [production, preview, development, all])

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "thanaton_manage_env",
    "arguments": {
      "project_id": "sample_project_id",
      "action": "list",
      "key": "sample_key",
      "value": "sample_value",
      "environment": "production"
    }
  },
  "id": 10
}

11. thanaton_rollback

Description: Instant atomic rollback of production traffic to a previous deployment snapshot in 8.2ms.

Parameter Specification:

Parameter Type Required Default Details & Constraints
project_id string ✅ Yes - Target project ID
deployment_id string ✅ Yes - Target snapshot deployment ID to restore

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "thanaton_rollback",
    "arguments": {
      "project_id": "sample_project_id",
      "deployment_id": "sample_deployment_id"
    }
  },
  "id": 11
}

12. thanaton_promote

Description: Promote staging preview deployment snapshot to 100% production traffic in 6.4ms.

Parameter Specification:

Parameter Type Required Default Details & Constraints
project_id string ✅ Yes - Target project ID

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "thanaton_promote",
    "arguments": {
      "project_id": "sample_project_id"
    }
  },
  "id": 12
}

13. thanaton_configure_waf

Description: Inspect or configure edge Web Application Firewall (WAF) Attack Mode, rate limits, allowlist, and blocklist.

Parameter Specification:

Parameter Type Required Default Details & Constraints
project_id string ✅ Yes - Target project ID
action string ✅ Yes - Action to perform (Enum: [get, set])
attack_mode boolean ❌ No - Enable Under Attack Mode (cryptographic PoW challenge)
rate_limit_rps number ❌ No - Per-IP rate limit RPS threshold
allowlist array ❌ No - CIDR allowlist IP blocks
blocklist array ❌ No - CIDR blocklist IP blocks

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "thanaton_configure_waf",
    "arguments": {
      "project_id": "sample_project_id",
      "action": "get",
      "attack_mode": true,
      "rate_limit_rps": 100,
      "allowlist": [
        "item_1",
        "item_2"
      ],
      "blocklist": [
        "item_1",
        "item_2"
      ]
    }
  },
  "id": 13
}

14. thanaton_configure_scaling

Description: Inspect or configure Thanaton compute scaling: toggle between Serverless (scale-to-zero) and Always-On stateful execution, RAM allocation, and idle timeout.

Parameter Specification:

Parameter Type Required Default Details & Constraints
project_id string ✅ Yes - Target project ID
action string ✅ Yes - Action to perform ('get' or 'set') (Enum: [get, set])
always_on boolean ❌ No - Enable 24/7 Always-On stateful background execution (Indie/Pro)
idle_timeout_seconds number ❌ No - Inactivity seconds before scaling to zero (min 15s)
memory_mb number ❌ No - RAM allocation in MB (e.g. 256, 1024, 4096)
vcpu_count number ❌ No - vCPU count (e.g. 1, 2, 4)

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "thanaton_configure_scaling",
    "arguments": {
      "project_id": "sample_project_id",
      "action": "get",
      "always_on": true,
      "idle_timeout_seconds": 10000,
      "memory_mb": 256,
      "vcpu_count": 100
    }
  },
  "id": 14
}

15. thanaton_get_volumes

Description: List persistent ext4 sparse volumes attached to a microVM sandbox for SQLite, PocketBase, or local file storage with scale-to-zero persistence.

Parameter Specification:

Parameter Type Required Default Details & Constraints
sandbox_id string ❌ No - MicroVM sandbox ID (default: sbx-default)

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "thanaton_get_volumes",
    "arguments": {
      "sandbox_id": "sbx-kvm-9f82d1"
    }
  },
  "id": 15
}

16. thanaton_attach_volume

Description: Attach a persistent sparse ext4 volume mounted at /data with scale-to-zero snapshot persistence.

Parameter Specification:

Parameter Type Required Default Details & Constraints
sandbox_id string ✅ Yes - MicroVM sandbox ID
mount_path string ❌ No - Target mount path inside microVM (default: /data)
size_gb number ❌ No - Virtual volume size in gigabytes (default: 10)

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "thanaton_attach_volume",
    "arguments": {
      "sandbox_id": "sbx-kvm-9f82d1",
      "mount_path": "sample_mount_path",
      "size_gb": 100
    }
  },
  "id": 16
}

17. thanaton_dual_probe

Description: Adaptive Dual-Liveness Probe: Probes HTTP endpoint and automatically falls back to raw TCP 3-way handshake on guest port, eliminating silent false-positive deploy failures.

Parameter Specification:

Parameter Type Required Default Details & Constraints
target_host string ❌ No - Target host IP or hostname (default: 127.0.0.1)
port number ✅ Yes - Target port inside guest (e.g., 3000, 8080)
health_path string ❌ No - Health check URL path (e.g., /health, /)

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "thanaton_dual_probe",
    "arguments": {
      "target_host": "sample_target_host",
      "port": 8080,
      "health_path": "sample_health_path"
    }
  },
  "id": 17
}

18. thanaton_inject_secrets

Description: Zero-rebuild environment variable and secret injection via Firecracker MMDS in <50µs without rebuilding the SquashFS rootfs.

Parameter Specification:

Parameter Type Required Default Details & Constraints
sandbox_id string ✅ Yes - MicroVM sandbox ID
secrets object ✅ Yes - Key-value map of secrets and environment variables to inject

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "thanaton_inject_secrets",
    "arguments": {
      "sandbox_id": "sbx-kvm-9f82d1",
      "secrets": {
        "key": "value"
      }
    }
  },
  "id": 18
}

19. thanaton_reap_extents

Description: Autonomous CoW extent reaper: Reclaims unreferenced disk blocks and frees host RAM via process_madvise(MADV_DONTNEED).

Parameter Specification:

No input parameters required.

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "thanaton_reap_extents",
    "arguments": {}
  },
  "id": 19
}

20. thanaton_pty_info

Description: Get real-time bidirectional WebSocket PTY terminal gateway connection details for an attached interactive microVM shell.

Parameter Specification:

Parameter Type Required Default Details & Constraints
sandbox_id string ✅ Yes - Target sandbox ID

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "thanaton_pty_info",
    "arguments": {
      "sandbox_id": "sbx-kvm-9f82d1"
    }
  },
  "id": 20
}

21. thanaton_expose_port

Description: Allocate and expose a Layer 4 TCP wire forwarding port (antinat) from ephemeral host pool (12000-20000) for PostgreSQL, gRPC, or custom daemons.

Parameter Specification:

Parameter Type Required Default Details & Constraints
sandbox_id string ✅ Yes - Target sandbox ID
guest_port number ✅ Yes - Internal port inside microVM (e.g. 5432, 8080)
protocol string ❌ No tcp Layer 4 transport protocol (Enum: [tcp])
service_name string ❌ No custom Descriptive service name (e.g. postgres, grpc)

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "thanaton_expose_port",
    "arguments": {
      "sandbox_id": "sbx-kvm-9f82d1",
      "guest_port": 8080,
      "protocol": "tcp",
      "service_name": "sample_service_name"
    }
  },
  "id": 21
}

22. thanaton_list_ports

Description: List all active Layer 4 TCP port forwardings for a specific microVM sandbox.

Parameter Specification:

Parameter Type Required Default Details & Constraints
sandbox_id string ✅ Yes - Target sandbox ID

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "thanaton_list_ports",
    "arguments": {
      "sandbox_id": "sbx-kvm-9f82d1"
    }
  },
  "id": 22
}

23. thanaton_close_port

Description: Close an active Layer 4 TCP port forwarding and return the host port to the pool.

Parameter Specification:

Parameter Type Required Default Details & Constraints
sandbox_id string ✅ Yes - Target sandbox ID
host_port number ✅ Yes - Allocated host port number to release

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "thanaton_close_port",
    "arguments": {
      "sandbox_id": "sbx-kvm-9f82d1",
      "host_port": 8080
    }
  },
  "id": 23
}

24. thanaton_speculate_race

Description: Execute multi-candidate speculative branch racing: runs N candidate code patches in parallel ephemeral microVMs, commits the fastest passing candidate, and instantly reaps losers.

Parameter Specification:

Parameter Type Required Default Details & Constraints
problem_id string ❌ No default_problem Unique identifier for the task or problem
candidates array ✅ Yes - List of candidate hypotheses/patches to race in parallel
timeout_ms number ❌ No 30000 Maximum race timeout in milliseconds

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "thanaton_speculate_race",
    "arguments": {
      "problem_id": "sample_problem_id",
      "candidates": [
        "item_1",
        "item_2"
      ],
      "timeout_ms": 10000
    }
  },
  "id": 24
}

MNEMON-DB • Zero-Copy Isolated Database Engine & Branching

Contains 14 production tools specifically designed for agent autonomy.

25. mnemon_list_tenants

Description: List active PostgreSQL database tenants, clusters, and copy-on-write branches with replication and fork telemetry.

Parameter Specification:

Parameter Type Required Default Details & Constraints
tenant_id string ❌ No - Optional tenant filter

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "mnemon_list_tenants",
    "arguments": {
      "tenant_id": "org_production"
    }
  },
  "id": 25
}

26. mnemon_create_branch

Description: Fork an instant copy-on-write PostgreSQL database branch in 31ms at an exact WAL LSN without storage duplication.

Parameter Specification:

Parameter Type Required Default Details & Constraints
tenant_id string ✅ Yes - Database tenant/cluster identifier
new_branch string ✅ Yes - Name for the new branch (e.g. 'feature-migration')
parent_branch string ❌ No - Parent branch name (default: 'main')
mask_pii boolean ❌ No false Mask sensitive PII fields (emails, names, phones) with deterministic SHA-256 hashes
target_lsn number ❌ No - Optional WAL LSN for point-in-time fork

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "mnemon_create_branch",
    "arguments": {
      "tenant_id": "org_production",
      "new_branch": "preview_experiment_branch",
      "parent_branch": "preview_experiment_branch",
      "target_lsn": 100
    }
  },
  "id": 26
}

27. mnemon_promote_branch

Description: Promote a preview/ephemeral database branch to primary production root with atomic zero-downtime pointer swap.

Parameter Specification:

Parameter Type Required Default Details & Constraints
tenant_id string ✅ Yes - Database tenant identifier
branch_id string ✅ Yes - Branch ID to promote to primary root

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "mnemon_promote_branch",
    "arguments": {
      "tenant_id": "org_production",
      "branch_id": "preview_experiment_branch"
    }
  },
  "id": 27
}

28. mnemon_reset_branch

Description: Reset an ephemeral database branch back to its parent snapshot in <50ms, wiping all test mutations.

Parameter Specification:

Parameter Type Required Default Details & Constraints
tenant_id string ✅ Yes - Database tenant identifier
branch_id string ✅ Yes - Branch ID to reset

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "mnemon_reset_branch",
    "arguments": {
      "tenant_id": "org_production",
      "branch_id": "preview_experiment_branch"
    }
  },
  "id": 28
}

29. mnemon_diff_branch

Description: Inspect SQL DDL schema diff and migration script between a branch and its parent.

Parameter Specification:

Parameter Type Required Default Details & Constraints
tenant_id string ✅ Yes - Database tenant identifier
branch_id string ✅ Yes - Branch ID to diff
parent_branch string ❌ No - Parent branch (default: 'main')

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "mnemon_diff_branch",
    "arguments": {
      "tenant_id": "org_production",
      "branch_id": "preview_experiment_branch",
      "parent_branch": "preview_experiment_branch"
    }
  },
  "id": 29
}

30. mnemon_execute_sql

Description: Execute raw SQL query directly on a tenant database cluster or branch.

Parameter Specification:

Parameter Type Required Default Details & Constraints
tenant_id string ✅ Yes - Database tenant identifier
query string ✅ Yes - SQL query statement to execute
as_of_lsn string ❌ No - Optional historical WAL LSN for inline point-in-time time-travel query

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "mnemon_execute_sql",
    "arguments": {
      "tenant_id": "org_production",
      "query": "sample_query"
    }
  },
  "id": 30
}

31. mnemon_get_schema

Description: Introspect database schema tables, column types, and primary key constraints.

Parameter Specification:

Parameter Type Required Default Details & Constraints
tenant_id string ✅ Yes - Database tenant identifier

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "mnemon_get_schema",
    "arguments": {
      "tenant_id": "org_production"
    }
  },
  "id": 31
}

32. mnemon_configure_scaling

Description: Configure Aurora Serverless v2 / Neon ACU scaling limits (min ACU, max ACU, scale-to-zero timeout).

Parameter Specification:

Parameter Type Required Default Details & Constraints
tenant_id string ✅ Yes - Database tenant identifier
min_acu number ❌ No - Minimum ACU capacity (e.g. 0.0 for scale-to-zero)
max_acu number ❌ No - Maximum ACU capacity (e.g. 16.0 or 128.0)
idle_timeout_sec number ❌ No - Inactivity seconds before scaling to zero (default: 300)

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "mnemon_configure_scaling",
    "arguments": {
      "tenant_id": "org_production",
      "min_acu": 100,
      "max_acu": 100,
      "idle_timeout_sec": 10000
    }
  },
  "id": 32
}

33. mnemon_configure_pooler

Description: Inspect or configure PgBouncer connection pooling mode and max connection limits.

Parameter Specification:

Parameter Type Required Default Details & Constraints
tenant_id string ✅ Yes - Database tenant identifier
pool_mode string ❌ No - Pooling mode (Enum: [transaction, session])
max_pool_size number ❌ No - Maximum pooled backend connections

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "mnemon_configure_pooler",
    "arguments": {
      "tenant_id": "org_production",
      "pool_mode": "transaction",
      "max_pool_size": 100
    }
  },
  "id": 33
}

34. mnemon_manage_extensions

Description: Manage 1-click PostgreSQL extensions (vector, pg_search, postgis, uuid-ossp).

Parameter Specification:

Parameter Type Required Default Details & Constraints
tenant_id string ✅ Yes - Database tenant identifier
action string ✅ Yes - Action to perform (Enum: [list, enable, disable])
name string ❌ No - Extension name (for enable/disable)

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "mnemon_manage_extensions",
    "arguments": {
      "tenant_id": "org_production",
      "action": "list",
      "name": "sample_name"
    }
  },
  "id": 34
}

35. mnemon_get_slow_queries

Description: Inspect slow query execution diagnostics, call frequencies, and buffer cache hit rates.

Parameter Specification:

Parameter Type Required Default Details & Constraints
tenant_id string ✅ Yes - Database tenant identifier

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "mnemon_get_slow_queries",
    "arguments": {
      "tenant_id": "org_production"
    }
  },
  "id": 35
}

36. mnemon_clone_vector

Description: Sub-35ms pgvector HNSW index clone: Duplicates vector index graphs across branches using XFS/Btrfs zero-copy reflink extents.

Parameter Specification:

Parameter Type Required Default Details & Constraints
project_id string ✅ Yes - Mnemon project / tenant ID
branch string ✅ Yes - Branch name to clone index from
index_name string ✅ Yes - pgvector HNSW index name

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "mnemon_clone_vector",
    "arguments": {
      "project_id": "sample_project_id",
      "branch": "preview_experiment_branch",
      "index_name": "sample_index_name"
    }
  },
  "id": 36
}

37. mnemon_autofreeze_policy

Description: Configure automatic zero-CPU instance freezing via cgroups v2 (cgroup.freeze) while keeping PostgreSQL shared buffer pool in RAM.

Parameter Specification:

Parameter Type Required Default Details & Constraints
project_id string ✅ Yes - Mnemon project / tenant ID
idle_timeout_seconds number ❌ No - Inactivity seconds before auto-freezing (default: 30)
preserve_buffer_pool boolean ❌ No - Preserve shared buffers in RAM (default: true)

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "mnemon_autofreeze_policy",
    "arguments": {
      "project_id": "sample_project_id",
      "idle_timeout_seconds": 10000,
      "preserve_buffer_pool": true
    }
  },
  "id": 37
}

38. mnemon_wal_rewind

Description: 31ms Point-in-Time Recovery & WAL rewind: forks an isolated zero-copy CoW PostgreSQL branch from an arbitrary historical timestamp or LSN.

Parameter Specification:

Parameter Type Required Default Details & Constraints
sandbox_id string ❌ No - Optional sandbox ID to rewind
project_id string ❌ No - Optional project ID
target_time string ❌ No - Target ISO-8601 UTC timestamp to rewind to
target_lsn string ❌ No - Target PostgreSQL WAL LSN position

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "mnemon_wal_rewind",
    "arguments": {
      "sandbox_id": "sbx-kvm-9f82d1",
      "project_id": "sample_project_id",
      "target_time": "sample_target_time",
      "target_lsn": "sample_target_lsn"
    }
  },
  "id": 38
}

ESCHATON & NEPHIS • Autonomous Polyglot Code Execution & Fast-Batch

Contains 3 production tools specifically designed for agent autonomy.

39. eschaton_preflight_check

Description: In-memory AST syntax and hazard detection (<50µs): Detects infinite loops, fork bombs, and banned syscalls before microVM dispatch.

Parameter Specification:

Parameter Type Required Default Details & Constraints
code string ✅ Yes - Source code to analyze
language string ✅ Yes - Programming language (python, javascript, c, cpp, bash, go)

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "eschaton_preflight_check",
    "arguments": {
      "code": "print('Executed safely via Nephis')",
      "language": "sample_language"
    }
  },
  "id": 39
}

40. nephis_fast_batch

Description: 50-Testcase Parallel Fast-Batch: Dispatches up to 50 testcases in a single HTTP request to evaluate concurrently in 38ms parallel memory.

Parameter Specification:

Parameter Type Required Default Details & Constraints
language_id number ❌ No 54 Language ID (e.g. 54 for Python, 63 for JavaScript, 71 for Python 3)
source_code string ✅ Yes - Source code to evaluate against tests
tests array ❌ No - List of up to 50 testcases with stdin and expected_output
submissions array ❌ No - Alternative batch submissions format for backward compatibility

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "nephis_fast_batch",
    "arguments": {
      "language_id": 100,
      "source_code": "print('Executed safely via Nephis')",
      "tests": [
        "item_1",
        "item_2"
      ],
      "submissions": [
        "item_1",
        "item_2"
      ]
    }
  },
  "id": 40
}

41. eschaton_fast_batch

Description: Parallel early-exit batch matrix execution: Runs test matrices across submissions concurrently with sub-millisecond short-circuiting on failure.

Parameter Specification:

Parameter Type Required Default Details & Constraints
language_id number ❌ No 54
source_code string ❌ No -
tests array ❌ No -
submissions array ❌ No - List of code submissions to evaluate

Sample JSON-RPC Invocation:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "eschaton_fast_batch",
    "arguments": {
      "language_id": 100,
      "source_code": "print('Executed safely via Nephis')",
      "tests": [
        "item_1",
        "item_2"
      ],
      "submissions": [
        "item_1",
        "item_2"
      ]
    }
  },
  "id": 41
}

42. mnemon_merge_branch

Description: Fast-forward merge schema migrations from a branch back to parent trunk in <200ms. Verifies non-divergence and applies migrations without table locks or cluster restarts.

Parameter Specification:

Parameter Type Required Default Details & Constraints
tenant_id string ✅ Yes - Database tenant identifier
branch_id string ✅ Yes - Branch identifier to merge
parent_branch string ❌ No "main" Target parent branch

43. thanaton_list_golden_amis

Description: List available pre-baked Golden AMI runtimes (node22, python312, golang122, nextjs) with pre-installed language toolchains and common packages. Eliminates cold package installation delays.


44. thanaton_create_ram_snapshot

Description: Capture running guest RAM state directly to high-speed POSIX shared memory (/dev/shm) in ~14.5ms. Allows sub-12ms speculative branch spawning without hypervisor determinism overhead.

Parameter Specification:

Parameter Type Required Default Details & Constraints
sandbox_id string ✅ Yes - Target sandbox ID
warm_packages array ❌ No [] List of pre-imported packages to register in memory snapshot

45. thanaton_restore_ram_snapshot

Description: Restore a guest microVM memory state from a pre-warmed RAM snapshot in 11.8ms.

Parameter Specification:

Parameter Type Required Default Details & Constraints
snapshot_id string ✅ Yes - Snapshot ID to restore
sandbox_id string ❌ No "default" Target sandbox ID to hydrate

46. thanaton_secret_shield_status

Description: Inspect or configure the eBPF kernel TAP outbound secret exfiltration firewall. Drops unauthorized credential leaks (OpenAI, Anthropic, AWS, JWT) in kernel space.

Parameter Specification:

Parameter Type Required Default Details & Constraints
sandbox_id string ✅ Yes - Target sandbox ID
action string ❌ No "get" Action to perform (get, enable, disable)

47. thanaton_capture_browser_display

Description: Capture real-time screenshot or CDP stream frame from a guest headless browser canvas via virtual framebuffer (/dev/fb0) or Chrome DevTools Protocol.

Parameter Specification:

Parameter Type Required Default Details & Constraints
sandbox_id string ✅ Yes - Target sandbox ID
format string ❌ No "jpeg" Image format (jpeg, png, webp)
quality number ❌ No 80 Compression quality (1-100)

💻 Developer SDKs & Native Command-Line Tools (CLI)

Beyond the Model Context Protocol (MCP) JSON-RPC transport, NEPHIS provides first-class native command-line interfaces and client SDKs for automated terminal scripting, CI/CD test automation, and full-stack application development.

1. Thanaton MicroVM CLI (thanaton)

Available as a zero-dependency CLI wrapper (sdk/cli/thanaton.bat on Windows or thanaton on Linux):

# Provision a sub-6ms hardware KVM MicroVM (512MB RAM, attached Postgres DB)
thanaton up --runtime microvm --memory-mb 512 --db

# Execute arbitrary bash / terminal commands inside the isolated sandbox
thanaton exec sbx-kvm-9f82d1 -- npm test

# Query pre-baked Golden AMI runtimes (node22, python312, golang122, nextjs)
thanaton goldenami

# Capture running guest RAM state directly to /dev/shm in ~14ms
thanaton ramsnap create sbx-kvm-9f82d1 --warm-packages next,react

# Enable eBPF kernel TAP outbound secret exfiltration firewall
thanaton shield sbx-kvm-9f82d1 enable

# Capture live headless browser canvas frame (screenshot)
thanaton display sbx-kvm-9f82d1 --out screenshot.jpg

# Put sandbox into compressed stasis (Scale-to-Zero, $0 RAM burn)
thanaton sleep sbx-kvm-9f82d1

# Instant hardware cold-wake from stasis (Sub-6ms SLA)
thanaton wake sbx-kvm-9f82d1

# Expose a local MicroVM port for live browser preview (e.g. Next.js on port 3000)
thanaton ports expose sbx-kvm-9f82d1 --port 3000

2. Mnemon-DB Serverless PostgreSQL CLI (mnemon)

Available as a native CLI tool (sdk/cli/mnemon.bat on Windows or mnemon on Linux):

# Instant zero-copy snapshot branch creation via Linux XFS reflink blocks (<31ms)
mnemon branch prod-db staging --parent main

# Fork a sanitized branch with automated PII masking (emails, names, phones)
mnemon branch prod-db safe-eval --parent main --mask-pii

# Execute raw SQL directly against the branch (supports inline AS OF LSN time-travel)
mnemon sql prod-db "SELECT * FROM balances WHERE id = 1;" --as-of-lsn 0/16B3740

# Fast-forward merge schema migrations from a branch back to parent trunk in <200ms
mnemon merge prod-db feat-auth-migration --parent main

# Structural schema and data delta comparison between branches
mnemon diff prod-db --branch staging --target main

# Point-in-Time WAL rewind to an exact PostgreSQL Log Sequence Number (LSN)
mnemon pitr restore prod-db --target-lsn 0/16B38D8

# Promote verified staging branch to production zero-downtime
mnemon promote prod-db staging --target main

3. Eschaton Code Execution CLI (eschatonctl)

High-throughput compiler and parallel testcase runner (scripts/eschatonctl.py):

# Single execution with instant in-memory microkernel (<3.4ms)
eschatonctl run solution.cpp --lang 54 --stdin input.txt

# Run 50 parallel testcases simultaneously in 38.2ms (Apex Fan-Out)
eschatonctl batch --source solution.cpp --testcases ./tests/ --parallel 50

# Ultra-fast (12µs) in-memory AST hazard detection (fork bombs, infinite loops)
eschatonctl preflight untrusted_script.py

4. Official Python SDK (nephis-sdk)

from nephis import NephisClient

# Authenticate with your API key or rely on auto-bootstrapped credentials
client = NephisClient(api_key="mrd_live_...")

# 1. Thanaton: Spawn a sub-6ms MicroVM
sandbox = client.thanaton.spawn(runtime="microvm", memory_mb=512)
result = sandbox.exec("python3 -c 'print(42)'")
print(result.stdout)  # 42
sandbox.sleep()  # Scale-to-zero stasis ($0 ongoing cost)

# 2. Mnemon-DB: Zero-copy PostgreSQL 16 branch in 30ms
branch = client.mnemon.create_branch("ai-agent-staging", parent="main")
db_rows = branch.query("SELECT id, email FROM tenants LIMIT 5;")

# 3. Eschaton: Sub-38ms batch code execution
run = client.eschaton.execute(
    language_id=54,  # C++
    source_code='#include <iostream>\nint main() { std::cout << "Done"; return 0; }'
)
print(f"Executed in {run.time}s with memory {run.memory}KB")

5. Official Node.js / TypeScript SDK (@nephis/sdk)

import { NephisClient } from '@nephis/sdk';

const nephis = new NephisClient({
  apiKey: process.env.NEPHIS_API_KEY,
  baseUrl: 'https://nephis.theeducode.com',
});

// Launch an isolated microVM and execute command
const sbx = await nephis.thanaton.spawnSandbox({ runtime: 'microvm', memoryMb: 1024 });
const exec = await nephis.thanaton.execCommand(sbx.id, 'uname -a');
console.log('Sandbox Kernel:', exec.stdout);

// Create zero-copy database branch in 30ms
const branch = await nephis.mnemon.createBranch({
  branchName: 'pr-142',
  parentBranch: 'main'
});
console.log('Branch Ready:', branch.connection_string);

👤 Creator & Engineering Attribution

from github.com/mohitrajdeo/nephis-mcp-server

Install Nephis in Claude Desktop, Claude Code & Cursor

Recommended · one command, every IDE
unyly install nephis

Installs into Claude Desktop, Claude Code, Cursor & VS Code — handles npx, uvx and build-from-source repos for you.

First time? Get the CLI: curl -fsSL https://unyly.org/install | sh

Or configure manually

Run in your terminal:

claude mcp add nephis --env NEPHIS_API_KEY="" --env NEPHIS_BASE_URL="" -- npx -y nephis-mcp-server

Step-by-step: how to install Nephis

FAQ

Is Nephis MCP free?

Yes, Nephis MCP is free — one-click install via Unyly at no cost.

Does Nephis need an API key?

Yes, it requires environment variables: NEPHIS_API_KEY, NEPHIS_BASE_URL. Unyly injects them into the config during install.

Is Nephis hosted or self-hosted?

Self-hosted: the server runs locally on your machine via the install command above.

How do I install Nephis in Claude Desktop, Claude Code or Cursor?

Open Nephis on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.

Related MCPs

Compare Nephis with

Not sure what to pick?

Find your stack in 60 seconds

Author?

Embed badge for your README

Browse similar

All data MCPs