Skip to content
<- Guides
Agents · Decision rules

Why MCP Needs Run Logs

Tool access is not production-ready until every action is reproducible.

Define the run log fields MCP-based agents need before read, write, approval, and rollback workflows can be trusted in a real Amazon account.

Kuudo
Reviewed by Kuudo Engineering
TL;DR

A Model Context Protocol (MCP) run log should capture who asked, which Skill ran, which tool parameters were used, what grounded the action, what checks fired, and what changed. Write-capable workflows need at least 5 durable fields beyond a chat transcript: artifact hash, approval state, before state, destination, and rollback context.

The operator question was not about a single Amazon workflow: "If an MCP-connected agent calls tools for us, how do we know what happened afterward?"

The answer is a run log. Model Context Protocol (MCP) gives agents a clean way to call tools. Production teams need the durable record around those calls: who asked, which tool ran, what parameters were passed, what policy checks fired, what changed, and who approved the change.

What a model without Atlas gets wrong

That makes the agent hard to trust even when the output is correct.

What Atlas retrieves

Atlas is one of the sources a run log must name. If an agent uses Amazon Agent Atlas to ground an Amazon Marketing Cloud (AMC) query, listing patch, or decision rule, the run log should capture:

  • The Atlas corpus version used for the answer.
  • The chunk identifiers that grounded the rule.
  • The tool inputs, outputs, and policy checks from the MCP server.

The same principle applies to live data called through an MCP server: capture the tool, inputs, outputs, and policy checks in the same run.

For Amazon workflows, the Amazon Ads MCP and Selling Partner MCP provide the live data surfaces. The run log is the connective record that explains why the agent used them.

The agent's working output

A production run log should answer five questions:

{
  "event": "mcp_tool_run",
  "riskTier": "write",
  "initiator": {"user": "required", "workspace": "required"},
  "execution": {"skillId": "required", "skillVersion": "required"},
  "toolCall": {"server": "required", "tool": "required", "parametersHash": "required"},
  "grounding": {"atlasCorpusVersion": "required", "chunkIds": ["required"]},
  "controls": {"checks": ["privacy", "permission", "approval"], "approvalState": "required"},
  "result": {"artifactHash": "required", "destination": "required", "rollbackContext": "required"}
}

If a field cannot be logged, the agent should treat that as a product gap before write access expands.

The footnotes the agent surfaces

Those details are mundane until something goes wrong. Then they are the product.

What happens next

The full workflow runs through the Amazon Agent Data layer: Amazon Ads MCP and Selling Partner MCP supply live Amazon context, Atlas grounds the answer, and Skills make the tool sequence repeatable. The run log records every step so a human can review the decision after the agent acts.

When a workflow graduates from analysis to activation, the run log becomes the audit surface for approval, debugging, and customer trust.

The point

If a tool call cannot be reconstructed, it should not be trusted in production.

Next: use the AMC Skill workflow pattern to decide which tool calls need approval before they write.

Private beta

Run this workflow on your own Amazon data

Bring us the Amazon workflow you want your agent to run. In a private-beta working session, we'll map the fit, setup, and next step with you.

Run this workflow in beta

What you need to run this

tables
run log event store, Atlas retrieval manifest
subscriptions
Amazon Ads MCP access for advertising workflows, Selling Partner MCP access for catalog workflows, Amazon Agent Atlas retrieval
Lookback window
Retain write-capable run logs for the customer's audit period
API compatibility
Model Context Protocol tool-call envelope plus Skill execution metadata
Schema version
run-log contract v1
Last verified
"2026-06-16T00:00:00.000Z"

What success and failure look like

resultinterpretation
Tool call has no artifact hashThe exact output cannot be reproduced or approved later.
Approval state lives only in chatThe write path is not auditable.
Rollback context is captured after the writeThe team may not know what state to restore.

Supporting payloads

Write-capable MCP run log

Minimum structured fields to retain when an agent can change Amazon-side state.

{"event":"mcp_tool_run","riskTier":"write","requiredFields":["initiator","tool_parameters","atlas_chunk_ids","approval_state","artifact_hash","rollback_context"]}
Related reading

Keep exploring this topic

Use these companion guides to understand the inputs, follow-on analysis, and adjacent workflows behind this playbook.

FAQ

What is the minimum MCP run log for a production agent?

Capture the initiator, workspace, Skill version, tool name, parameters, retrieved context, policy checks, approval state, artifact hash, destination, and result.

Do read-only MCP calls need the same log depth as writes?

No. Read-only calls can log lighter context, but write-capable calls need the exact artifact hash, approval state, before state, and rollback context.

Why is a chat transcript not enough?

A transcript is not a structured execution record. It usually misses tool parameters, source chunk identifiers, policy checks, and before/after state.

Why should a write fail when the run log cannot capture required fields?

Treat it as a product gap and keep the workflow read-only until the missing fields can be recorded reliably.

How do Atlas chunks appear in a run log?

Store the Atlas corpus version and chunk identifiers beside the tool call so reviewers can reconstruct which playbook grounded the action.

Sources