Skip to content
MCP server

Eeg MCP

Real-time EEG for agents: BrainFlow streaming, replay, recording and stimulation

Runs locallyStatus and history
Pricing
Open source
Platforms
CLI, self-hosted, Linux
Runs
Locally
Version
0.2.0
Listing updated
2 days ago

About Eeg MCP

Eeg MCP is an open-source MCP server for health and science. It runs locally on your machine and is started by your AI client.

This is the live-signal half of a pair: eeg-mcp handles everything that must happen while data is still arriving, and its sibling neuro-mcp covers offline MNE processing. It installs from PyPI and runs over stdio with 47 tools.

Acquisition covers 66 BrainFlow board identifiers (OpenBCI, Muse, ANT Neuro, g.tec, Mentalab) plus a synthetic board that needs no hardware; a background thread fills a ring buffer so tool calls read a live view. Existing EDF, BDF, GDF, SET or FIF files and BrainFlow CSVs can be replayed at their recorded rate with annotations re-emitted as events, so a pipeline built on a file runs unchanged against hardware.

Processing is stateful online filtering with band power, PSD and per-electrode quality, plus custom processors. A token-gated, loopback-only browser view shows live traces, and recording writes crash-safe .fif files. Stimulation goes through one send_stim_event contract over LSL, BrainFlow markers, serial or TTL, and TMS and tES protocols behind three safety gates.

Install

Run in a terminal

claude mcp add eeg-mcp -- uvx eeg-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "eeg-mcp": {
      "command": "uvx",
      "args": [
        "eeg-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "eeg-mcp": {
      "command": "uvx",
      "args": [
        "eeg-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "eeg-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "eeg-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "eeg-mcp": {
      "command": "uvx",
      "args": [
        "eeg-mcp"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "eeg-mcp": {
      "command": "uvx",
      "args": [
        "eeg-mcp"
      ]
    }
  }
}

Tools this server provides (1)

Taken from the project documentation; the running server may differ.

send_stim_event
Dispatches a stimulation event over LSL, BrainFlow markers, serial/TTL or templated TMS and tES protocols behind safety gates.

What it does

66 board types
BrainFlow boards plus a synthetic board for hardware-free work.
Wall-clock replay
Plays recordings at original timing with speed, seek and looping.
Online DSP
Stateful filters, band power, PSD and electrode quality.
Live browser monitor
Loopback-bound, token-gated view of traces and event markers.
Crash-safe recording
Continuous .fif files with the event log as annotations.
Gated stimulation
Three safety gates sit in front of stimulation output.

Good for

  • Prototype a closed-loop BCI without hardware
  • Replay a saved session to test a pipeline
  • Monitor electrode quality during acquisition
  • Record sessions for later MNE analysis
  • Trigger software or hardware stimulation events

Pricing

Open source

Free; install from PyPI

Prices change. Check aimplifier.github.io before you buy.

Eeg MCP FAQ

How do I install it?

pip install eeg-mcp; it runs over stdio.

Do I need EEG hardware?

No, a synthetic board is included.

What is its offline counterpart?

neuro-mcp, which does MNE processing, source imaging and BIDS/EHR storage.

Is the live view exposed to the network?

It is bound to loopback and token-gated.

Is Eeg MCP free?

Yes. Eeg MCP is open source, so you can use and self-host it for free.

How do I add Eeg MCP to Claude Code?

Run this command in your terminal: claude mcp add eeg-mcp -- uvx eeg-mcp

What are the best alternatives to Eeg MCP?

The closest alternatives to Eeg MCP are Tooluniverse, Oya Browser, Later Stages, MedXpert 标准检索连接器 and MedXpert 全球法规连接器 (reg-connector).

Alternatives to Eeg MCP

  1. Tooluniverse

    MCP server

    MCP server giving AI agents access to thousands of scientific research tools

    Runs locally
    • Open source
    • 1.8K GitHub stars
    • Health and science
  2. Oya Browser

    MCP server

    HIPAA-oriented agentic browser with replayable playbooks, reachable over MCP

    • 32 tools
    • Remote
    • Freemium
    • 349 GitHub stars
    • Browser automation
  3. Later Stages

    MCP server

    California senior living and care provider records from state licensing and Medicare

    • 6 tools
    • Remote
    • Free
    • Health and science
  4. Read-only local index of medical-device standards with official links, no standard text

    Runs locally
    • 4 tools
    • Free
    • Legal and government
  5. Splyt

    MCP server

    Let Claude or ChatGPT read your Splyt workouts, records, plan, habits and sleep

    • Remote
    • Free
    • Health and science