Onyx MCP Server

A Model Context Protocol (MCP) server for seamless integration with Onyx AI knowledge bases.

Local serverstdioMIT

What is the Onyx MCP Server?

Onyx MCP Server source profile. From the maintainer documentation: “A Model Context Protocol (MCP) server for seamless integration with Onyx AI knowledge bases.”

Local setup

The project provides a local client configuration using node. Follow the repository’s build and installation steps before copying it, and replace example paths with the paths on your own computer.

Configuration values

The example declares ONYX_API_TOKEN, ONYX_API_URL. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
query	required): The question to ask Onyx
documentSets	optional): List of document set names to search within (empty for all)
maxResults	optional): Maximum number of results to return (default: 5, max: 10)
chunksAbove	optional): Number of chunks to include above the matching chunk (default: 1)
chunksBelow	optional): Number of chunks to include below the matching chunk (default: 1)
retrieveFullDocuments	optional): Whether to retrieve full documents instead of just chunks (default: false)
personaId	optional): The ID of the persona to use (default: 15)
chatSessionId	optional): Existing chat session ID to continue a conversation

How to install the Onyx MCP Server

{
  "mcpServers": {
    "onyx-search": {
      "command": "node",
      "args": [
        "/path/to/onyx-mcp-server/build/index.js"
      ],
      "env": {
        "ONYX_API_TOKEN": "YOUR_ONYX_API_TOKEN",
        "ONYX_API_URL": "http://localhost:8080/api"
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

Variable	Description	Required
ONYX_API_TOKEN	Declared in the maintainer’s client configuration.	Check documentation
ONYX_API_URL	Declared in the maintainer’s client configuration.	Check documentation