What read permissions are available?
These permissions let your AI view your data.| Scope | Label | Description |
|---|---|---|
read:account | Account Information | View your account details and profile |
read:balances | Account Balances | View your account and earnings balances |
read:transactions | Transaction History | View your transaction history and details |
read:rates | Exchange Rates | View real-time exchange rates |
read:points | Points & Rewards | View your points balance and rewards activity |
read:referrals | Referral Program | View your referral code and referred friends |
read:virtual_accounts | Virtual Accounts | View your virtual bank account details |
read:contacts | Contacts | View your saved contacts and counterparties |
read:settings | App Settings | View your app preferences and notification settings |
read:recovery | Account Recovery | View your recovery contacts, recovery emails, and guardian relationships |
read:passkeys | Passkeys | View your passkeys and authentication devices |
read:external_accounts | External Accounts | View your saved wallets and bank accounts |
read:knowledge | Knowledge Base | Search FAQ and help articles about Moneda |
read:earnings | Earnings & APY | View APY rates for earnings products |
read:spending | Spending Analytics | View spending summaries and category breakdowns |
read:users | User Search | Search for Moneda users by username, display name, email, or phone |
read:payments | Payment Status | View payment request status and history |
read:sub_accounts | Sub-accounts (Vaults) | View your sub-accounts (vaults), their balances, and aggregate wealth |
read:notifications | Notifications | View your in-app notifications inbox |
read:cards | Cards | View your Moneda card details (status, last four digits, expiry, design) — never the full PAN, CVV, or PIN. Card transactions are read through read:transactions (the generic get_transactions tool accepts a cardId filter). |
read:receipts | Receipts & Invoices | View receipts attached to transactions, line items, and Bewirtungsbeleg/Eigenbeleg overlays |
read:subscriptions | Subscription Billing | View your subscription charge history and generate plan invoice PDFs |
read:agent_sessions | Agent Sessions | View your scoped autonomous agent sessions — status, spending policy, remaining period cap, and recent executions. |
What write permissions are available?
These permissions let your AI take actions on your behalf.| Scope | Label | Description |
|---|---|---|
write:profile | Update Profile | Update your display name and profile information |
write:transactions | Transaction Annotations | Add or update categories and notes on your transactions |
write:external_accounts | Manage External Accounts | Add wallets and bank accounts to your saved external accounts |
write:contacts | Manage Contacts | Add Moneda users or external contacts to your contact list |
write:payments | Initiate Payments | Create payment requests that require your approval in the Moneda app |
write:cards | Freeze / Unfreeze Cards | Freeze or unfreeze your Moneda cards on-chain. Fully reversible, does NOT touch issuer-side card state, and never exposes PIN or full PAN. Destructive operations (suspend, terminate, replace, spending-limit changes, PIN reveal) are NOT granted by this scope — those require a fresh passkey assertion in the Moneda mobile app. |
write:receipts | Manage Receipts | Upload receipts, edit line items, create Bewirtungsbeleg/Eigenbeleg overlays, and re-run extraction |
write:agent_sessions | Manage Agent Sessions | Create scoped autonomous agent sessions (you approve activation with a passkey in the Moneda app), execute payments within an active session’s on-chain spending policy, and revoke sessions. Spend is hard-capped on-chain by a pre-funded wallet and a pinned recipient — the agent can never exceed the policy or redirect funds. |
write:usage_credits | Manage AI Usage Credits | Redeem a completed top-up payment to Moneda for prepaid AI usage credits, and set the monthly spend limit. The purchase amount is read from the confirmed payment, not from input. This scope only turns an already-finished payment into credits and adjusts your spending cap — it never moves money on its own. |
Even with
write:payments granted, all payment requests must be approved by you in the Moneda mobile app with biometric authentication before any money moves.write:cards is not included in the default scope set — AI clients have to ask for it explicitly. Granting it lets the agent freeze/unfreeze your cards on-chain (reversible) but never lets it suspend, terminate, replace, change PIN, or reveal full card credentials. Those stay mobile-app-only behind a fresh passkey.read:agent_sessions and write:agent_sessions are not included in the default scope set — AI clients have to ask for them explicitly. Delegating autonomous spend is opt-in: you activate every session with a passkey in the Moneda app, and the on-chain policy (pre-funded wallet + pinned recipient + per-payment / per-period caps) means the agent can never exceed the limits you set or send funds anywhere else.write:usage_credits is not included in the default scope set — AI clients have to ask for it explicitly. It only lets the agent redeem a top-up payment you already sent to Moneda for AI usage credits. The amount comes from the confirmed payment, so there’s nothing extra to approve, and the same payment can never be redeemed twice.Learn more
Authentication
How OAuth keeps your account secure when connecting to AI.
Resources
Data your AI reads automatically for context.
Available tools
See the full set of tools your AI assistant can use.
Use cases
Real examples of what you can do with Moneda and AI.