Tool catalog
Every authenticated client discovers the same authorized business-tool catalog. The server exposes 22 reads and 12 confirmed actions. Compatible hosts may also discover four optional presentation tools.
Read tools
Read tools return minimized application data and do not change Inttegro state.
| Tool | What it returns |
|---|---|
get_country_specifications | Supported countries, currencies, payment methods, payout schedules, and onboarding capabilities |
get_balances | Balance categories by currency in minor units, plus Flint chart data and an optional PNG |
list_balance_transactions | A bounded page of balance activity and related order, payment, and payout IDs |
list_orders | A bounded page of recent orders with status and totals |
get_order | One order's status, totals, payment state, and timing without contact or address data |
list_payouts | A bounded page of payouts with status and amounts |
get_payout | One payout's status, amount, timing, destination identity, and minimized reconciliation detail |
get_payout_settings | Automatic payout schedule, FX status, and currency-to-destination mappings |
list_products | A bounded product page with compact price summaries |
get_product | One compact product without custom metadata or fulfillment internals |
list_prices | A bounded price page, optionally filtered to one product |
get_price | One price, its amount, and compact product identity |
get_payment_method_settings | Enabled and confirmation-required payment policy without credentials |
list_customers | A bounded customer page without raw contact or address data |
get_customer | One customer with channel availability and balances, without raw contact or address data |
list_buy_links | A bounded page of hosted buy links and lifecycle state |
get_buy_link | One buy link's canonical URL, rules, and lifecycle status |
list_messages | A bounded page of minimized message delivery states |
get_message | One delivery lifecycle without its body, recipient address, or provider payload |
get_order_analytics | Exact order and sales performance for 7, 30, or 90 days, with a Flint chart |
get_product_analytics | Exact product revenue, paid-order, and unit rankings, with a Flint chart |
get_customer_analytics | Exact new-customer and purchase analytics without contact details |
Action tools
Every action requires a caller-generated printable operation key of at most 60 characters and MCP form confirmation.
| Tool | What it can do |
|---|---|
create_customer | Create a customer without echoing submitted contact or address details |
update_customer | Update selected customer fields after confirmation |
create_order | Create a draft or finalized order from existing customer, product, and price IDs; never execute payment |
send_order_invoice | Send a finalized order's hosted invoice through all available customer channels |
send_order_receipt | Send a paid order's receipt and report outcomes by channel |
send_customer_sms | Send one bounded SMS to an existing customer with an SMS-capable number |
create_product | Create a draft or explicitly published physical, digital, service, voucher, custom, or cause product |
create_product_price | Create an active price for an existing product using a positive integer minor-unit amount |
create_buy_link | Create a hosted single-use or multi-use link for one product and price |
send_buy_link_sms | Verify a buy link, construct its canonical URL, and send it to an existing customer by SMS |
update_buy_link | Change a buy link's quantity bounds, expiry, or active state |
cancel_buy_link | Deactivate a buy link |
The owning Commerce API provides the durable idempotency boundary. Reuse an operation key only when retrying the exact same action with unchanged arguments; a new intent requires a new key.
Presentation tools
Hosts that advertise MCP Apps UI support may also use:
| Tool | View |
|---|---|
render_order_card | Compact order and payment status |
render_analytics_dashboard | Order, product, or customer analytics |
render_product_catalog | Product and price summaries |
render_buy_link_card | Buy-link status and canonical checkout URL |
These tools present unchanged business results. They do not add authority, fetch hidden data, or replace the text and structured result available to every client.
Analytics contract
Analytics comes from governed metric buckets rather than totals inferred from bounded operational pages. Exact values remain in structured results. Amounts stay in integer minor units, currencies remain separate, and missing buckets produce empty or partial status rather than estimates.
Deliberate boundaries
The catalog does not:
- execute or retry payments;
- move balances or change payout settings;
- expose customer phone numbers, email addresses, street addresses, payment credentials, or unrestricted custom metadata;
- send to arbitrary phone numbers, broadcast, or schedule messages;
- use repeated single-message calls as a bulk outreach mechanism; or
- proxy arbitrary Commerce API operations.
See merchant workflows for examples that combine these tools safely.