---
title: "List MCP tools"
method: GET
path: "/api/mcp/tools"
tags: ["MCP"]
---

# List MCP tools

`GET /api/mcp/tools`

Returns a list of available MCP tools filtered by the user's role. Admin/Editor roles see all tools, while Viewer role only sees tools with `readOnlyHint: true` annotation. Tools from multiple MCP servers are aggregated.

## Headers

- `X-Grafana-Org-Id` string

## Response `200`

List of MCP tools (RBAC-filtered)

- object
  - `tools` Tool[], required
    - `name` string, required — Tool name (unique identifier)
    - `description` string — Human-readable tool description
    - `inputSchema` object, required — JSON Schema for tool input parameters
    - `annotations` ToolAnnotations — MCP tool annotations for RBAC and behavior hints
      - `readOnlyHint` boolean, nullable — Tool only reads data (safe for Viewer role). Null means unspecified.
      - `destructiveHint` boolean, nullable — Tool may delete or modify data. Null means unspecified.
      - `idempotentHint` boolean, nullable — Tool is idempotent (safe to retry). Null means unspecified.
      - `openWorldHint` boolean, nullable — Tool may access external resources. Null means unspecified.

## Other responses

- `401` — Unauthorized (missing or invalid authentication)
- `500` — Internal server error

---

[API](https://skmtc.net/consensys/apis/ask-o11y-ai-powered-observability-assistant-api.md) · [All operations](https://skmtc.net/consensys/apis/ask-o11y-ai-powered-observability-assistant-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/consensys/ask-o11y-ai-powered-observability-assistant-api/versions/3ccc03eccaef/schema)