# Qorrelate - AI-Native Observability Platform
# https://qorrelate.io
# Last updated: 2026-02-08

> Qorrelate is an observability platform for logs, metrics, traces, and session replays. 
> It features a Model Context Protocol (MCP) server with 227 tools, enabling AI agents 
> to fully manage observability without human intervention.

## What is Qorrelate?

Qorrelate is a modern observability platform built on ClickHouse and OpenTelemetry. It provides:

- **Distributed Tracing**: End-to-end request tracking across microservices
- **Log Management**: Centralized logging with full-text search
- **Metrics Monitoring**: Time-series metrics with powerful querying
- **Session Replay**: Record and replay user sessions with DOM snapshots
- **Web Analytics**: Core Web Vitals, page views, geographic and device analytics
- **Alerting**: Flexible alerting with Slack, email, PagerDuty, and webhooks
- **Custom Dashboards**: Build visualizations for any data
- **Telemetry Pipeline**: Chronosphere-style data processing at ingestion time
- **Fleet Management**: Auto-discover services, manage agent deployments at scale
- **Cost Optimization**: Drop filters, aggregation rules, utility scoring, budget alerts

## MCP Server for AI Agents

Qorrelate provides a Model Context Protocol (MCP) server that enables AI assistants (Claude, GPT, Cursor, etc.) to fully manage observability.

### Installation

```bash
npx qorrelate-mcp-server
```

### Zero-Config Setup (Recommended)

No API key needed! Just add the MCP and say "login to qorrelate":

```json
{
  "mcpServers": {
    "qorrelate": {
      "command": "npx",
      "args": ["-y", "qorrelate-mcp-server"]
    }
  }
}
```

Browser login works instantly - all 227 tools available immediately after sign-in.

### With API Key (Optional)

For persistent authentication across restarts:

```json
{
  "mcpServers": {
    "qorrelate": {
      "command": "npx",
      "args": ["-y", "qorrelate-mcp-server"],
      "env": {
        "QORRELATE_API_KEY": "your-api-key",
        "QORRELATE_ORG_ID": "your-org-id"
      }
    }
  }
}
```

### 227 Tools Available

The MCP server exposes 227 tools across these categories:

| Category | Tools | Description |
|----------|-------|-------------|
| Auth | 2 | Browser-based login |
| Logs | 3 | Query logs, histogram, error summary |
| Traces | 4 | Search traces, latency analysis, dependencies |
| Metrics | 3 | Query metrics, list, compare periods |
| Alerts | 7 | CRUD alerts, acknowledge, templates |
| Dashboards | 8 | CRUD dashboards and panels |
| Organizations | 42 | Create/manage orgs, API keys, members, billing, usage, retention |
| Workflows | 8 | Automated actions on alerts |
| Notifications | 7 | Slack, email, PagerDuty destinations |
| Sessions | 4 | Session replay analysis, LLM-readable narratives |
| Services | 4 | Health monitoring, service map |
| Analytics | 11 | Web vitals, cardinality, patterns, geographic, device analytics |
| Data Control | 28 | Drop filters, aggregation rules, utility scoring, cost optimization |
| Setup | 8 | OTEL config generation for Python, Node.js, Go, Collector |
| User | 6 | Profile and invitations |
| Saved Searches | 4 | Save and reuse queries |
| AI Chat | 5 | Converse with Qorrelate AI |
| Agent Workflows | 25 | Webhooks, AI investigation, runbooks, workflow generation |
| Pipelines | 19 | Telemetry pipeline CRUD, processing rules, testing |
| Feature Flags | 8 | Gradual rollout management |
| Fleet Management | 20 | Agent registration, discovery, remote config |
| Open in Browser | 6 | Direct links to sessions, dashboards, traces |

### Key Tool Examples

**Query Logs**
- Tool: `query_logs`
- Args: `{ "query": "level:ERROR", "service": "backend", "limit": 100 }`

**Search Traces**
- Tool: `search_traces`
- Args: `{ "service": "api-gateway", "min_duration_ms": 1000 }`

**Create Alert**
- Tool: `create_alert`
- Args: `{ "name": "High Error Rate", "type": "error_rate", "threshold": 5, "severity": "critical" }`

