stata-mcp 1.17.3

Let LLM help you achieve your regression analysis with Stata

Stata-MCP

Let LLM help you achieve your regression analysis with Stata ✨
Evolve from reg monkey to causal thinker 🐒 -> 🧐

---

Notes: While we strive to make open source accessible to everyone, we regret that we can no longer maintain the Apache-2.0 License. Due to individuals directly copying this project and claiming to be its maintainers, we have decided to change the license to AGPL-3.0 to prevent misuse of the project in ways that go against our original vision.

Notes: 尽管我们希望尽可能让所有人都能从开源中获益，但我们很遗憾地宣布无法继续保持 Apache-2.0 License。由于有人直接抄袭本项目并标榜其为项目维护者，我们不得不将 License 更改为 AGPL-3.0，以防止有人滥用本项目进行违背项目初心的事情。

Reason

Background: @jackdark425's repository directly copied this project and claimed to be the sole maintainer. We welcome open source collaboration based on forks, including but not limited to adding new features, fixing existing bugs, or providing valuable suggestions for the project, but we firmly oppose plagiarism and false attribution.

Update: The infringing project has been taken down via GitHub DMCA. Click here to learn about.

背景: @jackdark425 的仓库直接抄袭了本项目并标榜为项目唯一维护者。我们欢迎基于fork的开源协作，包括但不限于添加新的feature、修改已有bug或对项目提出您宝贵的意见，但坚决反对抄袭和虚假署名行为。

更新: 侵权项目已通过GitHub DMCA被takedown，点击这里查看详情。

---

News:

• Find more in WeChat: Why I made it?, and 8 figures find out Stata-MCP
• 🦞 OpenClaw Support: Standalone CLI tools for OpenClaw integration (stata-mcp tool), see OpenClaw guide
• ✨ Claude Code Plugin Support: Official plugin package with MCP server and Stata LSP integration
• Use Stata-MCP in Claude Code, look here, or Codex here

Finding our newest research? Click here or visit reports website.

Looking for others?

MCP or AI about Stata

• A session based MCP server for Stata, mcp-stata
• A VScode or Cursor integrated here. Confused it? 💡 Comparison

Datasets and Information

• STOP Dataset: StataMCP-Team Opendata Project 📊, we have open-sourced a comprehensive dataset collection for social science research, aiming to enable the future of AI-driven and data-powered research paradigms.
• Trace DID: If you want to fetch the newest information about DID (Difference-in-Difference), click here. Now there is a Chinese translation by Sepine Tam and StataMCP-Team 🎉
• Jupyter Lab Usage (Important: Stata 17+) here and nbstata

💡 Quickly Start

Install for all agent

If you do not want to go through complicated setup, just run the following command:

uvx stata-mcp install --all

Supported Agents 🤖

Based on our own experience and testing, we recommend using Claude Code, Codex, and OpenClaw. We have found that Claude and DeepSeek are the two best models across any framework.

Agent	Tag	Command
Claude Desktop	claude	uvx stata-mcp install -c claude
Claude Code	cc	uvx stata-mcp install -c cc
Gemini CLI	gemini	uvx stata-mcp install -c gemini
Cursor	cursor	uvx stata-mcp install -c cursor
Cline (VScode Extension)	cline	uvx stata-mcp install -c cline
Codex CLI & Codex Desktop	codex	uvx stata-mcp install -c codex
OpenCode	opencode	uvx stata-mcp install -c opencode
OpenClaw	openclaw	uvx stata-mcp install -c openclaw

If you don't have uv, visit here to install it. Or, use our beta install script (auto-installs uv if missing):

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/SepineTam/stata-mcp/master/scripts/install.sh | bash

Windows (PowerShell):

irm https://raw.githubusercontent.com/SepineTam/stata-mcp/master/scripts/install.ps1 | iex

If you don't know how to use them, try click here and download the installation scripts and double-click it in your device. install.bat for Windows users, and install.command for macOS users.

Advanced - Claude Code

As we find Claude Code is the best agent for Stata-MCP as its prefect agentic ability, we recommend using it, and there are lots of advanced usage following:

