MCP.so
Sign In

Onyx MCP Server

@lupuletic

Repository

About Onyx MCP Server

No overview available yet

Config

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

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

Tools

No tools detected

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

Overview

What is Onyx MCP Server?

A Model Context Protocol (MCP) server that connects any MCP-compatible client to an Onyx AI knowledge base, enabling semantic search and chat capabilities across your documents.

How to use Onyx MCP Server?

Install via npm or Smithery, configure environment variables ONYX_API_TOKEN and ONYX_API_URL, then add the server configuration to your MCP client (e.g., Claude Desktop or Cline). Once configured, use the search_onyx tool for targeted document search or the chat_with_onyx tool for comprehensive LLM + RAG answers.

Key features of Onyx MCP Server

  • Semantic search with LLM relevance filtering across document sets
  • Context window retrieval (chunks above and below matches)
  • Full document retrieval option instead of just chunks
  • Chat API with LLM + RAG for comprehensive answers
  • Configurable document set filtering for targeted results

Use cases of Onyx MCP Server

  • Access your organization's knowledge base through any MCP-compatible interface
  • Help customer support agents quickly find relevant information
  • Conduct deep research across your organization's documents
  • Provide access to training materials and documentation
  • Ensure teams have access to the latest policies and procedures

FAQ from Onyx MCP Server

What prerequisites are needed to run 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 Onyx MCP Server for Claude Desktop?

Add a server entry to ~/Library/Application Support/Claude/claude_desktop_config.json with the command node, the path to build/index.js, and environment variables ONYX_API_TOKEN and ONYX_API_URL.

What tools does Onyx MCP Server provide?

It provides two tools: search_onyx for semantic search with configurable context retrieval, and chat_with_onyx for comprehensive LLM + RAG answers with optional chat session persistence.

How do I choose between the Search and Chat tools?

Use Search when you need specific, targeted information and want to control how much context is retrieved. Use Chat when you need comprehensive answers that synthesize information from multiple sources.

What environment variables must be configured?

ONYX_API_TOKEN (your API token) and ONYX_API_URL (the URL of your Onyx API, e.g., http://localhost:8080/api).

Frequently asked questions

What prerequisites are needed to run 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 Onyx MCP Server for Claude Desktop?

Add a server entry to `~/Library/Application Support/Claude/claude_desktop_config.json` with the command `node`, the path to `build/index.js`, and environment variables `ONYX_API_TOKEN` and `ONYX_API_URL`.

What tools does Onyx MCP Server provide?

It provides two tools: `search_onyx` for semantic search with configurable context retrieval, and `chat_with_onyx` for comprehensive LLM + RAG answers with optional chat session persistence.

How do I choose between the Search and Chat tools?

Use Search when you need specific, targeted information and want to control how much context is retrieved. Use Chat when you need comprehensive answers that synthesize information from multiple sources.

What environment variables must be configured?

`ONYX_API_TOKEN` (your API token) and `ONYX_API_URL` (the URL of your Onyx API, e.g., `http://localhost:8080/api`).

Comments

Basic information

Category

Other

License

MIT

Transports

stdio

Author

lupuletic

More Other MCP servers

MCP Registry

modelcontextprotocol

A community driven registry service for Model Context Protocol (MCP) servers.

7.0K

Maestro

mobile-dev-inc

Painless E2E Automation for Mobile and Web

14.8K

🚀 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

Codelf

unbug

A search tool helps dev to solve the naming things problem.

14.2K

MaxKB

1Panel-dev

🔥 MaxKB is an open-source platform for building enterprise-grade agents. 强大易用的开源企业级智能体平台。

22.0K