
Cortex RMCP
A syslog ingestion engine that turns your homelab into a queryable log warehouse. Listens on UDP and TCP port 1514, writes to SQLite with FTS5 full-text indexing, and exposes 40+ MCP actions for drilling into errors, correlating events across hosts, tracking AI transcript sessions, detecting abuse patterns, and comparing time ranges. The single `cortex` tool uses an action parameter to switch between search, filter, tail, anomalies, compose_status, and dozens of other operations. Ships with six infrastructure prompts for incident triage, host health checks, and auth review. Runs as a daemon with an RMCP HTTP server on port 3100 or stdio for local clients. Built in Rust, packaged as a Docker container.
- GitHub stars
- 4
- tools
- 30
- auth
- Secret needed
- transport
- STDIO
- env vars
- 7
- last updated
- Jul 12, 2026
Tools
30 toolsPublic tool metadata for what this MCP can expose to an agent.
listAllEntitiesList 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.16 params
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.
contextstringgitRepositoriesarraygroupsarrayhierarchyDepthstringincludeArchivedbooleanincludeHierarchyFieldsarrayincludeLinksbooleanincludeMetadatabooleanincludeNestedFieldsarrayincludeOwnersbooleanincludeSlackChannelsbooleanownersarraypageintegerpageSizeintegerquerystringtypesarraylistEntityDescriptorsCortex Catalog API - Access and manage your service catalog, teams, domains, and resources5 params
Cortex Catalog API - Access and manage your service catalog, teams, domains, and resources
contextstringpageintegerpageSizeintegertypesarrayyamlbooleanlistDependenciesForEntityList 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 radius6 params
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
callerTagstringcontextstringincludeIncomingbooleanincludeOutgoingbooleanpageintegerpageSizeintegergetDependencyGet 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 services5 params
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
calleeTagstringcallerTagstringcontextstringmethodstringpathstringgetEntityDetailsRetrieve 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.5 params
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.
contextstringhierarchyDepthstringincludeHierarchyFieldsarrayincludeOwnersbooleantagOrIdstringgetCustomDataForEntityList 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 data4 params
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
contextstringpageintegerpageSizeintegertagOrIdstringgetCustomDataForEntityByKeyRetrieve a specific custom data value by key for an entity. Efficiently access individual metadata attributes, configuration values, or custom properties without fetching all custom data3 params
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
contextstringkeystringtagOrIdstringlistCustomEventsForEntityList 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 data8 params
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
contextstringendTimestringpageintegerpageSizeintegerstartTimestringtagOrIdstringtimestampstringtypestringgetCustomEventForEntityByUuidRetrieve a specific custom event by its UUID. Returns event details including title, description, timestamp, type, and any custom data associated with the event3 params
Retrieve a specific custom event by its UUID. Returns event details including title, description, timestamp, type, and any custom data associated with the event
contextstringtagOrIdstringuuidstringgetDeploysForEntityList all deployments for a specific catalog entity. Returns deployment history including timestamps, environments, SHAs, and deployment types in paginated format4 params
List all deployments for a specific catalog entity. Returns deployment history including timestamps, environments, SHAs, and deployment types in paginated format
contextstringpageintegerpageSizeintegertagOrIdstringgetCurrentOncallForEntityRetrieve 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 schedules2 params
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
contextstringtagOrIdstringgetEntityDescriptorCortex Catalog API - Access and manage your service catalog, teams, domains, and resources3 params
Cortex Catalog API - Access and manage your service catalog, teams, domains, and resources
contextstringtagOrIdstringyamlbooleanlistEntityDestinationsForRelationshipTypeList all destinations for a certain relationship type & entity. Use the listRelationshipTypes tool to find the relevant relationshipTypeTag.5 params
List all destinations for a certain relationship type & entity. Use the listRelationshipTypes tool to find the relevant relationshipTypeTag.
contextstringdepthstringincludeArchivedbooleanrelationshipTypeTagstringtagOrIdstringlistEntitySourcesForRelationshipTypeList all sources for a certain relationship type & entity. Use the listRelationshipTypes tool to find the relevant relationshipTypeTag.5 params
List all sources for a certain relationship type & entity. Use the listRelationshipTypes tool to find the relevant relationshipTypeTag.
contextstringdepthstringincludeArchivedbooleanrelationshipTypeTagstringtagOrIdstringgetCustomMetricDataRetrieve 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 patterns7 params
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
contextstringcustomMetricKeystringendDatestringpageintegerpageSizeintegerstartDatestringtagOrIdstringqueryPointInTimeMetricsExecute point-in-time queries for one or more engineering metrics. Returns current metric values for specified time periods, with support for batch queries and optional period-over-period comparisons. Time range (startTime/endTime) cannot exceed 6 months (180 days). PREREQUISI...14 params
Execute point-in-time queries for one or more engineering metrics. Returns current metric values for specified time periods, with support for batch queries and optional period-over-period comparisons. Time range (startTime/endTime) cannot exceed 6 months (180 days). PREREQUISI...
comparisonvaluecontextstringendTimestringfiltersarraygroupByarraylimitintegermetricsarraynestedGroupByarraynestedMetricsarraynestedTimeAttributestringnextPagestringorderByarraystartTimestringtimeAttributestringlistMetricDefinitionsList all available engineering metric definitions. USAGE - Call this endpoint BEFORE querying metrics (queryPointInTimeMetrics): 1. Once at start: Call with view='basic' to discover all available metrics - cache this response 2. Once per metric: Call with view='full' and key=M...3 params
List all available engineering metric definitions. USAGE - Call this endpoint BEFORE querying metrics (queryPointInTimeMetrics): 1. Once at start: Call with view='basic' to discover all available metrics - cache this response 2. Once per metric: Call with view='full' and key=M...
contextstringkeyarrayviewstringlistInitiativesList 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 progress5 params
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
contextstringincludeDraftsbooleanincludeExpiredbooleanpageintegerpageSizeintegergetInitiativeRetrieve 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 objectives2 params
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
cidstringcontextstringgetMyWorkspaceTOOL for retrieving current user's owned resources and work items across the Cortex workspace. FLEXIBLE REQUEST STRUCTURE: The request accepts an object with optional fields for each resource type: - myEntitiesRequest: Fetch entities (services, resources, domains) owned by the...7 params
TOOL for retrieving current user's owned resources and work items across the Cortex workspace. FLEXIBLE REQUEST STRUCTURE: The request accepts an object with optional fields for each resource type: - myEntitiesRequest: Fetch entities (services, resources, domains) owned by the...
contextstringmyEntitiesRequestobjectmyOpenPRsRequestobjectmyRequestedReviewsRequestobjectmyScorecardsRequestobjectmyTeamsRequestobjectmyWorkItemsRequestobjectlistRelationshipTypesList 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 teams3 params
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
contextstringpageintegerpageSizeintegergetRelationshipTypeDetailsGet 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 apply2 params
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
contextstringrelationshipTypeTagstringlistEntityRelationshipsList 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 type4 params
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
contextstringpageintegerpageSizeintegerrelationshipTypeTagstringlistScorecardsList 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 scorecards7 params
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
contextstringentitiesarraygroupsarraypageintegerpageSizeintegershowDraftsbooleanteamsarraygetScorecardGet 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 meet2 params
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
contextstringtagstringgetScorecardNextStepsForEntityGet 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 goals3 params
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
contextstringentityTagstringtagstringlistScorecardScoresRetrieve 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 scores5 params
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
contextstringentityTagstringpageintegerpageSizeintegertagstringgetTeamDetailsRetrieve 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 group2 params
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
contextstringtagOrIdstringquery_docsQuery the Cortex knowledge base for answers. Args: query: The question to ask Cortex docs Returns: Response from Cortex including answer and metadata2 params
Query the Cortex knowledge base for answers. Args: query: The question to ask Cortex docs Returns: Response from Cortex including answer and metadata
contextstringquerystringget_more_toolsCheck for additional tools whenever your task might benefit from specialized capabilities - even if existing tools could work as a fallback.1 params
Check for additional tools whenever your task might benefit from specialized capabilities - even if existing tools could work as a fallback.
contextvalueSponsors
Configuration
CORTEX_HOMEOptional Cortex home directory containing configuration and local SQLite data.
CORTEX_TOKENsecretOptional bearer token for Cortex MCP HTTP mode; also used by some shared configs.
CORTEX_API_TOKENsecretBearer token for Cortex REST API routes when running daemon/API mode.
CORTEX_RMCP_VERSIONOptional GitHub release tag override for the downloaded Cortex binary.
CORTEX_RMCP_REPOdefault: jmagar/cortexOptional GitHub owner/repo override for release asset downloads.
CORTEX_RMCP_RELEASE_BASE_URLOptional release download base URL override.
RUST_LOGdefault: infoTracing filter for Cortex logs.
Readme
Cortex
Self-hosted homelab log intelligence over MCP, CLI, and REST with SQLite/FTS.
It collects logs and operational evidence, stores them in SQLite with FTS5 search, and exposes one shared intelligence layer through CLI, REST, MCP, and a bundled browser workspace.
Details
- Repository
- github.com/jmagar/cortex
- Website
- github.com/jmagar/cortex
- Categories
- Cloud & Infrastructure, Search & Web Crawling
- Package
cortex-rmcp- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active