What is mne-mcp-guard?

A set of safeguards for MNE-Python, a Python library used to analyze EEG, MEG, and related brain-recording data through an MCP server.

Use it to inspect recordings, check channels and sampling rates, review plots, validate filters and event windows, and cautiously prepare ICA, time-frequency, or source-localization analyses.

It catches common analysis problems before expensive processing, such as incorrect units, missing sensor positions, unsuitable events, or failed independent-component analysis.

mne-mcp-guard — Skill for Claude Code and Codex by Exekiel179/MNE-MCP

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent

npx skills add Exekiel179/MNE-MCP --skill mne-mcp-guard

Clone the repo

git clone --depth 1 https://github.com/Exekiel179/MNE-MCP

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/skills/exekiel179/mne-mcp/mne-mcp-guard/github.svg)](https://agentmods.dev/skills/exekiel179/mne-mcp/mne-mcp-guard)

Your own site

<a href="https://agentmods.dev/skills/exekiel179/mne-mcp/mne-mcp-guard"><img src="https://agentmods.dev/badge/skills/exekiel179/mne-mcp/mne-mcp-guard/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

Your own site · 80×15

<a href="https://agentmods.dev/skills/exekiel179/mne-mcp/mne-mcp-guard"><img src="https://agentmods.dev/badge/skills/exekiel179/mne-mcp/mne-mcp-guard.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 118 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.

When invoked 1,041 The whole file, excluding the scripts and references it only reads on demand.

Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5.1	$0.00118	$0.01041
Opus 5.5	$0.00047	$0.00416
Sonnet 5.5	$0.00024	$0.00208
Haiku 4.5	$0.00012	$0.00104

Measured 1mo ago against content hash 70c5819eb821, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

mne-mcp-guard scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/mne-mcp-guard/SKILL.md · 75 lines

How it starts

The opening of the file, as written. The whole thing — 75 lines — stays where its author put it; the contents beside it link to each section on GitHub.

MNE MCP Guard

Use this skill to make MNE MCP execution reliable, especially before expensive steps (ICA, time-frequency, source localization) and on unfamiliar data.

Workflow

Scientific dependencies are user-managed. Report the interpreter shown by mne_check_status. Distinguish missing packages from import-time binary/configuration errors. Never install packages inside mne_run_code or recreate an existing research environment. Missing optional libraries block only the relevant feature. After an authorized environment change, restart and check status again.

In PsyClaw, discover the mne server via psyclaw_mcp action=list before calling its tools. A successful setup check is not proof that an already-open session has reloaded. For missing tools or an unexpected interpreter, read the PsyClaw connection section in ../mne-analyst/references/environment.md; project configs override user configs.

Check capability first — mne_check_status. If MNE is missing, stop and say so; if scikit-learn is missing, ICA is unavailable.
Inspect before processing — mne_get_info / mne_describe. Never guess channel names, sampling rate, montage, or event codes.
Look before parameterizing — mne_plot_psd (read the PNG) before choosing filter cutoffs; mne_plot_raw before choosing rejection thresholds.
Smoke-test heavy steps
- Before ICA: confirm data is high-pass filtered (~1 Hz) and montage is set.
- Before epoching: verify real event codes exist (mne_find_events / mne_events_from_annotations) and that the epoch window fits the recording.
- Before TFR: confirm the epoch window is long enough for the lowest frequency.
Escalate gradually — get a minimal version working (one condition, default params), then add options. Don't jump to a 60-component ICA or full source pipeline on the first try.
Read warnings, not just success — dropped epochs, rank deficiency, montage subset warnings, and annotation notes change the validity of results.

Read the full file on GitHub · 75 lines

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

references/failure-patterns.md 2.0 KB

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

1mo ago Changed · +12 lines 70c5819eb821
2mo ago First seen · 63 lines · 118 tokens per session scan A 03507c43f6ea

Subscribe to this mod's changes

mne-mcp-guard is a skill published in the GitHub repository Exekiel179/MNE-MCP (12 stars, last pushed 23d ago), licensed MIT. It adds 118 tokens to every session and 1,041 once invoked, about $0.0005 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Scientific

mne-mcp-guard next to 6 skills from other repositories
Mod	Type	Stars	Last push	Licence	Scan	Tokens	Works with
mne-mcp-guardExekiel179/MNE-MCP	Skill	12	23d ago	MIT	A	118	Claude Code, Codex
instrument-data-to-allotropeanthropics/knowledge-work-plugins	Skill	35k	2d ago	Apache-2.0	A	123	Claude Code
exploratory-data-analysisK-Dense-AI/scientific-agent-skills	Skill	56k	4d ago	MIT	A	83	Claude Code
matlabK-Dense-AI/scientific-agent-skills	Skill	56k	4d ago	MIT	A	44	Claude Code
phylogeneticsK-Dense-AI/scientific-agent-skills	Skill	56k	4d ago	MIT	A	71	Claude Code, Codex
research-engineerdavila7/claude-code-templates	Skill	33k	yesterday	MIT	A	43	Claude Code, Codex
mapping-to-snomedmaziyarpanahi/openmed	Skill	5.8k	yesterday	Apache-2.0	A	205	Claude Code