# mcp

Connect an AI client to NeuronSearchLab recommendations, catalogue search, and analytics. Use it to inspect ranking results or manage recommendation settings from a chat.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: NeuronSearchLab
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/NeuronSearchLab/mcp
- Updated: 2026-09-23
- HTML: https://affpapa.org/en/nevibecode/mcp/neuronsearchlab-mcp

## What it does

The server can fetch personalised recommendations, record user events, and search catalogue items. It also exposes tools for contexts, rules, experiments, and analytics. Ask why an item ranked where it did for a particular user.

Connect over HTTP or run the package locally with `npx -y @neuronsearchlab/mcp`. Public mode uses OAuth client credentials; internal mode uses an API key with the `admin` scope to access platform controls. Claude Code can connect to the hosted endpoint without a local process.

Admin tools require the `admin` scope, and the hosted server requires team authentication. Requests to restricted functions will fail without the right credentials.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://console.neuronsearchlab.com/api/mcp`
- Environment variables: `NSL_CLIENT_ID`, `NSL_CLIENT_SECRET`, `NSL_PLATFORM_MODE`, `NSL_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http mcp https://console.neuronsearchlab.com/api/mcp
```

2. **Platform CLI**
```bash
claude mcp add --env NSL_CLIENT_ID=<NSL_CLIENT_ID> --env NSL_CLIENT_SECRET=<NSL_CLIENT_SECRET> --env NSL_PLATFORM_MODE=<NSL_PLATFORM_MODE> --env NSL_API_KEY=<NSL_API_KEY> --transport stdio neuronsearchlab-mcp -- npx -y @neuronsearchlab/mcp
```
Replace <…> with your own values

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add neuronsearchlab-mcp --url https://console.neuronsearchlab.com/api/mcp
```

2. **Platform CLI**
```bash
codex mcp add neuronsearchlab-mcp --env NSL_CLIENT_ID=<NSL_CLIENT_ID> --env NSL_CLIENT_SECRET=<NSL_CLIENT_SECRET> --env NSL_PLATFORM_MODE=<NSL_PLATFORM_MODE> --env NSL_API_KEY=<NSL_API_KEY> -- npx -y @neuronsearchlab/mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "neuronsearchlab-mcp": {
            "url": "https://console.neuronsearchlab.com/api/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "neuronsearchlab-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@neuronsearchlab/mcp"
            ],
            "env": {
                "NSL_CLIENT_ID": "<NSL_CLIENT_ID>",
                "NSL_CLIENT_SECRET": "<NSL_CLIENT_SECRET>",
                "NSL_PLATFORM_MODE": "<NSL_PLATFORM_MODE>",
                "NSL_API_KEY": "<NSL_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "neuronsearchlab-mcp": {
            "type": "http",
            "url": "https://console.neuronsearchlab.com/api/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "neuronsearchlab-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@neuronsearchlab/mcp"
            ],
            "env": {
                "NSL_CLIENT_ID": "<NSL_CLIENT_ID>",
                "NSL_CLIENT_SECRET": "<NSL_CLIENT_SECRET>",
                "NSL_PLATFORM_MODE": "<NSL_PLATFORM_MODE>",
                "NSL_API_KEY": "<NSL_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http neuronsearchlab-mcp https://console.neuronsearchlab.com/api/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e NSL_CLIENT_ID=<NSL_CLIENT_ID> -e NSL_CLIENT_SECRET=<NSL_CLIENT_SECRET> -e NSL_PLATFORM_MODE=<NSL_PLATFORM_MODE> -e NSL_API_KEY=<NSL_API_KEY> neuronsearchlab-mcp npx -y @neuronsearchlab/mcp
```
Replace <…> with your own values

## When to use it
- fetch recommendations for a specific user
- search the product catalogue by keyword
- record a view, click, or purchase event
- inspect why an item ranked for a user
- manage recommendation rules and experiments

## Example prompts
- Fetch recommendations for the user `alice@example.com`.
- Find `prod-456` and explain its ranking for Bob.
- Create a context called Twitter Feed and add a rule for Nike items.

## Similar
- [MCP Toolbox for Databases](https://affpapa.org/en/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP server · ★ 16730
- [labelhead-artist-momentum](https://affpapa.org/en/nevibecode/mcp/labelhead-artist-momentum.md) — MCP server · ★ 107701
- [Agent Skills Search Server](https://affpapa.org/en/nevibecode/mcp/agent-skills-search-server.md) — MCP server · ★ 26673
- [Skyvern](https://affpapa.org/en/nevibecode/mcp/skyvern.md) — MCP server · ★ 23283
- [Nhost](https://affpapa.org/en/nevibecode/mcp/nhost.md) — MCP server · ★ 9369
- [PraisonAI](https://affpapa.org/en/nevibecode/mcp/praisonai.md) — MCP server · ★ 9298

## Other versions with the same name
- [mcp · kubeshark](https://affpapa.org/en/nevibecode/mcp/kubeshark-mcp.md) — ★ 12110
- [mcp · butterbase-ai](https://affpapa.org/en/nevibecode/mcp/butterbase-ai-mcp.md) — ★ 3031
- [mcp · medplum](https://affpapa.org/en/nevibecode/mcp/mcp.md) — ★ 2766
- [mcp · sceneview](https://affpapa.org/en/nevibecode/mcp/sceneview-mcp.md) — ★ 1349
- [mcp · buoy-gg](https://affpapa.org/en/nevibecode/mcp/buoy-gg-mcp.md) — ★ 691

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md