{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-guides/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"MCP Tool Reference (Merchant)"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"mcp-tool-reference-merchant","__idx":0},"children":["MCP Tool Reference (Merchant)"]},{"$$mdtype":"Tag","name":"style","attributes":{},"children":["\n/* Tool names are long identifiers; without this the Tool column breaks them\n   mid-name across several lines. */\ntable td:first-child code {\n  white-space: nowrap;\n}\ntable td:first-child {\n  width: 1%;\n}\n"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Tools available to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["merchant accounts"]},". All tools run under the authenticated principal's identity and mirror the equivalent Merchant REST API endpoint. Partner accounts get a separate set — see the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/mcp-tools-partner"},"children":["Partner Tool Reference"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Access"]}," indicates the minimum permission required:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Read"]}," — any merchant role, including read-only logins (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merchant:read"]}," scope for M2M keys)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Write"]}," — a write-capable merchant role (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merchant:write"]}," scope for M2M keys)"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"general","__idx":1},"children":["General"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Tool"},"children":["Tool"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Access"},"children":["Access"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["list_resolve_accounts"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["List the Resolve accounts available to the authenticated login. Call this first when a login has access to multiple accounts."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["search"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Semantic search over Resolve's published help articles — ask \"how does X work in Resolve\"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["create_temp_file"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Write"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Mint a presigned S3 upload URL for a file (e.g. an invoice PDF) so it can be attached to an invoice without passing the file through the LLM. ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Not available in ChatGPT or Codex — see note below."]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["list_temp_files"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["List previously uploaded temp files and mint fresh download URLs. ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Not available in ChatGPT or Codex — see note below."]}]}]}]}]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["File handling in ChatGPT and Codex:"]}," these clients attach files directly to the conversation instead of using the temp-file tools. Tool parameters that expect a file URL (such as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merchant_invoice_url"]}," on ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["create_invoice"]},") accept the conversation attachment directly, and the MCP server resolves it for the Resolve API. The temp-file tools are hidden for these connections."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"customers","__idx":2},"children":["Customers"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Tool"},"children":["Tool"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Access"},"children":["Access"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["list_customers"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["List customers, with exact-match filters on ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["business_name"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["email"]},", and more."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_customer"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fetch a single customer, including credit status and available credit."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["create_customer"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Write"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Create a new customer (buyer)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["update_customer"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Write"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Update a customer's details."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["request_credit_check"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Write"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Submit a customer for credit underwriting."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["enroll_customer"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Write"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Enroll an approved customer in net terms."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"invoices","__idx":3},"children":["Invoices"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Tool"},"children":["Tool"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Access"},"children":["Access"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["list_invoices"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["List invoices, with filters on number, PO number, customer, balance, and status."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_invoice"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fetch a single invoice."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["create_invoice"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Write"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Create an invoice for a customer."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["update_invoice"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Write"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Update an invoice (e.g. set ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["terms"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["advance_requested"]}," before sending)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["send_invoice"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Write"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Send the invoice to the customer."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["advance_invoice"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Write"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Request an advance payout against a sent invoice."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["capture_invoice"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Write"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Capture an authorized invoice."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["void_invoice"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Write"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Void a sent invoice."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cancel_invoice"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Write"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Cancel an invoice."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["delete_invoice"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Write"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Delete a draft (unsent) invoice."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"orders","__idx":4},"children":["Orders"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Tool"},"children":["Tool"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Access"},"children":["Access"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["list_orders"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["List orders."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_order"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fetch a single order."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["create_order"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Write"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Create an order."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["update_order"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Write"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Update an order."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["capture_order"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Write"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Capture an authorized order."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cancel_order"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Write"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Cancel an order."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"charges","__idx":5},"children":["Charges"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Tool"},"children":["Tool"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Access"},"children":["Access"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["list_charges"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["List charges."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_charge"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fetch a single charge."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["update_charge"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Write"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Update a charge."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["capture_charge"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Write"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Capture an authorized charge."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cancel_charge"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Write"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Cancel a charge."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"shipments","__idx":6},"children":["Shipments"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Tool"},"children":["Tool"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Access"},"children":["Access"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["list_shipments"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["List shipments."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_shipment"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fetch a single shipment."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["create_shipment"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Write"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Add a shipment (tracking number, courier, fulfillment method) to an invoice."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["update_shipment"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Write"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Update a shipment."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["delete_shipment"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Write"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Delete a shipment."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sync_shipment_tracking"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Write"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Pull real-time tracking status from the courier."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_shipment_signed_upload_url"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Write"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Mint a signed URL for uploading proof-of-delivery files, required for non-shipping-provider fulfillment methods."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"payments--payouts","__idx":7},"children":["Payments & Payouts"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Tool"},"children":["Tool"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Access"},"children":["Access"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["list_payments"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["List payments received from customers."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_payment"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fetch a single payment, including which invoices it applied to."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["list_payouts"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["List payouts from Resolve to your account."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_payout"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fetch a single payout."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["list_payout_transactions"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["List individual transactions within payouts."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_payout_transaction"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fetch a single payout transaction."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"credit-notes","__idx":8},"children":["Credit Notes"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Tool"},"children":["Tool"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Access"},"children":["Access"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["list_credit_notes"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["List credit notes."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_credit_note"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fetch a single credit note."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["create_credit_note"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Write"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Issue a credit note against a sent invoice."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["void_credit_note"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Write"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Void a credit note."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"webhooks","__idx":9},"children":["Webhooks"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Tool"},"children":["Tool"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Access"},"children":["Access"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["list_webhooks"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["List webhook endpoints and their subscribed events."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["upsert_webhook"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Write"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Create or update a webhook endpoint and its subscribed events."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["delete_webhook"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Write"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Delete a webhook endpoint."]}]}]}]}]}]},"headings":[{"value":"MCP Tool Reference (Merchant)","id":"mcp-tool-reference-merchant","depth":1},{"value":"General","id":"general","depth":2},{"value":"Customers","id":"customers","depth":2},{"value":"Invoices","id":"invoices","depth":2},{"value":"Orders","id":"orders","depth":2},{"value":"Charges","id":"charges","depth":2},{"value":"Shipments","id":"shipments","depth":2},{"value":"Payments & Payouts","id":"payments--payouts","depth":2},{"value":"Credit Notes","id":"credit-notes","depth":2},{"value":"Webhooks","id":"webhooks","depth":2}],"frontmatter":{"seo":{"title":"MCP Tool Reference (Merchant)"}},"lastModified":"2026-08-05T18:28:53.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/mcp-tools","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}