# 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`, …). USDp lives on 25 chains; minting, redeeming and savings run on the chains with a Parallelizer deployment — Ethereum, Base, Avalanche and HyperEVM, plus Sonic, which is being wound down. Bridging covers every chain except Mantle. ## 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 25 chains with status and contract addresses | | `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 (`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, APRs, voting power | | `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 25 chains |