<!--
Parallel Documentation — this page, as markdown.
Index of every page: https://docs.parallel.best/llms.txt
The whole documentation in one file: https://docs.parallel.best/llms-full.txt
-->

# Tools reference

36 tools. Reads return live data; transaction tools build [unsigned transactions](/agents/mcp/transactions) that your wallet reviews and signs — the server itself never signs, broadcasts or pays anything.

## Conventions

* **Amounts are human-readable strings** — pass `"100"` for 100 USDp, never wei. The server handles decimals.
* **Slippage is in basis points** — `50` = 0.5%. Default 50, maximum 500. Applies to `mint`, `redeem` and `redeem_proportional`.
* **Chains are lowercase slugs** (`base`, `ethereum`, `hyperevm`, …). Minting, redeeming and savings run on the chains with a Parallelizer deployment — Ethereum, Base, Avalanche and HyperEVM; on Sonic those operations return `CHAIN_SUNSET` (PIP-64 wind-down) while bridging and balance reads stay active. Bridging covers every supported chain.
* **Multi-chain aggregates are honest about failures**: when a chain read fails, the response carries `partial: true` and a `failedChains` list, and the totals exclude those chains — never a silently wrong number. `get_proof_of_solvency` goes further and refuses to conclude on incomplete data (`PARTIAL_READ`).

## Protocol data

| Tool | What it returns |
|---|---|
| `get_protocol_overview` | One snapshot: total TVL, USDp/sUSDp supply, savings APY, proof of solvency, backing composition |
| `get_supply` | Total and circulating supply of `usdp`, `susdp`, `prl`, `sprl1` or `sprl2`, with a per-chain breakdown |
| `get_tvl` | TVL, per chain and per collateral |
| `get_backing_composition` | Every collateral backing USDp: amounts, USD values, oracle prices, share of the basket |
| `get_supported_chains` | The 24 chains USDp is deployed on, with status and contract addresses (Sonic is flagged sunset — mint, redeem and savings were wound down there under PIP-64, while USDp, bridging and balance reads stay live) |
| `get_supported_collaterals` | Collaterals accepted on a chain, with caps, utilization and mint/redeem status |
| `get_fee_rates` | Adaptive mint/redeem fees per collateral — can be negative (incentives) |
| `get_savings_rate` | The protocol-wide sUSDp APY (7d/30d/90d), exchange rate and total deposits |
| `get_proof_of_solvency` | Total backing vs USDp supply — the canonical solvency ratio, per chain |

## Savings (sUSDp)

| Tool | What it does |
|---|---|
| `get_susdp_exchange_rate` | Live sUSDp → USDp rate per chain |
| `estimate_savings_yield` | Projects yield for an amount over a duration at the current APY |
| `deposit_savings` | Builds the deposit transaction — USDp in, sUSDp out (`amount`, `chain`, `receiver`) |
| `withdraw_savings` | Builds the withdrawal — sUSDp back to USDp (`amount` in sUSDp, `chain`, `receiver`) |

## Mint & redeem (Parallelizer)

| Tool | What it does |
|---|---|
| `get_quote` | Exact mint or redeem quote: output, fees, price impact — read-only |
| `mint` | Builds a mint of USDp from a collateral (`collateral`, `amount`, `chain`, `receiver`, `slippageTolerance?`) |
| `redeem` | Builds a redemption of USDp into one collateral |
| `redeem_proportional` | Builds a redemption into the whole collateral basket, market-neutral |

## Bridge (LayerZero)

| Tool | What it does |
|---|---|
| `get_bridge_quote` | Cost of bridging USDp between two chains — no bridge fee, only the LayerZero native fee (~10 min delivery) |
| `bridge` | Builds a USDp bridge transfer (`token` — only `usdp` — `fromChain`, `toChain`, `amount`, `recipientAddress`, your own address which sends and receives) |
| `get_bridge_status` | Track a bridge transfer by transaction hash |
| `get_bridge_limits` | Daily and global mint/burn capacity on a chain |
| `get_bridge_history` | Past transfers for an address |

## Staking (PRL)

| Tool | What it does |
|---|---|
| `get_staking_overview` | Epochs, totals staked in sPRL1/sPRL2, voting power, and APRs (when an epoch has settled — otherwise null, with the reason in `unavailableFields`) |
| `get_staking_info` | One address's full staking position: balances, rewards, cooldowns, ParaBoost |
| `get_cooldown_status` | Pending unstake requests, remaining time and estimated penalties |
| `stake` | Builds staking transactions — PRL into sPRL1, or PRL/BPT into sPRL2 |
| `unstake` | With `amount`: builds the cooldown start. Without: builds the withdrawal of matured requests |
| `claim_rewards` | Builds reward claims for sPRL1/sPRL2 — may return transactions on several chains |

sPRL1 is deployed on Ethereum, Polygon, Base and Sonic; sPRL2 on Ethereum only.

## Governance

| Tool | What it does |
|---|---|
| `get_proposals` | Snapshot proposals (PIP/PGP/PIR), filterable by type and status |
| `get_proposal_details` | One proposal in full, votes and result included |
| `get_protocol_parameters` | Contract addresses, governance roles, fees and bridge limits — one formatted summary |

## Agent payments (x402)

| Tool | What it does |
|---|---|
| `get_payment_capabilities` | Payment routes available on a chain and whether gas is sponsored |
| `prepare_x402_payment` | Builds a gasless x402 payment — returns typed data for your wallet to sign; the facilitator settles on-chain only after that |
| `prepare_convert_and_pay` | Builds a two-step payment — redeem USDp to a collateral, then pay it, for recipients wanting a specific token |

Gas is sponsored on every Parallelizer chain except Ethereum. See [x402](/agents/x402) for the full payment protocol.

## Meta

| Tool | What it does |
|---|---|
| `parallel_query_docs` | Full-text search over the server's own documentation |
| `parallel_health_check` | Server status and RPC latency for all 24 chains |