mcp · neuronsearchlab — NeuronSearchLab MCP server: features and setup
Connect an AI client to NeuronSearchLab recommendations, catalogue search, and analytics. Use it to inspect ranking results or manage recommendation settings from a chat.
claude mcp add --transport http mcp https://console.neuronsearchlab.com/api/mcpWhat mcp 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.
What it helps with
- 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 for the agent
- Fetch recommendations for the user
[email protected]. - Find
prod-456and explain its ranking for Bob. - Create a context called Twitter Feed and add a rule for Nike items.
How to install mcp
1Platform CLI: remote server
claude mcp add --transport http mcp https://console.neuronsearchlab.com/api/mcp2Platform CLI
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/mcpReplace <…> with your own values
1Platform CLI: remote server
codex mcp add neuronsearchlab-mcp --url https://console.neuronsearchlab.com/api/mcp2Platform CLI
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/mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"neuronsearchlab-mcp": {
"url": "https://console.neuronsearchlab.com/api/mcp"
}
}
}{
"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
Config file
{
"servers": {
"neuronsearchlab-mcp": {
"type": "http",
"url": "https://console.neuronsearchlab.com/api/mcp"
}
}
}{
"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
1Platform CLI: remote server
gemini mcp add -t http neuronsearchlab-mcp https://console.neuronsearchlab.com/api/mcp2Platform CLI
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/mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about mcp
How do I install mcp in Claude Code?
Add the hosted server with claude mcp add --transport http mcp https://console.neuronsearchlab.com/api/mcp, then authenticate with NeuronSearchLab.
What does mcp do?
It gives an AI client access to NeuronSearchLab recommendations, catalogue search, and analytics. Internal mode also provides platform administration tools.
What credentials does it need?
Public mode uses OAuth client credentials. Internal mode requires a NeuronSearchLab API key with the admin scope.
Similar MCP servers
All MCP servers for AI and ML →mcp by other authors comes first.
