From the command line

# VS Code
code --install-extension DeepEcon.stata-mcp

# Cursor
cursor --install-extension DeepEcon.stata-mcp

# Antigravity (installs from Open VSX Registry)
antigravity --install-extension DeepEcon.stata-mcp

From a local .vsix file

Download stata-mcp-<version>.vsix from the releases page, then either:

code        --install-extension path/to/stata-mcp-0.5.2.vsix
cursor      --install-extension path/to/stata-mcp-0.5.2.vsix
antigravity --install-extension path/to/stata-mcp-0.5.2.vsix

…or in the UI: Extensions view → … menu → Install from VSIX… → pick the downloaded file.

Registries

• VS Code Marketplace: https://marketplace.visualstudio.com/items?itemName=DeepEcon.stata-mcp
• Open VSX (Cursor / Antigravity): https://open-vsx.org/extension/DeepEcon/stata-mcp

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

Core Settings

Server Settings

Graph Settings

Log File Settings

Advanced Settings

Working Directory Settings

Control which directory Stata uses when running .do files:

Example: If your project structure is project/code/analysis.do and your do-file expects to run from project/, set workingDirectory to parent.

MCP Output Settings

These settings control how Stata output is returned to AI assistants (LLMs) via the MCP protocol, helping to reduce token usage:

Compact mode filters:

• Loop code echoes (foreach/forvalues/while blocks) - keeps actual output only
• Program definitions and Mata blocks
• Command echoes and line continuations (for run_file only)
• Verbose messages like "(N real changes made)" and "(N missing values generated)"

Multi-Session Settings

Enable parallel Stata execution with isolated sessions. Each session has its own data, variables, and macros.

Note: Each session requires ~200-300 MB RAM for Stata. Check your Stata license for concurrent instance limits.

GitHub Copilot supports MCP (Model Context Protocol) starting from VS Code 1.102. You can connect the Stata MCP server to Copilot for AI-powered Stata development.

Configuration

1. Install the Stata MCP extension in VS Code (see Installation section above)

2. Start the Stata MCP server: The server should start automatically when you open VS Code with the extension installed. Verify it's running by checking the status bar (should show "Stata").

3. Add the Stata MCP server to Copilot: You can configure MCP servers either per-workspace or globally.

   Option A: Per-Workspace Configuration

   Create a .vscode/mcp.json file in your workspace root:

   {
     "servers": {
       "stata-mcp": {
         "type": "http",
         "url": "http://localhost:4000/mcp-streamable"
       }
     }
   }
   

   Option B: Global Configuration (All Workspaces)

   1. Open Command Palette (Ctrl+Shift+P / Cmd+Shift+P)
   2. Type "MCP: Open User Configuration" and select it
   3. Add the Stata MCP server to the mcp.json file:

      {
        "servers": {
          "stata-mcp": {
            "type": "http",
            "url": "http://localhost:4000/mcp-streamable"
          }
        }
      }
      

   On older VS Code versions without Streamable HTTP support, use "type": "sse" with http://localhost:4000/mcp instead.

   The user-level mcp.json file is located at:

   • Windows: %APPDATA%\Code\User\mcp.json
   • macOS: ~/Library/Application Support/Code/User/mcp.json
   • Linux: ~/.config/Code/User/mcp.json

4. Reload VS Code to apply the configuration.

5. GitHub Copilot 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

Verifying the Connection

1. Open GitHub Copilot Chat (Ctrl+Shift+I / Cmd+Shift+I)
2. Type @mcp to see available MCP tools
3. The Stata tools (stata_run_selection, stata_run_file) should appear

Troubleshooting

If Copilot is not recognizing the Stata MCP server:

1. Verify VS Code version 1.102 or later
2. Verify the MCP server is running (Status bar should show "Stata")
3. Check that .vscode/mcp.json exists with the correct content
4. Try restarting VS Code
5. Check the extension output panel (View > Output > Stata MCP) for any errors
6. Ensure MCP is enabled in your organization's Copilot policy (if applicable)

Claude Code is Anthropic's official AI coding assistant available in VS Code, Cursor, and Antigravity. Follow these steps to configure the Stata MCP server:

