Once the Stata MCP server is running, configure Claude Code to connect to it:

1. Open your terminal or command palette

2. Run the following command to add the Stata MCP server:

   claude mcp add --transport http stata-mcp http://localhost:4000/mcp-streamable --scope user

   

> Older Claude Code versions (pre-2026) may not recognize --transport http. On those, use --transport sse with http://localhost:4000/mcp instead. Claude Code now treats SSE as legacy — prefer http whenever it is supported.

3. Restart your IDE

4. Claude Code will now have access to Stata tools and can help you:
- Write and execute Stata commands
- Analyze your data
- Generate visualizations
- Debug Stata code
- Create statistical reports

antigravity --install-extension DeepEcon.stata-mcp

Paste the block below into any MCP-aware assistant — Claude Code, OpenAI Codex, Cursor AI, Copilot Chat, etc. Hover the box on GitHub and click the copy icon in the top-right corner.

text
Set up the Stata MCP server for me. Endpoint: http://localhost:4000/mcp-streamable — setup guide: https://github.com/hanlulong/stata-mcp#detailed-configurations — if I already have a stata-mcp entry in my MCP config (e.g. using mcp-proxy), replace it rather than appending. When registration succeeds, tell me to restart the client so the stata_run_selection tool becomes available.

The assistant reads the guide, detects which client it is, writes the right config (or runs the right CLI command), and tells you to restart. The stata_run_selection tool becomes visible after the restart — MCP tool lists do not refresh mid-session.

Prefer manual setup? Expand Detailed Configurations below for per-client instructions.
1. Open a Stata .do file

2. Run commands using:

   - Run Selection: Select Stata code and press Ctrl+Shift+Enter (or Cmd+Shift+Enter on Mac), or click the play button in the editor toolbar

   - Run File: Press Ctrl+Shift+D (or Cmd+Shift+D on Mac) to run the entire .do file, or click the run-all button in the toolbar

   - Stop Execution: Press Ctrl+Shift+C (or Cmd+Shift+C on Mac) to stop a running command

   - Restart Session: Click the restart button in the editor toolbar or use the Command Palette ("Stata: Restart Session") to reset the Stata session. This clears all in-memory data, globals, and programs — equivalent to closing and reopening Stata

   - Interactive Mode: Click the graph button in the editor toolbar to run code in an interactive browser window

3. View output in the Stata Output panel
> Note for Cursor/Antigravity Users: Toolbar buttons may be hidden by default. To show them:

> 1. Click the ... (three dots) menu in the editor title bar

> 2. Select "Configure Icon Visibility"

> 3. Enable the Stata buttons you want to see (Run Selection, Run File, Stop, View Data, Restart Session, Interactive)
<details>

<summary><strong>Extension Settings</strong></summary>
Customize the extension behavior through VS Code settings. Access these settings via:

- VS Code/Cursor/Antigravity: File > Preferences > Settings (or Ctrl+, / Cmd+,)

- Search for "Stata MCP" to find all extension settings
If Codex doesn't see the Stata tools:

1. Verify the MCP server is running (status bar shows "Stata") — try curl -s http://localhost:4000/health

2. Check codex --version — make sure you're on 0.46.0 or newer. Older Codex versions need the mcp-proxy wrapper (see note below).

3. Verify the config file exists at ~/.codex/config.toml and contains the exact [mcp_servers.stata-mcp] block above

4. Run codex mcp list — stata-mcp should appear as registered

5. Restart Codex (CLI or IDE) after config changes

6. Check the extension output panel (View → Output → Stata) for any server-side errors

7. Ensure no port conflict (default is 4000 — change via stata-vscode.mcpServerPort if needed)
<details>

<summary>Stuck on Codex &lt; 0.46.0?</summary>
If you cannot upgrade, use mcp-proxy as a stdio wrapper around the SSE endpoint:

bash

curl -LsSf https://astral.sh/uv/install.sh | sh # macOS/Linux

toml [mcp_servers.stata-mcp] command = "uvx" args = ["mcp-proxy", "http://localhost:4000/mcp"]

</details>
<br>
</details>

<details>

<summary><strong>Cline</strong></summary>
1. Open your Cline MCP settings file:

   - macOS: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

   - Windows: %APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

   - Linux: ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
2. Add the Stata MCP server configuration:

   

json
{
"mcpServers": {
"stata-mcp": {
"url": "http://localhost:4000/mcp-streamable"
}
}
}

   Cline auto-detects the transport from the URL — no transport key needed. Point it at http://localhost:4000/mcp if you need SSE for any reason.

3. If the file already contains other MCP servers, just add the "stata-mcp" entry to the existing "mcpServers" object.
4. Save the file and restart VS Code.
You can also configure Cline through VS Code settings:

json
"cline.mcpSettings": {
"stata-mcp": {
"url": "http://localhost:4000/mcp-streamable"
}
}

If Cline is not recognizing the Stata MCP server:

1. Verify the MCP server is running (Status bar should show "Stata")

2. Check that the configuration file exists with the correct content

3. Try restarting VS Code

4. Check the extension output panel (View > Output > Stata MCP) for any errors

<br>
</details>

<details>

<summary><strong>Cursor</strong></summary>
The extension automatically configures Cursor MCP integration. To verify it's working:
1. Open Cursor

2. Press Ctrl+Shift+P (or Cmd+Shift+P on Mac) to open the Command Palette

3. Type "Stata: Test MCP Server Connection" and press Enter

4. You should see a success message if the server is properly connected
Cursor reads user-level MCP config from:
- macOS / Linux: ~/.cursor/mcp.json

- Windows: %USERPROFILE%\.cursor\mcp.json
Workspace-level config (overrides user-level for that project) goes in .cursor/mcp.json at the workspace root.
If you need to manually configure Cursor MCP:
1. Create or edit the MCP configuration file:

   - macOS/Linux: ~/.cursor/mcp.json

   - Windows: %USERPROFILE%\.cursor\mcp.json
2. Add the Stata MCP server configuration:

   

json
{
"mcpServers": {
"stata-mcp": {
"url": "http://localhost:4000/mcp-streamable"
}
}
}

   Cursor auto-detects the transport from the URL — no transport key needed. It tries Streamable HTTP first and falls back to SSE if the server advertises it.

3. If the file already contains other MCP servers, just add the "stata-mcp" entry to the existing "mcpServers" object.
4. Save the file and restart Cursor.
If Cursor is not recognizing the Stata MCP server:

1. Verify the MCP server is running

2. Check that the configuration file exists with the correct content

3. Try restarting Cursor

4. Ensure there are no port conflicts with other running applications
<br>
</details>

<details>

<summary><strong>Python Environment Management</strong></summary>
This extension uses uv, a fast Python package installer built in Rust, to manage Python dependencies. Key features:
- Automatic Python setup and dependency management

- Creates isolated environments that won't conflict with your system

- Works across Windows, macOS, and Linux

- 10-100x faster than traditional pip installations
If you encounter any UV-related errors during installation:

1. Install UV manually:

   

bash