Home / Servers / DigitalOcean API / insights_get_prom_query_range

Execute a range PromQL query

An MCP tool from the DigitalOcean API server, hosted on mcp.hjlabs.in.

Execute a range PromQL query To evaluate a PromQL expression over a time range, send a GET request to /v2/insights/query/{region}/prom/api/v1/query_range. [GET /v2/insights/query/{region}/prom/api/v1/query_range]

Name on the gateway: digitalocean_api__insights_get_prom_query_range · read-only.

Parameters

NameTypeDescription
region requiredstringThe datacenter region slug for the query.
query requiredstringA PromQL expression. This may be a metric selector (for example…
start requiredstringStart timestamp (inclusive). Accepts a RFC3339 string or a UNIX timestamp.
end requiredstringEnd timestamp (inclusive). Accepts a RFC3339 string or a UNIX timestamp.
step requiredstringQuery resolution step width as a Prometheus duration string (for example 15s…
timeoutstringOptional evaluation timeout as a Prometheus duration string.

How to call it

Through the Smart Gateway, any client can run it by name with call_tool, or let the gateway find it with search_tools:

call_tool arguments
{
  "name": "digitalocean_api__insights_get_prom_query_range",
  "arguments": {
    "region": "…",
    "query": "…",
    "start": "…",
    "end": "…",
    "step": "…"
  }
}

Or connect the DigitalOcean API server directly, which lists 874 tools including this one:

Run in your terminal
claude mcp add --transport http hj-digitalocean-api https://mcp.hjlabs.in/mcp/digitalocean-api \
  --header "Authorization: Bearer YOUR_API_KEY"

Try asking

Use the execute a range promql query tool with region set to ….

More from DigitalOcean API