Gretl MCP
NPM · GRETL-MCP · SCANNED AUG 3
Run Hansl/Gretl econometrics workflows via MCP with GUI launch and artifacts.
Available components
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. How we score →
Supply Chain Security87
- No malware found by supply-chain analysis.Pass
- Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree.Partial
- No install/post-install scripts declared.Pass
- Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree. View diagnostics → Partial
Provenance & Transparency45
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
- Clear OSI-approved license (MIT).Pass
- Actively maintained (last published 79 days ago).Pass
- Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail
Schema Quality & AI Usability43
- AI-judged instruction clarity (fair).Partial
- 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. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management27
- Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage89
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 67% of tool parameters carry a description.Partial
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.
npm · gretl-mcp
claude mcp add ondrejlapes-gretl-mcp -- npx -y gretl-mcp
codex mcp add ondrejlapes-gretl-mcp -- npx -y gretl-mcp
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"ondrejlapes-gretl-mcp": {
"type": "local",
"command": [
"npx",
"-y",
"gretl-mcp"
],
"enabled": true
}
}
} openclaw mcp add ondrejlapes-gretl-mcp --command npx --arg -y --arg gretl-mcp
mcp_servers:
ondrejlapes-gretl-mcp:
command: "npx"
args: ["-y", "gretl-mcp"] {
"mcpServers": {
"ondrejlapes-gretl-mcp": {
"command": "npx",
"args": [
"-y",
"gretl-mcp"
]
}
}
} Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 3 Aug 26 +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.
- 2 Aug 26 +56
- Provenance: unverified → fail ▼ security
- Known CVEs: unverified → partial ▲ security
- Install scripts: unverified → pass ▲ security
- Malware scan: unverified → pass ▲ security
- Maintenance: unverified → pass ▲ functional
- Dependency health: unverified → partial ▲ functional
- Schema quality: unverified → fair ▲ functional
- License: unverified → pass ▲ functional
- MCP protocol: unverified → pass ▲ functional
- Tool coverage: unverified → 100 ▲ functional
- Stability: unverified → 0.23 ▲ functional
- Licence: MIT functional
- 1 Aug 26 −13
- Tool coverage: 100 → unverified ▼ functional
- 31 Jul 26 −24
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 28 Jul 26 +18
- 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 functional
- 27 Jul 26 24
First indexed and scored.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 3 Aug 2026 · Analysed npm/[email protected]
Provenance none
Ecosystem: npm · Outcome: none
Dependencies 95 packages
95 packages in the resolved dependency tree · 95 deprecated · 29 stale.
The dependency tree was only partially resolved, so these counts may be incomplete.
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.
gretl_capabilities ~126
List Gretl commands, built-in functions, and package-management help from the installed Gretl version.
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | — | — |
No output schema declared.
No examples provided.
gretl_dataset_summary ~165
Open a Gretl-supported dataset file, return summary statistics, and open the same workflow in Gretl GUI by default.
| Name | Type | Req | Description |
|---|---|---|---|
| datasetPath | string | yes | 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 | — | — |
No output schema declared.
No examples provided.
gretl_gui_launch ~201
Launch the visible Gretl desktop GUI, optionally opening a local dataset/script or running a provided script on startup.
| Name | Type | Req | Description |
|---|---|---|---|
| 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. |
No output schema declared.
No examples provided.
gretl_gui_version ~75
Return the installed Gretl GUI version by running gretl.exe --version.
| Name | Type | Req | Description |
|---|---|---|---|
| gretlGuiPath | string | — | Optional explicit path to gretl or gretl.exe. |
| timeoutSeconds | integer | — | Maximum time to wait for gretl.exe --version. Defaults to 10 seconds. |
No output schema declared.
No examples provided.
gretl_help ~138
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.
| Name | Type | Req | Description |
|---|---|---|---|
| commandName | string | yes | 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. |
No output schema declared.
No examples provided.
gretl_make_package ~214
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.
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | 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 | — | — |
No output schema declared.
No examples provided.
gretl_ols ~179
Open a dataset, estimate an OLS model, and open the same workflow in Gretl GUI by default.
| Name | Type | Req | Description |
|---|---|---|---|
| datasetPath | string | yes | Path to a Gretl-supported dataset. |
| dependentVariable | string | yes | 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 | yes | Independent variable names. |
| requireGui | boolean | — | Require the visible Gretl GUI to open for this workflow. Defaults to true outside CI. |
| safeMode | boolean | — | — |
| timeoutSeconds | integer | — | — |
No output schema declared.
No examples provided.
gretl_package ~262
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.
| Name | Type | Req | Description |
|---|---|---|---|
| action | string | yes | 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 | — | — |
No output schema declared.
No examples provided.
gretl_run_commands ~246
Run one or more raw Gretl command lines. By default this also requires opening the same workflow in the visible Gretl GUI.
| Name | Type | Req | Description |
|---|---|---|---|
| commands | array | yes | 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. |
No output schema declared.
No examples provided.
gretl_run_script ~250
Run any Gretl/Hansl script through gretlcli. By default this also requires opening the same workflow in the visible Gretl GUI.
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | 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. |
No output schema declared.
No examples provided.
gretl_run_script_file ~211
Run an existing local Gretl .inp script file with gretlcli. By default this also requires opening the same workflow in the visible Gretl GUI.
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | Path to an existing local Gretl .inp script. |
| timeoutSeconds | integer | — | — |
| workingDirectory | string | — | Working directory for the script. Defaults to the script file directory. |
No output schema declared.
No examples provided.
gretl_version ~48
Return the installed Gretl version by running gretlcli.
| Name | Type | Req | Description |
|---|---|---|---|
| gretlCliPath | string | — | Optional explicit path to gretlcli or gretlcli.exe. |
No output schema declared.
No examples provided.