permission: Not permitted¶
The caller is known and not allowed to do this. Never retry with broader authority.
Results in this category have isError: true, start with [ouncemcp] Not permitted:, and carry _meta.ouncemcp.category = "permission" and retryable = false.
Code (_meta.ouncemcp.error) |
Cause | Fix |
|---|---|---|
permission_denied |
A FastMCP authorization check or a Python PermissionError refused the call. |
Ask for access, or use a tool you are allowed to call. |
upstream_forbidden |
The upstream service answered 403. | The server's upstream account lacks permission; tell the server owner. |
token_passthrough |
The server tried to send the caller's MCP access token to an upstream service, and OunceMCP blocked it (spec SEC-4). | Server authors: use the server's own upstream credentials, never the inbound token. |
approval_declined |
The person declined or cancelled the approval request for a write (proposal 0012). Nothing was changed. | Ask the user what they want instead; do not retry the same action. |
approval_unavailable |
The write needs a person's approval and the client cannot ask, and the server has no approver. Nothing was changed. |
Use a client that supports elicitation, or ask the server owner to configure an approver. |
permission |
A handler raised PermissionDenied. |
Follow the message. |
See proposal 0007 for how errors are classified.