**Generate OTEL Config**
- Tool: `generate_collector_config`
- Args: `{ "services": ["frontend", "backend", "worker"] }`

**Create Organization**
- Tool: `create_organization`
- Args: `{ "name": "My Company" }`

**Create Drop Filter (Cost Control)**
- Tool: `create_drop_filter`
- Args: `{ "name": "Drop DEBUG", "filter_type": "logs", "query": "level:DEBUG" }`

**Session Investigation (LLM-Readable)**
- Tool: `get_session_narrative`
- Args: `{ "session_id": "session-123" }`
- Returns: Human-readable timeline of user actions, clicks, errors, page navigation, scroll depth, and form submissions that LLMs can understand and reason about.

**AI Investigation**
- Tool: `ai_investigate`
- Args: `{ "query": "High latency on checkout API", "time_range": "1h" }`
- Returns: AI-powered root cause analysis with correlated logs, traces, and metrics.

**Telemetry Pipeline**
- Tool: `create_pipeline`
- Args: `{ "organization_id": "org-123", "name": "Filter debug logs", "sources": ["otlp"], "destinations": ["qorrelate"] }`

**Open in Browser**
- Tool: `open_session_replay`, `open_dashboard`, `open_trace`, `open_logs`, `open_alert`, `open_service`
- Generate direct URLs to view specific sessions, dashboards, or traces in the Qorrelate UI.

### Full Onboarding via AI

An AI agent can complete full onboarding:

1. `login` - Open browser for signup
2. `create_organization` - Create org
3. `create_api_key` - Generate collector key
4. `generate_collector_config` - OTEL YAML for services
5. `validate_ingestion` - Verify data flowing
6. `get_recommended_alert_templates` - Suggest alerts
7. `create_alert_from_template` - Create alerts
8. `create_dashboard` - Build monitoring dashboards
9. `create_drop_filter` - Optimize costs

## API Endpoints

Base URL: `https://qorrelate.io`

### Authentication
- Header: `X-API-Key: your-key`
- Or query param: `?api_key=your-key`

### Ingestion (OTLP)
- POST `/v1/traces` - Ingest traces
- POST `/v1/metrics` - Ingest metrics
- POST `/v1/logs` - Ingest logs
- POST `/v1/replay` - Ingest session replay

### Query
- GET `/v1/traces/search` - Search traces
- GET `/v1/traces/{trace_id}` - Get trace
- GET `/v1/logs/search` - Search logs
- GET `/v1/metrics/query` - Query metrics
- GET `/v1/replay` - List sessions

### Management
- GET/POST `/v1/organizations/{org_id}/alerts` - Alerts
- GET/POST `/v1/organizations/{org_id}/dashboards` - Dashboards
- GET/POST `/v1/organizations/{org_id}/drop-filters` - Drop filters
- GET/POST `/v1/organizations/{org_id}/pipelines` - Telemetry pipelines
- GET `/v1/organizations/{org_id}/usage` - Usage stats
- GET `/v1/organizations/{org_id}/billing` - Billing
- GET `/v1/agents` - Fleet management

## OpenTelemetry Integration

Qorrelate accepts standard OTLP (OpenTelemetry Protocol) data.

### Environment Variables
```bash
OTEL_SERVICE_NAME=my-service
OTEL_EXPORTER_OTLP_ENDPOINT=https://qorrelate.io
OTEL_EXPORTER_OTLP_HEADERS="X-API-Key=YOUR_KEY"
```

### Collector Config
```yaml
exporters:
  otlphttp:
    endpoint: https://qorrelate.io
    headers:
      X-API-Key: YOUR_KEY
```

## Pricing

- **Free Tier**: 1GB logs, 1M spans, 10M metrics/month
- **Pro**: $0.30/GB logs, $1.50/M spans, $8/M metrics
- **Enterprise**: Volume discounts, dedicated support

## Links

- Website: https://qorrelate.io
- Documentation: https://qorrelate.io/docs
- API Docs: https://qorrelate.io/docs/api
- MCP Server: https://www.npmjs.com/package/qorrelate-mcp-server
- Blog: https://qorrelate.io/blog
- Sandbox: https://qorrelate.io/sandbox
- GitHub: https://github.com/sethmichaelking/arqive

## Contact

- Email: support@qorrelate.io
- Demo: https://qorrelate.io/demo-request