For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Sign inTry it free
DocsGuidesSDKsIntegrationsAPI docsTutorialsFlagship blog
DocsGuidesSDKsIntegrationsAPI docsTutorialsFlagship blog
  • Get started
    • Overview
    • Onboarding
    • Get started
    • Launch Insights
    • LaunchDarkly architecture
    • LaunchDarkly vocabulary
  • AgentControl
    • AgentControl
    • Manage AgentControl
  • Feature flags
    • Create flags
    • Target with flags
    • Flag templates
    • Manage flags
    • Code references
    • Contexts
    • Segments
  • Releases
    • Releasing features with LaunchDarkly
    • Release policies
    • Percentage rollouts
    • Progressive rollouts
    • Guarded rollouts
    • Feature monitoring
    • Release pipelines
    • Engineering insights
    • Release management tools
    • Applications and app versions
    • Change history
    • Restoring previous flag versions
  • Observability
    • Observability
    • Session replay
    • Error monitoring
    • Logs
    • Traces
    • Observability metrics
    • Product analytics events
    • LLM observability
    • Alerts
    • Dashboards
    • Service map
    • Vega for auto-remediation
    • Observability MCP server
    • Search specification
    • Observability settings
    • Observability integrations
  • Experimentation
    • Experimentation
    • Experiment metric types
    • Experiment configuration
    • Managing experiments
    • Analyzing experiments
    • Multi-armed bandits
    • Holdouts
  • Metrics and events
    • Metrics in LaunchDarkly
    • Creating metrics
    • Metric groups
    • Events
    • Autogenerated metrics
  • Warehouse native
    • Warehouse native metrics
    • Setting up external warehouses
    • Creating experiments using warehouse native metrics
  • Infrastructure
    • Connect apps and services to LaunchDarkly
    • LaunchDarkly in China and Pakistan
    • LaunchDarkly in the European Union (EU)
    • LaunchDarkly in federal environments
    • Public IP list
  • Your account
    • Projects
    • Views
    • Environments
    • Tags
    • Teams
    • Members
    • Roles
    • Account security
    • Feature previews
    • Billing and usage
    • Changelog
Sign inTry it free
LogoLogo
On this page
  • Overview
  • Prerequisites
  • Enable the observability MCP server
  • Use the observability MCP server
  • Available tools
  • Querying data
  • Discovering the schema
  • Dashboards
  • Observability MCP server and Vega
  • Additional resources
Observability

Observability MCP server

Was this page helpful?
Previous

Search specification

Next
Built with

Overview

This topic describes the LaunchDarkly observability MCP server, which lets AI clients query observability data, build dashboards, and triage incidents using natural language.

The observability MCP server is one of three hosted MCP servers that LaunchDarkly offers. Each server is focused on a different product area, and the three servers are independent. You can enable any combination of them.

If you use LaunchDarkly’s observability product and want to query it from your AI client, enable the observability server.

Related to Vega

The observability MCP server and Vega for auto-remediation are complementary. Vega runs inside LaunchDarkly and investigates issues from observability views or alerts. The observability MCP server exposes the same underlying data to your AI client, so the agent can query it directly while it’s working on your code. To learn more about the relationship, read Observability MCP server and Vega.

Prerequisites

To use the Observability MCP server, you need:

  • An AI client that supports MCP such as Cursor, Claude Code, VS Code with Copilot, or Windsurf.
  • A LaunchDarkly account with the observability product enabled. To learn more, read Observability.

Enable the observability MCP server

The observability MCP server is a hosted server and connects your AI client to LaunchDarkly using OAuth. To enable it, follow the instructions in LaunchDarkly hosted MCP server and use the URL https://mcp.launchdarkly.com/mcp/observability.

For example, to manually configure the observability MCP server in Claude Code:

Claude Code
1{
2 "mcpServers": {
3 "launchdarkly-observability": {
4 "type": "http",
5 "url": "https://mcp.launchdarkly.com/mcp/observability"
6 }
7 }
8}

The first time you invoke a tool, the AI client prompts you to authorize access to your LaunchDarkly account. After that, tokens are stored and refreshed automatically.

Use the observability MCP server

After you enable the observability MCP server, you can prompt your agent to query your observability data. Typically you need to click Run tool or similar in your AI client to execute the result.

For example, you could try asking:

Show me error groups from the last 24 hours for the checkout service

or

Find the slowest traces in the last hour where service_name is “gonfalon-web”

or

Create a dashboard that shows error rate and p95 latency for the payments service

or

Which flag evaluations happened during session <session-id>?

Available tools

The observability MCP server exposes the tools described in the following sections.

Querying data

  • query-logs — Query project logs with a date range and optional query filter (for example, level=error AND service_name="api").
  • query-traces — Query project traces with a date range and filter. Supports sorting by duration to find the slowest traces.
  • query-error-groups — Query project error groups with filters like error_type, exception.message, or service_name.
  • query-sessions — Query project sessions, including filtering by identifier, errors, or session attributes.
  • query-aggregations — Retrieve bucketed, aggregated counts over time for a product type (useful for charts and trends rather than individual records).
  • query-flag-evaluations — Query flag evaluations for a specific session.
  • query-timeline-events — Query timeline indicator events for a specific session.

Discovering the schema

  • get-keys — Discover available data keys and dimensions for a product type (logs, traces, sessions, errors, metrics). Use this before building dashboards or crafting complex filters.

Dashboards

  • list-dashboards — List existing dashboards for a project.
  • get-dashboard — Get detailed information about a specific dashboard.
  • create-dashboard — Create a new empty dashboard for organizing charts.
  • create-graph — Add a chart or graph to an existing dashboard.

To learn about each tool’s inputs and outputs, review the tools list in your AI client after you enable the server.

Observability MCP server and Vega

The observability MCP server and Vega both help you understand observability data with AI assistance, but they run in different places and are used for different workflows:

Observability MCP serverVega for auto-remediation
Runs inYour AI client (Cursor, Claude Code, Copilot, Windsurf)The LaunchDarkly UI and alerts
Best forQuerying observability data while you work on code, bulk exploration, custom prompts, building dashboards from natural languageAutomated incident triage, summarizing issues, suggesting or opening fixes in GitHub
TriggerYou prompt the agentYou launch it from a logs, traces, errors, or sessions view, or it fires on alerts
OutputsRaw data, summaries, dashboardsInvestigations, root cause summaries, GitHub pull requests

You can use both the observability MCP server and Vega. For example, you might let Vega triage an alert inside LaunchDarkly and open a draft pull request, then switch to your AI client and use the observability MCP server to dig deeper into the affected traces while you review the fix.

Additional resources

  • LaunchDarkly MCP server overview
  • LaunchDarkly hosted MCP server
  • Vega for auto-remediation
  • Observability
  • Search specification

For issues or feature requests, visit the LaunchDarkly MCP server GitHub repository.