{"id":"calmoai-mcp-server-signoz","name":"mcp-server-signoz","homepage":null,"repo_url":"https://github.com/CalmoAI/mcp-server-signoz","category":"ai-ml","subcategories":[],"tags":["mcp","observability","signoz","ai","clickhouse","golang","stdio","api-integration","analytics"],"what_it_does":"Provides a Go-based Model Context Protocol (MCP) server (STDIO transport) that exposes SigNoz observability data access as MCP tools. It connects to a user’s SigNoz instance (URL plus optional API key), supporting queries for dashboards, services, APM metrics, and trace/log retrieval via ClickHouse SQL, as well as executing custom ClickHouse or SigNoz builder queries within time ranges.","use_cases":["Use an AI/MCP client to inspect SigNoz dashboards and panel data","Retrieve APM metrics (request/error/latency/apdex) for a service over a time range","List instrumented services and explore what is deployed","Fetch traces or logs by issuing ClickHouse-based queries via MCP tools","Run custom ClickHouse SQL queries against SigNoz data (with time range support)","Assist troubleshooting by fetching observability data programmatically from an MCP client"],"not_for":["Serving as a public multi-tenant API gateway without additional security controls","Performing write operations or state changes in SigNoz (appears to be read/query-focused)","Handling extremely large/long-running analytics without careful query limits and time bounds","Use where you cannot control/secure SQL inputs from an untrusted user/agent"],"best_when":"You want an MCP-compatible integration to query SigNoz observability data from tools like Claude Desktop/Cursor using STDIO.","avoid_when":"You need a REST/HTTP API, webhooks, or cloud-hosted managed service rather than a local MCP server process; or you cannot restrict/validate query inputs when enabling custom SQL execution.","alternatives":["Use SigNoz dashboards/APIs directly (SigNoz HTTP API + auth)","Build a custom MCP server around SigNoz APIs tailored to your specific queries and validation requirements","Use other MCP servers/observability integrations (if available) that focus on narrower, safer query sets"],"af_score":66.2,"security_score":55.8,"reliability_score":25.0,"package_type":"mcp_server","discovery_source":["github"],"priority":"low","status":"evaluated","version_evaluated":null,"last_evaluated":"2026-04-04T19:36:11.106556+00:00","interface":{"has_rest_api":false,"has_graphql":false,"has_grpc":false,"has_mcp_server":true,"mcp_server_url":null,"has_sdk":false,"sdk_languages":[],"openapi_spec_url":null,"webhooks":false},"auth":{"methods":["SigNoz API key via SIGNOZ_MCP_SIGNOZ_API_KEY (optional per README)"],"oauth":false,"scopes":false,"notes":"Authentication is described as optional depending on SigNoz configuration. No OAuth or fine-grained scope model is described for MCP access itself; MCP server appears to rely on the configured upstream SigNoz auth."},"pricing":{"model":null,"free_tier_exists":false,"free_tier_limits":null,"paid_tiers":[],"requires_credit_card":false,"estimated_workload_costs":null,"notes":"Pricing for the package/service is not described; repository appears to be open source and self-hosted."},"requirements":{"requires_signup":false,"requires_credit_card":false,"domain_verification":false,"data_residency":[],"compliance":[],"min_contract":null},"agent_readiness":{"af_score":66.2,"security_score":55.8,"reliability_score":25.0,"mcp_server_quality":80.0,"documentation_accuracy":70.0,"error_message_quality":0.0,"error_message_notes":null,"auth_complexity":85.0,"rate_limit_clarity":45.0,"tls_enforcement":80.0,"auth_strength":60.0,"scope_granularity":20.0,"dependency_hygiene":45.0,"secret_handling":70.0,"security_notes":"TLS is configurable and defaults to enabled; there is an option to skip certificate verification (which should be avoided). Upstream authentication is via SigNoz API key, but the MCP server’s own authorization model is not described (i.e., any MCP client that can access STDIO may query SigNoz). README claims input validation, built-in rate limiting, and that sensitive info is not exposed in errors, but it does not provide concrete details about SQL sanitization/guardrails for the custom query tools, which could be risky if untrusted agents/users can supply SQL.","uptime_documented":0.0,"version_stability":40.0,"breaking_changes_history":0.0,"error_recovery":60.0,"idempotency_support":"false","idempotency_notes":"The tools are predominantly read/query operations, but idempotency is not explicitly documented for MCP tool execution semantics.","pagination_style":"none","retry_guidance_documented":true,"known_agent_gotchas":["Custom ClickHouse/SQL execution tools can be expensive or slow; use strict time ranges and query limits to avoid timeouts.","If your SigNoz instance requires auth, missing/incorrect SIGNOZ_MCP_SIGNOZ_API_KEY will likely cause connectivity/auth errors.","TLS skip verification (SIGNOZ_MCP_SIGNOZ_TLS_SKIP_VERIFY) can reduce security; ensure it’s not enabled in production.","Tool outputs may depend on dashboard/service naming conventions; mismatches can lead to empty results or query failures."]}}