Cortex · cortex — Claude Code MCP server: what it does, how to install
Cortex gives an AI agent access to an internal developer portal for service catalogs, ownership, dependencies, on-call data, and scorecards.
no license 488 installs updated 2026-03-29
claude mcp add --transport http cortex https://cortex.run.toolsWhat Cortex does
Cortex lets an agent work with a catalog of services, teams, domains, and resources. It can look up ownership, entity details, incoming and outgoing dependencies, deployment history, current on-call contacts, and custom data. The server also exposes the Cortex knowledge base for documentation queries.
Its tools cover engineering metrics, initiatives, relationship graphs, and scorecards. An agent can inspect scorecard rules, retrieve entity scores, and get the next actions needed to reach a higher level. Metric queries require the available metric definitions to be fetched first, and a requested period cannot exceed 180 days.
The server uses HTTP at https://cortex.run.tools. Setup commands are provided for Claude Code, Codex, and Gemini CLI; Cursor and GitHub Copilot use JSON configuration. If the metric definitions are not loaded before queryPointInTimeMetrics, the documented request sequence is broken.
What it helps with
- find the owner of a catalog service
- trace incoming and outgoing dependencies
- check the active on-call contact
- review a service against scorecard rules
- query engineering metrics for a time period
Example prompts for the agent
- Find the owner and dependencies of
payment-apiin the Cortex catalog. - Review the scorecard for
checkout-serviceand list the next actions for reaching the next level. - Fetch the available metric definitions first, then query values for
orders-apiover the required period.
How to install Cortex
Platform CLI: remote server
claude mcp add --transport http cortex https://cortex.run.toolsPlatform CLI: remote server
codex mcp add cortex-cortex --url https://cortex.run.toolsConfig file
{
"mcpServers": {
"cortex-cortex": {
"url": "https://cortex.run.tools"
}
}
}Config file
{
"servers": {
"cortex-cortex": {
"type": "http",
"url": "https://cortex.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http cortex-cortex https://cortex.run.toolsStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Cortex
How do I install Cortex in Claude Code?
Run claude mcp add --transport http cortex https://cortex.run.tools, then run claude mcp add --transport http cortex-cortex https://cortex.run.tools.
What does Cortex do?
Cortex connects an agent to an internal developer portal. Its tools cover catalog entities, dependencies, deployments, on-call data, metrics, initiatives, relationships, and scorecards.
What is required before querying Cortex metrics?
Load the metric definitions first so the available keys and details are known. A metric query can cover up to 180 days.
Similar MCP servers
All MCP servers for Agent setup: memory, context, orchestration →Cortex by other authors comes first.