# CB Insights MCP Server

> _**Deprecation notice:** This repository, serving as an example implementation of a simple self-hosted MCP server that acts as a pass-through to the CB Insights API, is deprecated as of January 2026. CB Insights is pleased to offer a fully supported MCP server at [mcp.cbinsights.com](https://mcp.cbinsights.com), which can be invoked programmatically or through clients like ChatGPT, Claude, and Microsoft Copilot._

The CBI MCP Server provides an interface for developers to interact with CB Insights ChatCBI LLM through AI Agents.

## Tools

### ChatCBI
Send a message from an agent to ChatCBI and return the response.
- Input parameters:
  - `message`: The content of your message to ChatCBI
  - `chatID`(optional): A unique identifier for the chat session, obtained from a previous response. If included, the conversation is continued. Otherwise, a new conversation is started.
- Returns JSON object containing the following fields:
  - `chatID`: Identifies the conversation. If chatID was provided in the request, this will be the same.
  - `message`: ChatCBI response to the message.
  - `relatedContent`: List of related references.
  - `sources`: List of sources used to generate the response.
  - `suggestions`: List of suggested follow-up questions.
  - `title`: Title of the chat
- For more information see [Using ChatCBI](https://api-docs.cbinsights.com/portal/docs/CBI-API/chatcbi)

## Setup
The CBI MCP Server uses [uv](https://docs.astral.sh/uv/getting-started/installation/) to manage the project. 

Environment variables are set via the .env file:
- `CBI_CLIENT_ID` & `CBI_CLIENT_SECRET` OAuth Client ID and Secret
  - see [CB Insights API Authentication](https://api-docs.cbinsights.com/portal/docs/CBI-API/Authentication) for usage and how to obtain them
- `CBI_MCP_TIMEOUT` (default: 120)
- `CBI_MCP_PORT` (default: 8000)

## Usage

### With Claude Desktop

Update the `claude_desktop_config.json` file using the following command:

```shell
mcp install server.py
```

This will add the following configuration:

```json
{
  "mcpServers": {
    "cbi-mcp-server": {
      "command": "/path/to/.local/bin/uv",
      "args": [
        "--directory",
        "/path/to/cloned/cbi-mcp-server",
        "run",
        "server.py"
      ]
    }
  }
}
```

## Debugging

The [inspector](https://modelcontextprotocol.io/docs/tools/inspector#getting-started) can be used to test/debug your server. 

```shell
mcp dev server.py 
```
[More info on using the inspector](https://modelcontextprotocol.io/docs/tools/inspector#py-pi-package)