Open MCP Portaldocs
ReferenceGateways and calls

Calls through the team's gateways, to the team's servers, or by the team's service accounts (team owners and admins; platform staff)

GET/v1/teams/{team}/calls

A call is listed when it went through one of the team's gateways, reached one of the team's servers, or was made by one of the team's service accounts through any gateway (for example a platform gateway granted to the team). Calls of a deleted service account stay listed under its name.

Path Parameters

team*string

Team slug or ID

Query Parameters

gateway?string

Gateway ID

Formatuuid
server?string

MCP server ID

Formatuuid
outcome?string

ok: answered. tool_error: the tool reported an error. denied: refused by policy (logged; the client saw not found, or for a service account calling a capability that requires an account, a clear refusal). upstream_error: unreachable, refused or malformed (also provider_unavailable: the provider's token endpoint failed). bad_request: the client's request was invalid. needs_authorization: not forwarded because the person must connect or reconnect an account; the client got a consent link (JSON-RPC -32042). rate_limited: not forwarded because a rate limit was exceeded (HTTP 429, JSON-RPC -32029; errorClass names the limit: person_per_minute, credential_per_minute, service_account_per_minute or gateway_per_minute).

Value in

  • "ok"
  • "tool_error"
  • "denied"
  • "upstream_error"
  • "timeout"
  • "too_large"
  • "bad_request"
  • "needs_authorization"
  • "rate_limited"
user?string

Only calls made by this person (any credential)

Formatuuid
serviceAccount?string

Only calls made by this service account

Formatuuid
from?string

Entries at or after this time

Formatdate-time
to?string

Entries before this time (exclusive)

Formatdate-time
cursor?string

nextCursor from the previous page

limit?integer
Range1 <= value <= 200
Default50

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/teams/string/calls"
{  "data": {    "items": [      {        "id": 0,        "occurredAt": "2019-08-24T14:15:22Z",        "method": "tools/call",        "exposedName": "string",        "gateway": {          "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",          "slug": "string",          "name": "string",          "exists": true        },        "server": {          "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",          "slug": "string",          "name": "string",          "exists": true        },        "principal": {          "kind": "api_key",          "userId": "2c4a230c-5085-4924-a3e1-25fb4fc5965b",          "displayName": "string",          "email": "string",          "apiKeyName": "string",          "oauthClientName": "string",          "oauthClientVerified": true,          "serviceAccountId": "a814cf67-aaac-43ae-acb4-8d34e82a4b4c",          "serviceAccountTeamSlug": "string",          "serviceAccountExists": true        },        "clientName": "string",        "outcome": "ok",        "errorClass": "string",        "providerSlug": "string",        "latencyMs": 0,        "requestBytes": 0,        "responseBytes": 0,        "requestId": "string",        "captured": true      }    ],    "nextCursor": "string"  }}