mcp-stata 1.2.2__py3-none-any.whl → 1.6.8__py3-none-any.whl

mcp_stata-1.6.8.dist-info/METADATA

@@ -0,0 +1,388 @@
+Metadata-Version: 2.4
+Name: mcp-stata
+Version: 1.6.8
+Summary:  A lightweight Model Context Protocol (MCP) server for Stata. Execute commands, inspect data, retrieve stored results (`r()`/`e()`), and view graphs in your chat interface. Built for economists who want to integrate LLM assistance into their Stata workflow. 
+Project-URL: Homepage, https://github.com/tmonk/mcp-stata
+Project-URL: Repository, https://github.com/tmonk/mcp-stata
+Project-URL: Issues, https://github.com/tmonk/mcp-stata/issues
+Author-email: Thomas Monk <t.d.monk@lse.ac.uk>
+License-Expression: AGPL-3.0-or-later
+License-File: LICENSE
+Keywords: ai,econometrics,llm,mcp,stata,statistics
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Scientific/Engineering :: Information Analysis
+Requires-Python: >=3.12
+Requires-Dist: httpx<0.28.0,>=0.27.0
+Requires-Dist: mcp[cli]>=1.0.0
+Requires-Dist: pandas>=2.0.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: pystata>=0.0.1
+Requires-Dist: pytest-asyncio>=1.3.0
+Requires-Dist: stata-setup>=0.1.0
+Provides-Extra: dev
+Requires-Dist: build>=1.3.0; extra == 'dev'
+Requires-Dist: hatch>=1.16.2; extra == 'dev'
+Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.4.0; extra == 'dev'
+Requires-Dist: twine>=6.2.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Stata MCP Server
+
+<a href="https://cursor.com/en-US/install-mcp?name=mcp-stata&config=eyJjb21tYW5kIjoidXZ4IC0tZnJvbSBtY3Atc3RhdGEgbWNwLXN0YXRhIn0%3D"><img src="https://cursor.com/deeplink/mcp-install-dark.svg" alt="Install MCP Server" height="20"></a>&nbsp;
+<a href="https://pypi.org/project/mcp-stata/"><img src="https://img.shields.io/pypi/v/mcp-stata?style=flat&color=black" alt="PyPI - Version" height="20"></a>
+
+A [Model Context Protocol](https://github.com/modelcontextprotocol) (MCP) server that connects AI agents to a local Stata installation.
+
+> 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: [<img src="https://raw.githubusercontent.com/tmonk/stata-workbench/refs/heads/main/img/icon.png" height="12px"> Stata Workbench](https://github.com/tmonk/stata-workbench/).
+
+Built by <a href="https://tdmonk.com">Thomas Monk</a>, London School of Economics.
+<!-- mcp-name: io.github.tmonk/mcp-stata -->
+
+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.
+
+## Prerequisites
+
+- **Stata 17+** (required for `pystata` integration)
+- **Python 3.12+** (required)
+- **uv** (recommended for install/run)
+
+## Installation
+
+### Run as a published tool with `uvx`
+
+```bash
+uvx --refresh --from mcp-stata@latest mcp-stata
+```
+
+`uvx` is an alias for `uv tool run` and runs the tool in an isolated, cached environment.
+
+## Configuration
+
+This server attempts to automatically discover your Stata installation (supporting standard paths and StataNow).
+
+If auto-discovery fails, set the `STATA_PATH` environment variable to your Stata executable:
+
+```bash
+# macOS example
+export STATA_PATH="/Applications/StataNow/StataMP.app/Contents/MacOS/stata-mp"
+
+# Windows example (cmd.exe)
+set STATA_PATH="C:\Program Files\Stata18\StataMP-64.exe"
+```
+
+If you prefer, add `STATA_PATH` to your MCP config's `env` for any IDE shown below. It's optional and only needed when discovery cannot find Stata.
+
+Optional `env` example (add inside your MCP server entry):
+
+```json
+"env": {
+  "STATA_PATH": "/Applications/StataNow/StataMP.app/Contents/MacOS/stata-mp"
+}
+```
+
+## IDE Setup (MCP)
+
+This MCP server uses the **stdio** transport (the IDE launches the process and communicates over stdin/stdout).
+
+---
+
+### Claude Desktop
+
+Open Claude Desktop → **Settings** → **Developer** → **Edit Config**.
+Config file locations include:
+
+* macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
+* Windows: `%APPDATA%\Claude\claude_desktop_config.json`
+
+#### Published tool (uvx)
+
+```json
+{
+  "mcpServers": {
+    "mcp-stata": {
+      "command": "uvx",
+        "args": [
+        "--refresh",
+        "--from",
+        "mcp-stata@latest",
+        "mcp-stata"
+      ]
+    }
+  }
+}
+```
+
+After editing, fully quit and restart Claude Desktop to reload MCP servers.
+
+---
+
+### Cursor
+
+Cursor supports MCP config at:
+
+* Global: `~/.cursor/mcp.json`
+* Project: `.cursor/mcp.json`
+
+#### Published tool (uvx)
+
+```json
+{
+  "mcpServers": {
+    "mcp-stata": {
+      "command": "uvx",
+       "args": [
+        "--refresh",
+        "--from",
+        "mcp-stata@latest",
+        "mcp-stata"
+      ]
+    }
+  }
+}
+```
+
+---
+
+### Windsurf
+
+Windsurf supports MCP plugins and also allows manual editing of `mcp_config.json`. After adding/editing a server, use the UI’s refresh so it re-reads the config.
+
+A common location is `~/.codeium/windsurf/mcp_config.json`.
+#### Published tool (uvx)
+
+```json
+{
+  "mcpServers": {
+    "mcp-stata": {
+      "command": "uvx",
+        "args": [
+        "--refresh",
+        "--from",
+        "mcp-stata@latest",
+        "mcp-stata"
+      ]
+    }
+  }
+}
+```
+
+---
+
+### Google Antigravity
+
+In Antigravity, MCP servers are managed from the MCP store/menu; you can open **Manage MCP Servers** and then **View raw config** to edit `mcp_config.json`.
+
+#### Published tool (uvx)
+
+```json
+{
+  "mcpServers": {
+    "mcp-stata": {
+      "command": "uvx",
+        "args": [
+        "--refresh",
+        "--from",
+        "mcp-stata@latest",
+        "mcp-stata"
+      ]
+    }
+  }
+}
+```
+
+---
+
+### Visual Studio Code
+
+VS Code supports MCP servers via a `.vscode/mcp.json` file. The top-level key is **`servers`** (not `mcpServers`).
+
+Create `.vscode/mcp.json`:
+
+#### Published tool (uvx)
+
+```json
+{
+  "servers": {
+    "mcp-stata": {
+      "type": "stdio",
+      "command": "uvx",
+      "args": [
+        "--refresh",
+        "--from",
+        "mcp-stata@latest",
+        "mcp-stata"
+      ]
+    }
+  }
+}
+```
+
+VS Code documents `.vscode/mcp.json` and the `servers` schema, including `type` and `command`/`args`.
+
+---
+
+## Skills
+
+- Skill file (for Claude/Codex): [skill/SKILL.md](skill/SKILL.md)
+
+## Tools Available (from server.py)
+
+* `run_command(code, echo=True, as_json=True, trace=False, raw=False, max_output_lines=None)`: Execute Stata syntax.
+  - Always writes output to a temporary log file and emits a single `notifications/logMessage` containing `{"event":"log_path","path":"..."}` so the client can tail it locally.
+  - May emit `notifications/progress` when the client provides a progress token/callback.
+* `read_log(path, offset=0, max_bytes=65536)`: Read a slice of a previously-provided log file (JSON: `path`, `offset`, `next_offset`, `data`).
+* `load_data(source, clear=True, as_json=True, raw=False, max_output_lines=None)`: Heuristic loader (sysuse/webuse/use/path/URL) with JSON envelope unless `raw=True`. Supports output truncation.
+* `get_data(start=0, count=50)`: View dataset rows (JSON response, capped to 500 rows).
+* `get_ui_channel()`: Return a short-lived localhost HTTP endpoint + bearer token for the UI-only data browser.
+* `describe()`: View dataset structure via Stata `describe`.
+* `list_graphs()`: See available graphs in memory (JSON list with an `active` flag).
+* `export_graph(graph_name=None, format="pdf")`: Export a graph to a file path (default PDF; use `format="png"` for PNG).
+* `export_graphs_all()`: Export all in-memory graphs. Returns file paths by default.
+* `get_help(topic, plain_text=False)`: Markdown-rendered Stata help by default; `plain_text=True` strips formatting.
+* `codebook(variable, as_json=True, trace=False, raw=False, max_output_lines=None)`: Variable-level metadata (JSON envelope by default; supports `trace=True` and output truncation).
+* `run_do_file(path, echo=True, as_json=True, trace=False, raw=False, max_output_lines=None)`: Execute a .do file.
+  - Always writes output to a temporary log file and emits a single `notifications/logMessage` containing `{"event":"log_path","path":"..."}` so the client can tail it locally.
+  - Emits incremental `notifications/progress` when the client provides a progress token/callback.
+* `get_stored_results()`: Get `r()` and `e()` scalars/macros as JSON.
+* `get_variable_list()`: JSON list of variables and labels.
+
+### Cancellation
+
+- Clients may cancel an in-flight request by sending the MCP notification `notifications/cancelled` with `params.requestId` set to the original tool call ID.
+- Client guidance:
+  1. Pass a `_meta.progressToken` when invoking the tool if you want progress updates (optional).
+  2. If you need to cancel, send `notifications/cancelled` with the same requestId. You may also stop tailing the log file path once you receive cancellation confirmation (the tool call will return an error indicating cancellation).
+  3. Be prepared for partial output in the log file; cancellation is best-effort and depends on Stata surfacing `BreakError`.
+
+Resources exposed for MCP clients:
+
+* `stata://data/summary` → `summarize`
+* `stata://data/metadata` → `describe`
+* `stata://graphs/list` → graph list (resource handler delegates to `list_graphs` tool)
+* `stata://variables/list` → variable list (resource wrapper)
+* `stata://results/stored` → stored r()/e() results
+
+## UI-only Data Browser (Local HTTP API)
+
+This server also hosts a **localhost-only HTTP API** intended for a VS Code extension UI to browse data at high volume (paging, filtering) without sending large payloads over MCP.
+
+Important properties:
+
+- **Loopback only**: binds to `127.0.0.1`.
+- **Bearer auth**: every request requires an `Authorization: Bearer <token>` header.
+- **Short-lived tokens**: clients should call `get_ui_channel()` to obtain a fresh token as needed.
+- **No Stata dataset mutation** for browsing/filtering:
+  - No generated variables.
+  - Paging uses `sfi.Data.get`.
+  - Filtering is evaluated in Python over chunked reads.
+
+### Discovery via MCP (`get_ui_channel`)
+
+Call the MCP tool `get_ui_channel()` and parse the JSON:
+
+```json
+{
+  "baseUrl": "http://127.0.0.1:53741",
+  "token": "...",
+  "expiresAt": 1730000000,
+  "capabilities": {
+    "dataBrowser": true,
+    "filtering": true
+  }
+}
+```
+
+Server-enforced limits (current defaults):
+
+- **maxLimit**: 500
+- **maxVars**: 200
+- **maxChars**: 500
+- **maxRequestBytes**: 1,000,000
+
+### Endpoints
+
+All endpoints are under `baseUrl` and require the bearer token.
+
+- `GET /v1/dataset`
+  - Returns dataset identity and basic state (`id`, `frame`, `n`, `k`).
+- `GET /v1/vars`
+  - Returns variable metadata (`name`, `type`, `label`, `format`).
+- `POST /v1/page`
+  - Returns a page of data for selected variables.
+- `POST /v1/views`
+  - Creates a server-side filtered view (handle-based filtering).
+- `POST /v1/views/:viewId/page`
+  - Pages within a filtered view.
+- `DELETE /v1/views/:viewId`
+  - Deletes a view handle.
+- `POST /v1/filters/validate`
+  - Validates a filter expression.
+
+### Paging request example
+
+```bash
+curl -sS \
+  -H "Authorization: Bearer $TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{"datasetId":"...","frame":"default","offset":0,"limit":50,"vars":["price","mpg"],"includeObsNo":true,"maxChars":200}' \
+  "$BASE_URL/v1/page"
+```
+
+Notes:
+
+- `datasetId` is used for cache invalidation. If the dataset changes due to running Stata commands, the server will report a new dataset id and view handles become invalid.
+- Filter expressions are evaluated in Python using values read from Stata via `sfi.Data.get`. Use boolean operators like `==`, `!=`, `<`, `>`, and `and`/`or` (Stata-style `&`/`|` are also accepted).
+
+## License
+
+This project is licensed under the GNU Affero General Public License v3.0 or later.
+See the LICENSE file for the full text.
+
+## Error reporting
+
+- All tools that execute Stata commands support JSON envelopes (`as_json=true`) carrying:
+  - `rc` (from r()/c(rc)), `stdout`, `stderr`, `message`, optional `line` (when Stata reports it), `command`, optional `log_path` (for log-file streaming), and a `snippet` excerpt of error output.
+- Stata-specific cues are preserved:
+  - `r(XXX)` codes are parsed when present in output.
+  - “Red text” is captured via stderr where available.
+  - `trace=true` adds `set trace on` around the command/do-file to surface program-defined errors; the trace is turned off afterward.
+
+## Logging
+
+Set `MCP_STATA_LOGLEVEL` (e.g., `DEBUG`, `INFO`) to control server logging. Logs include discovery details (edition/path) and command-init traces for easier troubleshooting.
+
+## Development & Contributing
+
+For detailed information on building, testing, and contributing to this project, see [CONTRIBUTING.md](CONTRIBUTING.md).
+
+Quick setup:
+
+```bash
+# Install dependencies
+uv sync --extra dev --no-install-project
+
+# Run tests (requires Stata)
+pytest
+
+# Run tests without Stata
+pytest -v -m "not requires_stata"
+
+# Build the package
+python -m build
+```
+
+[![MCP Badge](https://lobehub.com/badge/mcp/tmonk-mcp-stata)](https://lobehub.com/mcp/tmonk-mcp-stata)
+[![Tests](https://github.com/tmonk/mcp-stata/actions/workflows/build-test.yml/badge.svg)](https://github.com/tmonk/mcp-stata/actions/workflows/build-test.yml)

mcp_stata-1.6.8.dist-info/RECORD

@@ -0,0 +1,14 @@
+mcp_stata/__init__.py,sha256=kJKKRn7lGuVCuS2-GaN5VoVcvnxtNlfuswW_VOlYqwg,98
+mcp_stata/discovery.py,sha256=J_XU1_AXRpqWg_ULV8xf4lT6RRN8MxOdpr1ioTi5TjQ,12951
+mcp_stata/graph_detector.py,sha256=-dJIU1Dq_c1eQSk4eegUi0gU2N-tFqjFGM0tE1E32KM,16066
+mcp_stata/models.py,sha256=QETpYKO3yILy_L6mhouVEanvUIvu4ww_CAAFuiP2YdM,1201
+mcp_stata/server.py,sha256=PV8ragGMeHT72zgVx5DJp3vt8CPqT8iwdvJ8GXSctds,15989
+mcp_stata/stata_client.py,sha256=TNJnlkZ0IoNoVXhKUw0_IYLiRNOwyL2wVmb1gWdiRUY,95981
+mcp_stata/streaming_io.py,sha256=GVaXgTtxx8YLY6RWqdTcO2M3QSqxLsefqkmnlNO1nTI,6974
+mcp_stata/ui_http.py,sha256=kkPYpqp-lQDXs_9qcs7hb16FtvNcag3rKSH7wvQX7Qo,22013
+mcp_stata/smcl/smcl2html.py,sha256=wi91mOMeV9MCmHtNr0toihNbaiDCNZ_NP6a6xEAzWLM,2624
+mcp_stata-1.6.8.dist-info/METADATA,sha256=V5mN_9vRL5f1aja0zrhMatBKb-_ZC6Ok3uOXfRBfYw4,13794
+mcp_stata-1.6.8.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+mcp_stata-1.6.8.dist-info/entry_points.txt,sha256=TcOgrtiTL4LGFEDb1pCrQWA-fUZvIujDOvQ-bWFh5Z8,52
+mcp_stata-1.6.8.dist-info/licenses/LICENSE,sha256=DZak_2itbUtvHzD3E7GNUYSRK6jdOJ-GqncQ2weavLA,34523
+mcp_stata-1.6.8.dist-info/RECORD,,

mcp_stata-1.2.2.dist-info/METADATA

@@ -1,240 +0,0 @@
-Metadata-Version: 2.4
-Name: mcp-stata
-Version: 1.2.2
-Summary:  A lightweight Model Context Protocol (MCP) server for Stata. Execute commands, inspect data, retrieve stored results (`r()`/`e()`), and view graphs in your chat interface. Built for economists who want to integrate LLM assistance into their Stata workflow. 
-Project-URL: Homepage, https://github.com/tmonk/mcp-stata
-Project-URL: Repository, https://github.com/tmonk/mcp-stata
-Project-URL: Issues, https://github.com/tmonk/mcp-stata/issues
-Author-email: Thomas Monk <t.d.monk@lse.ac.uk>
-License-Expression: AGPL-3.0-or-later
-License-File: LICENSE
-Keywords: ai,econometrics,llm,mcp,stata,statistics
-Classifier: Development Status :: 4 - Beta
-Classifier: Intended Audience :: Developers
-Classifier: Intended Audience :: Science/Research
-Classifier: License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Topic :: Scientific/Engineering :: Information Analysis
-Requires-Python: >=3.11
-Requires-Dist: mcp[cli]>=1.0.0
-Requires-Dist: pandas>=2.0.0
-Requires-Dist: pydantic>=2.0.0
-Requires-Dist: pystata>=0.0.1
-Requires-Dist: stata-setup>=0.1.0
-Provides-Extra: dev
-Requires-Dist: build>=1.3.0; extra == 'dev'
-Requires-Dist: hatch>=1.16.2; extra == 'dev'
-Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
-Requires-Dist: pytest>=7.0.0; extra == 'dev'
-Requires-Dist: ruff>=0.4.0; extra == 'dev'
-Requires-Dist: twine>=6.2.0; extra == 'dev'
-Description-Content-Type: text/markdown
-
-# Stata MCP Server
-
-[![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en-US/install-mcp?name=mcp-stata&config=eyJjb21tYW5kIjoidXZ4IC0tZnJvbSBtY3Atc3RhdGEgbWNwLXN0YXRhIn0%3D)
-
-A [Model Context Protocol](https://github.com/modelcontextprotocol) (MCP) server that connects AI assistants to a local Stata installation.
-
-Built by <a href="https://tdmonk.com">Thomas Monk</a>, London School of Economics.
-<!-- mcp-name: io.github.tmonk/mcp-stata -->
-
-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).
-- **Verify results**: programmatically check stored results (`r()`, `e()`) for accurate validation.
-
-## Prerequisites
-
-- **Stata 17+** (required for `pystata` integration)
-- **Python 3.11+** (recommended)
-- **uv** (recommended for install/run)
-
-## Installation
-
-### Run as a published tool with `uvx`
-
-```bash
-uvx --from mcp-stata mcp-stata
-```
-
-`uvx` is an alias for `uv tool run` and runs the tool in an isolated, cached environment.
-
-## Configuration
-
-This server attempts to automatically discover your Stata installation (supporting standard paths and StataNow).
-
-If auto-discovery fails, set the `STATA_PATH` environment variable to your Stata executable:
-
-```bash
-# macOS example
-export STATA_PATH="/Applications/StataNow/StataMP.app/Contents/MacOS/stata-mp"
-
-# Windows example (cmd.exe)
-set STATA_PATH="C:\Program Files\Stata18\StataMP-64.exe"
-```
-
-If you prefer, add `STATA_PATH` to your MCP config's `env` for any IDE shown below. It's optional and only needed when discovery cannot find Stata.
-
-Optional `env` example (add inside your MCP server entry):
-
-```json
-"env": {
-  "STATA_PATH": "/Applications/StataNow/StataMP.app/Contents/MacOS/stata-mp"
-}
-```
-
-## IDE Setup (MCP)
-
-This MCP server uses the **stdio** transport (the IDE launches the process and communicates over stdin/stdout).
-
----
-
-### Claude Desktop
-
-Open Claude Desktop → **Settings** → **Developer** → **Edit Config**.
-Config file locations include:
-
-* macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
-* Windows: `%APPDATA%\Claude\claude_desktop_config.json`
-
-#### Published tool (uvx)
-
-```json
-{
-  "mcpServers": {
-    "mcp-stata": {
-      "command": "uvx",
-        "args": ["--from", "mcp-stata", "mcp-stata"]
-    }
-  }
-}
-```
-
-After editing, fully quit and restart Claude Desktop to reload MCP servers.
-
----
-
-### Cursor
-
-Cursor supports MCP config at:
-
-* Global: `~/.cursor/mcp.json`
-* Project: `.cursor/mcp.json`
-
-#### Published tool (uvx)
-
-```json
-{
-  "mcpServers": {
-    "mcp-stata": {
-      "command": "uvx",
-        "args": ["--from", "mcp-stata", "mcp-stata"]
-    }
-  }
-}
-```
-
----
-
-### Windsurf
-
-Windsurf supports MCP plugins and also allows manual editing of `mcp_config.json`. After adding/editing a server, use the UI’s refresh so it re-reads the config.
-
-A common location is `~/.codeium/windsurf/mcp_config.json`.
-#### Published tool (uvx)
-
-```json
-{
-  "mcpServers": {
-    "mcp-stata": {
-      "command": "uvx",
-        "args": ["--from", "mcp-stata", "mcp-stata"]
-    }
-  }
-}
-```
-
----
-
-### Google Antigravity
-
-In Antigravity, MCP servers are managed from the MCP store/menu; you can open **Manage MCP Servers** and then **View raw config** to edit `mcp_config.json`.
-
-#### Published tool (uvx)
-
-```json
-{
-  "mcpServers": {
-    "mcp-stata": {
-      "command": "uvx",
-        "args": ["--from", "mcp-stata", "mcp-stata"]
-    }
-  }
-}
-```
-
----
-
-### Visual Studio Code
-
-VS Code supports MCP servers via a `.vscode/mcp.json` file. The top-level key is **`servers`** (not `mcpServers`).
-
-Create `.vscode/mcp.json`:
-
-#### Published tool (uvx)
-
-```json
-{
-  "servers": {
-    "mcp-stata": {
-      "type": "stdio",
-      "command": "uvx",
-      "args": ["--from", "mcp-stata", "mcp-stata"],
-    }
-  }
-}
-```
-
-VS Code documents `.vscode/mcp.json` and the `servers` schema, including `type` and `command`/`args`.
-
----
-
-## Skills
-
-- Skill file (for Claude/Codex): [skill/SKILL.md](skill/SKILL.md)
-
-## Tools Available
-
-* `run_command(code, raw=false)`: Execute Stata syntax. Returns a structured JSON envelope by default; set `raw=true` for plain stdout/stderr. `trace=true` temporarily enables `set trace on`.
-* `load_data(source, clear=True, raw=false)`: Heuristic loader (sysuse/webuse/use/path/URL) with JSON envelope.
-* `get_data(start, count)`: View dataset rows (JSON response, capped to 500 rows).
-* `describe()`: View dataset structure.
-* `codebook(variable, raw=false)`: Variable-level metadata (JSON envelope by default).
-* `run_do_file(path, trace=false, raw=false)`: Execute a .do file with rich error capture (JSON by default).
-* `export_graph(name, format="pdf")`: Export a graph to a file path (default PDF; use `format="png"` for PNG).
-* `export_graphs_all()`: Export all in-memory graphs as base64-encoded PNGs (JSON response).
-* `list_graphs()`: See available graphs in memory (JSON list with an `active` flag).
-* `get_stored_results()`: Get `r()` and `e()` scalars/macros.
-* `get_help(topic, plain_text=false)`: Returns Markdown-rendered Stata help (default). Use `plain_text=true` for stripped text. Falls back to the Stata online help URL if missing.
-* `get_variable_list()`: JSON list of variables and labels.
-
-## License
-
-This project is licensed under the GNU Affero General Public License v3.0 or later.
-See the LICENSE file for the full text.
-
-## Error reporting
-
-- All tools that execute Stata commands support JSON envelopes (`as_json=true`) carrying:
-  - `rc` (from r()/c(rc)), `stdout`, `stderr`, `message`, optional `line` (when Stata reports it), `command`, and a `snippet` excerpt of error output.
-- Stata-specific cues are preserved:
-  - `r(XXX)` codes are parsed when present in output.
-  - “Red text” is captured via stderr where available.
-  - `trace=true` adds `set trace on` around the command/do-file to surface program-defined errors; the trace is turned off afterward.
-
-## Logging
-
-Set `STATA_MCP_LOGLEVEL` (e.g., `DEBUG`, `INFO`) to control server logging. Logs include discovery details (edition/path) and command-init traces for easier troubleshooting.

mcp_stata-1.2.2.dist-info/RECORD

@@ -1,11 +0,0 @@
-mcp_stata/__init__.py,sha256=kJKKRn7lGuVCuS2-GaN5VoVcvnxtNlfuswW_VOlYqwg,98
-mcp_stata/discovery.py,sha256=KVNgLzmsZfkQ41k0UDZjNfwfz8yRwJs7iZR9NMu0qCE,5791
-mcp_stata/models.py,sha256=mVRvZYZMeXf1o5MLcD0bSwd0xO16ldEWaY6qXsJehRc,1078
-mcp_stata/server.py,sha256=KxxuFeVfYbIH5aRmCgYFA_wQwVw-Q1JMD5vC3e7vzAU,7804
-mcp_stata/stata_client.py,sha256=GQi5t3L9jX6xSocaOqIWo0Lp3ORaqRMDYQHfITjNXYM,20474
-mcp_stata/smcl/smcl2html.py,sha256=wi91mOMeV9MCmHtNr0toihNbaiDCNZ_NP6a6xEAzWLM,2624
-mcp_stata-1.2.2.dist-info/METADATA,sha256=DH7y6cqEDJr-blD62LE0p4rudhmzaBkiSuHwtO2uagA,7840
-mcp_stata-1.2.2.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-mcp_stata-1.2.2.dist-info/entry_points.txt,sha256=TcOgrtiTL4LGFEDb1pCrQWA-fUZvIujDOvQ-bWFh5Z8,52
-mcp_stata-1.2.2.dist-info/licenses/LICENSE,sha256=DZak_2itbUtvHzD3E7GNUYSRK6jdOJ-GqncQ2weavLA,34523
-mcp_stata-1.2.2.dist-info/RECORD,,