Onyx MCP Server

@MCP-Mirror

About Onyx MCP Server

Mirror of

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "lupuletic_onyx-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "@lupuletic/onyx-mcp-server",
        "--client",
        "claude"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Onyx MCP Server?

Onyx MCP Server is a Model Context Protocol server that connects MCP-compatible clients to Onyx AI knowledge bases. It enables semantic search, context retrieval, and chat capabilities across your documents, acting as a bridge between MCP clients and the Onyx API.

How to use Onyx MCP Server?

Install via Smithery (npx -y @smithery/cli install @lupuletic/onyx-mcp-server --client claude) or manually by cloning the repository, installing dependencies, building, and setting the environment variables ONYX_API_TOKEN and ONYX_API_URL. Configure MCP clients (e.g., Claude Desktop, Cline) with the server command and environment variables. After setup, use the search_onyx and chat_with_onyx tools.

Key features of Onyx MCP Server

Enhanced semantic search with LLM relevance filtering
Context window retrieval (chunks above and below match)
Full document retrieval option
Chat integration using Onyx’s LLM + RAG API
Configurable document set filtering

Use cases of Onyx MCP Server

Access organizational knowledge bases through any MCP interface
Help customer support agents quickly find relevant information
Conduct deep research across company documents
Provide access to training materials and documentation
Ensure teams have the latest policies and procedures

FAQ from Onyx MCP Server

What are the prerequisites for Onyx MCP Server?

You need Node.js v16 or higher, an Onyx instance with API access, and an Onyx API token.

How do I configure environment variables?

Set ONYX_API_TOKEN and ONYX_API_URL (defaults to http://localhost:8080/api).

What is the difference between the search and chat tools?

Use search for specific, targeted information with controlled context retrieval. Use chat for comprehensive answers that synthesize information from multiple sources.

How do I maintain conversation context across chat interactions?

After the first chat call, the response includes a chat_session_id. Pass this ID in subsequent calls to maintain context.

Frequently asked questions

What are the prerequisites for Onyx MCP Server?

You need Node.js v16 or higher, an Onyx instance with API access, and an Onyx API token.

How do I configure environment variables?

Set `ONYX_API_TOKEN` and `ONYX_API_URL` (defaults to `http://localhost:8080/api`).

What is the difference between the search and chat tools?

Use search for specific, targeted information with controlled context retrieval. Use chat for comprehensive answers that synthesize information from multiple sources.

How do I maintain conversation context across chat interactions?

After the first chat call, the response includes a `chat_session_id`. Pass this ID in subsequent calls to maintain context.

Comments

Basic information

More Other MCP servers

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K