MCP Server for Coroot

A Model Context Protocol (MCP) server that provides seamless integration with Coroot observability platform. This server enables MCP clients to monitor applications, analyze performance metrics, examine logs and traces, and manage infrastructure through Coroot's comprehensive API.

Getting Started

Add this configuration to your MCP client settings:

{
  "mcpServers": {
    "coroot": {
      "command": "uvx",
      "args": ["mcp-coroot"],
      "env": {
        "COROOT_BASE_URL": "http://localhost:8080",
        "COROOT_USERNAME": "admin",
        "COROOT_PASSWORD": "your-password"
      }
    }
  }
}

Using Docker:

{
  "mcpServers": {
    "coroot": {
      "command": "docker",
      "args": ["run", "--rm", "-i", 
              "-e", "COROOT_BASE_URL=http://localhost:8080",
              "-e", "COROOT_USERNAME=admin",
              "-e", "COROOT_PASSWORD=your-password",
              "jamesbrink/mcp-coroot:latest"]
    }
  }
}

For SSO/MFA users, use session cookie authentication instead:

{
  "mcpServers": {
    "coroot": {
      "command": "uvx",
      "args": ["mcp-coroot"],
      "env": {
        "COROOT_BASE_URL": "http://localhost:8080",
        "COROOT_SESSION_COOKIE": "your-auth-cookie-value"
      }
    }
  }
}

Environment Variables

COROOT_BASE_URL - Your Coroot instance URL (required)
COROOT_USERNAME - Username for basic authentication
COROOT_PASSWORD - Password for basic authentication
COROOT_SESSION_COOKIE - Session cookie for SSO/MFA users
COROOT_API_KEY - API key (limited to data ingestion only)

That's it! Your MCP client can now interact with your Coroot instance.

Features

Core Capabilities

Application Monitoring - Real-time metrics, health checks, and performance analysis
Log Analysis - Search, filter, and analyze application logs with pattern detection
Distributed Tracing - Trace requests across microservices and identify bottlenecks
Infrastructure Overview - Monitor nodes, containers, and system resources
Incident Management - Track and analyze incidents with root cause analysis
Performance Profiling - CPU and memory profiling with flame graphs

Management Features

Project Management - Create, configure, and manage Coroot projects
Integration Configuration - Set up Prometheus, Slack, PagerDuty, and more
Dashboard Customization - Create and manage custom dashboards
Cost Tracking - Monitor cloud costs with custom pricing rules
User & Access Control - Manage users, roles, and permissions

Advanced Features

AI-Powered RCA - Automatic root cause analysis for application issues
Risk Assessment - Identify and track infrastructure and application risks
Deployment Tracking - Monitor deployments and their impact
SLO Management - Configure and track Service Level Objectives
Database Instrumentation - Specialized monitoring for databases

Installation

Using uvx (Recommended)

# Install and run directly
uvx mcp-coroot

Using pip

pip install mcp-coroot

Using Docker

docker run --rm -i \
  -e COROOT_BASE_URL="http://localhost:8080" \
  -e COROOT_USERNAME="admin" \
  -e COROOT_PASSWORD="your-password" \
  jamesbrink/mcp-coroot:latest

From Source

git clone https://github.com/jamesbrink/mcp-coroot.git
cd mcp-coroot
uv sync --all-groups
uv run mcp-coroot

Authentication Methods

Username/Password

Best for users with basic authentication. The server automatically handles login and session management.

Required for organizations using:

Single Sign-On (SAML, OIDC)
Multi-Factor Authentication (2FA/MFA)
Advanced authentication workflows

To get your session cookie:

Login to Coroot through your browser
Open Developer Tools (F12)
Go to Application/Storage → Cookies
Copy the value of the auth cookie

API Key

