Setup and Verification

Use the shared installer and verification flow instead of hand-writing per-agent config unless the user explicitly asks for manual steps.

Preferred Install Commands

Project-shared install:

bash plugin/install.sh --scope project

Personal install:

bash plugin/install.sh --scope user

Specific agent:

bash plugin/install.sh --agent codex

Pin a version if a lab wants to:

bash plugin/install.sh --version 2.5.1

Offline/local source:

bash plugin/install.sh --local-source /path/to/mcp-stata

Live verification:

bash plugin/install.sh --verify

What the Installer Does

• Uses the canonical server id mcp-stata
• Writes project-scoped configs where the client supports them
• Falls back to user-scoped config where project scope is not first-class
• Installs Codex skills into the Codex skills directory
• Installs the Gemini extension from plugin/gemini-extension.json
• Registers shared ~/.agents/skills/mcp-stata symlinks for compatible agents
• Supports latest-by-default installs and explicit version pinning

Verification Standard

When the user asks whether setup is complete, verify more than “the file exists”:

1. Stata discovery and edition
2. uv / uvx availability
3. package availability for reghdfe and gtools
4. graph-export readiness
5. log-path emission for command output
6. startup/profile behavior

If live verification is not possible on the current machine, state exactly what remains unverified.

Troubleshooting

• If Stata is not discovered, tell the user to set STATA_PATH.
• If a user-managed machine blocks temp files, logs, or graph export, use the stata-environment-diagnose skill.
• If project-wide configs are undesirable, re-run with --scope user.