MCP.so
Sign In

Onyx MCP Server

@MCP-Mirror

About Onyx MCP Server

Mirror of

Basic information

Category

Other

License

MIT license

Runtime

node

Transports

stdio

Publisher

MCP-Mirror

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.

Comments

More Other MCP servers