Skip to content
MCP server

Neuroencoder EEG embeddings

Turn EEG recordings into 768-dimensional embeddings and run sleep staging, from an agent

Status and history

Answered our latest tool-list check 16 hours ago with 8 tools. It will be marked verified after 3 successful checks in 7 days.

Install
Pricing
Free trial
Platforms
API, CLI
Runs
Remotely
Version
2.4.0
Listing updated
1 day ago

About Neuroencoder EEG embeddings

Neuroencoder EEG embeddings is an MCP server for knowledge and memory. It runs as a hosted remote server, so there is nothing to install locally.

Neuroencoder offers a hosted EEG embeddings API, and this MCP server wraps it for agents. It accepts EDF, BDF, FIF or NPY files in any montage and sampling rate and returns one 768-value vector per window, by default 30 seconds. Jobs run asynchronously: an agent requests an upload URL, queues an embedding or sleep-staging job, polls for status and fetches a result link.

Sleep staging works on whole-night polysomnography recordings of at least two hours with an EEG channel at 100 Hz or more, and the docs mark it as research use only, not a medical device. Billing counts 30 seconds of EEG per window and refunds failed jobs.

Getting started needs no human: samples are downloadable without a key, and a single signup request returns a provisional agent key good for 2 hours of EEG over 7 days. There is also a pip-installed CLI and a local MCP server that can inspect a file for free, embed it, find similar windows and plot a PCA.

Install

Run in a terminal

claude mcp add --transport http eeg-embeddings https://api.neuroencoder.com/mcp

Add to Settings → Connectors → Add custom connector

https://api.neuroencoder.com/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "eeg-embeddings": {
      "url": "https://api.neuroencoder.com/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "eeg-embeddings": {
      "type": "http",
      "url": "https://api.neuroencoder.com/mcp"
    }
  }
}

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

{
  "mcpServers": {
    "eeg-embeddings": {
      "serverUrl": "https://api.neuroencoder.com/mcp"
    }
  }
}

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

{
  "mcpServers": {
    "eeg-embeddings": {
      "type": "http",
      "url": "https://api.neuroencoder.com/mcp"
    }
  }
}

Tools this server provides (8)

Read directly from the server.

account
This API key: tier, limits and usage this month.
list_samples
Precomputed real outputs (no upload needed): ids, titles, sizes, download URLs.
get_sample
One sample: README, licence, channels_used, and its embeddings in the POST /v1/embeddings response format (first windows only for long ones).
create_upload
Start an upload of a local .edf, .bdf or .npy file (at most 2 GB). Returns id and a presigned upload_url: PUT the file there within 10 minutes with exactly upload_headers (e.g. curl -X PUT --upload-file night.edf -H 'Content-Length: N' '<upload_url>', no Authorization header), then call start_embedding_job with the id. Only the extension of filename is used.
start_embedding_job
Queue an embeddings job on an uploaded file. window_seconds: 2 to 30 (default 30); stride_seconds: default window_seconds. picks: EDF/BDF channel labels to keep; channel_names: 10-20 labels overriding the file's; sfreq: required for .npy. Bills 30 s of EEG per window at any window_seconds (refunded on failure). Poll get_job.
start_sleep_staging_job
Queue sleep staging of an uploaded whole-night PSG (.edf/.bdf; >= 1 EEG channel with a 10-20 label at >= 100 Hz; EOG used if present). eeg_channel/eog_channel: channels for the YASA features; picks, channel_names as for embeddings. Counts 1 night of the weekly quota (refunded on failure). Poll get_job, then get_result_url. Research use only, not a medical device.
get_job
A job's status (queued, running, succeeded, failed, cancelled, expired), usage, error or result. Poll every 5 s while queued or running.
get_result_url
Fresh presigned GET URLs (10 minutes) of a succeeded job's result. Embeddings: .npy float32 [windows, 768], window i starts at i * t_start_step s. Sleep staging: url = hypnogram JSON (stage, probabilities, confidence per 30 s epoch), csv_url = CSV, plus the summary.

What it does

Any EEG format
EDF, BDF, FIF or NPY with any montage and sampling rate.
Window embeddings
One 768-d vector per window, 30 seconds by default.
Sleep staging
Whole-night recordings produce a hypnogram and summary for research use.
Agent signup
One request returns a provisional key without an email.
Free samples
Precomputed samples are downloadable without a key.
Local companion
A local server inspects files free and finds similar windows.

Good for

  • Embed overnight recordings for similarity search
  • Check how many windows a file will bill before uploading
  • Stage sleep in a polysomnography night for research
  • Compare embeddings with a reference sample

Pricing

Free trial

Provisional agent key: 2 h of EEG for 7 days; paid tier prices not published

Prices change. Check docs.neuroencoder.com before you buy.

Neuroencoder EEG embeddings FAQ

Do I need a key to look around?

No. Samples can be fetched without one, and an agent key comes from one signup request.

How is usage billed?

30 seconds of EEG per window; failed jobs are refunded, and sleep staging counts one night of a weekly quota.

What files are accepted?

EDF, BDF or NPY up to 2 GB through uploads; FIF is listed in the registry description.

Is sleep staging medical?

No. The docs say it is for research use only and not a medical device.

Is Neuroencoder EEG embeddings free?

Neuroencoder EEG embeddings is a paid product with a free trial.

How do I add Neuroencoder EEG embeddings to Claude Code?

Run this command in your terminal: claude mcp add --transport http eeg-embeddings https://api.neuroencoder.com/mcp

What are the best alternatives to Neuroencoder EEG embeddings?

The closest alternatives to Neuroencoder EEG embeddings are Codebase Memory, XERJ, Claude Code Ultimate Guide, Tooluniverse and Nautilus Compass Memory.

Alternatives to Neuroencoder EEG embeddings

  1. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  2. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  3. MCP server for searching the Claude Code Ultimate Guide from any MCP client

    Runs locally
    • Open source
    • 6.5K GitHub stars
    • AI models and LLM tooling
  4. 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
  5. Local-first long-term memory layer for AI agents, served over MCP

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • 1.3K GitHub stars
    • Knowledge and memory
  6. Oya Browser

    MCP server

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

    • 32 tools
    • Remote
    • Freemium
    • 349 GitHub stars
    • Browser automation