MCP
NeuronSearchLab recommendations, catalogue and ranking tools for AI clients
- 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/mcpAdd to Settings → Connectors → Add custom connector
https://console.neuronsearchlab.com/api/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"url": "https://console.neuronsearchlab.com/api/mcp"
}
}
}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/mcpEnter 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.
