Stata MCP

🚀 Stata-MCP

Stata-MCP allows LLM to assist you in conducting regression analysis with Stata, enhancing your efficiency and experience in data analysis.

Looking for other related projects?

• Trace DID: If you want to fetch the latest 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
• NBER-MCP & AER-MCP 🔧 under construction
• Econometrics-Agent
• TexIV: A machine learning-driven framework that transforms text data into usable variables for empirical research using advanced NLP and ML techniques
• A VScode or Cursor integrated here. Confused about it? 💡 Difference

🚀 Quick Start

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

The standard config JSON is as follows. You can customize your config by adding environments.

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

For more detailed usage information, visit the Usage guide.

For some advanced usage, visit the Advanced guide

Prerequisites

• uv - Package installer and virtual environment manager
• Claude, Cline, ChatWise, or other LLM services
• Stata License
• Your API-KEY from the LLM

📦 Installation

For the new version, you don't need to install the stata-mcp package again. You can use the following commands to check whether your computer can use Stata-MCP.

uvx stata-mcp --usable
uvx stata-mcp --version

If you want to use it locally, you can install it via pip or download the source code.

Download via pip

pip install stata-mcp

Download source code and compile

git clone https://github.com/sepinetam/stata-mcp.git
cd stata-mcp

uv build

Then you can find the compiled stata-mcp binary in the dist directory. You can use it directly or add it to your PATH.

For example:

uvx /path/to/your/whl/stata_mcp-1.6.1-py3-non-any.whl  # here is the wheel file name, you can change it to your version

📚 Documentation

• For more detailed usage information, visit the Usage guide.
• For advanced usage, visit the Advanced guide
• For some common questions, visit the Questions guide
• To understand the difference with Stata-MCP@hanlulong, visit the Difference guide

💻 Usage Examples

Basic Usage

The basic usage is to follow the standard configuration and run the commands as described in the Quick Start section. For example, to check the usability and version:

uvx stata-mcp --usable
uvx stata-mcp --version

Advanced Usage

For advanced usage, you can refer to the Advanced guide. For example, customizing the configuration JSON to meet specific requirements.

💡 Questions

• Cherry Studio 32000 wrong
• Cherry Studio 32000 error
• Windows Support
• Network Errors When Running Stata-MCP

🚀 Roadmap

• [x] macOS support
• [x] Windows support
• [ ] Additional LLM integrations
• [ ] Performance optimizations

⚠️ Important Note

This project is for research purposes only. The author is not responsible for any damage caused by this project. Please ensure you have proper licensing to use Stata.

For more information, refer to the Statement.

🐛 Report Issues

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

📄 License

Apache License 2.0

📚 Citation

If you use Stata-MCP in your research, please 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.6.1}
}

APA

Song Tan. (2025). Stata-MCP: Let LLM help you achieve your regression analysis with Stata (Version 1.6.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.6.0. https://github.com/sepinetam/stata-mcp.

📬 Contact

Email: sepinetam@gmail.com

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.

✨ Star History