Agent-Skills.md

Agent Skills: stata-run

Run arbitrary Stata code or a .do file and display the result.

UncategorizedID: tmonk/mcp-stata/stata-run

Repository

tmonk/mcp-stata
tmonkLicense: AGPL-3.0
7516

Install this agent skill to your local

pnpm dlx add-skill https://github.com/tmonk/mcp-stata/tree/HEAD/plugin/skills/stata-run

Skill Files

Browse the full folder contents for stata-run.

Download Skill

Loading file tree…

plugin/skills/stata-run/SKILL.md

Skill Metadata

Name
stata-run
Description
Run arbitrary Stata code or a .do file and display the result.

The argument is the Stata code or absolute path to a .do file to execute.

  1. If the argument ends in .do or .ado, call:

    stata_run(code=<argument>, is_file=True, echo=True, as_json=True)

    Otherwise call:

    stata_run(code=<argument>, echo=True, as_json=True)

  2. If success is true, display the stdout output. Note the output is truncated to 5,000 chars; if the response includes a log_path, offer to tail the full log with /stata-log <log_path>.

  3. If success is false, display the error message and rc code. Suggest using /stata-lint <path> for syntax issues or /stata-help <command> for documentation.

  4. If the command produces graphs, note that /stata-graph can export them.

If using background mode (background=True): you may do other work or fire parallel tasks, but you MUST call stata_task_status(task_id=<id>, wait=True, timeout=<N>, tail_lines=<M>) for every task before returning to the user. Set timeout to match expected runtime; set tail_lines to how much output you want inline vs. reading separately via stata_read_log. Loop on timeout until status is 'done' or 'failed'.