Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

The Tool Call Record

Every tool call the MCP Gateway handles leaves a record: who, what, which Policies fired and what was exchanged. This is how Admins answer "why did the Agent do that?"

Every tool call passing through the MCP Gateway leaves a structured record. The record is the investigation surface for any Admin question that starts with "why did the Agent do that?"

Cakewalk does not present this as a separate log you open. The records surface inside the views you already use: Agent Activity, the Sessions tabs and the tool call side panel.


📖 Key Concepts

  • Session: One connection between an Agent and the Gateway. A session holds the tool calls made during it.

  • Tool call: A single action an Agent attempted against a Connection. Each one is recorded with its own outcome.

  • Triggered Policy: Any Policy whose conditions matched the tool call. Multiple Policies can trigger on a single call. The Gateway applies one outcome per call, resolved by the Policy conflict rules (Custom > Default, then most restrictive wins).

💡 Why this matters: The record is the only way to answer "why was this allowed?" or "why was this blocked?" It captures what the Gateway decided at the moment of the call, not what the rules say today.


📋 What a Tool Call Record Contains

Each record holds:

  • The tool called, its Action type and the Connection it ran against

  • The User whose access the Agent inherited

  • Every triggered Policy, with its conditions and outcome

  • The outcome: Auto-approve, Require approval or Deny

  • Where approval was required, what the person decided

  • The request payload sent to the Connection and the response payload returned

  • The timestamp


🔍 Where Admins Read It

Records surface in three places:

  • Agent Activity: the org-wide reverse chronological view of every session. Click any tool call row to open its record.

  • Sessions tabs: the same data scoped to one Agent, one Connection or one User. Same pattern of session row, expand, tool call rows, click through.

  • Tool call side panel: the drawer that opens on a tool call. Shows the payloads and every triggered Policy with its outcome.


🛡️ Records Do Not Change

A record is what the Gateway decided at the time, and later changes do not rewrite it.

  • If a Policy changes after the call, the record still shows the Policy that fired.

  • If a User is offboarded, the record still shows what they delegated.

  • If an Agent is restricted, the record still shows everything it did before.


Last updated

Was this helpful?