Stata Discover

Users need Stata to run stata-mcp, but Stata is not always installed in a default location. This skill discovers which Stata executables/versions exist on the user's device and configures stata-mcp to use the most suitable one.

All commands below use uvx stata-mcp; if stata-mcp is already installed, the bare stata-mcp command works the same way.

Stata Discover

When to Use

• First-time setup: the user has not configured Stata for stata-mcp yet
• stata_do or stata-mcp doctor reports that the Stata CLI cannot be found
• The user wants to switch the Stata version/edition used by stata-mcp
• The machine has multiple Stata installations and the user is unsure which one is in use

Find Stata with CLI

List all Stata installations on the machine:

uvx stata-mcp discover

• Prints one discovered Stata path per line, deduplicated and sorted; prints nothing when none is found
• Search scope: installed applications, common installation directories, PATH, and the STATA_CLI environment variable
• Read-only: does not launch Stata, verify licenses, or modify configuration
• Available since v1.24.0; macOS / Windows only (reports OSNotSupported on Linux — Linux users should rely on auto-detection below or set the path manually)
• Note: on macOS the output is a .app bundle path (e.g. /Applications/StataNow/StataMP.app), but STATA_CLI requires the CLI binary inside the bundle: append /Contents/MacOS/<binary>, where <binary> is usually stata-<edition> such as stata-mp (StataNow bundles may name it StataMP instead — check the directory). Full example: /Applications/StataNow/StataMP.app/Contents/MacOS/stata-mp

Independently, Stata-MCP ships a built-in StataFinder (src/stata_mcp/stata/stata_finder/). When STATA_CLI is not configured, it automatically discovers the best Stata executable and caches the result into the config file — no manual step needed.

Search locations per platform:

When multiple Stata installations exist, auto-detection picks by:

1. Edition first: mp > se > be > ic > default
2. Then version number within the same edition, higher wins (float versions like 19.5 are supported; an undetectable version counts as 99, i.e. treated as the current default version)

Inspect the currently resolved Stata CLI:

uvx stata-mcp config show cli           # value persisted in the config file
uvx stata-mcp doctor --check stata_cli  # effective path and its source (from env / from config / auto-detected)

After picking a version from the discover list, persist it with uvx stata-mcp config set cli <path> (see the next section).

Configure Stata for Stata-MCP

At runtime, Stata-MCP resolves STATA_CLI in this order: config file > STATA_CLI environment variable > auto-detection (the detected result is written back to the user config file as a cache to speed up later startups).

Permanent (recommended)

uvx stata-mcp config set cli            # auto-detect the best edition and persist it
uvx stata-mcp config set cli /Applications/StataNow/StataMP.app/Contents/MacOS/stata-mp  # macOS example
uvx stata-mcp config set cli "C:\Program Files\Stata18\StataMP-64.exe"                   # Windows example
uvx stata-mcp config edit STATA.STATA_CLI /path   # modify an existing config entry

This writes to the [STATA] section of ~/.statamcp/config.toml and applies to all projects.

Project-level

Create .statamcp/config.toml in the project root:

[STATA]
STATA_CLI = "/path/to/stata-mp"

For ordinary settings the project file overrides the user file, which suits projects that must pin a specific Stata version.