# MCP

> MCP is an MCP server for analytics and data. NeuronSearchLab recommendations, catalogue and ranking tools for AI clients. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Platforms:** API, CLI
- **Website:** https://docs.neuronsearchlab.com/sdk/mcp
- **Repository:** https://github.com/neuronsearchlab/mcp
- **MCP Registry name:** com.neuronsearchlab/mcp
- **Categories:** [analytics and data](https://ai-powered.com/categories/analytics-and-data), [e-commerce](https://ai-powered.com/categories/e-commerce)
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

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

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp": {
      "url": "https://console.neuronsearchlab.com/api/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
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.

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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.

## Alternatives

- [Hello Retail](https://ai-powered.com/mcp/hello-retail): Hello Retail is an MCP server for e-commerce.
- [effectsize](https://ai-powered.com/mcp/effectsize): effectsize is a freemium MCP server for analytics and data.
- [nextanalytica](https://ai-powered.com/mcp/nextanalytica): nextanalytica is an MCP server for analytics and data.
- [OneLence](https://ai-powered.com/mcp/onelence): OneLence is an MCP server for marketing and seo.
- [Watchr](https://ai-powered.com/mcp/watchr): Watchr is an MCP server for marketing and seo.

---
Source: https://ai-powered.com/mcp/mcp-mwencx2v
