CLI and MCP quick start

The cortxt CLI is Cortxt’s primary product surface. The MCP server is the external integration surface selected by ADR-024.

Install from the repository

Use Python 3.12 or later from a repository checkout:

python -m venv .venv
source .venv/bin/activate
python -m pip install -e ./agent-platform
cortxt --help

On Windows PowerShell, activate with .venv\Scripts\Activate.ps1.

Start the MCP server

cortxt mcp serve

The server uses standard input/output transport and exposes the read-only MCP tool slice by default. An MCP client starts this command as its server process.

Mandate required for mutations

Per ADR-032, every Tier-1 or higher MCP tool call requires a signed, nonce-bound mandate envelope that is verified before execution. ADR-032 is Proposed; this page does not present it as an Accepted decision. Keep mutation tiers locked unless your environment is configured to issue and verify these envelopes.

The mandate carries scoped authority such as the issue reference, allowed tools, data-class ceiling, budget, runtime limit, expiry, and scope fingerprint. Private signing keys stay on the operator side; the server receives public keys only.

Next steps

• Read the current operating model before choosing an execution path.
• Review the dispatch contract for required identity, lifecycle, and result evidence.
• See ADR-032 in the repository for the proposal and its current status.