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).
