Server Details
The Cortex MCP server provides read-only access to real-time engineering context from the Cortex developer portal, allowing AI coding assistants to answer natural language questions about your organization's catalog (microservices, libraries, domains, teams, infrastructure), scorecards (engineering standards and best practices), initiatives (goals and deadlines), and Engineering Intelligence metrics. It includes tools for querying documentation, tracking personal entities, and accessing AI-assisted insights across the entire Cortex ecosystem.
- Status
- Healthy
- Last Tested
- Transport
- Streamable HTTP
- URL
Available Tools
30 toolsgetCurrentOncallForEntityTry in Inspector
Retrieve the current on-call personnel for an entity in real-time. Shows who is actively responsible for incident response, including primary and secondary on-call, contact information, and rotation schedules
| Name | Required | Description | Default |
|---|---|---|---|
| context | Yes | Explain why you're invoking this tool now and how its output will be used. Then state how this call supports your *overall objective* and fits into your broader plan across all tool calls (e.g., why this tool vs. others, and what step it unblocks). Never share any personal details or sensitive information. | |
| tagOrId | Yes | Entity identifier - can be a tag or CID |
getCustomDataForEntityTry in Inspector
List all custom data key-value pairs associated with an entity. Retrieve metadata, configuration settings, and custom attributes stored for services, resources, or domains. Supports pagination for entities with large amounts of custom data
| Name | Required | Description | Default |
|---|---|---|---|
| page | Yes | Page number to return, 0-indexed. Default 0. | |
| context | Yes | Explain why you're invoking this tool now and how its output will be used. Then state how this call supports your *overall objective* and fits into your broader plan across all tool calls (e.g., why this tool vs. others, and what step it unblocks). Never share any personal details or sensitive information. | |
| tagOrId | Yes | Entity identifier - can be a tag or CID | |
| pageSize | Yes | Number of results to return per page, between 1 and 1000. Default 250. |
getCustomDataForEntityByKeyTry in Inspector
Retrieve a specific custom data value by key for an entity. Efficiently access individual metadata attributes, configuration values, or custom properties without fetching all custom data
| Name | Required | Description | Default |
|---|---|---|---|
| key | Yes | ||
| context | Yes | Explain why you're invoking this tool now and how its output will be used. Then state how this call supports your *overall objective* and fits into your broader plan across all tool calls (e.g., why this tool vs. others, and what step it unblocks). Never share any personal details or sensitive information. | |
| tagOrId | Yes | Entity identifier - can be a tag or CID |
getCustomEventForEntityByUuidTry in Inspector
Retrieve a specific custom event by its UUID. Returns event details including title, description, timestamp, type, and any custom data associated with the event
| Name | Required | Description | Default |
|---|---|---|---|
| uuid | Yes | ||
| context | Yes | Explain why you're invoking this tool now and how its output will be used. Then state how this call supports your *overall objective* and fits into your broader plan across all tool calls (e.g., why this tool vs. others, and what step it unblocks). Never share any personal details or sensitive information. | |
| tagOrId | Yes | Entity identifier - can be a tag or CID |
getCustomMetricDataTry in Inspector
Retrieve custom metric data points for an entity. Returns paginated time-series data for a specific custom metric, with optional filtering by date range to analyze trends and patterns
| Name | Required | Description | Default |
|---|---|---|---|
| page | Yes | Page number to return, 0-indexed. Default 0. | |
| context | Yes | Explain why you're invoking this tool now and how its output will be used. Then state how this call supports your *overall objective* and fits into your broader plan across all tool calls (e.g., why this tool vs. others, and what step it unblocks). Never share any personal details or sensitive information. | |
| endDate | No | End date for the filter (inclusive) | |
| tagOrId | Yes | Entity identifier - can be a tag or CID | |
| pageSize | Yes | Number of results to return per page, between 1 and 1000. Default 250. | |
| startDate | No | Start date for the filter (inclusive). Default: 6 months | |
| customMetricKey | Yes | Key for the custom metric filter |
getDependencyTry in Inspector
Get specific dependency details between two entities including method, path, and metadata. Useful for understanding the nature of the relationship, API contracts, and communication patterns between services
| Name | Required | Description | Default |
|---|---|---|---|
| path | No | ||
| method | No | ||
| context | Yes | Explain why you're invoking this tool now and how its output will be used. Then state how this call supports your *overall objective* and fits into your broader plan across all tool calls (e.g., why this tool vs. others, and what step it unblocks). Never share any personal details or sensitive information. | |
| calleeTag | Yes | ||
| callerTag | Yes |
getDeploysForEntityTry in Inspector
List all deployments for a specific catalog entity. Returns deployment history including timestamps, environments, SHAs, and deployment types in paginated format
| Name | Required | Description | Default |
|---|---|---|---|
| page | Yes | Page number to return, 0-indexed. Default 0. | |
| context | Yes | Explain why you're invoking this tool now and how its output will be used. Then state how this call supports your *overall objective* and fits into your broader plan across all tool calls (e.g., why this tool vs. others, and what step it unblocks). Never share any personal details or sensitive information. | |
| tagOrId | Yes | Entity identifier - can be a tag or CID | |
| pageSize | Yes | Number of results to return per page, between 1 and 1000. Default 250. |
getEntityDescriptorTry in Inspector
Cortex Catalog API - Access and manage your service catalog, teams, domains, and resources
| Name | Required | Description | Default |
|---|---|---|---|
| yaml | No | When true, returns the YAML representation of the descriptor | |
| context | Yes | Explain why you're invoking this tool now and how its output will be used. Then state how this call supports your *overall objective* and fits into your broader plan across all tool calls (e.g., why this tool vs. others, and what step it unblocks). Never share any personal details or sensitive information. | |
| tagOrId | Yes | Entity identifier - can be a tag or CID |
getEntityDetailsTry in Inspector
Retrieve comprehensive details about a specific entity including its metadata, ownership, hierarchies, and relationships. This is the primary method for getting complete information about services, teams, or domains.
| Name | Required | Description | Default |
|---|---|---|---|
| context | Yes | Explain why you're invoking this tool now and how its output will be used. Then state how this call supports your *overall objective* and fits into your broader plan across all tool calls (e.g., why this tool vs. others, and what step it unblocks). Never share any personal details or sensitive information. | |
| tagOrId | Yes | Entity identifier - can be a tag or CID | |
| includeOwners | No | Include ownership information, default is true | |
| hierarchyDepth | No | Depth of the parent / children hierarchy nodes. Can be 'full' or a valid integer | full |
| includeHierarchyFields | No | List of sub fields to include for hierarchies. Only supports 'groups' |
getInitiativeTry in Inspector
Retrieve detailed information about a specific initiative including its goals, timeline, affected entities, scorecard targets, and current progress. Essential for understanding initiative scope and tracking achievement of objectives
| Name | Required | Description | Default |
|---|---|---|---|
| cid | Yes | ||
| context | Yes | Explain why you're invoking this tool now and how its output will be used. Then state how this call supports your *overall objective* and fits into your broader plan across all tool calls (e.g., why this tool vs. others, and what step it unblocks). Never share any personal details or sensitive information. |
get_more_toolsTry in Inspector
Check for additional tools whenever your task might benefit from specialized capabilities - even if existing tools could work as a fallback.
| Name | Required | Description | Default |
|---|---|---|---|
| context | No |
getMyWorkspaceTry in Inspector
TOOL for retrieving current user's owned resources and work items across the Cortex workspace.
| Name | Required | Description | Default |
|---|---|---|---|
| context | Yes | Explain why you're invoking this tool now and how its output will be used. Then state how this call supports your *overall objective* and fits into your broader plan across all tool calls (e.g., why this tool vs. others, and what step it unblocks). Never share any personal details or sensitive information. | |
| myTeamsRequest | No | Request for teams the user belongs to | |
| myOpenPRsRequest | No | Request for user's open pull requests across all Git repositories | |
| myEntitiesRequest | No | Request for all entities (services, resources, domains) owned by the user | |
| myWorkItemsRequest | No | Request for work items (Jira, Linear, Azure DevOps issues) assigned to the user | |
| myScorecardsRequest | No | Request for scorecards associated with the user's entities | |
| myRequestedReviewsRequest | No | Request for pull requests where the user is requested as a reviewer |
getRelationshipTypeDetailsTry in Inspector
Get complete details of a specific relationship type including its configuration, rules, source/destination filters, and inheritance settings. Essential for understanding how entities can be connected and what validation rules apply
| Name | Required | Description | Default |
|---|---|---|---|
| context | Yes | Explain why you're invoking this tool now and how its output will be used. Then state how this call supports your *overall objective* and fits into your broader plan across all tool calls (e.g., why this tool vs. others, and what step it unblocks). Never share any personal details or sensitive information. | |
| relationshipTypeTag | Yes |
getScorecardTry in Inspector
Get complete details of a scorecard including its configuration, rules, levels, weights, exemption settings, and evaluation criteria. Essential for understanding how services are evaluated and what standards they must meet
| Name | Required | Description | Default |
|---|---|---|---|
| tag | Yes | Unique tag for the Scorecard | |
| context | Yes | Explain why you're invoking this tool now and how its output will be used. Then state how this call supports your *overall objective* and fits into your broader plan across all tool calls (e.g., why this tool vs. others, and what step it unblocks). Never share any personal details or sensitive information. |
getScorecardNextStepsForEntityTry in Inspector
Get actionable next steps for an entity to improve its scorecard performance. Shows which rules need to be satisfied to reach the next maturity level, helping teams prioritize improvements and track progress toward compliance goals
| Name | Required | Description | Default |
|---|---|---|---|
| tag | Yes | Unique tag for the Scorecard | |
| context | Yes | Explain why you're invoking this tool now and how its output will be used. Then state how this call supports your *overall objective* and fits into your broader plan across all tool calls (e.g., why this tool vs. others, and what step it unblocks). Never share any personal details or sensitive information. | |
| entityTag | Yes | The entity tag (`x-cortex-tag`) that identifies the entity. |
getTeamDetailsTry in Inspector
Retrieve detailed information about a specific team by its tag or ID. Returns complete team data including members, slack channels, metadata, and whether it's backed by an identity provider group
| Name | Required | Description | Default |
|---|---|---|---|
| context | Yes | Explain why you're invoking this tool now and how its output will be used. Then state how this call supports your *overall objective* and fits into your broader plan across all tool calls (e.g., why this tool vs. others, and what step it unblocks). Never share any personal details or sensitive information. | |
| tagOrId | Yes | Entity identifier - can be a tag or CID |
listAllEntitiesTry in Inspector
List and filter catalog entities with support for pagination, search, and various filters including groups, types, owners, and git repositories. If the client is trying to fetch data for teams, use 'type': 'team' in these APIs.
| Name | Required | Description | Default |
|---|---|---|---|
| page | Yes | Page number to return, 0-indexed. Default 0. | |
| query | No | Filter based on a [search query](https://docs.cortex.io/settings/search). This will search across entity properties. If provided, results will be sorted by relevance. | |
| types | No | Filter the response to specific types of entities. By default, this includes services, resources, and domains. Corresponds to the `x-cortex-type` field in the entity descriptor. | |
| groups | No | Filter based on groups, which correspond to the `x-cortex-groups` field in the Catalog Descriptor. Accepts a comma-delimited list of groups | |
| owners | No | Filter based on owner group names, which correspond to the `x-cortex-owners` field in the Catalog Descriptor. Accepts a comma-delimited list of owner group names | |
| context | Yes | Explain why you're invoking this tool now and how its output will be used. Then state how this call supports your *overall objective* and fits into your broader plan across all tool calls (e.g., why this tool vs. others, and what step it unblocks). Never share any personal details or sensitive information. | |
| pageSize | Yes | Number of results to return per page, between 1 and 1000. Default 250. | |
| includeLinks | No | Whether to include links for each entity in the response | |
| includeOwners | No | Whether to include ownership information for each entity in the response | |
| hierarchyDepth | No | Depth of the parent / children hierarchy nodes. Can be 'full' or a valid integer | full |
| gitRepositories | No | Supports only GitHub repositories in the `org/repo` format | |
| includeArchived | No | Whether to include archived entities in the response | |
| includeMetadata | No | Whether to include custom data for each entity in the response | |
| includeNestedFields | No | List of sub fields to include for different types | |
| includeSlackChannels | No | Whether to include Slack channels for each entity in the response | |
| includeHierarchyFields | No | List of sub fields to include for hierarchies. Only supports 'groups' |
listCustomEventsForEntityTry in Inspector
List custom events for an entity with optional filtering by type and time range. Supports pagination and filtering by event type, start time, and end time to retrieve historical event data
| Name | Required | Description | Default |
|---|---|---|---|
| page | Yes | Page number to return, 0-indexed. Default 0. | |
| type | No | ||
| context | Yes | Explain why you're invoking this tool now and how its output will be used. Then state how this call supports your *overall objective* and fits into your broader plan across all tool calls (e.g., why this tool vs. others, and what step it unblocks). Never share any personal details or sensitive information. | |
| endTime | No | If provided, events with less than or equal to timestamp will be returned (a date-time without a time-zone in the ISO-8601 calendar system) | |
| tagOrId | Yes | Entity identifier - can be a tag or CID | |
| pageSize | Yes | Number of results to return per page, between 1 and 1000. Default 250. | |
| startTime | No | If provided, events with greater than or equal to timestamp will be returned (a date-time without a time-zone in the ISO-8601 calendar system) | |
| timestamp | No | Use 'startTime' instead |
listDependenciesForEntityTry in Inspector
List all dependencies for an entity including both incoming (who depends on this service) and outgoing (what this service depends on) relationships. Essential for understanding service interactions, planning changes, and assessing blast radius
| Name | Required | Description | Default |
|---|---|---|---|
| page | Yes | Page number to return, 0-indexed. Default 0. | |
| context | Yes | Explain why you're invoking this tool now and how its output will be used. Then state how this call supports your *overall objective* and fits into your broader plan across all tool calls (e.g., why this tool vs. others, and what step it unblocks). Never share any personal details or sensitive information. | |
| pageSize | Yes | Number of results to return per page, between 1 and 1000. Default 250. | |
| callerTag | Yes | ||
| includeIncoming | No | ||
| includeOutgoing | No |
listEntityDescriptorsTry in Inspector
Cortex Catalog API - Access and manage your service catalog, teams, domains, and resources
| Name | Required | Description | Default |
|---|---|---|---|
| page | Yes | Page number to return, 0 indexed | |
| yaml | No | When true, returns the YAML representation of the descriptors | |
| types | No | Filter the response to specific types of entities. By default, this includes services, resources, and domains. Corresponds to the `x-cortex-type` field in the entity descriptor. | |
| context | Yes | Explain why you're invoking this tool now and how its output will be used. Then state how this call supports your *overall objective* and fits into your broader plan across all tool calls (e.g., why this tool vs. others, and what step it unblocks). Never share any personal details or sensitive information. | |
| pageSize | Yes | Number of entities to return per page |
listEntityDestinationsForRelationshipTypeTry in Inspector
List all destinations for a certain relationship type & entity. Use the listRelationshipTypes tool to find the relevant relationshipTypeTag.
| Name | Required | Description | Default |
|---|---|---|---|
| depth | No | Maximum depth to traverse in the relationship hierarchy. Defaults to 1 (i.e., direct relationships only). | |
| context | Yes | Explain why you're invoking this tool now and how its output will be used. Then state how this call supports your *overall objective* and fits into your broader plan across all tool calls (e.g., why this tool vs. others, and what step it unblocks). Never share any personal details or sensitive information. | |
| tagOrId | Yes | Entity identifier - can be a tag or CID | |
| includeArchived | No | If true will include relationships that traverse archived entities | |
| relationshipTypeTag | Yes |
listEntityRelationshipsTry in Inspector
List all entity relationships/full graph for a specific relationship type across the entire organization. Returns paginated results showing all source-destination pairs, useful for understanding the complete relationship graph and finding all connections of a particular type
| Name | Required | Description | Default |
|---|---|---|---|
| page | Yes | Page number to return, 0-indexed. Default 0. | |
| context | Yes | Explain why you're invoking this tool now and how its output will be used. Then state how this call supports your *overall objective* and fits into your broader plan across all tool calls (e.g., why this tool vs. others, and what step it unblocks). Never share any personal details or sensitive information. | |
| pageSize | Yes | Number of results to return per page, between 1 and 1000. Default 250. | |
| relationshipTypeTag | Yes |
listEntitySourcesForRelationshipTypeTry in Inspector
List all sources for a certain relationship type & entity. Use the listRelationshipTypes tool to find the relevant relationshipTypeTag.
| Name | Required | Description | Default |
|---|---|---|---|
| depth | No | Maximum depth to traverse in the relationship hierarchy. Defaults to 1 (i.e., direct relationships only). | |
| context | Yes | Explain why you're invoking this tool now and how its output will be used. Then state how this call supports your *overall objective* and fits into your broader plan across all tool calls (e.g., why this tool vs. others, and what step it unblocks). Never share any personal details or sensitive information. | |
| tagOrId | Yes | Entity identifier - can be a tag or CID | |
| includeArchived | No | If true will include relationships that traverse archived entities | |
| relationshipTypeTag | Yes |
listInitiativesTry in Inspector
List all initiatives in the organization with optional filters for draft and expired initiatives. View active improvement programs, strategic projects, and their current status to understand organizational priorities and track progress
| Name | Required | Description | Default |
|---|---|---|---|
| page | Yes | Page number to return, 0-indexed. Default 0. | |
| context | Yes | Explain why you're invoking this tool now and how its output will be used. Then state how this call supports your *overall objective* and fits into your broader plan across all tool calls (e.g., why this tool vs. others, and what step it unblocks). Never share any personal details or sensitive information. | |
| pageSize | Yes | Number of results to return per page, between 1 and 1000. Default 250. | |
| includeDrafts | No | Whether or not to include draft Initiatives in the response | |
| includeExpired | No | Whether or not to include expired Initiatives in the response |
listMetricDefinitionsTry in Inspector
List all available engineering metric definitions.
| Name | Required | Description | Default |
|---|---|---|---|
| key | No | ||
| view | No | basic | |
| context | Yes | Explain why you're invoking this tool now and how its output will be used. Then state how this call supports your *overall objective* and fits into your broader plan across all tool calls (e.g., why this tool vs. others, and what step it unblocks). Never share any personal details or sensitive information. |
listRelationshipTypesTry in Inspector
List all available relationship types with pagination. View relationship type configurations to understand what kinds of relationships can be created between entities like services, resources, domains, and teams
| Name | Required | Description | Default |
|---|---|---|---|
| page | Yes | Page number to return, 0-indexed. Default 0. | |
| context | Yes | Explain why you're invoking this tool now and how its output will be used. Then state how this call supports your *overall objective* and fits into your broader plan across all tool calls (e.g., why this tool vs. others, and what step it unblocks). Never share any personal details or sensitive information. | |
| pageSize | Yes | Number of results to return per page, between 1 and 1000. Default 250. |
listScorecardsTry in Inspector
List all scorecards in the organization with optional filtering. View scorecard configurations to understand quality standards, compliance requirements, and maturity models. Supports filtering by groups, entities, and teams to find relevant scorecards
| Name | Required | Description | Default |
|---|---|---|---|
| page | Yes | Page number to return, 0-indexed. Default 0. | |
| teams | No | Filter based on team (either tags or CIDs). Accepts a comma-delimited list of team tag or CIDs, please use only one type of identifier | |
| groups | No | Filter based on groups, which correspond to the `x-cortex-groups` field in the Catalog Descriptor. Accepts a comma-delimited list of groups | |
| context | Yes | Explain why you're invoking this tool now and how its output will be used. Then state how this call supports your *overall objective* and fits into your broader plan across all tool calls (e.g., why this tool vs. others, and what step it unblocks). Never share any personal details or sensitive information. | |
| entities | No | Filter based on entity (either tags or CIDs). Accepts a comma-delimited list of entity tag or CIDs, please use only one type of identifier | |
| pageSize | Yes | Number of results to return per page, between 1 and 1000. Default 250. | |
| showDrafts | No |
listScorecardScoresTry in Inspector
Retrieve scores for all entities evaluated by a specific scorecard. Returns paginated results showing how each service, resource, or domain performs against the scorecard's rules, including individual rule scores and overall scorecard scores
| Name | Required | Description | Default |
|---|---|---|---|
| tag | Yes | Unique tag for the Scorecard | |
| page | Yes | Page number to return, 0-indexed. Default 0. | |
| context | Yes | Explain why you're invoking this tool now and how its output will be used. Then state how this call supports your *overall objective* and fits into your broader plan across all tool calls (e.g., why this tool vs. others, and what step it unblocks). Never share any personal details or sensitive information. | |
| pageSize | Yes | Number of results to return per page, between 1 and 1000. Default 250. | |
| entityTag | No | Entity tag (x-cortex-tag) |
query_docsTry in Inspector
Query the Cortex knowledge base for answers.
Args: query: The question to ask Cortex docs
Returns: Response from Cortex including answer and metadata
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | ||
| context | Yes | Explain why you're invoking this tool now and how its output will be used. Then state how this call supports your *overall objective* and fits into your broader plan across all tool calls (e.g., why this tool vs. others, and what step it unblocks). Never share any personal details or sensitive information. |
queryPointInTimeMetricsTry in Inspector
Execute point-in-time queries for one or more engineering metrics.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | Yes | Maximum number of results to return | |
| context | Yes | Explain why you're invoking this tool now and how its output will be used. Then state how this call supports your *overall objective* and fits into your broader plan across all tool calls (e.g., why this tool vs. others, and what step it unblocks). Never share any personal details or sensitive information. | |
| endTime | Yes | End time for the query period | |
| filters | Yes | Filters to apply to the data | |
| groupBy | Yes | Fields to group results by | |
| metrics | Yes | List of metrics to query with their aggregation functions | |
| orderBy | Yes | Sort order for results | |
| nextPage | No | Pagination token for next page of results | |
| startTime | Yes | Start time for the query period | |
| comparison | No | ||
| nestedGroupBy | No | Fields to group nested results by | |
| nestedMetrics | No | Optional nested metrics for advanced queries | |
| timeAttribute | No | Time attribute to use for queries | |
| nestedTimeAttribute | No | Time attribute for nested queries |
FAQ
How do I claim this server?
To claim this server, publish a /.well-known/glama.json file on your server's domain with the following structure:
The email address must match the email associated with your Glama account. Once verified, the server will appear as claimed by you.
What are the benefits of claiming a server?
- Control your server's listing on Glama, including description and metadata
- Receive usage reports showing how your server is being used
- Get monitoring and health status updates for your server