Qorrelate MCP Server

Model Context Protocol (MCP) server that enables AI agents to fully manage Qorrelate observability. With 123 tools, agents can query data, create organizations, manage alerts, build dashboards, set up automations, and more—all through natural language.

Why Use This?

• Zero Config Setup: Just say "login to qorrelate" - browser auth works instantly, no API keys needed
• AI-Native Observability: Let AI assistants investigate issues, create alerts, and manage your observability stack
• Full Platform Access: 123 tools covering every Qorrelate feature
• Zero Setup for New Users: Create organizations, generate API keys, and instrument codebases entirely via AI
• Cost Optimization: AI can analyze usage, create drop filters, and optimize data retention

Features

| Category | Tools | Capabilities | |----------|-------|--------------| | Logs | 3 | Query, histogram, error analysis | | Traces | 4 | Search, latency analysis, dependency mapping | | Metrics | 3 | Query, list, period comparison | | Alerts | 7 | CRUD, acknowledge, templates | | Dashboards | 8 | CRUD for dashboards and panels | | Organizations | 19 | Create/delete orgs, API keys, members, usage, billing, retention, audit logs | | Workflows | 8 | Automated actions triggered by alerts | | Notifications | 7 | Slack, email, PagerDuty, webhook destinations | | Sessions | 4 | Session replay analysis, LLM-readable narratives | | Services | 4 | Health monitoring, service map | | Analytics | 10 | Web vitals, pages, devices, cardinality | | Data Control | 4 | Drop filters for cost control | | Setup | 7 | OTEL config generation | | User | 6 | Profile, invitations | | Saved Searches | 4 | Save and reuse queries | | AI Chat | 5 | Converse with Qorrelate's AI | | Agent Workflows | 12 | Webhooks, AI investigation, runbooks | | Open in Browser | 6 | Direct links to sessions, dashboards, traces | | Auth | 2 | Browser-based login |

Total: 123 tools

Installation

For Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "qorrelate": {
      "command": "npx",
      "args": ["-y", "qorrelate-mcp-server"],
      "env": {
        "QORRELATE_API_KEY": "your-api-key-here",
        "QORRELATE_ORG_ID": "your-org-id",
        "QORRELATE_ENDPOINT": "https://qorrelate.io"
      }
    }
  }
}

For Cursor

Add to .cursor/mcp.json in your home directory:

{
  "mcpServers": {
    "qorrelate": {
      "command": "npx",
      "args": ["-y", "qorrelate-mcp-server"],
      "env": {
        "QORRELATE_API_KEY": "your-api-key-here",
        "QORRELATE_ORG_ID": "your-org-id",
        "QORRELATE_ENDPOINT": "https://qorrelate.io"
      }
    }
  }
}

New User? No API Key Yet? (Recommended)

Start without any configuration - just add the MCP and authenticate via browser:

{
  "mcpServers": {
    "qorrelate": {
      "command": "npx",
      "args": ["-y", "qorrelate-mcp-server"],
      "env": {
        "QORRELATE_ENDPOINT": "https://qorrelate.io"
      }
    }
  }
}

Then just ask your AI: "Login to Qorrelate"

That's it! The AI will:

1. Open a browser login page
2. You sign in with Google/GitHub/email
3. All 123 tools work immediately - no config changes needed

Want to set up observability too? Ask: "Help me instrument my codebase for Qorrelate"

The AI will:

1. Open a browser for login/signup via login tool
2. Create an organization via create_organization
3. Generate API keys via create_api_key
4. Generate OTEL config for your stack via generate_collector_config
5. Validate data is flowing via validate_ingestion

Complete Tool Reference

Authentication (2 tools)

| Tool | Description | |------|-------------| | login | Start browser-based Auth0 login flow | | login_status | Check if login completed |

Logs (3 tools)

| Tool | Description | |------|-------------| | query_logs | Search logs with filters | | logs_get_histogram | Log volume over time | | logs_get_error_summary | Group errors by message |

Traces (4 tools)

| Tool | Description | |------|-------------| | search_traces | Find traces with filters | | get_trace | Get full trace with spans | | traces_analyze_latency | P50/P95/P99 analysis | | traces_find_dependencies | Service dependency map |

