# Gretl MCP (npm · gretl-mcp)

Run Hansl/Gretl econometrics workflows via MCP with GUI launch and artifacts.

- Trust score: 62/100 (medium)
- Change this week: +38
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- npm · `gretl-mcp`: 62/100 (this document), [markdown](https://verifymcp.io/servers/ondrejlapes-gretl-mcp/gretl-mcp.md), [page](https://verifymcp.io/servers/ondrejlapes-gretl-mcp/gretl-mcp)

## Channel facts

- Registry: `npm`
- Package: `gretl-mcp`
- Version: `0.2.1`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Supply Chain Security**: 87/100
  - No malware found by supply-chain analysis.
  - Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree.
  - No install/post-install scripts declared.
  - Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree.
- **Provenance & Transparency**: 45/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 79 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 43/100
  - AI-judged instruction clarity (fair).
  - Context-footprint check failed: tool/resource definitions use about 2115 tokens (~176/item across 12 items; 12 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 27/100
  - Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 89/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 67% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### Claude

```bash
claude mcp add ondrejlapes-gretl-mcp -- npx -y gretl-mcp
```

### Codex

```bash
codex mcp add ondrejlapes-gretl-mcp -- npx -y gretl-mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "ondrejlapes-gretl-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "gretl-mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add ondrejlapes-gretl-mcp --command npx --arg -y --arg gretl-mcp
```

### Hermes

```yaml
mcp_servers:
  ondrejlapes-gretl-mcp:
    command: "npx"
    args: ["-y", "gretl-mcp"]
```

### Other

```json
{
  "mcpServers": {
    "ondrejlapes-gretl-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "gretl-mcp"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-03 (score 62, +1)

No change was recorded against any check on this day. Stability & Change Management went from 23 to 27. That category is still filling its 30-day observation window: 7 days of observed history at the previous scan, 8 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-08-02 (score 61, +56)

- [security regression] Provenance: unverified → fail
- [security improvement] Known CVEs: unverified → partial
- [security improvement] Install scripts: unverified → pass
- [security improvement] Malware scan: unverified → pass
- [functional improvement] Maintenance: unverified → pass
- [functional improvement] Dependency health: unverified → partial
- [functional improvement] Schema quality: unverified → fair
- [functional improvement] License: unverified → pass
- [functional improvement] MCP protocol: unverified → pass
- [functional improvement] Tool coverage: unverified → 100
- [functional improvement] Stability: unverified → 0.23
- [functional] Licence: MIT

### 2026-08-01 (score 5, −13)

- [functional regression] Tool coverage: 100 → unverified

### 2026-07-31 (score 18, −24)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-28 (score 42, +18)

- [functional improvement] Tool coverage: unverified → 100
- [functional] First check of Schema quality: fail
- [functional] First check of Schema quality: fail
- [functional] First check of Tool coverage: 67
- [functional] First check of Schema quality: unverified

### 2026-07-27 (score 24)

First indexed and scored.

## MCP tools (12)

### `gretl_version` (~48 tokens)

Return the installed Gretl version by running gretlcli.

Input parameters:

- `gretlCliPath` (string): Optional explicit path to gretlcli or gretlcli.exe.

### `gretl_gui_version` (~75 tokens)

Return the installed Gretl GUI version by running gretl.exe --version.

Input parameters:

- `gretlGuiPath` (string): Optional explicit path to gretl or gretl.exe.
- `timeoutSeconds` (integer): Maximum time to wait for gretl.exe --version. Defaults to 10 seconds.

### `gretl_gui_launch` (~201 tokens)

Launch the visible Gretl desktop GUI, optionally opening a local dataset/script or running a provided script on startup.

Input parameters:

- `english` (boolean): Force Gretl GUI to use English.
- `filePath` (string): Optional local dataset or script file to open in the Gretl GUI.
- `gretlGuiPath` (string): Optional explicit path to gretl or gretl.exe.
- `newInstance` (boolean): Launch a new Gretl GUI instance instead of reusing an existing one.
- `runScript` (boolean): When filePath points to a script, launch Gretl with --run filePath.
- `safeMode` (boolean): When script is provided, block shell-like commands and absolute file reads/writes.
- `script` (string): Optional Gretl/Hansl script to write and open with --run in the GUI.
- `workspaceRoot` (string): Optional directory where GUI script workspaces are created.

### `gretl_run_script` (~250 tokens)

Run any Gretl/Hansl script through gretlcli. By default this also requires opening the same workflow in the visible Gretl GUI.

Input parameters:

- `displayInGretl` (boolean): Open a visible Gretl GUI script window for this run. Defaults to true outside CI.
- `gretlCliPath` (string): Optional explicit path to gretlcli or gretlcli.exe.
- `gretlGuiPath` (string): Optional explicit path to gretl or gretl.exe.
- `guiNewInstance` (boolean): Open a new Gretl GUI instance for the visible script.
- `keepWorkspace` (boolean): Keep the run workspace so generated artifacts remain available.
- `requireGui` (boolean): Require the visible Gretl GUI to open for this workflow. Defaults to true outside CI.
- `safeMode` (boolean): When true, blocks shell-like commands and absolute file writes.
- `script` (string, required): Gretl/Hansl script to run.
- `timeoutSeconds` (integer): Maximum runtime in seconds. Defaults to 30, max 300.
- `workspaceRoot` (string): Optional directory where run workspaces are created.

### `gretl_run_commands` (~246 tokens)

Run one or more raw Gretl command lines. By default this also requires opening the same workflow in the visible Gretl GUI.

Input parameters:

- `commands` (array, required): Gretl command lines to run in order.
- `displayInGretl` (boolean): Open the generated command script in the visible Gretl GUI. Defaults to true outside CI.
- `gretlCliPath` (string): Optional explicit path to gretlcli or gretlcli.exe.
- `gretlGuiPath` (string): Optional explicit path to gretl or gretl.exe.
- `guiNewInstance` (boolean): Open a new Gretl GUI instance for the visible script.
- `keepWorkspace` (boolean): Keep the run workspace so generated artifacts remain available.
- `requireGui` (boolean): Require the visible Gretl GUI to open for this workflow. Defaults to true outside CI.
- `safeMode` (boolean): When true, blocks shell-like commands and absolute file writes.
- `timeoutSeconds` (integer): Maximum runtime in seconds. Defaults to 30, max 300.
- `workspaceRoot` (string): Optional directory where run workspaces are created.

### `gretl_run_script_file` (~211 tokens)

Run an existing local Gretl .inp script file with gretlcli. By default this also requires opening the same workflow in the visible Gretl GUI.

Input parameters:

- `displayInGretl` (boolean): Open the script file in the visible Gretl GUI after running. Defaults to true outside CI.
- `gretlCliPath` (string)
- `gretlGuiPath` (string)
- `guiNewInstance` (boolean)
- `requireGui` (boolean): Require the visible Gretl GUI to open for this workflow. Defaults to true outside CI.
- `safeMode` (boolean): When true, validates the script before running it.
- `scriptOpt` (number): Optional numeric value passed to Gretl as --scriptopt.
- `scriptPath` (string, required): Path to an existing local Gretl .inp script.
- `timeoutSeconds` (integer)
- `workingDirectory` (string): Working directory for the script. Defaults to the script file directory.

### `gretl_capabilities` (~126 tokens)

List Gretl commands, built-in functions, and package-management help from the installed Gretl version.

Input parameters:

- `displayInGretl` (boolean): Open the generated help script in Gretl GUI. Defaults to false for this reference tool.
- `gretlCliPath` (string)
- `gretlGuiPath` (string)
- `includeFunctions` (boolean): Include Gretl's built-in accessors and functions from help functions.
- `includePackageHelp` (boolean): Include help for pkg and makepkg.
- `timeoutSeconds` (integer)

### `gretl_package` (~262 tokens)

Install, query, run samples for, unload, remove, or index Gretl function/data packages using the native pkg command. By default this also requires opening the generated workflow in the visible Gretl GUI.

Input parameters:

- `action` (string, required): Gretl pkg action to perform.
- `displayInGretl` (boolean): Open the generated package command script in Gretl GUI. Defaults to true outside CI.
- `gretlCliPath` (string)
- `gretlGuiPath` (string)
- `guiNewInstance` (boolean)
- `keepWorkspace` (boolean)
- `local` (boolean): Use pkg --local for a local .gfn or .zip package file.
- `packageName` (string): Package name, local package path, URL, or addons for index. Required except index defaults to addons.
- `quiet` (boolean): Use pkg --quiet.
- `requireGui` (boolean): Require the visible Gretl GUI to open for this workflow. Defaults to true outside CI.
- `staging` (boolean): Use pkg --staging for package installs from Gretl staging.
- `timeoutSeconds` (integer)
- `verbose` (boolean): Use pkg --verbose.
- `workspaceRoot` (string)

### `gretl_make_package` (~214 tokens)

Build a Gretl function package (.gfn or .zip) using the native makepkg command. By default this also requires opening the generated workflow in the visible Gretl GUI.

Input parameters:

- `displayInGretl` (boolean): Open the generated makepkg script in Gretl GUI. Defaults to true outside CI.
- `gretlCliPath` (string)
- `gretlGuiPath` (string)
- `guiNewInstance` (boolean)
- `index` (boolean): Write the auxiliary package XML index file.
- `keepWorkspace` (boolean)
- `packagePath` (string, required): Output path ending in .gfn or .zip.
- `quiet` (boolean): Use makepkg --quiet.
- `requireGui` (boolean): Require the visible Gretl GUI to open for this workflow. Defaults to true outside CI.
- `timeoutSeconds` (integer)
- `translations` (boolean): Write the auxiliary i18n C strings file.
- `workspaceRoot` (string)

### `gretl_help` (~138 tokens)

Ask Gretl for command help, for example ols, summary, open, arima, or gnuplot. By default this also requires opening the help workflow in the visible Gretl GUI.

Input parameters:

- `commandName` (string, required): Gretl command name.
- `displayInGretl` (boolean): Open a visible Gretl GUI script window for this help request. Defaults to true outside CI.
- `gretlCliPath` (string)
- `gretlGuiPath` (string)
- `requireGui` (boolean): Require the visible Gretl GUI to open for this workflow. Defaults to true outside CI.

### `gretl_dataset_summary` (~165 tokens)

Open a Gretl-supported dataset file, return summary statistics, and open the same workflow in Gretl GUI by default.

Input parameters:

- `datasetPath` (string, required): Path to a CSV, gdt, Excel, Stata, SPSS, or other Gretl-supported dataset.
- `displayInGretl` (boolean): Open a visible Gretl GUI script window for this workflow. Defaults to true outside CI.
- `gretlCliPath` (string)
- `gretlGuiPath` (string)
- `guiNewInstance` (boolean)
- `requireGui` (boolean): Require the visible Gretl GUI to open for this workflow. Defaults to true outside CI.
- `safeMode` (boolean)
- `timeoutSeconds` (integer)

### `gretl_ols` (~179 tokens)

Open a dataset, estimate an OLS model, and open the same workflow in Gretl GUI by default.

Input parameters:

- `datasetPath` (string, required): Path to a Gretl-supported dataset.
- `dependentVariable` (string, required): Dependent variable name.
- `displayInGretl` (boolean): Open a visible Gretl GUI script window for this workflow. Defaults to true outside CI.
- `gretlCliPath` (string)
- `gretlGuiPath` (string)
- `guiNewInstance` (boolean)
- `includeConstant` (boolean)
- `independentVariables` (array, required): Independent variable names.
- `requireGui` (boolean): Require the visible Gretl GUI to open for this workflow. Defaults to true outside CI.
- `safeMode` (boolean)
- `timeoutSeconds` (integer)

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/ondrejlapes-gretl-mcp/gretl-mcp#diagnostics

## Score history

- 2026-08-03: 62
- 2026-08-02: 61
- 2026-08-01: 5
- 2026-07-31: 18
- 2026-07-30: 42
- 2026-07-28: 42
- 2026-07-27: 24

## Links

- npm package: https://www.npmjs.com/package/gretl-mcp
- Socket report: https://socket.dev/npm/package/gretl-mcp
- Repository: https://github.com/OndrejLapes/GretlMCP
- Changelog RSS feed: https://verifymcp.io/servers/ondrejlapes-gretl-mcp/gretl-mcp/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/ondrejlapes-gretl-mcp/gretl-mcp/changelog.json
- HTML version of this page: https://verifymcp.io/servers/ondrejlapes-gretl-mcp/gretl-mcp