Hanzo AI
Sign inAPI key
Cloud MCP

Commerce

commerce: 215 operations.

Also for this capability: API · CLI · MCP · SDKs

commerce: 215 operations. Name one in "op" and pass that operation's own arguments in "input". describe returns an operation's input schema.

Toolcommerce
Addresshttps://api.hanzo.ai/v1/mcp
Methodtools/call (JSON-RPC 2.0)
Arguments2, 1 required
OperationPOST /v1/billing/invoices/{id}/collect · POST /v1/commerce/cart/{id}/discard · GET /v1/commerce/cart/{id} · GET /v1/billing/invoices/{id} · GET /v1/commerce/payments/{id} · GET /v1/billing/tier · GET /v1/billing/wire · GET /v1/commerce/admin/catalog · GET /v1/commerce/catalog · GET /v1/commerce/collection/ · GET /v1/commerce/collection/{collectionid} · GET /v1/commerce/disclosure/ · GET /v1/commerce/disclosure/{disclosureid} · GET /v1/commerce/discount/ · GET /v1/commerce/discount/{discountid} · GET /v1/commerce/movie/ · GET /v1/commerce/movie/{movieid} · GET /v1/commerce/note/ · GET /v1/commerce/note/{noteid} · GET /v1/commerce/org · GET /v1/commerce/product/ · GET /v1/commerce/product/{productid} · GET /v1/commerce/return/ · GET /v1/commerce/return/{returnid} · GET /v1/commerce/saleschannel/ · GET /v1/commerce/saleschannel/{saleschannelid} · GET /v1/commerce/stocklocation/ · GET /v1/commerce/stocklocation/{stocklocationid} · GET /v1/commerce/submission/ · GET /v1/commerce/submission/{submissionid} · GET /v1/commerce/subscriber/ · GET /v1/commerce/subscriber/{subscriberid} · GET /v1/commerce/tokentransaction/ · GET /v1/commerce/tokentransaction/{tokentransactionid} · GET /v1/commerce/transfer/ · GET /v1/commerce/transfer/{transferid} · GET /v1/commerce/variant/ · GET /v1/commerce/variant/{variantid} · GET /v1/commerce/wallet/ · GET /v1/commerce/wallet/{walletid} · GET /v1/commerce/watchlist/ · GET /v1/commerce/watchlist/{watchlistid} · GET /v1/commerce/webhook/ · GET /v1/commerce/webhook/{webhookid} · POST /v1/billing/invoices/{id}/issue · POST /v1/commerce/cart · POST /v1/commerce/collection/ · POST /v1/commerce/collection/{collectionid} · POST /v1/commerce/disclosure/ · POST /v1/commerce/disclosure/{disclosureid} · POST /v1/commerce/discount/ · POST /v1/commerce/discount/{discountid} · POST /v1/commerce/movie/ · POST /v1/commerce/movie/{movieid} · POST /v1/commerce/note/ · POST /v1/commerce/note/{noteid} · POST /v1/commerce/product/ · POST /v1/commerce/product/{productid} · POST /v1/commerce/return/ · POST /v1/commerce/return/{returnid} · POST /v1/commerce/saleschannel/ · POST /v1/commerce/saleschannel/{saleschannelid} · POST /v1/commerce/stocklocation/ · POST /v1/commerce/stocklocation/{stocklocationid} · POST /v1/commerce/submission/ · POST /v1/commerce/submission/{submissionid} · POST /v1/commerce/subscriber/ · POST /v1/commerce/subscriber/{subscriberid} · POST /v1/commerce/tokentransaction/ · POST /v1/commerce/tokentransaction/{tokentransactionid} · POST /v1/commerce/transfer/ · POST /v1/commerce/transfer/{transferid} · POST /v1/commerce/variant/ · POST /v1/commerce/variant/{variantid} · POST /v1/commerce/wallet/ · POST /v1/commerce/wallet/{walletid} · POST /v1/commerce/watchlist/ · POST /v1/commerce/watchlist/{watchlistid} · POST /v1/commerce/webhook/ · POST /v1/commerce/webhook/{webhookid} · POST /v1/billing/invoices · POST /v1/commerce/cart/{id}/item · POST /v1/commerce/payments · POST /v1/billing/invoices/{id}/void
Productbilling

