Resources / MCPCall

MCPCall

The record of one tool call on an MCP endpoint: who called, which document (by hash and operation name, never the text of secret values), what it touched and how it ended. Written by the platform only and never changed; kept for the endpoint's retention period.

Overview

APIintelligence.etorm.com/v1alpha1
Resourcemcpcalls (cluster-scoped inside its cluster)
Short namesmcpcall
Available inproject clusters only
Statusnone: the object is configuration only

Minimal example

apiVersion: intelligence.etorm.com/v1alpha1
kind: MCPCall
metadata:
  name: example
spec:
  endpointRef:
    name: "<name>"
  tool: search
  outcome: ok
  at: "<at>"

Spec

FieldTypeRequiredDefaultAllowedDescription
endpointRefobjectyesThe endpoint.
endpointRef.namestringyeslength 1 to 63Name of the MCPEndpoint.
credentialRefobjectThe credential the client used.
credentialRef.namestringup to 63 charactersName of the MCPCredential.
serviceAccountstringup to 63 charactersThe service account the call ran as.
workspacestringup to 63 charactersThe workspace the endpoint serves, when it serves one.
clientstringup to 200 charactersThe client's own name and version, as it introduced itself. A claim of the client.
toolstring (one of)yessearch, executeThe tool called.
documentHashstringup to 64 charactersSHA-256 prefix of the GraphQL document, or of the search text.
operationstringup to 128 charactersThe operation name in the document, if it has one.
kindstring (one of), query, mutationquery or mutation, for execute.
toucheslist of objectup to 100 itemsWhat the document reaches: kind and verb.
touches[].groupstringAPI group.
touches[].resourcestringPlural resource name.
touches[].verbstringlist, get, create, update, patch or delete.
objectslist of stringup to 100 itemsNames of the objects the document names (not their contents).
outcomestring (one of)yesok, refused, denied, errorok ran; refused by the endpoint's own rules (read-only, allow-list, limits); denied by authorization; error otherwise.
reasonstringup to 300 charactersWhy it was refused or failed.
resultBytesintegerat least 0Size of the answer.
durationMsintegerat least 0How long the call took.
atstringyesup to 40 charactersWhen (RFC 3339).

Columns in listings

ColumnFrom
Endpoint.spec.endpointRef.name
Tool.spec.tool
Outcome.spec.outcome
Document.spec.documentHash
At.spec.at

All resources