# Reported issues for SigNoz MCP Server

Pod holds 21 of 23 problems reported by people outside the maintainer team. Issues filed by the project's own owners, members and collaborators are excluded entirely — a maintainer's release checklist is not a warning to a prospective user.

Back to [SigNoz MCP Server](/mcp/signoz-mcp-server).

## Most discussed

### can not work in dify

the url is : `http://192.168.2.111:18000/mcp`
it can work in claude code as  install by `claude mcp add --scope user --transport http signoz http://192.168.2.111:18000/mcp`
but can not work in dify and other tools like cherry studio

[Read the thread](https://github.com/SigNoz/signoz-mcp-server/issues/169) · 2026-05-09 · closed · external user · 6 comments

### Why is the client storing the apikey? If we are caching the http client, we should reuse as much as possible to reuse connections. Otherwise it's an incomplete attempt to cache the http client.

Understood. Why is the client storing the apikey? If we are caching the http client, we should reuse as much as possible to reuse connections. Otherwise it's an incomplete attempt to cache the http client.

If the answer to this is "legacy" code, please take it up as an enhancement to be done later.

_Originally posted by @therealpandey in https://github.com/SigNoz/signoz-mcp-server/pull/63#discussion_r2955296138_

[Read the thread](https://github.com/SigNoz/signoz-mcp-server/issues/69) · 2026-03-18 · closed · outside contributor · 2 comments

### Add tools to mcp server to support update_alert

The SigNoz MCP Server only supports read-only alert operations (list alerts, get alert details, get alert history). There is no update_alert tool available yet.

[Read the thread](https://github.com/SigNoz/signoz-mcp-server/issues/64) · 2026-03-10 · closed · external user · 2 comments

### Write a blog on best practices to use SigNoz MCP server

highlight any tips which can help users make most use of it

[Read the thread](https://github.com/SigNoz/signoz-mcp-server/issues/31) · 2025-10-17 · open · outside contributor · 2 comments

### Enable creating dashboards via MCP tool calls?

Grafana MCP supports creating dashboards
https://github.com/grafana/mcp-grafana?tab=readme-ov-file#dashboards

[Read the thread](https://github.com/SigNoz/signoz-mcp-server/issues/23) · 2025-09-29 · closed · outside contributor · 16 comments

### Add SigNoz MCP Server as Claude Desktop Extension

https://github.com/anthropics/mcpb

Reference issues in Grafana MCP repo
https://github.com/grafana/mcp-grafana/issues/290

[Read the thread](https://github.com/SigNoz/signoz-mcp-server/issues/22) · 2025-09-29 · closed · outside contributor · 5 comments

### Claude not able to find logs & traces from a service

While investigating an alert, Claude was not able to find logs and traces from a particular service while I manually confirmed that the logs and traces from this service were present.

https://www.loom.com/share/fdc4a9b50f2b454483544d485ab0d901

[Read the thread](https://github.com/SigNoz/signoz-mcp-server/issues/17) · 2025-09-25 · closed · outside contributor · 4 comments

### get_alert_history doesn't work

I started with get_alert by giving the alert rule id. it works well but it keeps returning no alert history although there was at least one.

tried other alerts also doesn't work.

[Read the thread](https://github.com/SigNoz/signoz-mcp-server/issues/13) · 2025-09-21 · closed · outside contributor · 2 comments

## Most recent

### Add read-only tools to list and inspect log ingestion pipelines

SigNoz has a separate product surface for log ingestion/processing pipelines (parsers,
processors, enrichment rules applied to incoming logs) that currently has zero
representation in this MCP server's tool set. An agent today can search and aggregate
logs, but can't answer "why isn't this log being parsed/enriched the way I expect" — that
requires a human to open the SigNoz UI and check pipeline config directly.

Proposing two new **read-only** tools to start (scoping deliberately narrow for a 

[Read the thread](https://github.com/SigNoz/signoz-mcp-server/issues/270) · 2026-08-03 · open · external user · 1 comment

### Add a tool to expose the service dependency map (service-to-service call graph)

SigNoz's own UI has a Service Map feature — the call graph between services, including
per-edge error rate and latency. The MCP server currently exposes `signoz_list_services`
and `signoz_get_service_top_operations`, but nothing surfaces the actual dependency edges
between services.

This is a real gap for diagnostic workflows: answering "is the checkout failure caused by
something downstream" requires knowing what checkout actually calls, which today requires
leaving the chat to check the SigNo

[Read the thread](https://github.com/SigNoz/signoz-mcp-server/issues/269) · 2026-08-03 · open · external user · 0 comments

### Add tools to list, create, and delete planned-maintenance (downtime) schedules

> **Edited after digging into the SigNoz source — my original framing was wrong.** I opened this asking for Alertmanager *silence* tools. There is no silences API in SigNoz: `pkg/alertmanager/handler.go`'s `Handler` interface has no silence method, `pkg/apiserver/signozapiserver/alertmanager.go` exposes only channels / route policies / alerts, and Alertmanager is embedded as a library (`pkg/alertmanager/alertmanagerserver/server.go`) rather than run as a process, so upstream's `/api/v2/silences`

[Read the thread](https://github.com/SigNoz/signoz-mcp-server/issues/268) · 2026-08-03 · open · external user · 0 comments

### [foundry] docker healthcheck always fails on `signoz/signoz-mcp-server:latest`: image ships no `wget` (or any shell/coreutils)

**Environment**

- Image: `signoz/signoz-mcp-server:latest`, digest `sha256:da4fb0379d603a492fdbc0f384854f7d412a4c43347df2e086d17fc16770dd00` (build tag `main-2a64f20`, confirmed via Docker Hub API as the newest published build, 2026-07-17, still current at verification time 2026-07-19)
- Deployed via Foundry `foundryctl v0.2.14` (commit `6133128`), Docker Compose flavor, MCP enabled via `spec.mcp.spec.enabled: true`
- Host: macOS (Apple Silicon), Docker Desktop, Docker Engine 29.6.1, Compose v5

[Read the thread](https://github.com/SigNoz/signoz-mcp-server/issues/246) · 2026-07-18 · open · external user · 0 comments

### signoz_get_trace_details omits span links/references — async producer↔consumer traces can't be correlated

`signoz_get_trace_details` is described as "Get full trace with all spans", but the returned spans never include **span links** (OTel `Links` / references).

## Root cause

(Unverified claude research: ) `BuildTracesQueryPayload` (`pkg/types/querybuilder.go:550`) hardcodes the `SelectFields` list, and there is no entry for span links/references. So links are never requested from `/api/v5/query_range`. There is also no `link`/`references` field key exposed via `signoz_get_field_keys` (traces), so

[Read the thread](https://github.com/SigNoz/signoz-mcp-server/issues/229) · 2026-07-06 · open · external user · 0 comments

### Signoz mcp error x509 failed to verify cerificate when connecting to signoz in air-gapped private domain env

Hello,

we have signoz system running as self hosted on our closed air-gapped environment and we want to connect the signoz mcp to signoz.

we have configuared it via claude code that is running in our env.

the signoz mcp server is running on docker container and not he binary due to restrications in our env.

the claude code is connect to the mcp server, but when starting to use the tools and trying to get data from our signoz we get error x509 failed to verify, we tried to update the ca certi

[Read the thread](https://github.com/SigNoz/signoz-mcp-server/issues/177) · 2026-05-17 · open · external user · 1 comment

### fails to upload metrics in self-hosted Docker setup with "tls: first record does not look like a TLS handshake"

## Bug: `signoz-mcp-server` fails to upload metrics in self-hosted Docker setup with "`tls: first record does not look like a TLS handshake`"

### Summary

When using `signoz-mcp-server` against a healthy self-hosted SigNoz Docker deployment, the MCP server starts but repeatedly logs:

```text
failed to upload metrics: exporter export timeout: rpc error: code = Unavailable desc = connection error: desc = "transport: authentication handshake failed: tls: first record does not look like a TLS hand

[Read the thread](https://github.com/SigNoz/signoz-mcp-server/issues/136) · 2026-04-19 · closed · external user · 0 comments

### signoz_list_alerts returns empty: uses /api/v1/alerts (firing only) instead of /api/v1/rules

# `signoz_list_alerts` returns empty: uses `/api/v1/alerts` (firing only) instead of `/api/v1/rules`

## Bug Description

`signoz_list_alerts` tool returns an empty result even when there are alert rules defined in SigNoz. This is because it queries `/api/v1/alerts` (which only returns **currently firing** alerts) instead of `/api/v1/rules` (which returns all defined alert rules).

## Steps to Reproduce

1. Define alert rules in SigNoz (we have 16 rules, all in OK/inactive state)
2. Call `signoz

[Read the thread](https://github.com/SigNoz/signoz-mcp-server/issues/119) · 2026-04-14 · closed · external user · 0 comments

### MCP Server OpenAPI schema parsing error: cannot unmarshal bool into field Schema.properties

## Bug Description

When connecting to SigNoz MCP Server using hiAgent, data synchronization fails with the following error:
failed to unmarshal data: json error: json: cannot unmarshal bool into field Schema.properties of type openapi3.Schema, yaml error: error unmarshaling JSON: while decoding JSON: json: cannot unmarshal bool into field Schema.properties of type openapi3.Schema
hiAgent automatically reverted to the previous tool list.
## Environment
- **SigNoz Version**: v0.117.1
- **Client**

[Read the thread](https://github.com/SigNoz/signoz-mcp-server/issues/118) · 2026-04-14 · closed · external user · 0 comments

### `start`/`end` parameters ignored when `timeRange` defaults to `1h` in search/query tools

## Bug Description

The `signoz_search_logs`, `signoz_aggregate_logs`, `signoz_search_traces`, and similar tools have both `start`/`end` (Unix milliseconds) and `timeRange` (relative string like `1h`, `6h`) parameters.

The current behavior is that `timeRange` **defaults to `1h`** and **always overrides** `start`/`end`. This makes it impossible to query arbitrary date ranges using explicit timestamps, because the default `timeRange: "1h"` silently takes precedence even when `start`/`end` are exp

[Read the thread](https://github.com/SigNoz/signoz-mcp-server/issues/110) · 2026-04-08 · closed · external user · 2 comments

### timeout and body size limit is not defined

there are three things which are not handled in server
- read/write timeout
- stateful/stateless nature of server
- request/response body size limit

[Read the thread](https://github.com/SigNoz/signoz-mcp-server/issues/70) · 2026-03-18 · closed · outside contributor · 1 comment

### Error in opencode

I get this error in opencode on the latest version

`Invalid schema for function 'signoz_signoz_create_dashboard': In context=('properties', 'widgets', 'items', 'properties', 'query', 'properties', 'builder', 'properties', 'queryData', 'items', 'properties', 'functions', 'items', 'properties', 'args'), array schema items is not an object.`

this code change fixes it

<img width="1064" height="546" alt="Image" src="https://github.com/user-attachments/assets/632be674-a7e7-49a4-9459-45bb6180af72" /

[Read the thread](https://github.com/SigNoz/signoz-mcp-server/issues/59) · 2026-03-01 · closed · external user · 1 comment

### Add authentication oauth 2.1 protocol support for mcp server

specifications - 

https://modelcontextprotocol.io/specification/2025-11-25/basic/authorization
https://modelcontextprotocol.io/docs/tutorials/security/authorization

[Read the thread](https://github.com/SigNoz/signoz-mcp-server/issues/56) · 2026-02-23 · open · outside contributor · 0 comments

The remaining reports are on [the project's issue tracker](https://github.com/SigNoz/signoz-mcp-server/issues).
