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

> ## Agent Instructions
> Praesia is in closed beta. Cards work in the sandbox with test funds, and no real money moves. To use Praesia, you need an invite. To request an invite, open https://praesia.ai/contact.

# MCP tools for agent payments

> The MCP tools your agent uses to read its mandates, pay and check each outcome.

A purchase usually calls these tools in this order:

<ol>
  <li>`get_mandate`Reads the rules</li>
  <li>`pay`Asks for approval</li>
  <li>`get_card`Gets the card</li>
  <li>`get_status`Reads the outcome</li>
</ol>

## Available tools

| Tool | What it does |
| - | - |
| `get_mandate` | Reads the mandates your agent follows |
| `draft_mandate` | Submits a mandate or an agent budget for your approval |
| `pay` | Asks Praesia to approve one purchase |
| `get_card` | Gives the single-use card for an approved purchase |
| `get_status` | Reads the agent's status, a decision or a payment outcome |
| `list_transactions` | Lists the agent's 50 newest transactions |
| `get_transaction` | Reads one transaction |
| `contest_transaction` | Records your complaint about a paid purchase |
| `get_balance` | Reads your organization's funds |
| `list_agents` | Lists the agents on this machine |
| `enroll` | Gets a sign-in link for an agent with no shell |

To read a tool's full description, run `praesia call TOOL --help`. `enroll` and `list_agents` have no command.

## Payment statuses

Your agent reports these statuses.

| Status | What it means |
| - | - |
| paid | The purchase is paid. |
| approved | Praesia approved the purchase, and it isn't paid yet. |
| declined | The card paid nothing. |
| expired | The approval ended, or its card ended unused. |
| canceled | Approving a new version of a mandate ended the purchase approval before any payment. |
| card\_not\_issued | The card issuer couldn't create the card. |


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