Metrics (3 tools)

| Tool | Description | |------|-------------| | query_metrics | Query time-series data | | metrics_list | List available metrics | | metrics_compare | Compare two time periods |

Alerts (7 tools)

| Tool | Description | |------|-------------| | list_alerts | List active/historical alerts | | alerts_get_details | Get alert details | | acknowledge_alert | Mark as investigating | | alerts_summary | Counts by severity/service | | create_alert | Create new alert rule | | update_alert | Modify alert | | delete_alert | Remove alert |

Notification Destinations (4 tools)

| Tool | Description | |------|-------------| | list_notification_destinations | List Slack/email/PagerDuty configs | | create_notification_destination | Add new destination | | update_notification_destination | Modify destination | | delete_notification_destination | Remove destination |

Alert Templates (3 tools)

| Tool | Description | |------|-------------| | list_alert_templates | List pre-built templates | | get_recommended_alert_templates | Templates for your services | | create_alert_from_template | Quick alert creation |

Dashboards (8 tools)

| Tool | Description | |------|-------------| | list_dashboards | List all dashboards | | get_dashboard | Get dashboard with panels | | create_dashboard | Create new dashboard | | update_dashboard | Modify dashboard | | delete_dashboard | Remove dashboard | | add_panel | Add panel to dashboard | | update_panel | Modify panel | | delete_panel | Remove panel |

Session Replays (4 tools)

| Tool | Description | |------|-------------| | list_sessions | Find user sessions | | get_session | Get session details/events | | get_session_narrative | LLM-readable timeline of user actions, clicks, errors, and navigation | | sessions_analyze_errors | JS error analysis |

Services (4 tools)

| Tool | Description | |------|-------------| | list_services | List all services | | get_service_health | Error rate, latency | | services_overview | All service status | | services_compare_health | Compare services |

Organizations (19 tools)

| Tool | Description | |------|-------------| | list_organizations | List accessible orgs | | create_organization | Create new org | | leave_organization | Leave an org | | delete_organization | Delete org permanently | | clear_organization_data | Clear logs/traces/metrics | | get_organization_members | List members | | invite_user | Invite by email | | list_invitations | List pending invites | | create_api_key | Generate API key | | list_api_keys | List keys | | revoke_api_key | Revoke key | | get_usage | Usage statistics | | get_billing | Billing info | | get_data_usage_summary | Detailed breakdown | | get_unused_metrics | Find unused metrics | | get_retention_settings | Data retention config | | update_retention_settings | Change retention | | get_audit_logs | Who did what | | get_audit_log_summary | Activity summary |

Workflows (8 tools)

| Tool | Description | |------|-------------| | list_workflows | List automations | | get_workflow | Workflow details | | create_workflow | Create automation | | update_workflow | Modify workflow | | delete_workflow | Remove workflow | | run_workflow | Trigger manually | | get_workflow_executions | Execution history | | get_workflow_execution | Execution details |

User Profile (6 tools)

| Tool | Description | |------|-------------| | get_me | Current user info | | get_my_profile | Profile details | | update_my_profile | Update profile | | get_my_invitations | Pending invitations | | accept_invitation | Join organization | | decline_invitation | Decline invite |

Saved Searches (4 tools)

| Tool | Description | |------|-------------| | list_saved_searches | List saved queries | | create_saved_search | Save a query | | delete_saved_search | Remove saved query | | get_recent_searches | Recent queries |

Web Analytics (5 tools)

| Tool | Description | |------|-------------| | analytics_overview | Page views, visitors | | analytics_pages | Top pages | | analytics_devices | Browser/device breakdown | | analytics_geographic | Country/city breakdown | | analytics_web_vitals | Core Web Vitals |

Advanced Analytics (5 tools)

| Tool | Description | |------|-------------| | get_service_map | Service topology | | get_log_patterns | Detect log patterns | | get_guardrails | Rate limits/quotas | | estimate_query_cost | Query cost estimate | | get_cardinality_analysis | High-cardinality labels |

Data Control (4 tools)