Before using it, please make sure you have ever install Claude Code, if you don't know how to install it, visit on GitHub

Generally, you can install Stata-MCP globally for one time, you can run:

claude mcp add stata-mcp --scope user -- uvx stata-mcp

Then, you do not need to watch it again.

Local and share with your partners

If you want to install it locally only for the certain workspace, you can cd to your working directory, and run:

claude mcp add stata-mcp --env STATA_MCP__CWD=$(pwd) --scope local -- uvx --directory $(pwd) stata-mcp

It would nothing happen, you can type claude and type /mcp to find the status.

Also, collaboration is an essential part of research. You can share your MCP config with your co-authors using:

claude mcp add stata-mcp --scope project -- uvx stata-mcp

In your working directory, you can find a file named .mcp.json, your mcp config will be placed here.

Then, you can use Stata-MCP in Claude Code. Here are some scenarios for using it:

• Paper Replication: Replicate empirical studies from economics papers
• Quick Hypothesis Testing: Validate economic hypotheses through regression analysis
• Stata Learning Assistant: Learn econometrics with step-by-step Stata explanations
• Code Organization: Review and optimize existing Stata do-files
• Result Interpretation: Understand complex statistical outputs and regression results

If you use Claude Code inside IDEs (either the integrated terminal or the Claude Code Extension), installing our plugin including Stata-MCP and Stata LSP maintained by @euglevi.

# Add the Stata-MCP marketplace
claude plugin marketplace add SepineTam/stata-mcp

# Install the plugin to local, project or user scope
claude plugin install stata-toolbox -s project

The language server gives AI-generated Stata code better syntax awareness and completion, which improves output quality. We package the LSP in compliance with its license and give full attribution to the original author.

Advanced - Codex

We find that many researchers are using Codex as their agent, therefore we also provide instructions for Codex users.

I figure that researchers are not using Codex CLI but Codex Desktop, so we can say it is easier to config Stata-MCP than other agents.

You just need to say Install Stata-MCP for yourself globally from https://www.statamcp.com or visit https://github.com/SepineTam/stata-mcp then restart your Codex Desktop after it say ready.

Also, if you want to install it manually, here are two ways:

A. Install in Codex Desktop GUI

1. Open your Codex Desktop APP
2. Click Settings in the bottom-left corner
3. Find MCP servers on the left side
4. Click Add server
5. Fill with the following:

   Name: stata-mcp
   Command to launch: uvx
   Arguments: stata-mcp
   

6. Click Save
7. Then, restart your Codex Desktop and enjoy it.

B. Install with Codex CLI

For CLI mode, just run the following command in your terminal

uvx stata-mcp install -c codex

Or use

codex mcp add stata-mcp -- uvx stata-mcp

Other Clients

Standard config requires: please make sure the stata is installed at the default path, and the stata cli (for macOS and Linux) exists.

The standard config json as follows, you can DIY your config via add envs.

{
  "mcpServers": {
    "stata-mcp": {
      "command": "uvx",
      "args": [
        "stata-mcp"
      ]
    }
  }
}

For more detailed usage information, visit the Usage guide.

Prerequisites

• uv - Package installer and virtual environment manager
• Claude Code, Codex, OpenClaw or other Agents
• Stata License
• Your API-KEY from LLM

If you want to check whether your device is supported, you can run:

uvx stata-mcp doctor

It displays basic information about your device and checks whether your setup is supported.

Example output

stata-mcp v1.17.0 — Doctor Report

  [PASS] os: macOS (Darwin 25.3.0, arm64)
  [PASS] python: 3.13.5
  [PASS] uv: uv 0.11.13
  [PASS] dependencies: all required packages available
  [PASS] stata_cli: /usr/local/bin/stata-mp (from env)
  [PASS] stata_execution: OK (0.1s)
  [PASS] config: /Users/sepinetam/.statamcp/config.toml (loaded)
  [PASS] working_dir: /Users/sepinetam/Documents/Github/stata-mcp (writable)
  [PASS] guard: enabled, loaded 27 rules
  [PASS] monitor: disabled (psutil available)
  [PASS] pypi: reachable (4.86s)
  [PASS] cleanup: 0 old files (0 B) found; cleanup disabled (CLEAN_LOG_DAYS=-1)

