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

# Tool Reference

> Parameters for every Reinx MCP tool

Every tool requires `purpose` (string, 3–500 characters) — the agent's reason for acting, recorded in the audit log. Parameters below are in addition to `purpose`.

## Payments

### `request_wallet_payment`

| Parameter        | Type    | Required | Notes                                                             |
| ---------------- | ------- | -------- | ----------------------------------------------------------------- |
| `amountCents`    | integer | ✓        | ≥ 1. Alias: `amount_cents`                                        |
| `recipient`      | string  | ✓        | Wallet address, validated per chain (EIP-55 / base58)             |
| `caip2`          | string  | ✓        | Network id, e.g. `eip155:8453` (Base), `solana:mainnet`           |
| `asset`          | string  | —        | Defaults to `USDC`                                                |
| `idempotencyKey` | string  | ✓        | 8–200 chars, stable per logical payment. Alias: `idempotency_key` |

### `submit_approval_request`

Same parameters as `request_wallet_payment`, plus:

| Parameter       | Type   | Required | Notes                                         |
| --------------- | ------ | -------- | --------------------------------------------- |
| `justification` | string | —        | Up to 500 chars, shown to the approving human |

Always routes to human review regardless of the auto-approval threshold. Returns a `requestId` to poll via `check_approval_status`.

### `check_approval_status`

| Parameter    | Type          | Required | Notes                                                                       |
| ------------ | ------------- | -------- | --------------------------------------------------------------------------- |
| `request_id` | string (uuid) | ✓        | The `requestId` a payment tool returned (camelCase there, snake\_case here) |

Returns `pending` / `approved` / `used` / `failed` / `denied` / `expired` / `not_found` with a `retry_after_seconds` polling hint. See [Payment Workflow](/mcp-tools/payment-workflow) for the semantics.

## Balances & status

### `check_balance` · `get_agent_status` · `get_spending_rules` · `list_approved_merchants`

No parameters beyond `purpose`.

### `get_wallet_addresses`

| Parameter | Type   | Required | Notes                            |
| --------- | ------ | -------- | -------------------------------- |
| `chain`   | string | —        | `evm` or `solana`; omit for both |

Returns USDC deposit addresses per chain family (`usdc_evm`, `usdc_solana`).

### `get_budget_utilization` · `get_spending_summary`

| Parameter       | Type    | Required | Notes                                     |
| --------------- | ------- | -------- | ----------------------------------------- |
| `period`        | string  | —        | `24h`, `7d`, `30d`, `90d` (default `30d`) |
| `lookback_days` | integer | —        | 1–90; overrides `period` when supplied    |

## History & feedback

### `get_transactions`

| Parameter       | Type    | Required | Notes                               |
| --------------- | ------- | -------- | ----------------------------------- |
| `limit`         | integer | —        | 1–100 (default 20)                  |
| `lookback_days` | integer | —        | 1–365 (default 90)                  |
| `cursor`        | string  | —        | Opaque token from the previous page |

### `get_denial_feedback`

| Parameter       | Type    | Required | Notes              |
| --------------- | ------- | -------- | ------------------ |
| `limit`         | integer | —        | 1–50 (default 10)  |
| `lookback_days` | integer | —        | 1–365 (default 90) |

### `check_merchant_allowed`

| Parameter  | Type   | Required | Notes            |
| ---------- | ------ | -------- | ---------------- |
| `merchant` | string | ✓        | 1–200 chars      |
| `mcc_code` | string | —        | Exactly 4 digits |

## Rate limits

General tool calls are limited per your plan tier. The payment tools (`request_wallet_payment`, `submit_approval_request`) carry tighter caps: **10/min per key** and **30/min per org**. A `429` includes `retry-after`.