What it does
Onyx MCP is an independent community Model Context Protocol server for Onyx, formerly Danswer. It exposes Onyx search, chat, agents, projects, documents, connectors, ingestion and deployment-specific APIs to MCP clients. It is not an official Onyx package. Tools are grouped into profiles: read-only, write, admin, destructive and raw API.
It suits cases where an MCP client needs to query or work with an Onyx instance. The server starts read-only. Write, admin, destructive, raw API and web search or URL-fetching tools each need their own explicit setting. Authentication uses a scoped Onyx Personal Access Token or a legacy API key, and Onyx still enforces the permissions attached to that token. Some endpoints require an unrestricted token, so administrative operations are meant to run in a separate server configuration.
The server runs locally over stdio on Node.js 20 or 22. It needs the Onyx API base URL and a token. Optional settings cover the default agent for new chats, request timeouts, response size limits and concurrency limits. Clients can call tools/list for machine-readable schemas and safety annotations, and onyx_capabilities shows the active profile.
Limitations and requirements
Requires an Onyx API base URL and a Personal Access Token or API key. Requires Node.js 20 or 22. Runs only as a local stdio server. Write, admin, destructive, raw API and web-fetch tools are disabled by default and must be enabled explicitly; raw API requests need admin access, and non-GET raw requests also need write and destructive access plus confirmation. URL fetching is limited to HTTPS destinations on a configured hostname allowlist, and Onyx must validate redirects and resolved addresses to prevent DNS rebinding. Some Onyx endpoints need an unrestricted token or API key. Client configuration files containing a token should be treated as sensitive and restricted to the user account.
Safety
Our team has not reviewed this resource. Only automated rules checked it; resources with high-risk signals are not published. These are signals, not a guarantee that installing it is safe. Try it in a sandbox project first.
- Runs code or changes an assistant's behaviour
Sources
- Official MCP Registry first seen 13 Nov 2026 · last seen 13 Nov 2026 · its page on the source
Onyx MCP
Secure MCP access to Onyx search, chat, projects, and administration.
v0.2.1As shown on registry.modelcontextprotocol.io when we last read it