MCP Server for Coroot

Get current authenticated user information.

Returns information about the currently authenticated user including their email, name, roles, and accessible projects.

List all accessible projects.

Returns a list of all projects that the authenticated user has access to. Each project includes its ID and name.

Get project details and configuration.

Retrieves comprehensive information about a project including its settings, integrations, and configuration.

Args: project_id: Project ID

Create a new project.

Creates a new Coroot project with the specified name. The name must contain only lowercase letters, numbers, and hyphens.

Args: name: Project name (must match ^a-z0-9?$)

Get project status including agent and integration health.

Returns the current status of a project including:

• Overall project health

• Prometheus connection status

• Node agent deployment status

• Any error messages

Args: project_id: Project ID

Get application details and metrics.

Retrieves comprehensive information about an application including:

• Performance metrics (CPU, memory, network)

• Health checks and SLOs

• Recent incidents

• Deployment history

Args: project_id: Project ID app_id: Application ID (format: namespace/kind/name) from_timestamp: Start timestamp for metrics (optional) to_timestamp: End timestamp for metrics (optional)

Get application logs with pattern analysis.

Retrieves application logs with automatic pattern detection and grouping. Supports filtering by time range, search query, and severity level.

Args: project_id: Project ID app_id: Application ID (format: namespace/kind/name) from_timestamp: Start timestamp (optional) to_timestamp: End timestamp (optional) query: Log search query (optional) severity: Filter by severity level (optional)

Get distributed traces for an application.

Retrieves distributed tracing data showing request flow through the application and its dependencies.

⚠️ WARNING: This endpoint can return very large responses (100k+ tokens) when retrieving many traces. Consider using time filters or trace_id to limit the response size.

Args: project_id: Project ID app_id: Application ID (format: namespace/kind/name) from_timestamp: Start timestamp (optional, recommended to limit data) to_timestamp: End timestamp (optional, recommended to limit data) trace_id: Specific trace ID to retrieve (optional, returns single trace) query: Search query (optional)

Get overview of all applications in a project.

Returns a high-level view of all applications including:

• Application health status

• Key performance indicators

• Resource usage

• Recent incidents

Args: project_id: Project ID query: Search/filter query (optional)

Get overview of infrastructure nodes.

Returns information about all nodes in the infrastructure:

• Node health and status

• Resource utilization

• Running containers

• System metrics

Args: project_id: Project ID query: Search/filter query (optional)

Get distributed tracing overview.

Returns a summary of distributed traces across all applications:

• Trace volume and trends

• Error rates

• Latency percentiles

• Service dependencies

Args: project_id: Project ID query: Search/filter query (optional)

Get deployment tracking overview.

Returns information about recent deployments:

• Deployment timeline

• Success/failure rates

• Rollback history

• Impact on application performance

Args: project_id: Project ID query: Search/filter query (optional)

Get risk assessment overview.

Returns comprehensive risk analysis across all applications:

• High-risk applications

• Risk trends over time

• Critical issues requiring attention

• Compliance and security risks

Args: project_id: Project ID query: Search/filter query (optional)

List all configured integrations for a project.

Returns the configuration status of all available integrations:

• Prometheus

• ClickHouse

• AWS

• Slack

• Microsoft Teams

• PagerDuty

• Opsgenie

• Webhooks

Args: project_id: Project ID

Configure an integration for a project.

Sets up or updates an integration configuration. Each integration type has specific configuration requirements.

Integration types:

• prometheus: Metrics data source

• clickhouse: Long-term storage

• aws: AWS services integration

• slack: Slack notifications

• teams: Microsoft Teams notifications

• pagerduty: PagerDuty alerts

• opsgenie: Opsgenie alerts

• webhook: Custom webhooks

Args: project_id: Project ID integration_type: Type of integration config: Integration-specific configuration dictionary

List all available inspections for a project.

Returns a list of all inspection types and their configurations including CPU, memory, SLO, and other health checks.

Args: project_id: Project ID

Get inspection configuration for an application.

Retrieves the current configuration for a specific inspection type (e.g., cpu, memory, slo_availability, slo_latency) for an application.

Args: project_id: Project ID app_id: Application ID (format: namespace/kind/name) inspection_type: Type of inspection (cpu, memory, slo, etc)

