MCP tools

The Carriyo MCP server exposes 80 tools across 10 families. 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.

→ Browse the lookups catalog

Products (5 tools)

CRUD on the merchant's product catalog: get, list, create, edit, delete.

→ Browse the products catalog

Inventory (6 tools)

Stock-level reads, snapshots, deltas, and transfers across the merchant's fulfillment locations.

→ Browse the inventory catalog

Orders (5 tools)

Top-level order CRUD: create, get, list, edit, cancel. Operational actions on fulfillment orders live under Fulfillment orders.

→ Browse the orders catalog

Fulfillment orders (9 tools)

The operational lifecycle for the fulfillment orders sitting under an order — splits, merges, location changes, scheduling, 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.

→ Browse the returns catalog

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.

→ Browse the reports catalog

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:

1. What it does — one-line scenario from the server description.
2. Parameters — required and key optional fields, sourced from the live MCP server's input schema.
3. Returns — shape of the response.
4. Example agent prompt — natural-language input that triggers this tool.
5. 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.