eggsact
Deterministic MCP and in-process utility tools for coding agents. 86 tools across 23 categories: math, text, JSON, regex, path, shell, config, patch, dependency, analysis, network, encoding, temporal, and more. Includes a natural language math evaluator that parses expressions like "thirty plus five" or "30m + 100ft".
Installation
The latest release is v1.2.6. The verified binary installer is the recommended path for supported hosts:
|
On Windows, run the published PowerShell installer:
irm https://github.com/eggstack/eggsact/releases/latest/download/install.ps1 | iex
Pin the Windows installer with -Version 1.2.6. Both installers verify the
downloaded binary's checksum and reported version. Cargo remains available as
the fallback for unsupported hosts and source builds:
See Installation for the target matrix, fallback, and validation contract.
Maintainers can reproduce the release-mode performance evidence matrix with
cargo bench --locked --bench performance; it is non-gating and intended for
same-host baseline/candidate comparisons. See
Performance for the measured contracts and
hot-path invariants.
Or from source:
Minimum Rust version: 1.89.0.
Quick Start
CLI
# Natural language
# Standard math
# Unit conversions
# MCP server mode (stdio JSON-RPC, connection-pinned dual-era: 2026-07-28 + 2025-11-25/2024-11-05 legacy; one process serves one era)
# Low-context discovery surface (pinned front doors + tool_search/tool_invoke)
Each stdio process is pinned to one protocol era by its first classifiable
message: an enveloped modern claim selects 2026-07-28; initialize or any
claim-less opening selects the legacy path. The official SDK's automatic
modern probe is enveloped and runs in a disposable sibling process. A
claim-less server/discover is therefore legacy traffic, not an era-neutral
probe. Cross-era requests return -32022 Unsupported protocol version, while
mismatched notifications are dropped before side effects.
Discovery is an explicit low-context presentation option, not a capability
reduction: full/Model direct definitions are 77 tools / 111,911 serialized
bytes, while discovery advertises 7 / 6,088 bytes (5.44%). Deterministic
retrieval and policy-containment gates live in tests/mcp/test_discovery.rs
(76 stable Model tools at 100% semantic coverage with 88 task intents,
top-1 >=90% / top-3 >=98% / top-5 100%, zero Model-audience leaks; 48 Model
task scenarios plus 4 containment cases). Paired provider/client traces can
be scored offline with scripts/score-discovery-traces.py --pair direct.json discovery.json (plural expected_tools contract, 2pp
noninferiority gates); see tests/fixtures/discovery_traces/README.md.
External OpenAI/Anthropic evidence is still pending, so generated
integrations stay on direct while discovery remains explicitly selectable.
MCP client setup
Render a read-only, absolute-path registration instruction for a client-owned stdio process:
Update an installed binary with eggsact update. It verifies the crates.io
stable version, GitHub asset checksum, and candidate --version before
replacement. The updater is self-contained (in-process HTTP/1 + TLS via
eggfetch-core; no external curl required after install). Bootstrap
installers still use curl/PowerShell because they run before Eggsact exists.
Existing MCP sessions continue until their owning client
reconnects. Eggsact does not install a daemon or edit client configuration.
Library
use ;
// Natural language
let = run.unwrap;
assert_eq!;
// Direct math
let = evaluate.unwrap;
assert_eq!;
In-Process Agent API
use ;
let registry = default;
let ctx = agent_default;
let response = registry.call_json_with_execution_context.unwrap;
assert!;
Typed Preflight Wrappers
use ;
let input = DependencyPreflightInput ;
let output = run.unwrap;
assert!;
For new Rust integrations prefer calc/root functions, then typed text
primitives, then ToolRegistry, then typed preflight wrappers — raw
tools::* handlers are adapter internals kept pub for 1.x compatibility.
See docs/library-api.md for the full hierarchy.
Supported Platforms
| Tier | Platform | Status |
|---|---|---|
| 1 | Ubuntu latest (x86_64) | Full CI gate |
| 2 | Windows latest (x86_64) | Compile check |
| 2 | macOS latest (ARM64) | Compile check |
Documentation
| Topic | Link |
|---|---|
| CLI usage | docs/cli.md |
| Installation, updates, and client setup | docs/installation.md |
| Library API | docs/library-api.md |
| MCP tool reference (86 tools) | docs/mcp-tools.md |
| Math features, functions, constants, units | docs/math-features.md |
| Architecture overview | architecture/overview.md |
| Calculator core | architecture/calculator.md |
| MCP server internals | architecture/mcp-server.md |
| Agent API deep dive | architecture/agent-api.md |
| Preflight wrappers | architecture/preflight.md |
| Machine codes | architecture/machine-codes.md |
| Profiles and audiences | architecture/registry-profiles.md |
| Text processing library | architecture/text-library.md |
| Budget and concurrency | architecture/budget-concurrency.md |
| Performance evidence | architecture/performance.md |
| Compatibility policy | docs/compatibility-policy.md |
| Verification doctrine | docs/verification.md |
| Testing patterns | architecture/testing.md |
| Contributing | docs/contributing.md |
| Fuzzing | docs/fuzzing.md |
| Release process | docs/release.md |
Key Gotchas
^is XOR, not exponentiation. Use**for power. Matches Python.gmeans gram in unit expressions. Usegravityfor standard gravity.serde_jsonusespreserve_order— key order is intentional in serialized JSON.- Network, encoding, datetime, and cron utilities are deterministic and use no system/network state; temporal conversions accept fixed offsets only. IPv6 CIDR counts are exact decimal powers of two, mapped-IPv6 metadata is limited to
::ffff:0:0/96, and cron DOM/DOW matching follows Vixie/Cronie star syntax (either field starting with*, including*/nsteps, requires both fields to match; otherwise either may match; explicit full ranges are not star syntax).
Relationship to Python eggcalc
eggsact is a Rust reimplementation of the Python eggcalc project. The two projects are functionally equivalent for core math, unit conversion, and text processing operations. See docs/parity.md for known differences.
License
MIT -- see LICENSE for details.