Host-neutral transactional MCP server and execution broker for AI agents
Five tools with complete schemas, descriptions, and parameter types. Tool names follow verb_noun pattern (autonomous_read_file, autonomous_write_file, etc.). Descriptions are detailed (100-250 chars) and explain WHAT, WHEN, and consequences. Parameters have types, descriptions, and constraints (minLength, maxLength, pattern, defaults). Output schemas not explicitly documented in source. Error handling guidance present in descriptions but not formalized. Tool annotations present (read_only_hint, destructive_hint, idempotent_hint) in code. Composition is clean, each tool has one responsibility. No security issues detected (no secrets in params, workspace-scoped access enforced). Naming is clear and distinguishes tools well (read vs write vs recover vs status vs list).
Returns the local Engine state and authoritative Broker delivery state for one exact attempt UUID. Use this to inspect an earlier write or recovery result. It performs no action and does not change retry or approval state.
Lists all files and directories recursively within the workspace, with optional filtering by name pattern and depth limit.
Reads one UTF-8 text file through Autonomous Intelligence's policy broker. Use this only for files inside the configured workspace. It returns content, SHA-256, operation identifiers, and truncation metadata; it cannot access arbitrary host paths.
Reconciles every durable incomplete Engine attempt against the authoritative Broker ledger. Call this after either process restarts or when a previous tool call ended without a result. It never blindly retries an operation whose effect is uncertain.
Creates or atomically replaces one UTF-8 text file inside the configured workspace. The separate Broker independently validates the path and content hash and requests human approval. Use expected_prior_sha256 for safe compare-and-swap overwrites.
Output schemas not documented in source code. Tool descriptions explain what is returned (content, SHA-256, operation identifiers, truncation metadata) but formal output schema definitions are not visible in the provided code excerpt.
autonomous_recover_incomplete has empty input schema (no parameters). Description is brief (97 chars) and could better explain when to call it, what it reconciles, and what the agent should expect.
autonomous_list_recursive max_depth parameter defaults to null (unlimited). Description does not warn about performance implications of unlimited recursion on large directory trees.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 62 | 2026-07-28+ | v2 |
Error handling is implicit in descriptions (e.g., 'paths outside it are rejected') but no explicit error response schema or recovery guidance is documented. LLMs cannot infer what error messages to expect or how to recover.
autonomous_write_file overwrite parameter defaults to false, which is safe, but the description could be clearer about what happens if overwrite=false and the file exists (does it error or silently skip?).