Arguments

FieldTypeRequiredDefaultValuesDescription
inputobject———arguments for the chosen op
opstringyes———

tools/list declares a type, a description, which fields are required and an enumerated value set for each field and nothing further, and every column above is MCP's own. This tool takes an operation name and that operation's arguments, so what the document constrains is what goes inside input, field by field, on the operation you name — ask describe for that. A — means MCP does not constrain the field.

Call it

A tools/call carries every argument in one flat object — nothing binds to a path or a query string. This call carries exactly the arguments the operation requires, so it is the smallest one that can run.

curl -X POST https://api.hanzo.ai/v1/mcp \
  -H "Authorization: Bearer $HANZO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
       "jsonrpc": "2.0",
       "id": 1,
       "method": "tools/call",
       "params": {
         "name": "commerce",
         "arguments": {
           "op": "list___commerce_deposits"
         }
       }
     }'

Values are the operation's own defaults and enumerated values where it declares them, and a <placeholder> where neither source declares one. tools/list needs no credential; tools/call does — called without one MCP answers HTTP 200 with a JSON-RPC result whose isError is set and whose text says what was missing. How to get a key →

The operation behind it

commerce dispatches to 215 operations. 84 of them MCP names exactly as the document ids them, and those are below; for the rest MCP has its own verb, which describe resolves.

