Zineps platform

Public MCP — tools & access matrix

Who can call which MCP tool, at read or write level. Generated from McpToolAccessMatrix in the repo.

✓ read ✎ write — denied Read-only MCP credentials block all ✎ write tools.

Actor roles

RoleDescriptionData scope
Zineps AdminZineps staff (Admin role)All organisations
Zineps SuperuserZineps staff (Superuser role)All organisations
PartnerPartner owner or partner-panel userMerchants under their PartnerId
SubpartnerFranchise / sub-partner userMerchants assigned to their sub-partner
MerchantShipper organisation user (OAuth)Own organisation only (sub = company id)

Merchant shipping tools

Common merchant-facing label and order tools (also listed in the full matrix below).

ToolPurposeMerchant
FindLabel Find labels by track & trace, label id, or reference. ✓
GetLabelTrackingStatus Carrier tracking status and history for a label. ✓
FindOrder Find orders in Zineps by number, T&T, or email. ✓
GetLabelsForOrder Labels linked to a Zineps order id. ✓
ListRecentLabels Most recent labels in scope (newest first). ✓
GetLabel Full label details including order and carrier contract/product. ✓
CreateLabelForOrder Create shipping label for a Zineps order (requires carrier on order). ✎
RemakeLabel Create a new label using the same order and carrier contract/product as an existing label. ✎
DownloadLabel Re-download label PDF/ZPL as base64. ✓
SendLabelToPrintNode Send label print job to PrintNode (again). ✎

Full tool matrix

