Be the first to get access to new connectors. Get early access →
ConnectorBay Early access

Grafana On-Call (BYOK) — connector documentation

  • MCP endpoint: https://byok-grafana-oncall.connectorbay.com/mcp
  • REST API: POST https://byok-grafana-oncall.connectorbay.com/v1/tools/{tool_name}, described by the OpenAPI 3.1 spec at https://byok-grafana-oncall.connectorbay.com/openapi.json
  • Transport: Streamable HTTP, stateless, MCP specification 2025-06-18 or later
  • Authentication: your own Grafana On-Call Grafana OnCall API key, sent in the X-Upstream-Key header of every request (never stored, logged or cached)
  • Health: https://byok-grafana-oncall.connectorbay.com/health · Tool schemas: https://byok-grafana-oncall.connectorbay.com/tools.json
  • Publisher: Unify Dynamics LLC · connectorbay.com/byok-grafana-oncall · agent@connectorbay.com

What Grafana On-Call (BYOK) is for

Grafana On-Call (BYOK) lets an AI assistant read your own Grafana On-Call data through the Grafana On-Call API with a key you supply (Grafana OnCall API key). Read-only: 10 tools (list_integrations, get_integration, list_routes, list_escalation_chains, list_escalation_policies, list_schedules, list_alert_groups, list_teams, list_slack_channels, list_user_groups). The BYOK key travels with each request, is used for that one call only and is never stored, logged or cached; it is only ever sent to *.grafana.net. Unofficial connector by Unify Dynamics LLC: not affiliated with, endorsed by or sponsored by Grafana On-Call. Grafana On-Call and its logos are trademarks of their owners and are used only to say which service the connector works with.

Ask your assistant things like:

  • "Which Grafana OnCall integrations do I have?"
  • "Show Grafana OnCall integration CFRPV98RPR1U8"
  • "How are Grafana OnCall alerts routed for integration CFRPV98RPR1U8?"
  • "Which escalation chains exist in Grafana OnCall?"
  • "What are the steps of Grafana OnCall escalation chain F5JU6KJET33FE?"
  • "Which Grafana OnCall schedules exist and who is on call?"

What it does

  • list_integrations: List alert integrations with name, type, team and default route escalation chain. Inbound webhook links and templates are left out. Returns the first page only (about 50 items); narrow with the filters.
  • get_integration: Get one integration by id: name, type, team and default route.
  • list_routes: List alert routing rules (regex on the alert, position, target escalation chain). Filter by integration. Returns the first page only (about 50 items); narrow with the filters.
  • list_escalation_chains: List escalation chains with id, name and team. Returns the first page only (about 50 items); narrow with the filters.
  • list_escalation_policies: List escalation policy steps (position, type such as wait or notify_person_next_each_time, duration). Filter by escalation chain. Returns the first page only (about 50 items); narrow with the filters.
  • list_schedules: List on-call schedules with name, type (calendar, ical, web), time zone, team and the ids of the users on call now. iCal URLs are left out. Returns the first page only (about 50 items); narrow with the filters.
  • list_alert_groups: List alert groups with state (new, acknowledged, resolved, silenced), title, alert count, integration, route and key times. Alert payloads are left out. Returns the first page only (about 50 items); narrow with the filters.
  • list_teams: List teams with id, Grafana team id and name. Filter by exact name.
  • list_slack_channels: List Slack channels known to OnCall with name and Slack id.
  • list_user_groups: List Slack user groups used for on-call tagging: id, type and Slack group name and handle.

BYOK key

You bring your own Grafana On-Call Grafana OnCall API key (https://grafana.com/docs/oncall/latest/oncall-api-reference/#authentication). Your assistant sends it in the X-Upstream-Key header with each request. ConnectorBay uses it for that one call only: it is never stored, logged or cached, never shown in an answer, and it is only sent to *.grafana.net over https, with no redirects followed. Create a key with the fewest permissions the tools need (read-only if the provider offers it), and revoke it at the provider whenever you like.

Data sources

Live from the Grafana On-Call API (*.grafana.net) with a BYOK key; documentation: https://grafana.com/docs/oncall/latest/oncall-api-reference/. Endpoints checked against that documentation on 2026-10-16.

What it is not

Unofficial connector by Unify Dynamics LLC: not affiliated with, endorsed by or sponsored by Grafana On-Call. Grafana On-Call and its logos are trademarks of their owners and are used only to say which service the connector works with. It is read-only: it never creates, changes, sends or deletes anything in your Grafana On-Call account.

Built for: Worldwide. Languages: English.