Update inspection configuration for an application.

Updates the configuration for a specific inspection type. Configuration format depends on the inspection type.

Args: project_id: Project ID app_id: Application ID (format: namespace/kind/name) inspection_type: Type of inspection (cpu, memory, slo, etc) config: New configuration (format varies by type)

Get application categories configuration.

Returns the current application categorization rules that determine how applications are grouped (e.g., monitoring, control-plane, etc).

Args: project_id: Project ID

Create a new application category.

Creates a category for grouping applications based on namespace/name patterns. Patterns must be space-separated and in format namespace/name (e.g., "test/* demo/*"). Each pattern must contain exactly one '/' and cannot start with '/'.

Args: project_id: Project ID name: Category name (lowercase letters, numbers, hyphens, underscores; min 3 chars) custom_patterns: Space-separated glob patterns (e.g., "test/* demo/*") notify_incidents: Whether to notify about incidents (default: True) notify_deployments: Whether to notify about deployments (default: False) slack_channel: Slack channel for notifications (optional)

Update an existing application category.

Updates specific fields of an application category. Only provided fields are updated.

Args: project_id: Project ID name: Category name to update custom_patterns: New space-separated glob patterns (optional) notify_incidents: Whether to notify about incidents (optional) notify_deployments: Whether to notify about deployments (optional) slack_channel: Slack channel for notifications (optional)

Delete an application category.

Removes a custom application category. Built-in categories cannot be deleted.

Args: project_id: Project ID name: Category name to delete

Get custom applications configuration.

Returns the list of custom application definitions that group instances by patterns.

Args: project_id: Project ID

Update custom applications configuration.

Updates the list of custom application definitions. Custom applications allow grouping instances by container name patterns.

Args: project_id: Project ID applications: New custom applications list with instance patterns

Get AI-powered root cause analysis for application issues.

Analyzes application problems and provides insights into the root causes of incidents, performance degradation, or failures.

Args: project_id: Project ID app_id: Application ID (format: namespace/kind/name)

Get CPU and memory profiling data for an application.

Retrieves profiling data including flame graphs for CPU usage and memory allocation patterns to help identify performance bottlenecks and optimization opportunities.

⚠️ WARNING: This endpoint can return extremely large responses (180k+ tokens) for applications with extensive profiling data. Consider using time filters to limit the response size to specific time windows.

Args: project_id: Project ID app_id: Application ID (format: namespace/kind/name) from_timestamp: Start timestamp (optional, strongly recommended) to_timestamp: End timestamp (optional, strongly recommended) query: Search query (optional)

Update risk assessment configuration for an application.

Configures risk thresholds and monitoring parameters to better identify potential issues before they impact users.

Args: project_id: Project ID app_id: Application ID (format: namespace/kind/name) risks: Risk assessment configuration

Get database instrumentation configuration.

Retrieves instrumentation settings for a specific database type.

Args: project_id: Project ID app_id: Application ID (format: namespace/kind/name) db_type: Database type (mysql, postgres, redis, mongodb, memcached)

Update database instrumentation configuration.

Configures how Coroot instruments and monitors a specific database.

Args: project_id: Project ID app_id: Application ID (format: namespace/kind/name) db_type: Database type (mysql, postgres, redis, mongodb, memcached) config: Instrumentation configuration

Get detailed information about a specific infrastructure node.

Retrieves comprehensive metrics and information about a node including:

• Resource usage (CPU, memory, disk, network)

• Running containers

• System information

• Health status

Args: project_id: Project ID node_id: Node ID

Get detailed information about a specific incident.

Retrieves comprehensive incident information including:

• Timeline of events

• Affected applications

• Impact assessment

• Resolution status

Args: project_id: Project ID incident_id: Incident ID

List all custom dashboards for a project.

Returns all user-created dashboards with their configurations.

Args: project_id: Project ID

Create a new custom dashboard.

Creates a dashboard with custom panels and queries for monitoring specific aspects of your infrastructure.

Args: project_id: Project ID dashboard: Dashboard configuration with panels and layout

Get a specific dashboard configuration.

Retrieves the full configuration of a dashboard including all panels.

Args: project_id: Project ID dashboard_id: Dashboard ID

