Grafana MCP Server

Instructions

Implementation Reference

• src/grafana_mcp_server/processor/grafana_processor.py:538-591 (handler)

  The core implementation of the dashboard fetching logic.

  def grafana_fetch_all_dashboards(self, limit: int = 100) -> dict[str, Any]:
      """
      Fetches all dashboards from Grafana.
  
      Args:
          limit: Maximum number of dashboards to return
  
      Returns:
          Dict containing list of dashboards with basic information
      """
      try:
          url = f"{self.__host}/api/search"
          params = {"limit": limit}
          logger.info(f"Fetching all dashboards (limit: {limit})")
  
          response = requests.get(
              url,
              headers=self.headers,
              params=params,
              verify=self.__ssl_verify,
              timeout=20,
          )
  
          if response.status_code == 200:
              dashboards = response.json()
              # Extract relevant information
              dashboard_list = []
              for dashboard in dashboards:
                  dashboard_list.append(
                      {
                          "uid": dashboard.get("uid"),
                          "title": dashboard.get("title"),
                          "type": dashboard.get("type"),
                          "url": dashboard.get("url"),
                          "folder_title": dashboard.get("folderTitle"),
                          "folder_uid": dashboard.get("folderUid"),
                          "tags": dashboard.get("tags", []),
                          "is_starred": dashboard.get("isStarred", False),
                      }
                  )
  
              return {
                  "status": "success",
                  "total_count": len(dashboard_list),
                  "limit": limit,
                  "dashboards": dashboard_list,
              }
          else:
              raise Exception(f"Failed to fetch dashboards. Status: {response.status_code}, Response: {response.text}")
  
      except Exception as e:
          logger.error(f"Error fetching dashboards: {e!s}")
          raise e

• src/grafana_mcp_server/mcp_server.py:475-475 (registration)

  Tool registration mapping the tool name to its handler function.

  "grafana_fetch_all_dashboards": grafana_fetch_all_dashboards,