Acts as a bridge to observability backends for querying Prometheus metrics and Loki logs, enabling alert investigation, troubleshooting, and correlation of metrics and logs for monitored services.
Provides tools for querying Prometheus metrics using PromQL, discovering metrics and labels, retrieving current and historical metric values, and investigating service health and performance issues.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@OpenTelemetry MCP Server show me the top 5 services by error rate in the last hour"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP server for querying Prometheus metrics and Loki logs with OIDC authentication.
Query Prometheus metrics (PromQL)
Query Loki logs (LogQL)
HTTP API for K8s deployment
Service discovery (metrics, labels, log streams)
Related MCP server: Prometheus MCP Server
# 1. Install
git clone <your-repo-url>
cd otel-mcp
uv sync
# 2. Configure .env
cp .env.example .env
# Edit .env with your Prometheus/Loki URLs
# 3. Run (stdio mode for local MCP)
uv run python -m src.serverSee K8S_DEPLOYMENT.md for full deployment guide.
# Build and deploy
docker build -t your-registry/otel-mcp:latest .
kubectl apply -f k8s/
# Access at https://otel-mcp.your-domain.comquery_prometheus - Execute PromQL instant queries
query_prometheus_range - Query metrics over time range
list_metrics - List available metrics
list_label_values - Get label values (discover services)
list_labels - List all label names
query_loki - Execute LogQL queries
search_logs - Simple log search with filters
list_log_labels - List log stream labels
list_log_label_values - Get log label values
Deploy HTTP server behind Authentik for authentication.
See K8S_DEPLOYMENT.md for complete setup.
# Build and deploy
docker build -t registry/otel-mcp:latest .
kubectl apply -f k8s/
# Use the API
curl -H "Authorization: Bearer YOUR_TOKEN" \
https://otel-mcp.your-domain.com/tools
curl -X POST https://otel-mcp.your-domain.com/call \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"tool": "query_prometheus", "arguments": {"query": "up"}}'For local MCP clients like Claude Desktop.
# Run stdio server
uv run python -m src.server
# Claude Desktop config
{
"mcpServers": {
"otel-mcp": {
"command": "uv",
"args": ["--directory", "/path/to/otel-mcp", "run", "python", "-m", "src.server"],
"env": {
"PROMETHEUS_URL": "http://localhost:9090",
"LOKI_URL": "http://localhost:3100"
}
}
}
}Variable | Default | Description |
|
| Prometheus endpoint |
|
| Loki endpoint |
|
| Enable OIDC auth |
| - | OIDC provider URL |
| - | OAuth2 client ID |
| - | Token audience (optional) |
|
| Logging level |
|
| Query timeout (seconds) |
Prometheus/Loki support Basic Auth and Bearer tokens:
# Basic Auth
PROMETHEUS_AUTH_TYPE=basic
PROMETHEUS_USERNAME=admin
PROMETHEUS_PASSWORD=secret
# Bearer Token
LOKI_AUTH_TYPE=bearer
LOKI_BEARER_TOKEN=your-token# List services
{"tool": "list_label_values", "arguments": {"label": "job"}}
# Query CPU usage
{"tool": "query_prometheus", "arguments": {"query": "rate(cpu_usage[5m])"}}
# Search error logs
{"tool": "search_logs", "arguments": {"search_text": "error", "start": "1h"}}MIT
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
AI agent run monitoring with incident replay and SLA receipts.
Persistent memory and knowledge management for AI agents with semantic search and 50+ tools.
Provide real-time data querying and visualization by integrating Tako with your agents. Generate o…
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/agarwalvivek29/opentelemetry-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server