OperationRouteProductSummary
collectInvoicePOST /v1/billing/invoices/{id}/collectbillingCollect an issued invoice from credits, balance, then card
discardCartPOST /v1/commerce/cart/{id}/discardcommerceDiscard a cart the shopper abandoned
getCartGET /v1/commerce/cart/{id}commerceRead one cart with its lines and totals
getInvoiceGET /v1/billing/invoices/{id}billingRead one invoice
getPaymentGET /v1/commerce/payments/{id}commerceRead one settled payment by its id
get_billing_tierGET /v1/billing/tierbillingAnswers which tier the caller is on, what it allows, and what is left to spend.
get_billing_wireGET /v1/billing/wirebillingAnswers where to send a wire top-up: the receiving bank details, with the caller's own…
get_commerce_admin_catalogGET /v1/commerce/admin/catalogcommerceThe catalog projection with cost and margin included
get_commerce_catalogGET /v1/commerce/catalogcommerceThe public product catalog projection for a brand
get_commerce_collectionGET /v1/commerce/collection/commerceList your org's collections, as a page
get_commerce_collection_by_collectionidGET /v1/commerce/collection/{collectionid}commerceFetch one collection
get_commerce_disclosureGET /v1/commerce/disclosure/commerceList your org's disclosures, as a page
get_commerce_disclosure_by_disclosureidGET /v1/commerce/disclosure/{disclosureid}commerceFetch one disclosure
get_commerce_discountGET /v1/commerce/discount/commerceList your org's discounts, as a page
get_commerce_discount_by_discountidGET /v1/commerce/discount/{discountid}commerceFetch one discount
get_commerce_movieGET /v1/commerce/movie/commerceList your org's movies, as a page
get_commerce_movie_by_movieidGET /v1/commerce/movie/{movieid}commerceFetch one movie
get_commerce_noteGET /v1/commerce/note/commerceList your org's notes, as a page
get_commerce_note_by_noteidGET /v1/commerce/note/{noteid}commerceFetch one note
get_commerce_orgGET /v1/commerce/orgcommerceThe public org configuration a checkout page boots from
get_commerce_productGET /v1/commerce/product/commerceList your org's products, as a page
get_commerce_product_by_productidGET /v1/commerce/product/{productid}commerceFetch one product
get_commerce_returnGET /v1/commerce/return/commerceList your org's returns, as a page
get_commerce_return_by_returnidGET /v1/commerce/return/{returnid}commerceFetch one return
get_commerce_saleschannelGET /v1/commerce/saleschannel/commerceList your org's sales channels, as a page
get_commerce_saleschannel_by_saleschannelidGET /v1/commerce/saleschannel/{saleschannelid}commerceFetch one sales channel
get_commerce_stocklocationGET /v1/commerce/stocklocation/commerceList your org's stock locations, as a page
get_commerce_stocklocation_by_stocklocationidGET /v1/commerce/stocklocation/{stocklocationid}commerceFetch one stock location
get_commerce_submissionGET /v1/commerce/submission/commerceList your org's submissions, as a page
get_commerce_submission_by_submissionidGET /v1/commerce/submission/{submissionid}commerceFetch one submission
get_commerce_subscriberGET /v1/commerce/subscriber/commerceList your org's subscribers, as a page
get_commerce_subscriber_by_subscriberidGET /v1/commerce/subscriber/{subscriberid}commerceFetch one subscriber
get_commerce_tokentransactionGET /v1/commerce/tokentransaction/commerceList your org's token transactions, as a page
get_commerce_tokentransaction_by_tokentransactionidGET /v1/commerce/tokentransaction/{tokentransactionid}commerceFetch one token transaction
get_commerce_transferGET /v1/commerce/transfer/commerceList your org's transfers, as a page
get_commerce_transfer_by_transferidGET /v1/commerce/transfer/{transferid}commerceFetch one transfer
get_commerce_variantGET /v1/commerce/variant/commerceList your org's variants, as a page
get_commerce_variant_by_variantidGET /v1/commerce/variant/{variantid}commerceFetch one variant
get_commerce_walletGET /v1/commerce/wallet/commerceList your org's wallets, as a page
get_commerce_wallet_by_walletidGET /v1/commerce/wallet/{walletid}commerceFetch one wallet
get_commerce_watchlistGET /v1/commerce/watchlist/commerceList your org's watchlists, as a page
get_commerce_watchlist_by_watchlistidGET /v1/commerce/watchlist/{watchlistid}commerceFetch one watchlist
get_commerce_webhookGET /v1/commerce/webhook/commerceList your org's webhooks, as a page
get_commerce_webhook_by_webhookidGET /v1/commerce/webhook/{webhookid}commerceFetch one webhook
issueInvoicePOST /v1/billing/invoices/{id}/issuebillingIssue a draft invoice, making it collectible
openCartPOST /v1/commerce/cartcommerceOpen a cart for a shopper to fill
post_commerce_collectionPOST /v1/commerce/collection/commerceCreate a collection
post_commerce_collection_by_collectionidPOST /v1/commerce/collection/{collectionid}commerceMethod-override tunnel for a collection — for clients that cannot send PUT, PATCH or…
post_commerce_disclosurePOST /v1/commerce/disclosure/commerceCreate a disclosure
post_commerce_disclosure_by_disclosureidPOST /v1/commerce/disclosure/{disclosureid}commerceMethod-override tunnel for a disclosure — for clients that cannot send PUT, PATCH or…
post_commerce_discountPOST /v1/commerce/discount/commerceCreate a discount
post_commerce_discount_by_discountidPOST /v1/commerce/discount/{discountid}commerceMethod-override tunnel for a discount — for clients that cannot send PUT, PATCH or DELETE
post_commerce_moviePOST /v1/commerce/movie/commerceCreate a movie
post_commerce_movie_by_movieidPOST /v1/commerce/movie/{movieid}commerceMethod-override tunnel for a movie — for clients that cannot send PUT, PATCH or DELETE
post_commerce_notePOST /v1/commerce/note/commerceCreate a note
post_commerce_note_by_noteidPOST /v1/commerce/note/{noteid}commerceMethod-override tunnel for a note — for clients that cannot send PUT, PATCH or DELETE
post_commerce_productPOST /v1/commerce/product/commerceCreate a product
post_commerce_product_by_productidPOST /v1/commerce/product/{productid}commerceMethod-override tunnel for a product — for clients that cannot send PUT, PATCH or DELETE
post_commerce_returnPOST /v1/commerce/return/commerceCreate a return
post_commerce_return_by_returnidPOST /v1/commerce/return/{returnid}commerceMethod-override tunnel for a return — for clients that cannot send PUT, PATCH or DELETE
post_commerce_saleschannelPOST /v1/commerce/saleschannel/commerceCreate a sales channel
post_commerce_saleschannel_by_saleschannelidPOST /v1/commerce/saleschannel/{saleschannelid}commerceMethod-override tunnel for a sales channel — for clients that cannot send PUT, PATCH or…
post_commerce_stocklocationPOST /v1/commerce/stocklocation/commerceCreate a stock location
post_commerce_stocklocation_by_stocklocationidPOST /v1/commerce/stocklocation/{stocklocationid}commerceMethod-override tunnel for a stock location — for clients that cannot send PUT, PATCH or…
post_commerce_submissionPOST /v1/commerce/submission/commerceCreate a submission
post_commerce_submission_by_submissionidPOST /v1/commerce/submission/{submissionid}commerceMethod-override tunnel for a submission — for clients that cannot send PUT, PATCH or…
post_commerce_subscriberPOST /v1/commerce/subscriber/commerceCreate a subscriber
post_commerce_subscriber_by_subscriberidPOST /v1/commerce/subscriber/{subscriberid}commerceMethod-override tunnel for a subscriber — for clients that cannot send PUT, PATCH or…
post_commerce_tokentransactionPOST /v1/commerce/tokentransaction/commerceCreate a token transaction
post_commerce_tokentransaction_by_tokentransactionidPOST /v1/commerce/tokentransaction/{tokentransactionid}commerceMethod-override tunnel for a token transaction — for clients that cannot send PUT, PATCH…
post_commerce_transferPOST /v1/commerce/transfer/commerceCreate a transfer
post_commerce_transfer_by_transferidPOST /v1/commerce/transfer/{transferid}commerceMethod-override tunnel for a transfer — for clients that cannot send PUT, PATCH or DELETE
post_commerce_variantPOST /v1/commerce/variant/commerceCreate a variant
post_commerce_variant_by_variantidPOST /v1/commerce/variant/{variantid}commerceMethod-override tunnel for a variant — for clients that cannot send PUT, PATCH or DELETE
post_commerce_walletPOST /v1/commerce/wallet/commerceCreate a wallet
post_commerce_wallet_by_walletidPOST /v1/commerce/wallet/{walletid}commerceMethod-override tunnel for a wallet — for clients that cannot send PUT, PATCH or DELETE
post_commerce_watchlistPOST /v1/commerce/watchlist/commerceCreate a watchlist
post_commerce_watchlist_by_watchlistidPOST /v1/commerce/watchlist/{watchlistid}commerceMethod-override tunnel for a watchlist — for clients that cannot send PUT, PATCH or DELETE
post_commerce_webhookPOST /v1/commerce/webhook/commerceCreate a webhook
post_commerce_webhook_by_webhookidPOST /v1/commerce/webhook/{webhookid}commerceMethod-override tunnel for a webhook — for clients that cannot send PUT, PATCH or DELETE
raiseInvoicePOST /v1/billing/invoicesbillingRaise a draft invoice against a customer
setCartItemPOST /v1/commerce/cart/{id}/itemcommerceSet one item's quantity in a cart; zero removes it
takePaymentPOST /v1/commerce/paymentscommerceTake a card payment and credit the org's balance
voidInvoicePOST /v1/billing/invoices/{id}/voidbillingVoid a draft or issued invoice

The same capability over plain HTTP is in the billing API reference, on https://api.hanzo.ai.

All 121 tools · MCP · API reference

Generated from tools/list on https://api.hanzo.ai/v1/mcp — 121 tools captured 2026-08-16.

How is this guide?

Code

code: 7 operations.

Company

company: 22 operations.

On this page

ArgumentsCall itThe operation behind it