Connect your AI Agents to Grafana in minutes
Available tools
list_alert_rules
List all Grafana alert rules. Returns rule UIDs, titles, conditions, and folder assignments.
get_alert_rule
Get a Grafana alert rule by UID. Returns the full rule configuration. Use list_alert_rules to find valid UIDs.
create_alert_rule
Create a Grafana alert rule. Requires title, condition, data queries, folder_uid, and rule_group. Use list_datasources for data source UIDs and list_folders for folder UIDs.
update_alert_rule
Update a Grafana alert rule by UID. Requires all fields (title, condition, data, folder_uid, rule_group). Use get_alert_rule to fetch current values.
delete_alert_rule
Delete a Grafana alert rule by UID. This action is permanent. Use list_alert_rules to find valid UIDs.
list_contact_points
List all Grafana alerting contact points. Returns names, types (email, slack, webhook, etc.), and UIDs.
create_contact_point
Create a Grafana alerting contact point. Types: 'email', 'slack', 'webhook', 'pagerduty', 'teams'. Settings vary by type.
update_contact_point
Update a Grafana alerting contact point by UID. Use list_contact_points to find valid UIDs.
delete_contact_point
Delete a Grafana alerting contact point by UID. This action is permanent. Use list_contact_points to find valid UIDs.
list_annotations
List Grafana annotations filtered by time range, tags, or dashboard. Returns annotation text, tags, and timestamps. Time values are epoch milliseconds.
create_annotation
Create a Grafana annotation. Annotations mark events on dashboards. Provide text and optionally attach to a dashboard/panel with tags.
update_annotation
Update a Grafana annotation by ID. Supports partial updates (only changed fields needed). Use list_annotations to find valid IDs.
delete_annotation
Delete a Grafana annotation by ID. This action is permanent. Use list_annotations to find valid IDs.
search_dashboards
Search Grafana dashboards by query, tags, or folder. Returns paginated results. Use page from page_info for next page.
get_dashboard
Get a Grafana dashboard by UID. Returns the full dashboard model with panels, variables, and metadata. Use search_dashboards to find valid UIDs.
create_dashboard
Create a new Grafana dashboard. Provide a dashboard object with 'title' and 'id' set to null. Optionally specify a folder_uid. Use list_folders to find valid folder UIDs.
update_dashboard
Update an existing Grafana dashboard. The dashboard object must include 'uid' and 'title'. Include 'version' for conflict detection. Use get_dashboard to fetch the current version.
delete_dashboard
Delete a Grafana dashboard by UID. This action is permanent. Use search_dashboards to find valid UIDs.
list_datasources
List all Grafana data sources. Returns names, types, UIDs, and connection details. No pagination (returns all).
get_datasource
Get a Grafana data source by UID. Returns full configuration details. Use list_datasources to find valid UIDs.
create_datasource
Create a new Grafana data source. Common types: 'prometheus', 'loki', 'elasticsearch', 'influxdb', 'graphite', 'mysql', 'postgres'. Requires name, type, and usually url.
update_datasource
Update an existing Grafana data source by numeric ID. Use list_datasources to find the ID. Requires name and type.
delete_datasource
Delete a Grafana data source by UID. This action is permanent. Use list_datasources to find valid UIDs.
list_folders
List all Grafana folders. Folders organize dashboards. Returns folder UIDs, titles, and URLs.
get_folder
Get a Grafana folder by UID. Returns folder details including version. Use list_folders to find valid UIDs.
create_folder
Create a new Grafana folder for organizing dashboards. Optionally specify a custom UID.
update_folder
Update a Grafana folder's title. Include version for conflict detection. Use get_folder to find the current version.
delete_folder
Delete a Grafana folder and all its dashboards. This action is permanent. Use list_folders to find valid UIDs.
get_org
Get the current Grafana organization info. Returns organization name and ID.
list_org_users
List all users in the current Grafana organization. Returns user IDs, logins, emails, and roles (Admin, Editor, Viewer).
get_current_user
Get the currently authenticated Grafana user. Returns user ID, login, email, name, and admin status.
search_teams
Search Grafana teams by name or query. Returns paginated results with member counts. Use page from page_info for next page.
get_team
Get a Grafana team by ID. Returns team name, email, and member count. Use search_teams to find valid IDs.
create_team
Create a new Grafana team. Optionally set a team email. Use add_team_member to add members after creation.
update_team
Update a Grafana team's name or email. Use search_teams to find valid IDs.
delete_team
Delete a Grafana team by ID. This action is permanent. Use search_teams to find valid IDs.
list_team_members
List members of a Grafana team. Returns user IDs, logins, emails, and names. Use search_teams to find valid team IDs.
add_team_member
Add a user to a Grafana team. Use list_org_users to find valid user IDs and search_teams for team IDs.
remove_team_member
Remove a user from a Grafana team. Use list_team_members to find valid user IDs for the team.
validate_credential
Validate Grafana credentials by fetching the current organization. Returns success status and message.
How to set up Merge Agent Handler
In an mcp.json file, add the configuration below, and restart Cursor.
Learn more in the official documentation ↗
1{
2 "mcpServers": {
3 "agent-handler": {
4 "url": "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
5 "headers": {
6 "Authorization": "Bearer yMt*****"
7 }
8 }
9 }
10}
11Open your Claude Desktop configuration file and add the server configuration below. You'll also need to restart the application for the changes to take effect.
Make sure Claude is using the Node v20+.
Learn more in the official documentation ↗
1{
2 "mcpServers": {
3 "agent-handler": {
4 "command": "npx",
5 "args": [
6 "-y",
7 "mcp-remote@latest",
8 "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
9 "--header",
10 "Authorization: Bearer ${AUTH_TOKEN}"
11 ],
12 "env": {
13 "AUTH_TOKEN": "yMt*****"
14 }
15 }
16 }
17}Open your Windsurf MCP configuration file and add the server configuration below.
Click on the refresh button in the top right of the Manage MCP server page or in the top right of the chat box in the box icon.
Learn more in the official documentation ↗
1{
2 "mcpServers": {
3 "agent-handler": {
4 "command": "npx",
5 "args": [
6 "-y",
7 "mcp-remote@latest",
8 "https://ah-api.merge.dev/api/v1/tool-packs/<tool-pack-id>/registered-users/<registered-user-id>/mcp",
9 "--header",
10 "Authorization: Bearer ${AUTH_TOKEN}"
11 ],
12 "env": {
13 "AUTH_TOKEN": "<ah-production-access-key>"
14 }
15 }
16 }
17 }In Command Palette (Cmd+Shift+P on macOS, Ctrl+Shift+P on Windows), run "MCP: Open User Configuration".
You can then add the configuration below and press "start" right under servers. Enter the auth token when prompted.
Learn more in the official documentation ↗
1{
2 "inputs": [
3 {
4 "type": "promptString",
5 "id": "agent-handler-auth",
6 "description": "Agent Handler AUTH_TOKEN", // "yMt*****" when prompt
7 "password": true
8 }
9 ],
10 "servers": {
11 "agent-handler": {
12 "type": "stdio",
13 "command": "npx",
14 "args": [
15 "-y",
16 "mcp-remote@latest",
17 "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
18 "--header",
19 "Authorization: Bearer ${input:agent-handler-auth}"
20 ]
21 }
22 }
23}FAQs on using Merge's Grafana MCP server
FAQs on using Merge's Grafana MCP server
Ready to try it out?
Whether you're an engineer experimenting with agents or a product manager looking to add tools, you can get started for free now
