STATA-MCP

Project-local, reproducible Stata execution for humans and AI agents. Every managed analysis stays beside its source project and produces immutable, readable do-files, logs, results, graphs, and provenance.

Why this exists

Existing Stata MCP servers prove that agents can call Stata. STATA-MCP Repro adds the controls required for real research: explicit project ownership, deterministic planning gates, immutable run identity, process-tree cancellation, typed results, graph provenance, safe migration, and one shared human/agent ledger.

Core guarantees:

• startup never creates a workspace;
• no forced stata-mcp-folder and no copied central archive;
• one .stata-mcp.toml selects a human-readable project-relative artifact directory;
• run names are descriptive and collision-safe;
• completed runs are immutable and every artifact is SHA-256 bound to its run;
• medical and other material analyses require a reviewed, approved plan;
• dashboard listens only on 127.0.0.1 with an expiring bearer token;
• humans and agents create the same canonical run records.

Start

Prerequisites: Python 3.11–3.13, a separately licensed Stata installation, and uv.

git clone https://github.com/taewat07/STATA-MCP-AGENT.git
cd STATA-MCP-AGENT
uv tool install .
stata-mcp install --all
cd "/path/to/research-project"
stata-mcp project init --artifact-dir "analysis/stata" --name "Readable study name"
stata-mcp doctor

Restart the AI client after installation. Use stata-planner to inspect and approve a material analysis, then stata-analyst to execute it. Humans can inspect the same ledger with:

stata-mcp dashboard --project .

The command prints the loopback URL and a short-lived token. The VS Code client connects to this service; it never starts or stops the MCP server.

Documentation

Read the installation guide, architecture, human and agent workflows, provenance contract, and security model. Legacy users should follow the copy-first migration guide.

Contributions follow CONTRIBUTING.md, the Code of Conduct, and the public security policy.

Status and attribution

Pre-release 0.1.x; APIs may change under the documented two-release deprecation policy. Derived from SepineTam's MCP-for-Stata 1.21.3; see THIRD_PARTY_NOTICES.md. Not affiliated with or endorsed by StataCorp LLC. Licensed AGPL-3.0-or-later.