Home / Servers / DigitalOcean API / insights_post_spans_search

Search spans

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

Search spans To search spans in a region, send a POST request to /v2/insights/query/{region}/spans/search with a JSON body describing the time range, optional filter, ordering, and pagination. The time range… [POST /v2/insights/query/{region}/spans/search]

Name on the gateway: digitalocean_api__insights_post_spans_search · may change things.

Parameters

NameTypeDescription
region requiredstringThe datacenter region slug for the query.
time_range requiredobjectAn inclusive query time window. The window must not exceed 7 days.
filterobjectA boolean filter tree for spans queries. Exactly one node is set per message.…
order_byarraySort clauses applied to the result set. Defaults to start_time descending when…
paginationobjectLimits the number of spans returned.

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_post_spans_search",
  "arguments": {
    "region": "…",
    "time_range": "…"
  }
}

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 search spans tool with region set to ….

More from DigitalOcean API