| Tool | Description | |------|-------------| | list_drop_filters | List filters | | create_drop_filter | Drop noisy data | | delete_drop_filter | Remove filter | | get_drop_filter_stats | Data savings |

Setup & Instrumentation (7 tools)

| Tool | Description | |------|-------------| | generate_otel_python | Python SDK config | | generate_otel_node | Node.js SDK config | | generate_otel_go | Go SDK config | | generate_collector_config | OTEL Collector YAML | | generate_session_replay | Replay JS snippet | | validate_ingestion | Check data flow | | get_onboarding_status | Setup progress |

AI Chat (5 tools)

| Tool | Description | |------|-------------| | list_chats | List conversations | | get_chat | Get conversation | | create_chat | Start conversation | | send_chat_message | Chat with AI | | delete_chat | Remove conversation |

Webhooks (3 tools)

| Tool | Description | |------|-------------| | list_webhooks | List webhook destinations | | create_webhook | Create new webhook | | test_webhook | Test a webhook URL |

Dashboard Folders (4 tools)

| Tool | Description | |------|-------------| | list_dashboard_folders | List folders | | create_dashboard_folder | Create folder | | update_dashboard_folder | Update folder | | delete_dashboard_folder | Delete folder |

Agent Workflows (5 tools)

| Tool | Description | |------|-------------| | ai_investigate | AI investigates an issue | | ai_generate_workflow | AI generates automation | | get_runbook | Get incident runbook | | get_agent_services_summary | Services for AI agents | | toggle_drop_filter | Enable/disable filter |

Open in Browser (6 tools)

| Tool | Description | |------|-------------| | open_session_replay | Get URL to watch a session | | open_dashboard | Get URL to view a dashboard | | open_trace | Get URL to view trace waterfall | | open_logs | Get URL to log explorer with query | | open_alert | Get URL to alert details | | open_service | Get URL to service overview |

Example Prompts

Getting Started

"Sign me up for Qorrelate and create an organization called 'My Company'"

"Generate the OpenTelemetry configuration for my Python FastAPI app"

"Check if data is flowing to Qorrelate"

Investigating Issues

"Show me all errors from the payment-service in the last hour"

"What's causing the spike in 500 errors?"

"Find traces with latency over 2 seconds"

"What did user [email protected] experience during their session?" (uses get_session_narrative)

"Find sessions with JavaScript errors and tell me what users were doing when errors occurred"

Setting Up Alerts

"Create an alert that fires when error rate exceeds 5%"

"Set up a Slack notification for all critical alerts"

"Show me recommended alert templates for my services"

Cost Optimization

"What's my usage this month?"

"Find metrics that haven't been queried in 7 days"

"Create a drop filter to remove DEBUG logs"

"Analyze my metric cardinality for high-cost labels"

Team Management

"Invite [email protected] to my organization"

"Create an API key for the production collector"

"Show me the audit logs for the last 24 hours"

Agent-First Workflows

"Investigate why checkout is slow" (uses ai_investigate)

"Create a workflow that notifies Slack when errors spike" (uses ai_generate_workflow)

"Set up a webhook to send alerts to our Discord"

"Test if my Slack webhook is working"

"Show me the runbook for handling high error rates"

"Temporarily disable the DEBUG log filter"

Resources

The MCP also exposes read-only resources:

| Resource | Description | |----------|-------------| | qorrelate://services | Available services | | qorrelate://alerts/active | Firing alerts | | qorrelate://onboarding | Setup status | | qorrelate://ingestion | Ingestion status | | qorrelate://billing | Current billing | | qorrelate://drop-filters | Active filters |

Environment Variables

| Variable | Description | Default | |----------|-------------|---------| | QORRELATE_API_KEY | API key (optional with login) | - | | QORRELATE_ENDPOINT | API endpoint | https://qorrelate.io | | QORRELATE_ORG_ID | Default organization ID | - |

Development

cd mcp-server
npm install
npm run build
npm start

Support

• Documentation: https://qorrelate.io/documentation
• Issues: https://github.com/sethmichaelking/arqive/issues
• Email: [email protected]

License

MIT