Write MCP tools for payments, transaction categorization, contact management, receipts, and account updates on Moneda
Write tools let your AI assistant make changes on your behalf. All write tools require the appropriate permissions, and payments always require your explicit approval in the Moneda mobile app.
Profile
update_display_name
Change your display name shown to other Moneda users.Try asking: “Change my display name to Federico”
set_passkey_label
Give one of your passkeys a nickname so you can tell your devices apart in the security screen. Maximum 40 characters. Pass the passkey id from get_passkeys, or send an empty label to go back to the provider name. Cosmetic only — it cannot add, remove, or weaken a passkey.Try asking: “Rename my hardware key passkey to Backup Yubikey”
set_help_improve_moneda
Choose whether your conversations with Moneda AI may be used to train Moneda’s own models. This is the same switch as Settings > Privacy in the app. Turning it off records your objection and applies to everything you send from then on; messages you sent earlier are not affected. It does not change how Moneda answers you, security logging, or quality measurement. On the free Standard plan it is always on; turning it off needs a paid plan.Try asking: “Don’t use my Moneda AI conversations for training”
update_settings
Change your decimal separator (1,234.56 or 1.234,56), or opt in or out of marketing and product-update emails and push notifications. Only what you ask for changes. Security and transactional messages always send. Language and theme stay in the app.Try asking: “Use commas for decimals and stop marketing emails”
Transaction annotations
update_transaction_category
Assign a spending category to a transaction (e.g. Groceries, Restaurants, Travel).Try asking: “Categorize my last coffee purchase as Restaurants”
add_transaction_note
Add or update a personal note on a transaction. Maximum 140 characters.Try asking: “Add a note to my last transaction: Birthday dinner with friends”
batch_update_transaction_categories
Assign spending categories to up to 25 transactions at once.Try asking: “Categorize all my uncategorized transactions from last week”
batch_add_transaction_notes
Add or update notes on up to 25 transactions at once.Try asking: “Add notes to my recent transactions”
External accounts
add_wallet
Save an external crypto wallet to your account. The wallet must support USDC, EURC, CHFAU, CADD, and MXNB on the Base network. You’ll be asked to confirm this before the wallet is saved.Try asking: “Save this wallet address: 0x…”
add_bank
Save a bank account for withdrawals. Supports EU bank accounts (IBAN) and US bank accounts (ACH routing + account number).Try asking: “Add my bank account”
Contacts
add_contact_external
Register an external (non-Moneda) contact with their wallet address or bank account details. EU Travel Rule requires first name, last name, and country of residence.Try asking: “Add John as an external contact with his wallet address”
add_contact_moneda
Add a Moneda user to your contacts by their username.Try asking: “Add @alice to my contacts”
Payments
Payment requests created through MCP are sent to your Moneda mobile app, where you must approve them with biometric authentication. No money moves without your explicit confirmation.
initiate_payment
Create a payment request that requires your approval in the Moneda app. Supports transfers to Moneda users, your own external accounts, or contact bank accounts and wallets.Try asking: “Send $50 to @alice” or “Transfer EUR 100 to my bank account”By default the money comes from your main balance. Pass source to pay from earnings (USD and EUR sends) or from one of your single-signature sub-accounts (wallet recipients on Base only). Paying from a sub-account also needs the write:sub_accounts scope.Wallet payouts go out on Base. Payouts to a contact’s wallet on another chain can’t be requested through an agent yet; make those in the Moneda app.
initiate_currency_exchange
Exchange money between two of your own currency accounts, for example USD to EUR. The money lands in your own account in the target currency, and nothing moves until you approve the request in the Moneda app. Supported currencies: USD, EUR, CHF, CAD, MXN.Try asking: “Exchange $100 into euros”
propose_automation
Propose an automation: when a condition is met, Moneda alerts you or opens a prefilled trade for you to confirm. Beyond price moves, an automation can watch other signals, such as a company’s Moneda Ratio or the VIX, combined with “and”, “or” and time windows. Before anything is saved, your AI tool gets a readback in plain words with today’s real values, how often the rule would have fired over the history Moneda has stored, and any clash with your other automations. An alert starts right away. A trade automation waits for your approval in the Moneda app (you have 3 days), and every trade it opens still waits for your confirmation. Requires the write:trades scope.Try asking: “Tell me if the VIX goes above 30 while Intel’s Moneda Ratio is below 4”
propose_scheduled_payment
Propose a recurring payment, for example $50 every month to a Moneda user or a contact’s wallet. You review it in the Moneda app, including the most it can ever send, and nothing is scheduled until you approve and sign with your passkey. Proposals you don’t approve expire after 48 hours.Try asking: “Send @alice $50 every month starting October 1”
propose_sub_account_top_up
Propose moving money from your main account into one of your sub-accounts. Nothing moves until you approve and sign in the Moneda app. Requires the write:sub_accounts scope.Try asking: “Put $200 into my Travel vault”
propose_sub_account_withdraw
Propose moving money from a sub-account back to your main account. For joint accounts that need more than one approval, use propose_sub_account_multisig_proposal. Requires the write:sub_accounts scope.Try asking: “Move €50 from my Travel vault back to my account”
propose_sub_account_swap
Propose a swap inside a sub-account, for example USD into Bitcoin. The funds stay in the sub-account, and you see the live price and sign in the Moneda app. Requires the write:sub_accounts scope.Try asking: “Swap $100 to Bitcoin in my Savings vault”
propose_sub_account_freeze
Propose freezing a sub-account you created. You approve it in the Moneda app; unfreezing can only be done in the app. Requires the write:sub_accounts scope.Try asking: “Freeze my Kids vault”
propose_sub_account_multisig_proposal
Open a spend or withdraw proposal on a joint account that needs more than one approval. This only creates the proposal: you and your co-owners still approve and execute it in the Moneda app. Requires the write:sub_accounts scope.Try asking: “Propose paying @landlord $900 from our joint account”
initiate_crypto_trade
Buy or sell a crypto asset (Bitcoin or Ethereum) with your own balance. Moneda picks the route. You see the live price in the Moneda app, and nothing moves until you approve and sign there. Pays from or lands in USD, EUR, CAD or MXN.Try asking: “Buy $100 of Bitcoin”
initiate_token_buy
Buy a token on Base that is not in the crypto-trade catalogue, by its contract address, with your own USD, EUR, CHF or MXN balance. The token must be tradeable on Base. You see how much you get at the live price in the Moneda app, and nothing moves until you approve and sign there.Try asking: “Buy $25 of the token at 0x4ed4…efed”
initiate_crypto_send
Send crypto out of your main account, a vault or a joint account, to one of your contacts or to any address on Base. It works for every token you hold, including ones outside Moneda’s own list. Amounts are given in the token’s smallest unit, so ask for the list first and use the decimals it reports. Nothing moves until you review it and approve it with your passkey in the Moneda app, where you also see the token’s contract address and any warnings about it. Sending from a vault or a joint account also needs the write:sub_accounts scope.Try asking: “Send 0.5 of the token at 0x4ed4…efed to Ana”
cancel_conditional_order
Cancel an open crypto limit, stop-loss, take-profit or trailing-stop order. For a repeating rule, every remaining repeat is cancelled too. If the order is already live in the order book, it is withdrawn on-chain first and only then marked cancelled; if that fails the order stays live and you can retry. Filled, cancelled or expired orders can’t be cancelled. Requires write:trades. Creating orders is only possible in the Moneda app.Try asking: “Cancel my ETH take-profit order”
initiate_earnings_move
Move your own money into or out of an earnings vault: Earnings (Morpho, in USD, EUR or MXN) or Smart Earnings (YO, in USD or EUR). A deposit comes from the account in the same currency, and a withdrawal goes back to it. Nothing moves until you approve and sign in the Moneda app.Try asking: “Move $500 into Smart Earnings”
get_payment_status
Check the current status of a pending payment request. Terminal statuses are: completed, failed, expired, or rejected.Try asking: “What’s the status of my last payment?”
pay_x402
Pay an x402 (HTTP 402 Payment Required) invoice to a wallet address. When an API or service replies with HTTP 402, your AI assistant can pay it with USDC or EURC — requiring your approval in the Moneda app before it settles. Then it polls get_payment_status and retries the original request once paid.Try asking: “This API returned a 402 — pay the x402 invoice for me.”
Replies to Moneda
Both tools need the write:notifications scope, which isn’t granted by default. A reply goes to the Moneda team, so your assistant only sends words you wrote or approved.
request_message_reply_upload
Step 1 of 2 for attaching a document to a reply. Returns a presigned S3 PUT URL, a signed upload key and a literal curl command for your code sandbox. The file goes straight to S3, never through the conversation. PDF, JPEG or PNG, up to 5 MB.Try asking: “Send Moneda my payslip, it’s in my Downloads folder”
reply_to_moneda_message
Reply to a message from Moneda that asks for one. Pass the upload key from request_message_reply_upload when the message takes a document. One reply per message, up to 600 characters, and it can’t be edited afterwards.Try asking: “Reply to Moneda that the transfer was my salary”
undo_message_reply
Take back a reply within 10 seconds of sending it (until the reply’s undoableUntil). Only when the user asks to undo. The message asks for a reply again.Try asking: “Wait, undo that reply”
Receipts
request_receipt_upload
Step 1 of 2 for uploading a local receipt file. Returns a presigned S3 PUT URL, a signed upload key, and a literal curl command for your code sandbox to stage the file. The file bytes go straight to S3 — never through the conversation context. Follow up with finalize_receipt_upload.Try asking: “I want to upload a receipt — what do I do?”
finalize_receipt_upload
Step 2 of 2 for uploading a local receipt file. Pass the upload key from request_receipt_upload after you’ve PUT the file to S3. Runs OCR + LLM extraction, attempts to auto-match to an existing transaction, and persists line items. Returns the receipt id, optional bill id (for invoices), and any matched/suggested transaction.Try asking: (used as a follow-up to request_receipt_upload)
import_receipt_from_url
Import a receipt directly from an https:// URL (S3, Drive shared link, public file host). The server fetches the file behind an SSRF guard, validates it, then runs OCR + matching. Single tool call, no sandbox needed.Try asking: “Import this receipt from this URL”
reparse_receipt
Re-run the OCR / LLM extraction pipeline on an existing receipt and return the refreshed fields. Use when extraction looks wrong or after a model upgrade.Try asking: “Re-scan this receipt — the merchant looks wrong”
attach_receipt
File an unattached receipt against a transaction. A transaction holds at most one receipt, so this reports a conflict if another is already attached — detach that one first.Try asking: “Attach that invoice to my Adobe payment”
detach_receipt
Unlink a receipt from its transaction, leaving the receipt itself intact as an orphan. Use it to correct a wrong match or free the transaction for a different receipt. Deletes nothing.Try asking: “That receipt is on the wrong transaction, unlink it”
confirm_receipt_suggestion
Accept the matcher’s suggested transaction for a receipt, promoting the soft suggestion to a real attachment. Suggestions appear when the match score was too low to attach automatically.Try asking: “Yes, that receipt does belong to the Lufthansa charge”
reject_receipt_suggestion
Dismiss the matcher’s suggested transaction. The receipt stays unattached and stops being offered against that transaction.Try asking: “No, that receipt isn’t for that payment”
delete_receipt
Permanently delete a receipt and its stored file. This is a hard delete — line items and any Bewirtungsbeleg or Eigenbeleg overlay go with it, and there is no undo. To move a receipt to a different transaction, use detach_receipt and attach_receipt instead.Try asking: “Delete that duplicate receipt”
mark_receipt_partial_payment
Mark a receipt as a partial payment: the document covers more than this one payment (a deposit or instalment against a larger invoice), so its total differing from the transaction amount is expected. Clears the amount-mismatch warning and keeps it cleared across a rescan. Amounts are not changed.Try asking: “That invoice was only a deposit, stop flagging the amount”
update_receipt_amounts
Correct a receipt’s total, subtotal, tax amount, tax rate or tip when the scan read them wrong. Omit a field to leave it unchanged, pass null to clear it. The tax rate is a percentage (19 for 19%). Rescanning the receipt re-extracts and overwrites these.Try asking: “The total on that receipt is 47.50, not 4.75”
Agent sessions
Agent sessions let you hand your AI a bounded, autonomous spending mandate: a single pinned recipient, a per-payment cap, and a per-period cap, enforced on-chain by a pre-funded dedicated wallet. The funded balance is the hard ceiling on worst-case loss and the recipient is fixed on-chain — the agent can never exceed the limits or redirect funds. These tools need the Manage Agent Sessions permission, which is not granted by default — you opt in at connection time.
create_agent_session
Create a scoped autonomous session bound to your AI agent. You provide the recipient, currency, per-payment and per-period limits, and an optional expiry and funding amount. The tool returns a wallet address and an activation link. The session is not active yet — you open the activation link in the Moneda app and approve with your passkey to install the on-chain spending policy and fund the wallet. Only then can the agent pay within those limits.Try asking: “Set up an agent that can pay my landlord up to $500/month”
agent_execute_payment
Send a payment to an active session’s pinned recipient, within its on-chain limits — no per-payment approval. Rejected automatically if it would exceed the per-payment cap, the remaining period cap, or the funded balance. For safe retries, pass a stable idempotency key — retrying with the same key returns the original transaction instead of sending twice.Try asking: “Pay this month’s rent from my landlord agent session”
revoke_agent_session
Revoke an agent session. This immediately stops all further payments through it. You finish the on-chain teardown in the Moneda app.Try asking: “Stop the landlord agent session”
Active sessions
These tools let your AI sign devices out of your account and disconnect connected agents. Terminating a session takes effect immediately. They need the Manage Active Sessions permission, which is not granted by default — you opt in at connection time.
terminate_session
Sign out one login session by id (from list_active_sessions). The device is signed out immediately and can’t renew.Try asking: “Sign out my old iPhone” or “Terminate that web session”
terminate_all_other_sessions
Sign out all of your login sessions on other devices, keeping the current one. Doesn’t disconnect connected agents.Try asking: “Sign me out of every other device”
disconnect_connected_service
Disconnect a connected agent by id, revoking its access to your account immediately.Try asking: “Disconnect the ChatGPT connection”
Usage credits
AI usage credits are prepaid budget for your AI assistant. You top up by sending a stablecoin payment to Moneda and then redeeming that completed payment for credits. This tool needs the Purchase AI Usage Credits permission, which is not granted by default — you opt in at connection time.
purchase_usage_credits
Redeem a payment you already sent to Moneda for prepaid AI usage credits. You give the transaction hash of the completed top-up, and the amount is read straight from that confirmed payment, converted to your USD credit balance. The payment is already finished, so there’s nothing more to approve — this just turns it into credits. Safe to call again with the same hash: credits are only ever granted once.Try asking: “I sent the credit payment, here’s the transaction hash — add my AI credits.”
set_ai_usage_limit
Set a monthly cap on how much of your prepaid AI credit balance can be spent, or remove the cap entirely. Give a US dollar amount to set the limit, or ask for no limit to make it unlimited. The cap resets at the start of each month. Setting the same value again does nothing.Try asking: “Cap my AI spending at $50 a month.” or “Remove my monthly AI spending limit.”
redeem_points
Turn your Moneda Points into prepaid AI usage credits. Spends the points and adds the matching AI credit balance in one step, subject to a minimum and a monthly limit (check get_points_redemption_config first). Redemptions are final.Try asking: “Redeem 500 points for AI credits.”
create_api_key
Create an API key for a script, the CLI, or an integration. The secret is returned once and can never be retrieved again. A key can only carry permissions the connection creating it already has, and can never be used for payments — those always need your approval in the app.Try asking: “Create a read-only API key for my accounting script”
revoke_api_key
Revoke an API key. It stops working on its very next request, and this can’t be undone — you’d need to create a new key.Try asking: “Revoke the key I made for the old export script”
generate_statement
Generate a PDF balance statement of your activity for a tax year or a custom date range — opening/closing balances, every transaction with its home-currency value, fees, and the exchange rate used. It generates in the background and returns a requestId; pass it to get_statement_status for the download link. A period covers at most 366 days, and an end date in the future is clamped to now. The optional currency filter takes USD, EUR, CHF, CAD, MXN or CRYPTO. CRYPTO lists crypto and stock trades; the currency filters leave those out, and an exchange between two currencies is on the statement of both. reportingCurrency takes USD, EUR, CHF or CAD; it defaults to the filter when that is one of those four, then your display currency, then USD. Not tax advice.Try asking: “Generate my 2025 balance statement” or “Export a PDF of my activity from January to June”
Learn more
Read tools
Tools for querying balances, transactions, account data, recovery setup, notifications, vaults, receipts, and bills.
Scopes
Permission scopes that control which tools your AI can use.
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Moneda Docs","colors":{"primary":"#03789B","light":"#1ADDFF","dark":"#101010"},"logo":{"light":"https://mintcdn.com/moneda/IqWzDgNspCei7rzS/assets/Moneda-Logo-Lockup.png?fit=max\u0026auto=format\u0026n=IqWzDgNspCei7rzS\u0026q=85\u0026s=1af6aaa757979972093a77dfbdf28132","dark":"https://mintcdn.com/moneda/IqWzDgNspCei7rzS/assets/Moneda-Logo-Lockup.png?fit=max\u0026auto=format\u0026n=IqWzDgNspCei7rzS\u0026q=85\u0026s=1af6aaa757979972093a77dfbdf28132"},"favicon":"https://mintcdn.com/moneda/Zs20WlyDQ57sO4wK/assets/favicon.png?fit=max\u0026auto=format\u0026n=Zs20WlyDQ57sO4wK\u0026q=85\u0026s=5487e5010bf7d07bc69332d23411e2db","background":{"color":{"light":"#EFF4F5","dark":"#0E1011"}},"navbar":{"primary":{"type":"button","label":"Download Moneda","href":"https://get.moneda.com/docs"}},"footer":{"socials":{"x":"https://x.com/moneda_com","github":"https://github.com/MonedaIO","linkedin":"https://linkedin.com/company/moneda-com"},"links":[{"header":"Legal","items":[{"label":"Terms of Service","href":"https://moneda.com/terms"},{"label":"Privacy Policy","href":"https://moneda.com/privacy"}]}]},"seo":{"metatags":{"canonical":"https://docs.moneda.com","og:site_name":"Moneda Docs","og:image":"https://docs.moneda.com/assets/og-image.png","og:type":"website","twitter:card":"summary_large_image","twitter:site":"@moneda_com"}},"fonts":{"heading":{"family":"Ease Display","weight":500,"source":"fonts/EaseDisplay-Medium.woff2","format":"woff2"},"body":{"family":"Inter"}},"contextual":{"options":["copy","view","claude","cursor","mcp"],"display":"header"},"styling":{"latex":true},"navigation":{"global":{"anchors":[]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"moneda","hasAudioNarration":false,"actualSubdomain":"moneda","customDomains":["docs.moneda.com"],"gitSource":{"type":"github","owner":"monedaio","repo":"app","deployBranch":"main","contentDirectory":"packages/docs","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6afcf8a84ddbc3be3cbc36e7","clientVersion":"0.0.4248","searchFilterCounts":[{"language":"default","tag":"MCP","count":14},{"language":"default","tag":"CLI","count":8},{"language":"default","tag":"Moneda","count":5},{"language":"default","tag":"About","count":5},{"language":"default","tag":"API","count":4},{"language":"default","tag":"REST API","count":4},{"language":"default","tag":"Reference","count":4},{"language":"default","tag":"Tools","count":4},{"language":"default","tag":"Getting Started","count":3},{"language":"default","tag":"Overview","count":3}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"#navbar img[alt=\"light logo\"],#navbar img[alt=\"dark logo\"],#navbar img[src*=\"logo\"],#navbar img[src*=\"Logo\"]{height:48px!important;max-height:48px!important}[data-accordion]{background:#ffffff;padding:0.75rem 1rem}.accordion,details[data-state],div[data-radix-accordion-item]{background:#ffffff;border-radius:8px;padding:0.75rem 1rem;margin-bottom:0.5rem}table,table *,.dark table,.dark table *,[data-theme=\"dark\"] table,[data-theme=\"dark\"] table *,html.dark table,html.dark table *{background:#ffffff!important;background-color:#ffffff!important;color:#101010!important;border-color:#e5e7eb!important}table code,.dark table code,[data-theme=\"dark\"] table code,html.dark table code{background:#f3f4f6!important;color:#101010!important}table{border-radius:8px;overflow:hidden}.table-container,div:has(>table),.dark .table-container,.dark div:has(>table),[data-theme=\"dark\"] .table-container,[data-theme=\"dark\"] div:has(>table),html.dark .table-container,html.dark div:has(>table){background:#ffffff!important;border-radius:8px;padding:1rem 1.5rem}table th,table td{padding:0.75rem 1rem!important}[class*=\"step\"] [class*=\"number\"],[class*=\"step\"] [class*=\"indicator\"],[class*=\"Step\"] [class*=\"number\"],[class*=\"Step\"] [class*=\"indicator\"],ol[class*=\"step\"]>li::before,[data-step]::before{background:#03789B!important;color:#ffffff!important;border-color:#03789B!important}.dark [class*=\"step\"] [class*=\"number\"],.dark [class*=\"step\"] [class*=\"indicator\"],.dark [class*=\"Step\"] [class*=\"number\"],.dark [class*=\"Step\"] [class*=\"indicator\"],[data-theme=\"dark\"] [class*=\"step\"] [class*=\"number\"],[data-theme=\"dark\"] [class*=\"step\"] [class*=\"indicator\"]{background:#1ADDFF!important;color:#101010!important;border-color:#1ADDFF!important}.dark [class*=\"step\"] [class*=\"line\"],.dark [class*=\"step\"] [class*=\"connector\"],[data-theme=\"dark\"] [class*=\"step\"] [class*=\"line\"],[data-theme=\"dark\"] [class*=\"step\"] [class*=\"connector\"]{background:#333333!important;border-color:#333333!important}[class*=\"badge\"],[class*=\"tag\"],[data-tag],nav span[class*=\"tag\"],nav span[class*=\"badge\"]{background:#1ADDFF!important;color:#101010!important;font-weight:500!important;border:none!important;border-radius:6px!important}#search-bar-entry,#search-bar-entry *{background:#ffffff!important;background-color:#ffffff!important}#search-bar-entry *,#search-bar-entry input::placeholder,#search-bar-entry p,#search-bar-entry span,#search-bar-entry div{color:#888888!important;opacity:1!important}"}]}
{"page":{"pagePath":"tools/write-tools","slug":"/tools/write-tools","pageMetadata":{"title":"Write Tools","description":"Write MCP tools for payments, transaction categorization, contact management, receipts, and account updates on Moneda","tag":"Beta","href":"/tools/write-tools"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Write MCP tools for payments, transaction categorization, contact management, receipts, and account updates on Moneda\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,p:`p`,strong:`strong`,..._provideComponents(),...props.components},{Accordion,AccordionGroup,Card,CardGroup,Heading,Info,Warning}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!AccordionGroup)_missingMdxReference(`AccordionGroup`,true);if(!Card)_missingMdxReference(`Card`,true);if(!CardGroup)_missingMdxReference(`CardGroup`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Write tools let your AI assistant make changes on your behalf. All write tools require the appropriate permissions, and `,_jsx(_components.strong,{children:`payments always require your explicit approval`}),` in the Moneda mobile app.`]}),`\n`,_jsx(Heading,{level:`2`,id:`profile`,children:`Profile`}),`\n`,_jsxs(AccordionGroup,{children:[_jsxs(Accordion,{title:`update_display_name`,id:`update-display-name`,children:[_jsx(_components.p,{children:`Change your display name shown to other Moneda users.`}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Try asking:`}),` “Change my display name to Federico”`]})]}),_jsxs(Accordion,{title:`set_passkey_label`,id:`set-passkey-label`,children:[_jsxs(_components.p,{children:[`Give one of your passkeys a nickname so you can tell your devices apart in the security screen. Maximum 40 characters. Pass the passkey `,_jsx(_components.code,{children:`id`}),` from `,_jsx(_components.code,{children:`get_passkeys`}),`, or send an empty label to go back to the provider name. Cosmetic only — it cannot add, remove, or weaken a passkey.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Try asking:`}),` “Rename my hardware key passkey to Backup Yubikey”`]})]}),_jsxs(Accordion,{title:`set_help_improve_moneda`,id:`set-help-improve-moneda`,children:[_jsxs(_components.p,{children:[`Choose whether your conversations with Moneda AI may be used to train Moneda’s own models. This is the same switch as `,_jsx(_components.code,{children:`Settings > Privacy`}),` in the app. Turning it off records your objection and applies to everything you send from then on; messages you sent earlier are not affected. It does not change how Moneda answers you, security logging, or quality measurement. On the free Standard plan it is always on; turning it off needs a paid plan.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Try asking:`}),` “Don’t use my Moneda AI conversations for training”`]})]}),_jsxs(Accordion,{title:`update_settings`,id:`update-settings`,children:[_jsx(_components.p,{children:`Change your decimal separator (1,234.56 or 1.234,56), or opt in or out of marketing and product-update emails and push notifications. Only what you ask for changes. Security and transactional messages always send. Language and theme stay in the app.`}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Try asking:`}),` “Use commas for decimals and stop marketing emails”`]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`transaction-annotations`,children:`Transaction annotations`}),`\n`,_jsxs(AccordionGroup,{children:[_jsxs(Accordion,{title:`update_transaction_category`,id:`update-transaction-category`,children:[_jsx(_components.p,{children:`Assign a spending category to a transaction (e.g. Groceries, Restaurants, Travel).`}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Try asking:`}),` “Categorize my last coffee purchase as Restaurants”`]})]}),_jsxs(Accordion,{title:`add_transaction_note`,id:`add-transaction-note`,children:[_jsx(_components.p,{children:`Add or update a personal note on a transaction. Maximum 140 characters.`}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Try asking:`}),` “Add a note to my last transaction: Birthday dinner with friends”`]})]}),_jsxs(Accordion,{title:`batch_update_transaction_categories`,id:`batch-update-transaction-categories`,children:[_jsx(_components.p,{children:`Assign spending categories to up to 25 transactions at once.`}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Try asking:`}),` “Categorize all my uncategorized transactions from last week”`]})]}),_jsxs(Accordion,{title:`batch_add_transaction_notes`,id:`batch-add-transaction-notes`,children:[_jsx(_components.p,{children:`Add or update notes on up to 25 transactions at once.`}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Try asking:`}),` “Add notes to my recent transactions”`]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`external-accounts`,children:`External accounts`}),`\n`,_jsxs(AccordionGroup,{children:[_jsxs(Accordion,{title:`add_wallet`,id:`add-wallet`,children:[_jsx(_components.p,{children:`Save an external crypto wallet to your account. The wallet must support USDC, EURC, CHFAU, CADD, and MXNB on the Base network. You’ll be asked to confirm this before the wallet is saved.`}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Try asking:`}),` “Save this wallet address: 0x…”`]})]}),_jsxs(Accordion,{title:`add_bank`,id:`add-bank`,children:[_jsx(_components.p,{children:`Save a bank account for withdrawals. Supports EU bank accounts (IBAN) and US bank accounts (ACH routing + account number).`}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Try asking:`}),` “Add my bank account”`]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`contacts`,children:`Contacts`}),`\n`,_jsxs(AccordionGroup,{children:[_jsxs(Accordion,{title:`add_contact_external`,id:`add-contact-external`,children:[_jsx(_components.p,{children:`Register an external (non-Moneda) contact with their wallet address or bank account details. EU Travel Rule requires first name, last name, and country of residence.`}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Try asking:`}),` “Add John as an external contact with his wallet address”`]})]}),_jsxs(Accordion,{title:`add_contact_moneda`,id:`add-contact-moneda`,children:[_jsx(_components.p,{children:`Add a Moneda user to your contacts by their username.`}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Try asking:`}),` “Add @alice to my contacts”`]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`payments`,children:`Payments`}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Payment requests created through MCP are sent to your Moneda mobile app, where you must approve them with biometric authentication. No money moves without your explicit confirmation.`})}),`\n`,_jsxs(AccordionGroup,{children:[_jsxs(Accordion,{title:`initiate_payment`,id:`initiate-payment`,children:[_jsx(_components.p,{children:`Create a payment request that requires your approval in the Moneda app. Supports transfers to Moneda users, your own external accounts, or contact bank accounts and wallets.`}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Try asking:`}),` “Send $50 to @alice” or “Transfer EUR 100 to my bank account”`]}),_jsxs(_components.p,{children:[`By default the money comes from your main balance. Pass `,_jsx(_components.code,{children:`source`}),` to pay from `,_jsx(_components.strong,{children:`earnings`}),` (USD and EUR sends) or from one of your single-signature `,_jsx(_components.strong,{children:`sub-accounts`}),` (wallet recipients on Base only). Paying from a sub-account also needs the `,_jsx(_components.code,{children:`write:sub_accounts`}),` scope.`]}),_jsx(_components.p,{children:`Wallet payouts go out on Base. Payouts to a contact’s wallet on another chain can’t be requested through an agent yet; make those in the Moneda app.`})]}),_jsxs(Accordion,{title:`initiate_currency_exchange`,id:`initiate-currency-exchange`,children:[_jsx(_components.p,{children:`Exchange money between two of your own currency accounts, for example USD to EUR. The money lands in your own account in the target currency, and nothing moves until you approve the request in the Moneda app. Supported currencies: USD, EUR, CHF, CAD, MXN.`}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Try asking:`}),` “Exchange $100 into euros”`]})]}),_jsxs(Accordion,{title:`propose_automation`,id:`propose-automation`,children:[_jsxs(_components.p,{children:[`Propose an automation: when a condition is met, Moneda alerts you or opens a prefilled trade for you to confirm. Beyond price moves, an automation can watch other signals, such as a company’s Moneda Ratio or the VIX, combined with “and”, “or” and time windows. Before anything is saved, your AI tool gets a readback in plain words with today’s real values, how often the rule would have fired over the history Moneda has stored, and any clash with your other automations. An alert starts right away. A trade automation waits for your approval in the Moneda app (you have 3 days), and every trade it opens still waits for your confirmation. Requires the `,_jsx(_components.code,{children:`write:trades`}),` scope.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Try asking:`}),` “Tell me if the VIX goes above 30 while Intel’s Moneda Ratio is below 4”`]})]}),_jsxs(Accordion,{title:`propose_scheduled_payment`,id:`propose-scheduled-payment`,children:[_jsx(_components.p,{children:`Propose a recurring payment, for example $50 every month to a Moneda user or a contact’s wallet. You review it in the Moneda app, including the most it can ever send, and nothing is scheduled until you approve and sign with your passkey. Proposals you don’t approve expire after 48 hours.`}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Try asking:`}),` “Send @alice $50 every month starting October 1”`]})]}),_jsxs(Accordion,{title:`propose_sub_account_top_up`,id:`propose-sub-account-top-up`,children:[_jsxs(_components.p,{children:[`Propose moving money from your main account into one of your sub-accounts. Nothing moves until you approve and sign in the Moneda app. Requires the `,_jsx(_components.code,{children:`write:sub_accounts`}),` scope.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Try asking:`}),` “Put $200 into my Travel vault”`]})]}),_jsxs(Accordion,{title:`propose_sub_account_withdraw`,id:`propose-sub-account-withdraw`,children:[_jsxs(_components.p,{children:[`Propose moving money from a sub-account back to your main account. For joint accounts that need more than one approval, use `,_jsx(_components.code,{children:`propose_sub_account_multisig_proposal`}),`. Requires the `,_jsx(_components.code,{children:`write:sub_accounts`}),` scope.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Try asking:`}),` “Move €50 from my Travel vault back to my account”`]})]}),_jsxs(Accordion,{title:`propose_sub_account_swap`,id:`propose-sub-account-swap`,children:[_jsxs(_components.p,{children:[`Propose a swap inside a sub-account, for example USD into Bitcoin. The funds stay in the sub-account, and you see the live price and sign in the Moneda app. Requires the `,_jsx(_components.code,{children:`write:sub_accounts`}),` scope.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Try asking:`}),` “Swap $100 to Bitcoin in my Savings vault”`]})]}),_jsxs(Accordion,{title:`propose_sub_account_freeze`,id:`propose-sub-account-freeze`,children:[_jsxs(_components.p,{children:[`Propose freezing a sub-account you created. You approve it in the Moneda app; unfreezing can only be done in the app. Requires the `,_jsx(_components.code,{children:`write:sub_accounts`}),` scope.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Try asking:`}),` “Freeze my Kids vault”`]})]}),_jsxs(Accordion,{title:`propose_sub_account_multisig_proposal`,id:`propose-sub-account-multisig-proposal`,children:[_jsxs(_components.p,{children:[`Open a spend or withdraw proposal on a joint account that needs more than one approval. This only creates the proposal: you and your co-owners still approve and execute it in the Moneda app. Requires the `,_jsx(_components.code,{children:`write:sub_accounts`}),` scope.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Try asking:`}),` “Propose paying @landlord $900 from our joint account”`]})]}),_jsxs(Accordion,{title:`initiate_crypto_trade`,id:`initiate-crypto-trade`,children:[_jsx(_components.p,{children:`Buy or sell a crypto asset (Bitcoin or Ethereum) with your own balance. Moneda picks the route. You see the live price in the Moneda app, and nothing moves until you approve and sign there. Pays from or lands in USD, EUR, CAD or MXN.`}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Try asking:`}),` “Buy $100 of Bitcoin”`]})]}),_jsxs(Accordion,{title:`initiate_token_buy`,id:`initiate-token-buy`,children:[_jsx(_components.p,{children:`Buy a token on Base that is not in the crypto-trade catalogue, by its contract address, with your own USD, EUR, CHF or MXN balance. The token must be tradeable on Base. You see how much you get at the live price in the Moneda app, and nothing moves until you approve and sign there.`}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Try asking:`}),` “Buy $25 of the token at 0x4ed4…efed”`]})]}),_jsxs(Accordion,{title:`initiate_crypto_send`,id:`initiate-crypto-send`,children:[_jsxs(_components.p,{children:[`Send crypto out of your main account, a vault or a joint account, to one of your contacts or to any address on Base. It works for every token you hold, including ones outside Moneda’s own list. Amounts are given in the token’s smallest unit, so ask for the list first and use the decimals it reports. Nothing moves until you review it and approve it with your passkey in the Moneda app, where you also see the token’s contract address and any warnings about it. Sending from a vault or a joint account also needs the `,_jsx(_components.code,{children:`write:sub_accounts`}),` scope.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Try asking:`}),` “Send 0.5 of the token at 0x4ed4…efed to Ana”`]})]}),_jsxs(Accordion,{title:`cancel_conditional_order`,id:`cancel-conditional-order`,children:[_jsxs(_components.p,{children:[`Cancel an open crypto limit, stop-loss, take-profit or trailing-stop order. For a repeating rule, every remaining repeat is cancelled too. If the order is already live in the order book, it is withdrawn on-chain first and only then marked cancelled; if that fails the order stays live and you can retry. Filled, cancelled or expired orders can’t be cancelled. Requires `,_jsx(_components.code,{children:`write:trades`}),`. Creating orders is only possible in the Moneda app.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Try asking:`}),` “Cancel my ETH take-profit order”`]})]}),_jsxs(Accordion,{title:`initiate_earnings_move`,id:`initiate-earnings-move`,children:[_jsx(_components.p,{children:`Move your own money into or out of an earnings vault: Earnings (Morpho, in USD, EUR or MXN) or Smart Earnings (YO, in USD or EUR). A deposit comes from the account in the same currency, and a withdrawal goes back to it. Nothing moves until you approve and sign in the Moneda app.`}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Try asking:`}),` “Move $500 into Smart Earnings”`]})]}),_jsxs(Accordion,{title:`get_payment_status`,id:`get-payment-status`,children:[_jsx(_components.p,{children:`Check the current status of a pending payment request. Terminal statuses are: completed, failed, expired, or rejected.`}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Try asking:`}),` “What’s the status of my last payment?”`]})]}),_jsxs(Accordion,{title:`pay_x402`,id:`pay-x402`,children:[_jsxs(_components.p,{children:[`Pay an x402 (HTTP 402 Payment Required) invoice to a wallet address. When an API or service replies with HTTP 402, your AI assistant can pay it with USDC or EURC — requiring your approval in the Moneda app before it settles. Then it polls `,_jsx(_components.code,{children:`get_payment_status`}),` and retries the original request once paid.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Try asking:`}),` “This API returned a 402 — pay the x402 invoice for me.”`]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`replies-to-moneda`,children:`Replies to Moneda`}),`\n`,_jsxs(_components.p,{children:[`Both tools need the `,_jsx(_components.code,{children:`write:notifications`}),` scope, which isn’t granted by default. A reply goes to the Moneda team, so your assistant only sends words you wrote or approved.`]}),`\n`,_jsxs(AccordionGroup,{children:[_jsxs(Accordion,{title:`request_message_reply_upload`,id:`request-message-reply-upload`,children:[_jsxs(_components.p,{children:[`Step 1 of 2 for attaching a document to a reply. Returns a presigned S3 PUT URL, a signed upload key and a literal `,_jsx(_components.code,{children:`curl`}),` command for your code sandbox. The file goes straight to S3, never through the conversation. PDF, JPEG or PNG, up to 5 MB.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Try asking:`}),` “Send Moneda my payslip, it’s in my Downloads folder”`]})]}),_jsxs(Accordion,{title:`reply_to_moneda_message`,id:`reply-to-moneda-message`,children:[_jsxs(_components.p,{children:[`Reply to a message from Moneda that asks for one. Pass the upload key from `,_jsx(_components.code,{children:`request_message_reply_upload`}),` when the message takes a document. One reply per message, up to 600 characters, and it can’t be edited afterwards.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Try asking:`}),` “Reply to Moneda that the transfer was my salary”`]})]}),_jsxs(Accordion,{title:`undo_message_reply`,id:`undo-message-reply`,children:[_jsxs(_components.p,{children:[`Take back a reply within 10 seconds of sending it (until the reply’s `,_jsx(_components.code,{children:`undoableUntil`}),`). Only when the user asks to undo. The message asks for a reply again.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Try asking:`}),` “Wait, undo that reply”`]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`receipts`,children:`Receipts`}),`\n`,_jsxs(AccordionGroup,{children:[_jsxs(Accordion,{title:`request_receipt_upload`,id:`request-receipt-upload`,children:[_jsxs(_components.p,{children:[`Step 1 of 2 for uploading a local receipt file. Returns a presigned S3 PUT URL, a signed upload key, and a literal `,_jsx(_components.code,{children:`curl`}),` command for your code sandbox to stage the file. The file bytes go straight to S3 — never through the conversation context. Follow up with `,_jsx(_components.code,{children:`finalize_receipt_upload`}),`.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Try asking:`}),` “I want to upload a receipt — what do I do?”`]})]}),_jsxs(Accordion,{title:`finalize_receipt_upload`,id:`finalize-receipt-upload`,children:[_jsxs(_components.p,{children:[`Step 2 of 2 for uploading a local receipt file. Pass the upload key from `,_jsx(_components.code,{children:`request_receipt_upload`}),` after you’ve PUT the file to S3. Runs OCR + LLM extraction, attempts to auto-match to an existing transaction, and persists line items. Returns the receipt id, optional bill id (for invoices), and any matched/suggested transaction.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Try asking:`}),` (used as a follow-up to `,_jsx(_components.code,{children:`request_receipt_upload`}),`)`]})]}),_jsxs(Accordion,{title:`import_receipt_from_url`,id:`import-receipt-from-url`,children:[_jsxs(_components.p,{children:[`Import a receipt directly from an `,_jsx(_components.code,{children:`https://`}),` URL (S3, Drive shared link, public file host). The server fetches the file behind an SSRF guard, validates it, then runs OCR + matching. Single tool call, no sandbox needed.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Try asking:`}),` “Import this receipt from this URL”`]})]}),_jsxs(Accordion,{title:`reparse_receipt`,id:`reparse-receipt`,children:[_jsx(_components.p,{children:`Re-run the OCR / LLM extraction pipeline on an existing receipt and return the refreshed fields. Use when extraction looks wrong or after a model upgrade.`}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Try asking:`}),` “Re-scan this receipt — the merchant looks wrong”`]})]}),_jsxs(Accordion,{title:`attach_receipt`,id:`attach-receipt`,children:[_jsx(_components.p,{children:`File an unattached receipt against a transaction. A transaction holds at most one receipt, so this reports a conflict if another is already attached — detach that one first.`}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Try asking:`}),` “Attach that invoice to my Adobe payment”`]})]}),_jsxs(Accordion,{title:`detach_receipt`,id:`detach-receipt`,children:[_jsx(_components.p,{children:`Unlink a receipt from its transaction, leaving the receipt itself intact as an orphan. Use it to correct a wrong match or free the transaction for a different receipt. Deletes nothing.`}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Try asking:`}),` “That receipt is on the wrong transaction, unlink it”`]})]}),_jsxs(Accordion,{title:`confirm_receipt_suggestion`,id:`confirm-receipt-suggestion`,children:[_jsx(_components.p,{children:`Accept the matcher’s suggested transaction for a receipt, promoting the soft suggestion to a real attachment. Suggestions appear when the match score was too low to attach automatically.`}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Try asking:`}),` “Yes, that receipt does belong to the Lufthansa charge”`]})]}),_jsxs(Accordion,{title:`reject_receipt_suggestion`,id:`reject-receipt-suggestion`,children:[_jsx(_components.p,{children:`Dismiss the matcher’s suggested transaction. The receipt stays unattached and stops being offered against that transaction.`}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Try asking:`}),` “No, that receipt isn’t for that payment”`]})]}),_jsxs(Accordion,{title:`delete_receipt`,id:`delete-receipt`,children:[_jsxs(_components.p,{children:[`Permanently delete a receipt and its stored file. This is a `,_jsx(_components.strong,{children:`hard delete`}),` — line items and any Bewirtungsbeleg or Eigenbeleg overlay go with it, and there is no undo. To move a receipt to a different transaction, use `,_jsx(_components.code,{children:`detach_receipt`}),` and `,_jsx(_components.code,{children:`attach_receipt`}),` instead.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Try asking:`}),` “Delete that duplicate receipt”`]})]}),_jsxs(Accordion,{title:`mark_receipt_partial_payment`,id:`mark-receipt-partial-payment`,children:[_jsx(_components.p,{children:`Mark a receipt as a partial payment: the document covers more than this one payment (a deposit or instalment against a larger invoice), so its total differing from the transaction amount is expected. Clears the amount-mismatch warning and keeps it cleared across a rescan. Amounts are not changed.`}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Try asking:`}),` “That invoice was only a deposit, stop flagging the amount”`]})]}),_jsxs(Accordion,{title:`update_receipt_amounts`,id:`update-receipt-amounts`,children:[_jsx(_components.p,{children:`Correct a receipt’s total, subtotal, tax amount, tax rate or tip when the scan read them wrong. Omit a field to leave it unchanged, pass null to clear it. The tax rate is a percentage (19 for 19%). Rescanning the receipt re-extracts and overwrites these.`}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Try asking:`}),` “The total on that receipt is 47.50, not 4.75”`]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`agent-sessions`,children:`Agent sessions`}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[`Agent sessions let you hand your AI a `,_jsx(_components.strong,{children:`bounded, autonomous spending mandate`}),`: a single pinned recipient, a per-payment cap, and a per-period cap, enforced `,_jsx(_components.strong,{children:`on-chain`}),` by a pre-funded dedicated wallet. The funded balance is the hard ceiling on worst-case loss and the recipient is fixed on-chain — the agent can never exceed the limits or redirect funds. These tools need the `,_jsx(_components.strong,{children:`Manage Agent Sessions`}),` permission, which is `,_jsx(_components.strong,{children:`not granted by default`}),` — you opt in at connection time.`]})}),`\n`,_jsxs(AccordionGroup,{children:[_jsxs(Accordion,{title:`create_agent_session`,id:`create-agent-session`,children:[_jsxs(_components.p,{children:[`Create a scoped autonomous session bound to your AI agent. You provide the recipient, currency, per-payment and per-period limits, and an optional expiry and funding amount. The tool returns a wallet address and an activation link. The session is `,_jsx(_components.strong,{children:`not active yet`}),` — you open the activation link in the Moneda app and approve with your passkey to install the on-chain spending policy and fund the wallet. Only then can the agent pay within those limits.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Try asking:`}),` “Set up an agent that can pay my landlord up to $500/month”`]})]}),_jsxs(Accordion,{title:`agent_execute_payment`,id:`agent-execute-payment`,children:[_jsx(_components.p,{children:`Send a payment to an active session’s pinned recipient, within its on-chain limits — no per-payment approval. Rejected automatically if it would exceed the per-payment cap, the remaining period cap, or the funded balance. For safe retries, pass a stable idempotency key — retrying with the same key returns the original transaction instead of sending twice.`}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Try asking:`}),` “Pay this month’s rent from my landlord agent session”`]})]}),_jsxs(Accordion,{title:`revoke_agent_session`,id:`revoke-agent-session`,children:[_jsx(_components.p,{children:`Revoke an agent session. This immediately stops all further payments through it. You finish the on-chain teardown in the Moneda app.`}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Try asking:`}),` “Stop the landlord agent session”`]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`active-sessions`,children:`Active sessions`}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[`These tools let your AI sign devices out of your account and disconnect connected agents. Terminating a session takes effect immediately. They need the `,_jsx(_components.strong,{children:`Manage Active Sessions`}),` permission, which is `,_jsx(_components.strong,{children:`not granted by default`}),` — you opt in at connection time.`]})}),`\n`,_jsxs(AccordionGroup,{children:[_jsxs(Accordion,{title:`terminate_session`,id:`terminate-session`,children:[_jsxs(_components.p,{children:[`Sign out one login session by id (from `,_jsx(_components.code,{children:`list_active_sessions`}),`). The device is signed out immediately and can’t renew.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Try asking:`}),` “Sign out my old iPhone” or “Terminate that web session”`]})]}),_jsxs(Accordion,{title:`terminate_all_other_sessions`,id:`terminate-all-other-sessions`,children:[_jsx(_components.p,{children:`Sign out all of your login sessions on other devices, keeping the current one. Doesn’t disconnect connected agents.`}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Try asking:`}),` “Sign me out of every other device”`]})]}),_jsxs(Accordion,{title:`disconnect_connected_service`,id:`disconnect-connected-service`,children:[_jsx(_components.p,{children:`Disconnect a connected agent by id, revoking its access to your account immediately.`}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Try asking:`}),` “Disconnect the ChatGPT connection”`]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`usage-credits`,children:`Usage credits`}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[`AI usage credits are prepaid budget for your AI assistant. You top up by sending a stablecoin payment to Moneda and then redeeming that completed payment for credits. This tool needs the `,_jsx(_components.strong,{children:`Purchase AI Usage Credits`}),` permission, which is `,_jsx(_components.strong,{children:`not granted by default`}),` — you opt in at connection time.`]})}),`\n`,_jsxs(AccordionGroup,{children:[_jsxs(Accordion,{title:`purchase_usage_credits`,id:`purchase-usage-credits`,children:[_jsx(_components.p,{children:`Redeem a payment you already sent to Moneda for prepaid AI usage credits. You give the transaction hash of the completed top-up, and the amount is read straight from that confirmed payment, converted to your USD credit balance. The payment is already finished, so there’s nothing more to approve — this just turns it into credits. Safe to call again with the same hash: credits are only ever granted once.`}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Try asking:`}),` “I sent the credit payment, here’s the transaction hash — add my AI credits.”`]})]}),_jsxs(Accordion,{title:`set_ai_usage_limit`,id:`set-ai-usage-limit`,children:[_jsx(_components.p,{children:`Set a monthly cap on how much of your prepaid AI credit balance can be spent, or remove the cap entirely. Give a US dollar amount to set the limit, or ask for no limit to make it unlimited. The cap resets at the start of each month. Setting the same value again does nothing.`}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Try asking:`}),` “Cap my AI spending at $50 a month.” or “Remove my monthly AI spending limit.”`]})]}),_jsxs(Accordion,{title:`redeem_points`,id:`redeem-points`,children:[_jsx(_components.p,{children:`Turn your Moneda Points into prepaid AI usage credits. Spends the points and adds the matching AI credit balance in one step, subject to a minimum and a monthly limit (check get_points_redemption_config first). Redemptions are final.`}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Try asking:`}),` “Redeem 500 points for AI credits.”`]})]}),_jsxs(Accordion,{title:`create_api_key`,id:`create-api-key`,children:[_jsxs(_components.p,{children:[`Create an API key for a script, the CLI, or an integration. The secret is returned `,_jsx(_components.strong,{children:`once`}),` and can never be retrieved again. A key can only carry permissions the connection creating it already has, and can never be used for payments — those always need your approval in the app.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Try asking:`}),` “Create a read-only API key for my accounting script”`]})]}),_jsxs(Accordion,{title:`revoke_api_key`,id:`revoke-api-key`,children:[_jsx(_components.p,{children:`Revoke an API key. It stops working on its very next request, and this can’t be undone — you’d need to create a new key.`}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Try asking:`}),` “Revoke the key I made for the old export script”`]})]}),_jsxs(Accordion,{title:`generate_statement`,id:`generate-statement`,children:[_jsxs(_components.p,{children:[`Generate a PDF balance statement of your activity for a tax year or a custom date range — opening/closing balances, every transaction with its home-currency value, fees, and the exchange rate used. It generates in the background and returns a `,_jsx(_components.code,{children:`requestId`}),`; pass it to `,_jsx(_components.code,{children:`get_statement_status`}),` for the download link. A period covers at most 366 days, and an end date in the future is clamped to now. The optional `,_jsx(_components.code,{children:`currency`}),` filter takes `,_jsx(_components.code,{children:`USD`}),`, `,_jsx(_components.code,{children:`EUR`}),`, `,_jsx(_components.code,{children:`CHF`}),`, `,_jsx(_components.code,{children:`CAD`}),`, `,_jsx(_components.code,{children:`MXN`}),` or `,_jsx(_components.code,{children:`CRYPTO`}),`. CRYPTO lists crypto and stock trades; the currency filters leave those out, and an exchange between two currencies is on the statement of both. `,_jsx(_components.code,{children:`reportingCurrency`}),` takes `,_jsx(_components.code,{children:`USD`}),`, `,_jsx(_components.code,{children:`EUR`}),`, `,_jsx(_components.code,{children:`CHF`}),` or `,_jsx(_components.code,{children:`CAD`}),`; it defaults to the filter when that is one of those four, then your display currency, then USD. Not tax advice.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Try asking:`}),` “Generate my 2025 balance statement” or “Export a PDF of my activity from January to June”`]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`learn-more`,children:`Learn more`}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`Read tools`,icon:`book-open`,href:`/tools/read-tools`,children:_jsx(_components.p,{children:`Tools for querying balances, transactions, account data, recovery setup, notifications, vaults, receipts, and bills.`})}),_jsx(Card,{title:`Scopes`,icon:`list-check`,href:`/scopes`,children:_jsx(_components.p,{children:`Permission scopes that control which tools your AI can use.`})})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Write Tools","description":"Write MCP tools for payments, transaction categorization, contact management, receipts, and account updates on Moneda","tag":"Beta","href":"/tools/write-tools"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Profile","slug":"profile","depth":2,"children":[]},{"title":"Transaction annotations","slug":"transaction-annotations","depth":2,"children":[]},{"title":"External accounts","slug":"external-accounts","depth":2,"children":[]},{"title":"Contacts","slug":"contacts","depth":2,"children":[]},{"title":"Payments","slug":"payments","depth":2,"children":[]},{"title":"Replies to Moneda","slug":"replies-to-moneda","depth":2,"children":[]},{"title":"Receipts","slug":"receipts","depth":2,"children":[]},{"title":"Agent sessions","slug":"agent-sessions","depth":2,"children":[]},{"title":"Active sessions","slug":"active-sessions","depth":2,"children":[]},{"title":"Usage credits","slug":"usage-credits","depth":2,"children":[]},{"title":"Learn more","slug":"learn-more","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/moneda/786fa541146b6fb2/posthog.js"],"subdomain":"moneda","siteName":"Moneda Docs","title":"Write Tools - Moneda Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-16T12:21:31.957Z","originalFileLocation":"tools/write-tools.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Write MCP tools for payments, transaction categorization, contact management, receipts, and account updates on Moneda\">\u003cmeta data-mint-head name=\"application-name\" content=\"Moneda Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/moneda/bbGfxjUGvIMskUCN/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/moneda/bbGfxjUGvIMskUCN/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/moneda/bbGfxjUGvIMskUCN/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/moneda/bbGfxjUGvIMskUCN/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/moneda/bbGfxjUGvIMskUCN/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/moneda/bbGfxjUGvIMskUCN/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/moneda/bbGfxjUGvIMskUCN/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/moneda/bbGfxjUGvIMskUCN/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/moneda/bbGfxjUGvIMskUCN/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Write Tools - Moneda Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Write MCP tools for payments, transaction categorization, contact management, receipts, and account updates on Moneda\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Moneda Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.moneda.com/tools/write-tools\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://docs.moneda.com/assets/og-image.png\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Write Tools - Moneda Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Write MCP tools for payments, transaction categorization, contact management, receipts, and account updates on Moneda\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://docs.moneda.com/assets/og-image.png\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/moneda/bbGfxjUGvIMskUCN/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Moneda Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#03789B\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.moneda.com/tools/write-tools\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/tools/write-tools.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.moneda.com/#organization\",\"name\":\"Moneda Docs\",\"url\":\"https://docs.moneda.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/moneda/IqWzDgNspCei7rzS/assets/Moneda-Logo-Lockup.png?fit=max\u0026auto=format\u0026n=IqWzDgNspCei7rzS\u0026q=85\u0026s=1af6aaa757979972093a77dfbdf28132\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.moneda.com#website\",\"name\":\"Moneda Docs\",\"url\":\"https://docs.moneda.com\",\"publisher\":{\"@id\":\"https://docs.moneda.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.moneda.com/tools/write-tools#webpage\",\"url\":\"https://docs.moneda.com/tools/write-tools\",\"name\":\"Write Tools\",\"description\":\"Write MCP tools for payments, transaction categorization, contact management, receipts, and account updates on Moneda\",\"dateModified\":\"2026-11-16T12:21:31.957Z\",\"isPartOf\":{\"@id\":\"https://docs.moneda.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.moneda.com/tools/write-tools#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.moneda.com/tools/write-tools#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Tools\",\"item\":\"https://docs.moneda.com/tools/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Write Tools\",\"item\":\"https://docs.moneda.com/tools/write-tools\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.moneda.com/tools/write-tools#article\",\"headline\":\"Write Tools\",\"name\":\"Write Tools\",\"description\":\"Write MCP tools for payments, transaction categorization, contact management, receipts, and account updates on Moneda\",\"url\":\"https://docs.moneda.com/tools/write-tools\",\"mainEntityOfPage\":{\"@id\":\"https://docs.moneda.com/tools/write-tools#webpage\"},\"image\":\"https://docs.moneda.com/assets/og-image.png\",\"dateModified\":\"2026-11-16T12:21:31.957Z\",\"publisher\":{\"@id\":\"https://docs.moneda.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.moneda.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Moneda Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Moneda Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/tools/write-tools.md","siteName":"Moneda Docs","nav":{"global":{"anchors":[]},"tabs":[{"tab":"Moneda","pages":[{"title":"Moneda","href":"/moneda"}]},{"tab":"API","pages":[{"title":"API","href":"/api/overview"}]},{"tab":"CLI","pages":[{"title":"CLI","href":"/cli/overview"}]},{"tab":"MCP","groups":[{"group":"Overview","icon":"book-open","pages":[{"title":"What is Moneda MCP","tag":"Beta","href":"/mcp-overview"},{"title":"Action patterns","href":"/mcp-action-patterns"},{"title":"Use Cases","href":"/use-cases"}]},{"group":"Getting Started","icon":"rocket","pages":[{"title":"Quickstart","tag":"Beta","href":"/getting-started/quickstart"},{"title":"Authentication","tag":"Beta","href":"/getting-started/authentication"},{"title":"Connect Your AI Assistant","tag":"Beta","href":"/getting-started/client-setup"}]},{"group":"Tools","icon":"wrench","pages":[{"title":"Available Tools","tag":"Beta","href":"/tools/overview"},{"title":"Read Tools","description":"Read-only MCP tools to query Moneda balances, transactions, spending breakdowns, earnings analytics, contacts, recovery setup, notifications, sub-account vaults, receipts, bills, and account info","tag":"Beta","href":"/tools/read-tools"},{"title":"Write Tools","tag":"Beta","href":"/tools/write-tools"},{"title":"Agent Tools (SDK)","description":"Provider-agnostic tool descriptors for binding Moneda's read-only services directly to an LLM agent — ~10× cheaper than MCP-over-HTTP","tag":"Beta","href":"/tools/agent-tools"}]},{"group":"Reference","icon":"book","pages":[{"title":"Resources","tag":"Beta","href":"/resources"},{"title":"Scopes","tag":"Beta","href":"/scopes"},{"title":"Integrations","href":"/integrations"},{"title":"Changelog","href":"/changelog"}]}]}]},"basePath":"","title":"Write Tools - Moneda Docs","deploymentId":"dpl_2pTxFtyBudBMYZiCw1MyvoA1wxpd","buildId":"dpl_2pTxFtyBudBMYZiCw1MyvoA1wxpd","dynamics":[],"chunks":[]}