mcp-stata

Stata MCP Server (mcp-stata)

 

mcp-stata is an agentic toolkit for empirical researchers. It gives AI agents native control over a local Stata installation, allowing agents to run do-files, inspect data, check stored results, and export graphs. Contains a skills catalog for workflows researchers use often: auditing data, replication and robustness checks, specification comparisons, publication QA, referee responses, and modernization of legacy code. Featured in News.

If you'd like a fully integrated VS Code extension to run Stata code without leaving your IDE, and also allow AI agent interaction, check out my other project: Stata Workbench.

Built by Thomas Monk, London School of Economics.

This server enables LLMs to:

• Execute Stata code: run any Stata command (e.g. sysuse auto, regress price mpg).
• Inspect data: retrieve dataset summaries and variable codebooks.
• Export graphics: generate and view Stata graphs (histograms, scatterplots).
• Streaming graph caching: automatically cache graphs during command execution for instant exports.
• Verify results: programmatically check stored results (r(), e()) for accurate validation.
• Drive paper workflows: run structured research audits, estimation planning, specification comparisons, publication checks, and reproducibility diagnostics.
• Use modern MCP surfaces: discover prompts, project/session resources, artifacts, and safety metadata through structured tool envelopes.

Quickstart

1 · Install

macOS/Linux:

curl -LsSf https://raw.githubusercontent.com/tmonk/mcp-stata/main/plugin/install.sh | bash

Windows (PowerShell):

irm https://raw.githubusercontent.com/tmonk/mcp-stata/main/plugin/install.ps1 | iex

Client-specific examples:

Client	macOS/Linux	Windows (PowerShell)
Claude Code	bash <(curl -LsSf https://raw.githubusercontent.com/tmonk/mcp-stata/main/plugin/install.sh) --agent claude	& ([scriptblock]::Create((irm https://raw.githubusercontent.com/tmonk/mcp-stata/main/plugin/install.ps1))) --agent claude
Codex	bash <(curl -LsSf https://raw.githubusercontent.com/tmonk/mcp-stata/main/plugin/install.sh) --agent codex	& ([scriptblock]::Create((irm https://raw.githubusercontent.com/tmonk/mcp-stata/main/plugin/install.ps1))) --agent codex
Gemini	bash <(curl -LsSf https://raw.githubusercontent.com/tmonk/mcp-stata/main/plugin/install.sh) --agent gemini	& ([scriptblock]::Create((irm https://raw.githubusercontent.com/tmonk/mcp-stata/main/plugin/install.ps1))) --agent gemini
Cursor	bash <(curl -LsSf https://raw.githubusercontent.com/tmonk/mcp-stata/main/plugin/install.sh) --agent cursor	& ([scriptblock]::Create((irm https://raw.githubusercontent.com/tmonk/mcp-stata/main/plugin/install.ps1))) --agent cursor
Windsurf	bash <(curl -LsSf https://raw.githubusercontent.com/tmonk/mcp-stata/main/plugin/install.sh) --agent windsurf	& ([scriptblock]::Create((irm https://raw.githubusercontent.com/tmonk/mcp-stata/main/plugin/install.ps1))) --agent windsurf
VS Code	bash <(curl -LsSf https://raw.githubusercontent.com/tmonk/mcp-stata/main/plugin/install.sh) --agent vscode	& ([scriptblock]::Create((irm https://raw.githubusercontent.com/tmonk/mcp-stata/main/plugin/install.ps1))) --agent vscode
Auto-detect / default	bash <(curl -LsSf https://raw.githubusercontent.com/tmonk/mcp-stata/main/plugin/install.sh)	& ([scriptblock]::Create((irm https://raw.githubusercontent.com/tmonk/mcp-stata/main/plugin/install.ps1)))

2 · Verify

Ask your agent:

Do you have access to the Stata agentic toolkit? (mcp-stata)

It will confirm the connection and describe all available tools and skills.

3 · Try it

Load the auto dataset and run a regression of price on mpg

Academic Research Workflows

The toolkit is designed for empirical economics research.