> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentcard.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# list_pending_approvals

> List the user's PENDING approval requests: asks from connected apps (create a card, view full card details, close/pause/resume a card, change a limit) waiting…

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

**Behavior:** read-only, idempotent.

## What it does

List the user's PENDING approval requests: asks from connected apps (create a card, view full card details, close/pause/resume a card, change a limit) waiting on the user's decision. Surface each one to the user and let THEM decide; after the user answers, resolve with approve\_request. NEVER approve or deny on your own — an approval is the user's consent, not yours. Personal sessions only; company-connected sessions have no personal inbox.

## Inputs

None.

## Returns

| Field | Type | Description |
| - | - | - |
| `message` *(required)* | string | Human-readable list of pending approvals (or an empty-state note). |
| `status` | string | Present only when the list is unavailable: "personal\_surface\_only" for company-connected sessions. |
| `count` | number | Number of pending approvals. |
| `approvals` | array | Pending, unexpired approval requests, newest first. Each is waiting on the user's decision. |

## Example call

```json theme={null}
{
  "tool": "list_pending_approvals",
  "arguments": {}
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.