Self-hosted homelab log intelligence over MCP, CLI, and REST with SQLite/FTS.
Connect Runs on your machine
claude mcp add cortex -e CORTEX_HOME=<CORTEX_HOME> -e CORTEX_TOKEN=<CORTEX_TOKEN> -e CORTEX_API_TOKEN=<CORTEX_API_TOKEN> -e CORTEX_RMCP_VERSION=<CORTEX_RMCP_VERSION> -e CORTEX_RMCP_REPO=<CORTEX_RMCP_REPO> -e CORTEX_RMCP_RELEASE_BASE_URL=<CORTEX_RMCP_RELEASE_BASE_URL> -e RUST_LOG=<RUST_LOG> -- npx -y @dinglebear/[email protected]{
"mcpServers": {
"cortex": {
"command": "npx",
"args": [
"-y",
"@dinglebear/[email protected]"
],
"env": {
"CORTEX_HOME": "<CORTEX_HOME>",
"CORTEX_TOKEN": "<CORTEX_TOKEN>",
"CORTEX_API_TOKEN": "<CORTEX_API_TOKEN>",
"CORTEX_RMCP_VERSION": "<CORTEX_RMCP_VERSION>",
"CORTEX_RMCP_REPO": "<CORTEX_RMCP_REPO>",
"CORTEX_RMCP_RELEASE_BASE_URL": "<CORTEX_RMCP_RELEASE_BASE_URL>",
"RUST_LOG": "<RUST_LOG>"
}
}
}
}{
"mcpServers": {
"cortex": {
"command": "npx",
"args": [
"-y",
"@dinglebear/[email protected]"
],
"env": {
"CORTEX_HOME": "<CORTEX_HOME>",
"CORTEX_TOKEN": "<CORTEX_TOKEN>",
"CORTEX_API_TOKEN": "<CORTEX_API_TOKEN>",
"CORTEX_RMCP_VERSION": "<CORTEX_RMCP_VERSION>",
"CORTEX_RMCP_REPO": "<CORTEX_RMCP_REPO>",
"CORTEX_RMCP_RELEASE_BASE_URL": "<CORTEX_RMCP_RELEASE_BASE_URL>",
"RUST_LOG": "<RUST_LOG>"
}
}
}
}{
"servers": {
"cortex": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@dinglebear/[email protected]"
],
"env": {
"CORTEX_HOME": "<CORTEX_HOME>",
"CORTEX_TOKEN": "<CORTEX_TOKEN>",
"CORTEX_API_TOKEN": "<CORTEX_API_TOKEN>",
"CORTEX_RMCP_VERSION": "<CORTEX_RMCP_VERSION>",
"CORTEX_RMCP_REPO": "<CORTEX_RMCP_REPO>",
"CORTEX_RMCP_RELEASE_BASE_URL": "<CORTEX_RMCP_RELEASE_BASE_URL>",
"RUST_LOG": "<RUST_LOG>"
}
}
}
}Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools
This server runs locally, so its tools are listed by your MCP client once it starts.
Environment variables
| Name | Description |
|---|---|
CORTEX_HOMEOptional | Optional Cortex home directory containing configuration and local SQLite data. |
CORTEX_TOKENOptional, secret | Optional bearer token for Cortex MCP HTTP mode; also used by some shared configs. |
CORTEX_API_TOKENOptional, secret | Bearer token for Cortex REST API routes when running daemon/API mode. |
CORTEX_RMCP_VERSIONOptional | Optional GitHub release tag override for the downloaded Cortex binary. |
CORTEX_RMCP_REPOOptional | Optional GitHub owner/repo override for release asset downloads. |
CORTEX_RMCP_RELEASE_BASE_URLOptional | Optional release download base URL override. |
RUST_LOGOptional | Tracing filter for Cortex logs. |
Details
| Package | @dinglebear/[email protected] (NPM, stdio) |
| First published | 10 Aug 2026 |
| Last updated | 10 Aug 2026 |
| Registry name | ai.dinglebear/cortex |
More databases servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.