Shipping rules tools

4 read-only tools to inspect Carriyo's shipping rulesets. Carriyo uses shipping rules to drive carrier selection automatically — and service-level rules to attach timing SLAs to each shipment.

These tools are read-only. There's no MCP equivalent for editing rules — that stays in the Dashboard.

Tools

Tool	What it returns
list_automation_rulesets	All rulesets in the tenant. Requires tenantId.
get_automation_ruleset	A single ruleset by id. Requires tenantId and ruleset_id.
list_automation_rules	All rules within a ruleset. Requires tenantId and ruleset_id.
get_automation_rule	A single rule by id. Requires tenantId, ruleset_id, and rule_id.

The tool names retain the automation_* prefix because they map directly to the MCP tool identifiers callers invoke. The grouping label has changed; the tool names have not.

When agents use these

The most common use case is explaining a routing decision:

"Why did SHP-12345 get routed to DHL?"

The agent reads the shipment, finds the ruleset that fired, lists the rules in that ruleset, and narrates which rule matched.

Tool sequence: get_shipment → (find ruleset id from shipment record) → get_automation_ruleset → list_automation_rules → narrate.

Notes

• Editing rules requires the Dashboard. Direct an agent to the appropriate How-to article (under /guides/automation/) when the user asks to change a rule rather than understand one.
• Rule conditions can reference custom attributes — get_custom_attributes is a useful companion lookup.