MCP Overview

The Model Context Protocol (MCP) lets AI assistants query your OpsTrails timeline directly. Instead of manually searching for events, ask your AI assistant questions like“what was deployed in the last 2 hours?” or“did the error rate spike after the last deployment?”

What is MCP?

MCP is an open protocol that enables AI models to interact with external data sources and tools. When you connect OpsTrails as an MCP server, your AI assistant gains access to 8 tools for querying events, analyzing metrics, and understanding your operational history.

How It Works

1. Connect — Add the OpsTrails MCP server to your AI assistant (Claude.ai, Claude Desktop, Claude Code, VS Code, Cursor, or Copilot)
2. Authenticate — Provide an API key or authorize via OAuth (Claude.ai)
3. Ask — Your AI assistant can now query events, check metrics, and investigate incidents using natural language

MCP Server URL

The OpsTrails MCP server is available at:

https://api.opstrails.dev/api/mcp/mcp

Transport: Streamable HTTP

Authentication

There are two ways to authenticate with the MCP server:

• OAuth 2.0 (Claude.ai) — Claude.ai handles the OAuth flow automatically. You sign in to OpsTrails, select an organization, and approve access. A read-only API key is created and managed for you.
• API Key (all other clients) — Generate a READ_ONLY API key in the console and pass it as a Bearer token in the Authorization header.

Available Tools

The MCP server exposes 8 tools. See the MCP Tools Reference for full documentation.

• get_organization_context — Understand the org's data model
• query_events — Search and filter events
• get_event_summary — High-level activity overview
• list_event_types — Discover tracked event types
• list_event_sources — Discover tracked sources
• list_event_subjects — Discover tracked subjects
• get_metrics_around_event — Before/after metric comparison
• list_metric_names — Available metrics

Setup Guides

• Claude.ai — OAuth-based integration
• Claude Desktop — Local config file
• Claude Code — CLI command
• VS Code / Cursor / Copilot — Workspace MCP config
• Copilot CLI — CLI config file