# list_dashboards

Use this as the primary tool to retrieve a list of existing custom monitoring dashboards in a Google Cloud project. Custom monitoring dashboards let users view and analyze data from different sources in the same context. This is useful for understanding what custom dashboards are currently configured and available in a given project.

Agent View of the PolicyLayer registry record for `list_dashboards`. HTML page: https://policylayer.com/tools/com-googleapis-monitoring-mcp/list-dashboards

## Facts

- Tool: `list_dashboards`
- Server: Mcp (`https://monitoring.googleapis.com/mcp`) — https://policylayer.com/tools/com-googleapis-monitoring-mcp.md
- Homepage: https://github.com/https://monitoring.googleapis.com/mcp
- Risk category: Read (Low risk)
- Registry record: grade C, identity unverified
- Server auth posture: open
- Server rate-limited: no
- Parameters: 3 (1 required)
- Recommended policy verdict: Allowed

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `parent` | string | yes | Required. The scope of the dashboards to list. The format is: projects/[PROJECT_ID_OR_NUMBER] |
| `pageSize` | integer | no | A positive number that is the maximum number of results to return. If unspecified, a default of 1000 is used. |
| `pageToken` | string | no | Optional. If this field is not empty then it must contain the `nextPageToken` value returned by a previous call to this method. Using this field causes the meth |

Parameters from the server's own tool schema.

## Example call (MCP tools/call, JSON-RPC 2.0)

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_dashboards",
    "arguments": {
      "parent": "<parent>"
    }
  }
}
```

## Why list_dashboards is rated Low

This tool only reads and lists existing dashboard configurations without any side effects. It queries data about available dashboards in a Google Cloud project, which is a classic Read operation. The blast radius of misuse is minimal, as an attacker would only gain visibility into dashboard configurations, not ability to modify infrastructure, execute operations, or access sensitive data within those dashboards.

From the tool's own definition: "Tool description states it is used to 'retrieve a list of existing custom monitoring dashboards'. The action is purely informational—listing dashboards with no modification, deletion, or execution capability."

## Use case

AI agents call list_dashboards to retrieve information from Mcp without modifying anything. It is typically the context-gathering step in research, monitoring, and reporting workflows, before the agent takes action elsewhere.

## Recommended policy (PolicyLayer)

Verdict: **Allowed**. Enforced by the PolicyLayer MCP gateway (https://policylayer.com/mcp-gateway) before a call reaches Mcp:

```json
{
  "version": "1",
  "default": "deny",
  "tools": {
    "list_dashboards": {}
  }
}
```

## Other tools on Mcp (8)

- `get_alert` — Read — https://policylayer.com/tools/com-googleapis-monitoring-mcp/get-alert.md
- `get_alert_policy` — Read — https://policylayer.com/tools/com-googleapis-monitoring-mcp/get-alert-policy.md
- `get_dashboard` — Read — https://policylayer.com/tools/com-googleapis-monitoring-mcp/get-dashboard.md
- `list_alert_policies` — Read — https://policylayer.com/tools/com-googleapis-monitoring-mcp/list-alert-policies.md
- `list_alerts` — Read — https://policylayer.com/tools/com-googleapis-monitoring-mcp/list-alerts.md
- `list_metric_descriptors` — Read — https://policylayer.com/tools/com-googleapis-monitoring-mcp/list-metric-descriptors.md
- `list_timeseries` — Read — https://policylayer.com/tools/com-googleapis-monitoring-mcp/list-timeseries.md
- `query_range` — Read — https://policylayer.com/tools/com-googleapis-monitoring-mcp/query-range.md

## For agents

This record is a snapshot. Live verdicts and the full registry:

- Check every server in your MCP config at once: `npx -y policylayer stack`
- Vet a server before you add it: install the mcp-precheck skill — `npx skills add https://policylayer.com` (skill text: https://policylayer.com/skill.md)
- Query the registry over MCP: endpoint `https://api.policylayer.com/mcp` — tools `check_mcp_server`, `check_mcp_stack`, `check_tool`, `search_registry`, `get_change_events`

---

Source: the PolicyLayer MCP registry — one continuously verified record per MCP server. Full record: https://policylayer.com/registry?q=com-googleapis-monitoring-mcp · API: https://policylayer.com/registry/api · Policy library: https://policylayer.com/policies/com-googleapis-monitoring-mcp