---
document_id: agent.error.max_credits_required
schema_version: 1
---

<!-- Generated by scripts.build_agent_guide; do not edit. -->

# max_credits_required

Recovery / 恢复动作: `ask_user`
Billing / 计费: `not_charged`

- Cause / 原因: A paid MCP operation exceeded approval_threshold_credits and was attempted without both an approved max_credits value and the matching approved_plan_digest. / 付费 MCP 操作超过 approval_threshold_credits，但执行时未同时提供已同意的 max_credits 和匹配的 approved_plan_digest。
- Agent: Show the returned upper_bound_credits, wait for approval, then retry the identical request once with max_credits and approved_plan_digest set from the returned plan_digest. / 展示返回的 upper_bound_credits，等待同意，再使用 max_credits，并把返回的 plan_digest 赋给 approved_plan_digest，对相同请求重试一次。
- User / 用户: Approve the displayed upper bound or ask the Agent to reduce the scope. / 同意展示的费用上界，或要求 Agent 缩小范围。