Skip to content
MCP server

MCP

NeuronSearchLab recommendations, catalogue and ranking tools for AI clients

Install
Platforms
API, CLI
Runs
Locally or Remotely
Version
2.0.0
Listing updated
5 days ago

Similar MCP servers

About MCP

MCP is an MCP server for analytics and data. It can run locally on your machine or as a hosted remote server.

This server connects an assistant to a NeuronSearchLab workspace, where it can fetch recommendations, record events, manage catalogue items and ask why an item ranked where it did. Typical prompts in the README include getting five recommendations for a user, adding a pin rule so one brand always appears in the top three, and checking a plan against its limits.

It runs in two credential modes. Public mode uses OAuth client credentials for the Core API, while internal mode uses a platform API key for workspace administration. A hosted endpoint is recommended, using OAuth sign-in or an API key, and a local stdio package is the alternative. The hosted profile requires admin scope and leaves credential creation, billing changes and the arbitrary API fallback to trusted local clients.

Install

Run in a terminal

claude mcp add --transport http mcp https://console.neuronsearchlab.com/api/mcp

Add to Settings → Connectors → Add custom connector

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://console.neuronsearchlab.com/api/mcp"
    }
  }
}

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

{
  "mcpServers": {
    "mcp": {
      "serverUrl": "https://console.neuronsearchlab.com/api/mcp"
    }
  }
}

Add to Grok Bot desktop app → Connect apps → Add a custom connector

https://console.neuronsearchlab.com/api/mcp

Enter a Name (for example "MCP"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

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

{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://console.neuronsearchlab.com/api/mcp"
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • NSL_CLIENT_IDOAuth client ID for public mode (SDK Credentials from console → Security).
  • NSL_CLIENT_SECRETOAuth client secret for public mode.
  • NSL_PLATFORM_MODESet to 'internal' for admin-platform tools with an API key; defaults to 'public'.
  • NSL_API_KEYNSL API key (nsl_...) for internal mode.

Tools this server provides (9)

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

get_recommendations
Fetch personalised recommendations for a user.
get_recommendation_sets
Fetch every rail of a page in one request.
get_auto_recommendations
Auto-sectioned feed with pagination for infinite scroll.
track_event
Record a user interaction such as a click, view or purchase.
upsert_item
Add or update a catalogue item.
patch_item
Partially update an item, such as enabling or disabling it.
delete_items
Permanently remove items from the catalogue.
search_items
Search the catalogue by keyword.
explain_ranking
Explain why an item ranked where it did for a user.

What it does

Recommendation fetching
Returns personalised recommendations, whole-page sets or an auto-sectioned feed.
Event tracking
Records clicks, views, purchases and other interactions.
Catalogue management
Adds, patches, searches and deletes catalogue items.
Ranking explanations
Explains why an item ranked where it did for a given user.
Two credential modes
Public mode for the Core API, internal mode for admin tools.

Good for

  • Test recommendation output for a user in a chosen context
  • Add a pin or ranking rule through an assistant
  • Review plan usage against limits
  • Debug why a catalogue item ranked first

MCP FAQ

How do I connect it?

Use the hosted endpoint with OAuth or a bearer key, or run the npm package over stdio.

What credentials does local mode need?

Public mode needs a client ID and secret; internal mode needs a platform API key.

Can the hosted server create credentials or change billing?

No. Those, and the arbitrary API fallback, stay with trusted local or internal clients.

What is the default request timeout?

15,000 milliseconds, configurable with NSL_TIMEOUT_MS.

How do I add MCP to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp https://console.neuronsearchlab.com/api/mcp

What are the best alternatives to MCP?

The closest alternatives to MCP are Hello Retail, effectsize, nextanalytica, OneLence and Watchr.

Where this comes from

  • Description: written from the project's README and the project's website.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers