Skip to Content
The Makinari API repo now includes an MCP Server — connect your AI models directly. View on GitHub →
MCPCommerce

Commerce tools

MCP names: checkout, reservations, quotations, sales, purchases, catalog_commerce.

Procurement: purchasing, tenders and awards

Procurement requests — interactive demo
Explore procurement requests as a visual reference for the request, approval and order lifecycle described below.
Sample workspace, not your live Site. This visual reference does not verify API calls or configure your integrations.
Open procurement requests demo in a new tab ↗Scroll inside the demo to explore. If it does not load or you need more space, use the link above.
Procurement tenders — interactive demo
Explore procurement tenders as a visual reference for publication and proposal management. The API contract determines approval and sealed-proposal permissions.
Sample workspace, not your live Site. This visual reference does not verify API calls or configure your integrations.
Open procurement tenders demo in a new tab ↗Scroll inside the demo to explore. If it does not load or you need more space, use the link above.

The procurement_* tools operate the procurement module, not legacy vendor bills, customer checkout or sales quotations. Discover their action-specific schemas through tools (describe). Tools are filtered by their respective screen permissions in discovery and execution, following the shared administrator exemption. The canonical database operations additionally require a verified owner/admin actor with unrestricted workspace access; configured approval eligibility is also enforced.

ToolActions
procurement_requestslist, get, save, submit, revalidate, decide
procurement_tenderslist, get, save, publish, transition, participant, portal
procurement_quotationslist, get, options, record
procurement_approvalslist, get, create, decide
procurement_orderslist, receive
procurement_policyget

save creates a full draft with no ID and version/revision zero; updates require the current ID and version/revision. Amounts are integer minor units. Invitations record supplier eligibility, not email delivery. Publication, award and order requests may remain pending approval. Read the resulting state before claiming completion. Sealed proposals remain sealed until the module permits opening.

Quotation imports and receipts require stable idempotency UUIDs. Reuse the same key and payload on retries. Other creates are not generally idempotent; inspect state after a lost response rather than blindly retrying. Receipts are non-stock acceptance, not inventory movement, accounting posting or payment.

Request/tender/approval lists support bounded limit/offset. Canonical quotation and order lists are limited to the latest 100. Supplier onboarding, policy editing, supplier-side submission and evidence uploads remain in the procurement UI. The backend procurement migrations and service-only MCP bridge must be deployed before execution; tool discovery alone does not prove backend availability.

checkout

Actions: create_order · create_payment_link · get_order.

Creates a pending sale_order. Stripe completion is handled by the commerce webhook (metadata.type = sale_order). Do not also call create_order for a slot you already booked with reservations.create.

ParameterTypeNotes
actionstringcreate_order, create_payment_link, get_order
customer_emailstringResolves / creates a lead
lead_idstringAttach to the sale
sourcestringquote, marketplace, shop, sales
linesstringJSON string of lines: catalogItemId, quantity, optional modifiers, reservationStart / reservationEnd
order_idstringRequired for payment link / get
return_urlstringAfter Stripe; default /buyer/orders
{ "action": "create_order", "site_id": "YOUR_SITE_ID", "customer_email": "buyer@example.com", "lines": "[{\"catalogItemId\":\"HOST_ID\",\"quantity\":1}]" }
{ "action": "create_payment_link", "order_id": "ORDER_ID" }

reservations

Actions: list · get · get_available_slots · create · update.

create books the slot and inserts a pending sale order (order_id, sale_id in the response). Charge with checkout.create_payment_link. Pass entitlement_id for a $0 line.

ParameterTypeNotes
catalog_item_idstringRequired for create and slot query
lead_idstringRequired for create
from_date, to_datestringISO date for slot query
start_time, end_timestringISO datetime for create / reschedule
quantitynumberSeats (default 1)
id / reservation_idstringRequired for get / update
statusstringpending, confirmed, cancelled
{ "action": "get_available_slots", "catalog_item_id": "CAT_ITEM_ID", "from_date": "2026-07-27", "to_date": "2026-07-31", "quantity": 2 }

update with status=cancelled frees capacity. Capacity checks exclude the reservation being updated.

catalog_commerce

Actions: create · list · get · update · delete.

Default resource is item. Other resources cover the same structures the catalog UI can set: modifiers, tech specs, and taxes.

resourceNotes
itemProducts / services. delete is not supported — archive with status=archived. get accepts include_modifiers, include_specs, include_taxes.
modifier_groupSelection rules (min_select, max_select)
modifier_group_itemOption = a catalog item inside a group
item_modifier_groupAttach a group to a host product
item_spec_categoryTech-spec group. slug is required in DB and is auto-generated from name if omitted.
item_specSpec row. category_id here is an item_spec_category UUID, not a catalog category.
catalog_item_specAttach a spec to a product. Identify rows with catalog_item_id + item_spec_id.
taxSite tax. rate is 0–100.
catalog_item_taxAttach a tax to a product. update is not supported.
{ "action": "create", "resource": "item_spec_category", "site_id": "YOUR_SITE_ID", "name": "Dimensions" }
{ "action": "create", "resource": "item_spec", "site_id": "YOUR_SITE_ID", "category_id": "SPEC_CATEGORY_ID", "name": "120 x 60 cm" }
{ "action": "create", "resource": "catalog_item_spec", "site_id": "YOUR_SITE_ID", "catalog_item_id": "ITEM_ID", "item_spec_id": "SPEC_ID" }
{ "action": "create", "resource": "tax", "site_id": "YOUR_SITE_ID", "name": "IVA", "rate": 16 }
{ "action": "create", "resource": "catalog_item_tax", "site_id": "YOUR_SITE_ID", "catalog_item_id": "ITEM_ID", "tax_id": "TAX_ID" }
  • quotations / quotation_items — commercial quotes before checkout.
  • sales / salesOrder — closed deals and order records.
  • purchases / purchase_items / transactions — vendor bills and expenses.
  • catalog_commerce — listing, modifiers, tech specs, taxes, and catalog settings.
  • promotions, entitlements, subscription_plan_items — discounts and digital access.

Same auth and site_id rules as CRM.

Last updated on