Only supports data ingestion endpoints (/v1/*). Cannot be used for management APIs.

Available Tools

The server provides 61 tools organized into functional categories:

🔐 Authentication & Users (5 tools)

get_current_user - Get authenticated user information
update_current_user - Update user profile
list_users - List all users
create_user - Create new users
get_roles - View roles and permissions

📊 Project Management (9 tools)

list_projects - List all accessible projects
get_project - Get project details
create_project - Create new project
get_project_status - Check project health
update_project_settings - Update project configuration
delete_project - Delete project
list_api_keys - View API keys
create_api_key - Generate API keys
delete_api_key - Delete API keys

🚀 Application Monitoring (3 tools)

get_application - Comprehensive application metrics
get_application_logs - Search and analyze logs
get_application_traces - View distributed traces

🌐 Overview & Analysis (5 tools)

get_applications_overview - All applications summary
get_nodes_overview - Infrastructure overview
get_traces_overview - Tracing summary
get_deployments_overview - Deployment history
get_risks_overview - Risk assessment

📈 Dashboard Management (5 tools)

list_dashboards - View dashboards
create_dashboard - Create dashboard
get_dashboard - Get dashboard details
update_dashboard - Update dashboard
delete_dashboard - Remove dashboard

🔌 Integrations (4 tools)

list_integrations - View integrations
configure_integration - Configure integration
test_integration - Test connectivity
delete_integration - Remove integration

⚙️ Configuration (9 tools)

list_inspections - View inspection types
get_inspection_config - Get inspection settings
update_inspection_config - Update inspections
get_application_categories - View categories
create_application_category - Create new category
update_application_category - Update existing category
delete_application_category - Delete category
get_custom_applications - View custom apps
update_custom_applications - Define custom apps

🔍 Advanced Features (15 tools)

Including RCA, profiling, cloud pricing, database instrumentation, SSO/AI configuration, and more.

Example Usage

Basic Monitoring

"Show me all applications in the production project"
"Check the health status of the API service"
"Are there any critical incidents right now?"

Troubleshooting

"Search for error logs in the payment service from the last hour"
"Show me slow database queries"
"Analyze the root cause of high latency in the frontend"

Configuration

"Set up Slack notifications for critical alerts"
"Create a dashboard for monitoring Redis performance"
"Configure SLO thresholds for the API service"

Development

Using Test PyPI Version

To use the pre-release version from Test PyPI:

{
  "mcpServers": {
    "coroot": {
      "command": "uvx",
      "args": [
        "--index-url",
        "https://test.pypi.org/simple/",
        "--extra-index-url",
        "https://pypi.org/simple/",
        "mcp-coroot"
      ],
      "env": {
        "COROOT_BASE_URL": "http://localhost:8080",
        "COROOT_USERNAME": "admin",
        "COROOT_PASSWORD": "your-password"
      }
    }
  }
}

Note: The --extra-index-url is required because Test PyPI doesn't host all dependencies.

Testing

# Run all tests
uv run pytest

# Run with coverage
uv run pytest --cov

# Run specific tests
uv run pytest tests/test_server.py -v

Code Quality

# Type checking
uv run mypy src

# Linting
uv run ruff check src tests

# Formatting
uv run ruff format src tests

API Compatibility

This MCP server is compatible with Coroot v1.0+ and implements the full management API surface. For data ingestion endpoints, use the Coroot API directly with your API key.

Troubleshooting

Connection Issues

Verify Coroot is accessible at the configured URL
Check firewall rules and network connectivity
Ensure credentials are correct

Authentication Errors

Username/password authentication is recommended for automatic login
Session cookies expire after 7 days of inactivity
API keys only work for data ingestion, not management APIs

Large Response Errors

Some endpoints return large datasets. Use time filters:

get_application_traces - Use from_timestamp and to_timestamp
get_application_profiling - Limit time range to reduce data size

Contributing

Contributions are welcome! Please:

Fork the repository
Create a feature branch
Add tests for new functionality
Ensure all tests pass
Submit a pull request

License

MIT License - see LICENSE file for details.

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

View all tools

A Model Context Protocol server that provides seamless integration with Coroot observability platform, enabling monitoring of applications, analysis of performance metrics, examination of logs and traces, and management of infrastructure through Coroot's comprehensive API.

Related Resources

Reddit Discussion about this server

Related MCP Servers

Workato MCP Server
jacobgoren-sb
-
security
A
license
-
quality
A Model Context Protocol server that provides seamless interaction with Workato's API through custom AI tools, enabling management of recipes, connections, connectors, folders, and activity logs.
Last updated -
TypeScript
MIT License
Godot MCP
Coding-Solo
A
security
A
license
A
quality
A Model Context Protocol server that enables AI assistants to interact with the Godot game engine, allowing them to launch the editor, run projects, capture debug output, and control project execution.
Last updated -
14
651
JavaScript
MIT License
HubSpot MCP Server
KaranThink41
-
security
A
license
-
quality
A Model Context Protocol server that provides tools for interacting with HubSpot CRM, allowing users to create, update, delete, and fetch summary records stored as Note engagements in HubSpot.
Last updated -
JavaScript
MIT License
FastMCP
ryuichi1208
-
security
F
license
-
quality
A lightweight Model Context Protocol server that enables creating, managing, and querying model contexts with integrated Datadog metrics and monitoring.
Last updated -
Python

View all related MCP servers