MCP Server

The NeuralSnap MCP Server gives AI coding assistants like Claude Desktop, Cursor, and Windsurf direct access to your knowledge graph. Store insights, search your brain, and traverse relationships — all from within your IDE.

MCP (Model Context Protocol) is an open standard that lets AI assistants connect to external data sources and tools. NeuralSnap's MCP server exposes your snapshots, search, and crystallization pipeline as MCP tools.

Installation

No installation needed — run directly with npx:

bash

npx @neuralsnap/mcp-server

Or install globally:

bash

npm install -g @neuralsnap/mcp-server

Claude Desktop

Get your API key

Go to API Keys in your dashboard and copy your key.

Configure Claude Desktop

Open Claude Desktop settings, go to Developer → MCP Servers, and add:

json

{
  "mcpServers": {
    "neuralsnap": {
      "command": "npx",
      "args": ["@neuralsnap/mcp-server"],
      "env": {
        "NEURALSNAP_API_KEY": "ns_your_api_key_here"
      }
    }
  }
}

Start using it

Restart Claude Desktop. You can now ask Claude to search your NeuralSnap brain, store new knowledge, or find related snapshots.

Cursor

Add the same configuration to your Cursor MCP settings:

json

{
  "mcpServers": {
    "neuralsnap": {
      "command": "npx",
      "args": ["@neuralsnap/mcp-server"],
      "env": {
        "NEURALSNAP_API_KEY": "ns_your_api_key_here"
      }
    }
  }
}

Windsurf

Same configuration format for Windsurf's MCP settings.

Available Tools

neuralsnap_store

Crystallize text into Neural Snapshots. Pass any text and the pipeline extracts structured knowledge.

Input: text (required), source_type (optional)

neuralsnap_search

Search your knowledge with 6 modes: semantic, graph, hybrid, summary, chain, or auto.

Input: query (required), mode (optional), limit (optional)

neuralsnap_related

Find snapshots connected via the knowledge graph. Traverses edges to discover related knowledge.

Input: snapshot_id (required)

neuralsnap_recent

Get the most recently created snapshots from your brain.

Input: limit (optional, default 10)

neuralsnap_get

Retrieve a specific snapshot by ID with all 16 fields.

Input: id (required)

Resources

neuralsnap://profile

Your profile and usage statistics — plan, snapshot count, search count, and API key status.

Environment Variables

Variable	Required	Description
NEURALSNAP_API_KEY	Yes	Your NeuralSnap API key (starts with `ns_`)
NEURALSNAP_API_URL	No	API base URL (default: `https://api.neuralsnap.ai/v1`)
NEURALSNAP_BRAIN_ID	No	Default brain/space ID for all operations

Troubleshooting

Server doesn't start

Make sure NEURALSNAP_API_KEY is set. The server exits with an error if no API key is provided.

Tools return errors

Check that your API key is valid and your plan includes API access (Pro or Business). Starter plans don't have API access.

Search returns no results

Make sure you have snapshots in your brain. Try crystallizing some text first with the neuralsnap_store tool.

Overview

OpenClaw