Summary: 12 passed, 0 failed, 0 warning(s), 0 skipped

Notes:

1. If you are located in China, a short uv usage document you can find here.
2. Claude is the best choice for Stata-MCP, for Chinese, I recommend to use DeepSeek as your model provider as it is cheap and powerful, also the score is highest in China provider, if you are increased in it, visit the report How to use StataMCP improve your social science research.

Comparison

There are several Stata-related MCP projects. The table below was generated by Claude Code after analyzing each codebase directly.

Feature	Stata-MCP (this)	hanlulong/stata-mcp	tmonk/mcp-stata
Agents	All	VSCode window must stay active	All
Type	MCP Server + CLI toolkit	VSCode Extension (localhost server, not standalone MCP)	Session-based MCP Server
Execution	do-file via subprocess	IDE-embedded runner via localhost :4000	pystata (Stata 17+)
Safety	Command guard + RAM monitor	—	—
Data analysis	CSV, DTA, XLSX, SPSS handlers	—	In-session describe / codebook
Logs	Text + SMCL readers	—	Built-in log reader
Graphs	—	—	Export, cache, SVG/PNG
CLI Support	Native (same tools as MCP server)	—	—
Sessions	—	—	Multi-session, background tasks
IDE plug-in	—	Native VSCode / Cursor	Stata Workbench (VS Code)
Install	uvx stata-mcp install	VS Code Marketplace	uvx or install script
Best for	Agent-driven analysis (Claude Code, Codex, OpenClaw)	Users who write and run Stata code inside VSCode themselves	Research workflows (replication, robustness, publication QA)

📝 Documentation

Stata-MCP documents visit https://docs.statamcp.com

Core Documentation

• Complete Documentation: Full documentation site with all features
• Configuration Guide: Unified TOML-based configuration system
• Security Guard: Security validation for dangerous commands
• Monitoring System: RAM monitoring and resource limits
• Architecture Overview: System design and integration patterns

Key Features

• Security Guard: Blocks dangerous commands (!, shell, erase, etc.)
• RAM Monitoring: Prevents memory exhaustion with configurable limits
• Unified Configuration: TOML config + environment variables
• Cross-platform support (macOS, Windows, Linux)
• Automatic log capture and error reporting

🐛 Report Issues

If you encounter any bugs or have feature requests, please open an issue.

📄 License

GNU Affero General Public License v3.0

📚 Citation

If you use Stata-MCP in your research, and it really helps you, you can cite this repository using one of the following formats:

BibTeX

@software{sepinetam2025stata,
  author = {Song Tan},
  title = {Stata-MCP: Let LLM help you achieve your regression analysis with Stata},
  year = {2025},
  url = {https://github.com/sepinetam/stata-mcp},
  version = {1.13.0}
}

APA

Song Tan. (2025). Stata-MCP: Let LLM help you achieve your regression analysis with Stata (Version 1.13.0) [Computer software]. https://github.com/sepinetam/stata-mcp

Chicago

Song Tan. 2025. "Stata-MCP: Let LLM help you achieve your regression analysis with Stata." Version 1.13.0. https://github.com/sepinetam/stata-mcp.

📬 Contact

Email: [e-mail]

Or contribute directly by submitting a Pull Request! We welcome contributions of all kinds, from bug fixes to new features.

❤️ Acknowledgements

The author sincerely thanks the Stata official team for their support and the Stata License for authorizing the test development.

📃 Statement

The Stata referred to in this project is the commercial software Stata developed by StataCorp LLC. This project is not affiliated with, endorsed by, or sponsored by StataCorp LLC. This project does not include the Stata software or any installation packages; users must obtain and install a validly licensed copy of Stata from StataCorp. This project is licensed under AGPL-3.0. The project maintainers accept no liability for any loss or damage arising from the use of this project or from actions related to Stata.

More information: refer to the Chinese version at cn/README.md; in case of any conflict, the Chinese version shall prevail.

✨ Star History