eggsact
Deterministic MCP and in-process utility tools for coding agents. 80 tools across 20 categories: math, text, JSON, regex, path, shell, config, patch, dependency, analysis, and more. Includes a natural language math evaluator that parses expressions like "thirty plus five" or "30m + 100ft".
Installation
Or from source:
Minimum Rust version: 1.89.0.
Quick Start
CLI
# Natural language
# Standard math
# Unit conversions
# MCP server mode (stdio JSON-RPC)
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!;
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 |
| Library API | docs/library-api.md |
| MCP tool reference (80 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 |
| 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.
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.