Home / Servers / Vercel API / create_observability_query

POST /v2/observability/query

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

POST /v2/observability/query [POST /v2/observability/query]

Name on the gateway: vercel_api__create_observability_query · may change things.

Parameters

NameTypeDescription
metric requiredstringMetric id
scope requiredobjectOwner or project scope for the query
aggregationstringAggregation function to apply. Some aggregations require a dimension: use /…
groupByarrayDimensions to group results by. JSON dimensions support nested refs, for…
filterstringFilter to apply to the query. JSON dimensions support nested refs, for example…
limitnumberMaximum number of results
orderBystringRollup column to order grouped results by. Use the generated rollup key for…
orderDirectionasc | descDirection to order grouped results by. Defaults to desc.
granularityobjectTime bucket size
startTimestringStart timestamp
endTimestringEnd timestamp
bucketTimezonestringIANA timezone (e.g. Europe/Paris) used only to align calendar buckets (1d/1mo)…

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": "vercel_api__create_observability_query",
  "arguments": {
    "metric": "…",
    "scope": "…"
  }
}

Or connect the Vercel API server directly, which lists 472 tools including this one:

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

Try asking

Use the post /v2/observability/query tool with metric set to ….

More from Vercel API