Sign in

v1

latestOpenAPI 3.0.3MIT2026-07-17323590.7 KB
MCP

Execute MCP tool

Executes an MCP tool with RBAC enforcement. The tool must be available in the user's filtered tool list (see /api/mcp/tools). Admin/Editor roles can access all tools, while Viewer role can only access tools with readOnlyHint: true annotation. RBAC is enforced both at tool listing time and at execution time (double-check pattern).

post/api/mcp/call-tool

Headers

X-Grafana-Org-Idstring

Grafana organization ID for multi-tenant isolation. Defaults to '1' if not provided.

Request body

namestring required

Tool name

argumentsobject

Tool-specific arguments matching the tool's inputSchema

orgNamestring

Organization name (optional, for multi-tenant routing)

scopeOrgIdstring

Scope organization ID (optional, for multi-tenant routing)

Response

Tool execution result

isErrorboolean

True if tool execution failed