Skip to main content

Model Context Protocol (MCP)

Oodle provides a Model Context Protocol (MCP) integration that enables AI assistants like Cursor to directly access your observability data. Query logs, metrics, traces, alerts, and Grafana dashboards using natural language.

What is MCP?​

Model Context Protocol is an open protocol that standardizes how AI applications interact with external data sources. By connecting Oodle through MCP, your AI assistant can:

  • Query and filter logs
  • Execute PromQL queries for metrics
  • Search and analyze traces
  • Check active alerts and monitor status
  • Access and search Grafana dashboards

Supported AI Assistants​

Oodle's MCP integration works with:

As MCP adoption grows, more AI assistants will support the protocol.

Available Tools​

The Oodle MCP server provides comprehensive observability tools across five categories:

Logs​

Query and filter logs with flexible time ranges and field-based filtering. Discover available fields and run aggregations to analyze log patterns.

Metrics​

Execute PromQL queries to access your metrics data. Search for metrics, explore labels, and validate queries.

Traces​

Search distributed traces by service, operation, or custom tags. Retrieve specific trace details and explore available trace attributes.

Alerts​

Access active alerts, view monitor configurations, and check historical trigger data to understand your alerting landscape.

Grafana​

Interact with Grafana dashboards programmatically. Search, retrieve, update dashboards, and query panel data directly.

Authentication​

MCP integration uses your Oodle API key for authentication. The API key is configured once in your AI assistant's MCP settings and used for all subsequent requests.

Getting Started​

Follow the integration guide for your AI assistant:

Support​

If you need assistance or have any questions, please reach out to us through:

  • The help chat widget in the bottom-right corner of this page
  • Email at support@oodle.ai