MCP tools
These pages document 93 tools across 11 families of the Carriyo MCP server. Click a family to see the catalog with parameters and example agent prompts.
Lookups (12 tools)
Read-only resolution tools — tenants, merchants, types, attributes, carrier accounts, locations, plus return-request reference data (reasons, resolutions, rejection reasons, item conditions, refund types). Agents call these first to know what they can act on.
Delivery options (5 tools)
CRUD on delivery options — the delivery choices a merchant offers at checkout (home delivery, click & collect, digital), each with its schedule, shipping fee, and eligibility conditions: list, get, create, edit, delete.
→ Browse the delivery options catalog
Products (5 tools)
CRUD on the merchant's product catalog: get, list, create, edit, delete.
Inventory (6 tools)
Stock-level reads, snapshots, deltas, and transfers across the merchant's fulfillment locations.
→ Browse the inventory catalog
Orders (11 tools)
Top-level order tools: create, get, list, edit, cancel, fulfill and unfulfill, plus order holds — hold, release, and read the order hold rules. Operational actions on fulfillment orders live under Fulfillment orders.
Fulfillment orders (11 tools)
The operational lifecycle for the fulfillment orders sitting under an order — splits, merges, location changes, scheduling, holds, fulfilling, shipping, cancelling items.
→ Browse the fulfillment orders catalog
Returns (10 tools)
Return-request CRUD and state-transition actions: create, edit, approve, reject, receive, ship, cancel, complete. Reference data (reasons, resolutions, etc.) lives under Lookups.
Shipments (16 tools)
CRUD and operational actions on shipments — create, edit, book, schedule, cancel, reassign, label, mark ready to ship, plus customer promise date revision.
→ Browse the shipments catalog
Reports (11 tools)
Analytics — SLA compliance, carrier performance, failure analysis, aging, transit time, return analytics, and more. Each tool returns the same data as its equivalent Dashboard report.
Automation rules (4 tools)
Read-only access to automation rulesets and individual rules. Useful for an agent diagnosing why a shipment was routed the way it was.
→ Browse the automation rules catalog
System logs (2 tools)
Diagnostic tools that surface a shipment's request / response history with carriers — invaluable when debugging a stuck shipment.
→ Browse the system logs catalog
Tool page shape
Every tool page follows the same structure:
- What it does — one-line scenario from the server description.
- Parameters — required and key optional fields, sourced from the live MCP server's input schema.
- Returns — shape of the response.
- Example agent prompt — natural-language input that triggers this tool.
- Related tools — tools commonly chained with this one.
Source of truth
The tool catalog on these pages is hand-authored from the live MCP
server (https://mcp.carriyo.com/mcp → tools/list). When the
catalog or schemas change, these pages need to be updated by hand —
they are not auto-regenerated. If something on a sub-page
disagrees with the live tools/list response, treat the server as
authoritative and let us know via
Carriyo.com/contact.