Skip to content

Latest commit

 

History

5 Commits

Folders and files

Repository files navigation

Coralogix MCP Server

Query and investigate your Coralogix observability data — logs, spans, metrics, RUM, alerts, cases, dashboards and service catalog — from any Model Context Protocol client.

The server is fully hosted and remote. There is nothing to install, build, or run.

https://api.<region>.coralogix.com/mgmt/api/v1/mcp

About this repository. This is the public home for Coralogix MCP documentation, connection examples, and registry metadata. The server implementation is maintained privately by Coralogix; this repo carries no server source code. See Contributing.


Quick start

Pick your client, substitute your region, and connect. OAuth runs in the browser on first use — no API key needed.

Claude Code

claude mcp add --transport http coralogix https://api.eu2.coralogix.com/mgmt/api/v1/mcp

Cursor — .cursor/mcp.json

{
  "mcpServers": {
    "coralogix": {
      "url": "https://api.eu2.coralogix.com/mgmt/api/v1/mcp"
    }
  }
}

Codex

codex mcp add coralogix --url "https://api.eu2.coralogix.com/mgmt/api/v1/mcp"

Full, copy-pasteable configurations for these and other clients are in examples/clients/.

Then ask your assistant:

"Show me the most frequent errors for service payments-api in the last hour." "Why did this alert fire? Walk me through the case timeline." "What's the p99 latency for checkout over the past 24 hours?"

More in examples/prompts/.


What it can do

71 tools across 21 capability domains — 65 by default, plus the six Olly agent tools when x-allow-costly-use is set — and 20 skills that teach the model Coralogix query languages and investigation workflows on demand.

Domain What it covers
Logs, Spans & Datasets Query logs, spans and named datasets with DataPrime
Metrics PromQL instant and range queries, metric and label discovery
Alerts & Cases Alert definitions, alert events, case triage and lifecycle
Service Catalog RED metrics — error rate, latency percentiles, throughput, saturation
Service Map Service-to-service dependency graph
Infrastructure Resource inventory, health history, raw resource data
RUM Real user monitoring — Web Vitals, frontend errors, sessions
Dashboards List, search, create, replace and delete dashboards and folders
Saved Views Manage saved log views and view folders
Data Usage Billable ingestion volumes, quota attribution, usage trends
AI Center Observe and evaluate GenAI applications, guardrails, model pricing
Field Discovery Semantic search across log and span fields
Schemas Dataset schemas and available fields
DataPrime Language Command and function reference, construct guidance
Documentation Search and fetch Coralogix docs
Utilities Current UTC time, for grounding relative time ranges
Olly Agent Coralogix's natural-language observability agent (opt-in)

Tools declare MCP annotations (readOnlyHint, destructiveHint, openWorldHint) so clients know what needs approval. Most are read-only; the manage_* tools that mutate state are flagged destructive.


Documentation

Getting started Connect, verify, and run a first query
Regions Endpoint URL for every Coralogix region
Authentication OAuth 2.1 and API key, permissions, tenancy
Tool catalog All 71 current tools, and the 12 deprecated ones, with annotations
Skills The 20 progressive-disclosure skills
Headers and versioning mcp-version, x-allow-costly-use
Troubleshooting Common failures and what they mean
Registry publishing How server.json is published and verified

Agents: start at llms.txt.


Registry

Registry metadata lives in server.json, following the official MCP registry schema.

Registry name com.coralogix/mcp-server
Transport streamable-http
Server version 2.0.0
Authentication OAuth 2.1 (OIDC) or bearer API key

Support

Releases

Packages

Used by

Contributors