Installation

1. Install the Stata MCP extension in VS Code, Cursor, or Antigravity (see Installation section above)

2. Start the Stata MCP server: The server should start automatically when you open your IDE with the extension installed. Verify it's running by checking the status bar (should show "Stata").

Configuration

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

Verifying the Connection

To verify Claude Code is properly connected to the Stata MCP server:

1. Open a Stata .do file or create a new one
2. Ask Claude Code to help with a Stata task (e.g., "Load the auto dataset and show summary statistics")
3. Claude Code should be able to execute Stata commands and show results

Troubleshooting

If Claude Code is not recognizing the Stata MCP server:

1. Verify the MCP server is running (Status bar should show "Stata")
2. Check that you ran the claude mcp add command with the correct URL
3. Try restarting your IDE
4. Check the extension output panel (View > Output > Stata MCP) for any errors
5. Ensure there are no port conflicts (default port is 4000)

Claude Desktop connects to remote MCP servers like the one this extension exposes. Make sure the Stata MCP extension is installed and its status bar shows "Stata" before configuring Claude Desktop.

Option A (recommended): add as a Custom Connector

1. Open Claude Desktop → Settings → Connectors → Add custom connector
2. Name: Stata MCP
3. URL: http://localhost:4000/mcp-streamable
4. Save and restart Claude Desktop

No wrapper, no config file editing, no Python/Node install required. This is Anthropic's current recommended way to add remote MCP servers to Claude Desktop.

Option B: JSON config with a stdio wrapper (if you prefer editing claude_desktop_config.json)

Anthropic's JSON config doesn't yet accept remote URLs directly — you still need a local stdio wrapper. The easiest is mcp-remote, which is zero-install if you have Node:

1. Open the config file:

   • macOS: ~/Library/Application Support/Claude Desktop/claude_desktop_config.json
   • Windows: %APPDATA%\Claude Desktop\claude_desktop_config.json

2. Add this block (merge with any existing mcpServers object):

   {
     "mcpServers": {
       "stata-mcp": {
         "command": "npx",
         "args": ["-y", "mcp-remote", "http://localhost:4000/mcp-streamable"]
       }
     }
   }
   

3. Restart Claude Desktop. The Stata tools will appear in the available-tools list.

You can use this extension with OpenAI Codex — the CLI and every IDE extension share the same ~/.codex/config.toml. Codex CLI 0.46.0+ (October 2025) supports MCP servers over HTTP natively, so no wrapper is needed. Either drive it from the command line:

codex mcp add stata-mcp --url http://localhost:4000/mcp-streamable

Or append this block manually to ~/.codex/config.toml (or %USERPROFILE%\.codex\config.toml on Windows):

[mcp_servers.stata-mcp]
url = "http://localhost:4000/mcp-streamable"

Upgrading from an older setup? If an existing [mcp_servers.stata-mcp] block uses command = "mcp-proxy" (or command = "uvx" + mcp-proxy in args), delete that block before adding the one above — TOML forbids duplicate keys, and Codex will silently skip the server if both are present.

Then restart Codex — the stata_run_selection and stata_run_file tools will appear. Run codex mcp list to confirm the server is registered.

Note on transports. Codex only speaks MCP's Streamable HTTP transport (single endpoint at /mcp-streamable). The extension's legacy SSE endpoint (/mcp) is for older clients like GitHub Copilot — don't point Codex at it.

Troubleshooting Codex Configuration

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)

# Install uv first if needed:
curl -LsSf https://astral.sh/uv/install.sh | sh   # macOS/Linux
# Windows: powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

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

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:

   {
     "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:

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

Troubleshooting Cline Configuration

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

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 Configuration File Paths

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.

Manual Cursor Configuration

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:

   {
     "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.

Troubleshooting Cursor Configuration

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

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:

   # Windows (PowerShell as Administrator)
   powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
   
   # macOS/Linux
   curl -LsSf https://astral.sh/uv/install.sh | sh
   

2. Follow the clean-reinstall steps in the troubleshooting guide to reinstall the extension.