Update an existing dashboard configuration.

Updates dashboard panels, layout, or other settings.

Args: project_id: Project ID dashboard_id: Dashboard ID dashboard: Updated dashboard configuration

Delete a custom dashboard.

Permanently removes a dashboard from the project.

Args: project_id: Project ID dashboard_id: Dashboard ID

Test an integration configuration.

Verifies that an integration is properly configured and can connect.

Args: project_id: Project ID integration_type: Type of integration (prometheus, slack, etc)

Delete an integration configuration.

Removes an integration from the project.

Args: project_id: Project ID integration_type: Type of integration to delete

Update project settings and configuration.

Updates project-level settings such as retention, alerting, etc.

Args: project_id: Project ID settings: Updated project settings

Delete a project and all associated data.

WARNING: This action is irreversible and will delete all project data.

Args: project_id: Project ID

List all API keys for a project.

Returns all API keys with their metadata (but not the secret values).

Args: project_id: Project ID

Create a new API key for data ingestion.

Creates an API key that can be used for sending metrics and data. The key secret is only returned once during creation.

Args: project_id: Project ID name: API key name description: Optional description

Delete an API key.

Removes an API key from the project. This action cannot be undone.

Args: project_id: Project ID key: The API key to delete (the actual key string)

Update current user information.

Updates the profile of the currently authenticated user.

Args: user_data: Updated user information

List all users in the system (admin only).

Returns all users with their roles and permissions. Requires admin privileges.

Create a new user (admin only).

Creates a new user account with specified role and permissions. Requires admin privileges.

Args: user_data: New user information including email, name, role

Get available user roles.

Returns all available roles that can be assigned to users (e.g., Viewer, Editor, Admin).

Get custom cloud pricing configuration.

Retrieves any custom cloud pricing overrides for cost calculations.

Args: project_id: Project ID

Update custom cloud pricing configuration.

Sets custom pricing for cloud resources to override default pricing.

Args: project_id: Project ID pricing: Custom pricing configuration

Delete custom cloud pricing configuration.

Removes custom pricing overrides and reverts to default pricing.

Args: project_id: Project ID

Check if Coroot server is healthy.

Performs a simple health check to verify that the Coroot server is running and accessible.

Get SSO configuration.

Retrieves Single Sign-On (SSO) configuration and available roles.

Update SSO configuration.

Configures Single Sign-On settings for the Coroot instance.

Args: config: SSO configuration settings

Get AI provider configuration.

Retrieves AI provider settings used for root cause analysis.

Update AI provider configuration.

Configures AI provider settings for enhanced root cause analysis.

Args: config: AI provider settings (API keys, model selection, etc.)

Get data for a specific dashboard panel.

Retrieves the data that powers a specific panel in a custom dashboard, including metrics, time series data, or aggregated values.

Args: project_id: The project ID dashboard_id: The dashboard ID panel_id: The panel ID within the dashboard from_time: Optional start time (ISO format or relative like '-1h') to_time: Optional end time (ISO format or 'now')

Get specific integration configuration details.

Retrieves the current configuration for a specific integration type, including connection details, settings, and status.

Args: project_id: The project ID integration_type: Type of integration (prometheus, cloudwatch, etc.)

Configure CPU and memory profiling for an application.

Enables or disables continuous profiling and sets the sampling rate for collecting CPU and memory profiles.

Args: project_id: The project ID app_id: The application ID enabled: Whether to enable profiling sample_rate: Optional sampling rate (0.0-1.0)

Configure distributed tracing for an application.

Controls trace collection settings including sampling rate and paths to exclude from tracing.

Args: project_id: The project ID app_id: The application ID enabled: Whether to enable tracing sample_rate: Optional trace sampling rate (0.0-1.0) excluded_paths: Optional list of URL paths to exclude

Configure log collection settings for an application.

Controls which logs are collected and processed, including log level filtering and pattern exclusions.

Args: project_id: The project ID app_id: The application ID enabled: Whether to enable log collection level: Optional minimum log level (debug, info, warn, error) excluded_patterns: Optional regex patterns to exclude

Create or update a user role (admin only).

Defines custom roles with specific permissions for fine-grained access control.

Args: name: Role name permissions: List of permission strings description: Optional role description