Cortex MCP Overview
[!NOTE] Research Preview
Not seeing the results you expect? This is an early version of the Cortex MCP. Please send feedback and bug reports to Cortex Customer Engineering.
Cortex MCP is a Model Context Protocol server that provides access to the Cortex API. It uses relevant context from your workspace, ensuring awareness of your system's structure when answering your questions.
You can query information in natural language, powering faster decisions and efficient processes. For example:
- Who is the right person to handle an incident with backend-server?
- Show me the services that belong to the platform engineering team
- We're having an incident with backend-server, give me a summary of information to help handle the incident
Requirements
Before getting started, you'll need:
- MCP Client: Claude Desktop or other MCP-compatible client
- Cortex Personal Access Token: Create a token in your Cortex workspace settings.
Installation
[!NOTE] Docker Required
Make sure Docker is installed and running on your system before proceeding with the installation.
Then configure your MCP client. We've tested this with Claude Desktop, and Cursor, but it should work with any MCP-compatible client.
If you are a self-managed Cortex customer, you must also set CORTEX_API_BASE_URL=https:// alongside the CORTEX_API_TOKEN variable. See the docs for an example configuration.
Claude Desktop
{
"mcpServers": {
"cortex": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"--env",
"CORTEX_API_TOKEN=YOUR_API_TOKEN_HERE",
"ghcr.io/cortexapps/cortex-mcp:latest"
]
}
}
}
Claude Code
Use the following command to add Cortex MCP to Claude Code:
claude mcp add-json "cortex" '{
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"--env",
"CORTEX_API_TOKEN=YOUR_API_TOKEN_HERE",
"ghcr.io/cortexapps/cortex-mcp:latest"
]
}'
If successful, you should see: "Added stdio MCP server cortex to local config"
Cursor
{
"mcpServers": {
"cortex": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"--env",
"CORTEX_API_TOKEN=YOUR_API_TOKEN_HERE",
"ghcr.io/cortexapps/cortex-mcp:latest"
]
}
}
}
VSCode
VS Code MCP Servers Documentation
Sample .vscode/mcp.json
{
"inputs": [
{
"type": "promptString",
"id": "cortex-key",
"description": "Cortex API Key",
"password": true
}
],
"servers": {
"Cortex": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"ghcr.io/cortexapps/cortex-mcp:latest"
],
"env": {
"CORTEX_API_TOKEN": "${input:cortex-key}"
}
}
}
}
Warp
Under Settings > AI > Manage MCP Servers, you can configure your JSON config:
{
"cortex": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"--env",
"CORTEX_API_TOKEN=YOUR_API_TOKEN_HERE",
"ghcr.io/cortexapps/cortex-mcp:latest"
],
"env": {},
"start_on_launch": true
}
}
Support
- GitHub Issues: https://github.com/cortexapps/cortex-mcp/issues
- Email: help@cortex.io
License
MIT License - see LICENSE file for details.
Metadata
Release files for iflow-mcp_cortex-mcp 0.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| iflow_mcp_cortex_mcp-0.0.0.tar.gz | 13.4 kB | Without provenance | Details for iflow_mcp_cortex_mcp-0.0.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| iflow_mcp_cortex_mcp-0.0.0-py3-none-any.whl | Python 3 | none | any | Details for iflow_mcp_cortex_mcp-0.0.0-py3-none-any.whl |
Total release size: 25.8 kB
Release files / iflow_mcp_cortex_mcp-0.0.0.tar.gz
| Download URL | iflow_mcp_cortex_mcp-0.0.0.tar.gz |
|---|---|
| Size | 13.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
728dc282bb9a9e2a61963461fa4aa8f1d590b4bee084fc30f6e6ec544de83362
|
|
BLAKE2b-256 checksum How to use checksums |
93716a997ef5dccb3fe49e4643215127afeb88c5b537eae488407747d49e9e1e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.10 {"installer":{"name":"uv","version":"0.9.10"},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / iflow_mcp_cortex_mcp-0.0.0-py3-none-any.whl
| Download URL | iflow_mcp_cortex_mcp-0.0.0-py3-none-any.whl |
|---|---|
| Size | 12.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
a23edcdaeed45ad9d94daf42cc40b4f8254c906b81b70d56ed169955150af4a1
|
|
BLAKE2b-256 checksum How to use checksums |
11beb8b7837de22fe789ccc520fe8f8751803bd7d7793a4499d4ee38bdbf9944
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.10 {"installer":{"name":"uv","version":"0.9.10"},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for iflow-mcp_cortex-mcp 0.0.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.