Onyx MCP Server

@MCP-Mirror

Repository

Basic information

About Onyx MCP Server

Mirror of

#onyx#mcp-server #ai-integration

Onyx MCP Server 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"
      ]
    }
  }
}

Onyx MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

Fetch the live tool list by running this server in a temporary sandbox using the button above.

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

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

More Other MCP servers

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K

The Living Bread

A free remote MCP server for The Living Bread. Bible passages read word for word from a stored public domain text with an evidence label, keyword search and cross references, real churches, gatherings and prayer groups w