approve_request

Connect to https://mcp.agentcard.sh/mcp with the user’s connection token (or a buy_token for org-owned accounts).

What it does

Resolve a pending approval request (approve or deny) once the USER has decided. Use this after get_card_details or create_card returns a 202 requiring approval, or for a row from list_pending_approvals. For card_details and transaction, approval automatically completes the follow-up action and returns the result. For cross_app actions (asks from another app: close/pause/resume a card, change a limit, view details), approval records the user’s consent and the REQUESTING app completes the action from its side when it retries with the approval id.

Inputs

Field	Type	Description
`approval_id` (required)	string	The approval request ID
`decision` (required)	string: `approved` · `denied`	Whether to approve or deny the request
`action` (required)	string: `card_details` · `transaction` · `cross_app:details` · `cross_app:close` · `cross_app:pause` · `cross_app:resume` · `cross_app:update`	The original action type from the approval prompt (list_pending_approvals rows carry it as action).
`resource_id` (required)	string	Card ID (for card_details and cross_app actions) or approval ID (for transaction)

Returns

Field	Type	Description
`message` (required)	string	Human-readable summary of the approval outcome and any follow-up action.
`status`	string	Outcome of the request: ‘denied’, ‘card_details’, ‘card_created’, ‘resolved’ (cross_app approvals: consent recorded, the requesting app completes the action), ‘personal_surface_only’ (company-connected session; the user resolves personally), or ‘unknown_action’.
`decision`	string	The decision that was applied: ‘approved’ or ‘denied’.
`action`	string	The original action type from the approval prompt: ‘card_details’ or ‘transaction’.
`card`	object	The card resource returned by the approved follow-up action, when applicable.

Example call

{
  "tool": "approve_request",
  "arguments": {
    "approval_id": "\u2026",
    "decision": "\u2026",
    "action": "\u2026",
    "resource_id": "\u2026"
  }
}

MCP

Organization tools

User tools

What it does

Inputs

Returns

Example call

​What it does

​Inputs

​Returns

​Example call

What it does

Inputs

Returns

Example call