Scopes

When you connect Moneda to your AI client, you’ll be asked to approve specific permissions. These control what your AI can see and do with your account.

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.
`read:sessions`	Active Sessions	View your active login sessions (devices and clients signed in to your account) and connected agents.

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.
`write:sessions`	Manage Active Sessions	Terminate a login session or disconnect a connected agent. Terminating a session immediately signs that device out. Not granted by default — an agent ending your other sessions is a security action you opt into.

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.

Overview

Getting Started

Tools

Reference

What read permissions are available?

What write permissions are available?

Learn more

Authentication

Resources

Available tools

Use cases

​What read permissions are available?

​What write permissions are available?

​Learn more

Authentication

Resources

Available tools

Use cases

What read permissions are available?

What write permissions are available?

Learn more