Gretl MCP
NPM · GRETL-MCP · SCANNED SEP 20
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 → Why this is hard to score →
Supply Chain Security98
- No malware found by supply-chain analysis.Pass
- No known CVEs affecting this package version or its production dependencies.Pass
- No install/post-install scripts declared.Pass
- 31 of 96 dependencies flagged as unhealthy. View diagnostics → Partial
Provenance & Transparency48
- 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 127 days ago).Pass
- Publishes a security disclosure policy (SECURITY.md).Pass
Schema Quality & AI Usability60
- AI-judged instruction clarity (good).Pass
- 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 Management93
- Stability observed for 28 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
Tool Safety100
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- We read all 12 captured tool definition(s), and no name or description among them implies an irreversible operation.Pass
- An AI judge read all 12 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
How do I install the Gretl MCP server?
Gretl MCP runs locally as an npm package, launched with npx -y gretl-mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
npm · gretl-mcp
claude mcp add ondrejlapes-gretl-mcp -- npx -y gretl-mcp
{
"mcpServers": {
"ondrejlapes-gretl-mcp": {
"command": "npx",
"args": [
"-y",
"gretl-mcp"
]
}
}
} {
"servers": {
"ondrejlapes-gretl-mcp": {
"command": "npx",
"args": [
"-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": {
"Transport": "stdio",
"Command": "npx",
"Arguments": [
"-y",
"gretl-mcp"
]
}
}
} assistant mcp add ondrejlapes-gretl-mcp -t stdio -c npx -a -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.
- 19 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 87 to 90. That category is still filling its 30-day observation window: 26 days of observed history at the previous scan, 27 at this one. The score rises as the window fills, whether or not the server changes.
- 17 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 80 to 83. That category is still filling its 30-day observation window: 24 days of observed history at the previous scan, 25 at this one. The score rises as the window fills, whether or not the server changes.
- 15 Sept 26 −3
- Stability: pass → 0.77 functional
- 14 Sept 26 0
- Stability: 0.97 → pass security
- 13 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 93 to 97. That category is still filling its 30-day observation window: 28 days of observed history at the previous scan, 29 at this one. The score rises as the window fills, whether or not the server changes.
- 11 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 87 to 90. That category is still filling its 30-day observation window: 26 days of observed history at the previous scan, 27 at this one. The score rises as the window fills, whether or not the server changes.
- 9 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 80 to 83. That category is still filling its 30-day observation window: 24 days of observed history at the previous scan, 25 at this one. The score rises as the window fills, whether or not the server changes.
- 8 Sept 26 −2
- Security disclosure: unverified → pass ▲ functional
- Stability: pass → 0.80 functional
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 20 Sept 2026 · Analysed npm/gretl-mcp@0.2.1
Provenance No attestation
The registry publishes no build provenance for this version, so there is nothing to verify.
| Result | No attestation |
|---|---|
| Ecosystem | npm |
Background: How many MCP packages publish verified provenance →
Dependencies 96 packages
| Packages resolved | 96 |
|---|---|
| Stale | 31 |
| Tree resolution | Complete |
Background: SBOMs and build attestations, explained →
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. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
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.
What is the Gretl MCP server?
Gretl MCP is listed in the public MCP registry as io.github.OndrejLapes/gretl-mcp. Run Hansl/Gretl econometrics workflows via MCP with GUI launch and artifacts. This page covers its npm package (gretl-mcp).
Is the Gretl MCP server safe to use?
Gretl MCP scores 80 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 20 September 2026. It declares no install or post-install scripts. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the Gretl MCP server expose?
Gretl MCP exposes 12 tools: gretl_version, gretl_gui_version, gretl_gui_launch, gretl_run_script, gretl_run_commands, and 7 more. Their descriptions and schemas cost roughly 2,115 tokens of context every time the server is loaded.
Is the Gretl MCP server still maintained?
Gretl MCP is still listed as active in the MCP registry. We last reached this channel on 20 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.
What licence is the Gretl MCP server under?
Gretl MCP declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.