ToolCategoryWrite? AdminSuperuserPartnerSubpartnerMerchant Description
GetAddressBookForUser Address book no ✎ ✎ ✓ ✓ ✓ Address book entries.
SearchAddressBook Address book no ✎ ✎ ✓ ✓ ✓ Search address book.
FindInvoice Billing no ✎ ✎ ✓ ✓ — Find customer invoices.
GetCustomerInvoicesForUser Billing no ✎ ✎ ✓ ✓ ✓ Invoices for a company.
InvoiceInvestigation Billing no ✎ ✎ ✓ ✓ — Invoice line detail.
ListCarrierInvoices Billing no ✎ ✎ ✓ — — Carrier invoice files for partner reconciliation.
SearchCustomerInvoices Billing no ✎ ✎ ✓ ✓ — Search invoices in partner scope.
get_carrier_routes Carriers no ✎ ✎ ✓ ✓ — Carrier route metadata.
GetCarrierProducts Carriers no ✎ ✎ ✓ ✓ ✓ Products for a carrier.
GetPartnerCarrierRates Carriers no ✎ ✎ ✓ ✓ — Partner rates for carrier/product.
ListCarriers Carriers no ✎ ✎ ✓ ✓ ✓ List carriers available in scope.
FindUser Customers no ✎ ✎ ✓ ✓ — Find merchants/users by email or company name.
GetUser Customers no ✎ ✎ ✓ ✓ ✓ Full user profile by company id.
LookupCustomer Customers no ✎ ✎ ✓ ✓ ✓ Detailed customer profile and stats.
SearchUsers Customers no ✎ ✎ ✓ ✓ — Search users under partner scope.
DebugCarrierRateFromDraft Drafts no ✎ ✎ ✓ ✓ ✓ Live carrier rate debug from draft.
GetShipmentDraft Drafts no ✎ ✎ ✓ ✓ ✓ Get shipment draft payload JSON.
GetShipmentDraftsForUser Drafts no ✎ ✎ ✓ ✓ ✓ List shipment drafts for a company.
ListRecentUserQuestions Intent no ✎ ✎ ✓ ✓ — Recent MCP user questions in scope.
RecordUserQuestion Intent yes ✎ ✎ ✎ ✎ ✎ Logs support/intent context for an MCP session.
CreateLabelForOrder Labels yes ✎ ✎ ✎ ✎ ✎ Create shipping label for a Zineps order (requires carrier on order).
DownloadLabel Labels no ✎ ✎ ✓ ✓ ✓ Re-download label PDF/ZPL as base64.
FindLabel Labels no ✎ ✎ ✓ ✓ ✓ Find labels by track & trace, label id, or reference.
get_label_log Labels no ✎ ✎ ✓ ✓ — Fetch a single label API log entry.
GetLabel Labels no ✎ ✎ ✓ ✓ ✓ Full label details including order and carrier contract/product.
GetLabelsForOrder Labels no ✎ ✎ ✓ ✓ ✓ Labels linked to a Zineps order id.
GetLabelSurchargesForUser Labels no ✎ ✎ ✓ ✓ ✓ Label surcharges for a company.
GetLabelTrackingStatus Labels no ✎ ✎ ✓ ✓ ✓ Carrier tracking status and history for a label.
GetUsageRecordsForUser Labels no ✎ ✎ ✓ ✓ ✓ Usage records for one company.
InvestigateLabelByTrackTrace Labels no ✎ ✎ ✓ ✓ ✓ Material/customs/line-item label investigation.
ListRecentLabels Labels no ✎ ✎ ✓ ✓ ✓ Most recent labels in scope (newest first).
LookupByTrackTrace Labels no ✎ ✎ ✓ ✓ ✓ Shipment lookup by exact track & trace.
LookupByTrackTraceBatch Labels no ✎ ✎ ✓ ✓ — Batch T&T lookup (max 200).
RemakeLabel Labels yes ✎ ✎ ✎ ✎ ✎ Create a new label using the same order and carrier contract/product as an existing label.
search_label_logs Labels no ✎ ✎ ✓ ✓ — Search label API logs.
SearchLabelSurcharges Labels no ✎ ✎ ✓ ✓ ✓ Search label surcharges by track & trace.
SearchUsageRecords Labels no ✎ ✎ ✓ ✓ ✓ Search label usage records.
SendLabelToPrintNode Labels yes ✎ ✎ ✎ ✎ ✎ Send label print job to PrintNode (again).
SummarizeUsageRecords Labels no ✎ ✎ ✓ ✓ ✓ Label volume summary for a period.
FetchWebshopOrder Orders no ✎ ✎ ✓ ✓ ✓ Live shop API lookup (Shopify/Woo/CCV).
FindOrder Orders no ✎ ✎ ✓ ✓ ✓ Find orders in Zineps by number, T&T, or email.
GetOrdersForUser Orders no ✎ ✎ ✓ ✓ ✓ List orders for a company id.
GetShopifyOrderLineItems Orders no ✎ ✎ ✓ ✓ ✓ Shopify line items for a shop order.
OrderInvestigation Orders no ✎ ✎ ✓ ✓ ✓ Deep order investigation with line items.
SearchOrders Orders no ✎ ✎ ✓ ✓ ✓ Search orders with optional open-only filter.
GetPartner Partner no ✎ ✎ ✓ — — Single partner record by id.
GetPartnerCarrierSurcharges Partner no ✎ ✎ ✓ ✓ — Partner carrier surcharge catalog.
PartnerSummary Partner no ✎ ✎ ✓ — — Partner-level KPI summary.
SearchCarrierSurcharges Partner no ✎ ✎ ✓ ✓ — Search carrier surcharges.
SearchPartners Partner no ✎ ✎ ✓ — — Search partners by name.
GetPaymentOrderByMollieId Payments no ✎ ✎ ✓ ✓ — Lookup payment order by Mollie id.
GetPaymentOrdersForUser Payments no ✎ ✎ ✓ ✓ ✓ Payment orders for a company.
GetReturnOrdersForUser Returns no ✎ ✎ ✓ ✓ ✓ Return orders for a company.
SearchReturnOrders Returns no ✎ ✎ ✓ ✓ — Search return orders.
GetMyInfo Session no ✎ ✎ ✓ ✓ ✓ Current MCP actor, organisation, access mode (read/write).
GetToolGuide Session no ✎ ✎ ✓ ✓ ✓ Explains available MCP tools for the current actor.
GetShopIntegrations Shops no ✎ ✎ ✓ ✓ ✓ Shop integrations for partner scope.
GetShopIntegrationsForUser Shops no ✎ ✎ ✓ ✓ ✓ Shop integrations for a company.
GetSubscriptionsForUser Subscriptions no ✎ ✎ ✓ ✓ ✓ Subscriptions for a company.
ListSubscriptionTiers Subscriptions no ✎ ✎ ✓ ✓ — Available subscription tiers.
GetTicketsForUser Support no ✎ ✎ ✓ ✓ ✓ Support tickets for a user.
SearchTickets Support no ✎ ✎ ✓ ✓ — Search tickets.

Address book

Billing

Carriers

Customers

Drafts

Intent

Labels

Orders

Partner

Payments

Returns

Session

Shops

Subscriptions

Support