MCP Server

Moltline Shipping Maths

com.moltlinestudio/shipping
Business & Operations Commerce & Retail Public & reachable MCP 2025-11-25

What this MCP does

Calculates dimensional weight, parcel fit, freight class, landed cost, shipping thresholds, and customer-facing shipping rates.

dim_weight
Dim Weight
Work out whether a parcel bills on its size or its weight. FREE. Carriers charge the greater of actual weight and dimensional weight, so a light bulky box costs more than the scale suggests. Typical input {"length": 18, "width": 12, "height": 10, "actual_weight": 6} returns {"cubic": 2160.0, "dim_weight": 15.54, "actual_weight": 6.0, "billable_weight": 15.54, "billed_on": "dimensional", "overage": 9.54, "divisor_used": 139.0, "note": "..."}. Use when deciding whether a smaller box is worth the packing effort, or why an invoice exceeded the scale weight. Not for choosing a box from a list of candidates — that is parcel_fit. Errors: on invalid, missing, or malformed input this tool never raises a protocol error — it returns {"error": "<what is wrong and how to fix it>"} (for example {"error": "custom_divisor must be greater than 0 when divisor is 'custom'"}). Every call is read-only and idempotent, so after correcting the input it is always safe to retry.
Read only Idempotent
Input schema
{'type': 'object', 'required': ['length', 'width', 'height', 'actual_weight'], 'properties': {'width': {'type': 'number', 'description': 'Second side, same unit as length. Must be greater than 0.', 'exclusiveMinimum': 0}, 'height': {'type': 'number', 'description': 'Third side, same unit as length. Must be greater than 0.', 'exclusiveMinimum': 0}, 'length': {'type': 'number', 'description': 'Longest side of the packed parcel, in inches (or centimetres\nwhen using a metric divisor). Must be greater than 0.', 'exclusiveMinimum': 0}, 'divisor': {'enum': ['ups_daily', 'ups_retail', 'fedex', 'usps', 'metric_5000', 'metric_6000', 'custom'], 'type': 'string', 'default': 'ups_daily', 'description': 'Which published divisor to apply. "ups_daily" is 139 and\n"ups_retail" is 166 cubic inches per pound, as UPS states them;\n"usps" is 166; the metric options are cubic centimetres per\nkilogram. Use "custom" to supply a contracted divisor.'}, 'actual_weight': {'type': 'number', 'description': 'Scale weight in pounds (or kilograms with a metric\ndivisor). Must be greater than 0.', 'exclusiveMinimum': 0}, 'custom_divisor': {'type': 'number', 'default': 0, 'description': 'Your contracted divisor, used only when divisor is\n"custom". Must be greater than 0 in that case.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'additionalProperties': True}
free_shipping_threshold
Free Shipping Threshold
Find the order value at which free shipping stops costing you money. PREMIUM (license). Break-even is where the gross margin on the order covers the shipping you absorb. Typical input {"gross_margin_pct": 45, "ship_cost": 7.5, "current_aov": 38, "target_uplift_pct": 15} returns {"break_even": 16.67, "suggested_threshold": 43.7, "above_current_aov_by": 5.7, "rationale": "..."}. Use when setting or defending a free-shipping bar. Not for what shipping should cost when it is not free — that is rate_card. Errors: on invalid, missing, or malformed input this tool never raises a protocol error — it returns {"error": "<what is wrong and how to fix it>"}. Every call is read-only and idempotent, so after correcting the input it is always safe to retry.
Read only Idempotent
Input schema
{'type': 'object', 'required': ['gross_margin_pct', 'ship_cost', 'current_aov'], 'properties': {'ship_cost': {'type': 'number', 'description': 'What one shipment actually costs you to send.', 'exclusiveMinimum': 0}, 'current_aov': {'type': 'number', 'description': 'Your current average order value.', 'exclusiveMinimum': 0}, 'gross_margin_pct': {'type': 'number', 'maximum': 100, 'description': 'Gross margin on a typical order, e.g. 45 for 45%.\nMust be above 0 and at most 100.', 'exclusiveMinimum': 0}, 'target_uplift_pct': {'type': 'number', 'default': 0, 'minimum': 0, 'description': 'How far above current AOV you want the threshold\nset, to pull baskets up. Default 0, which returns break-even.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'additionalProperties': True}
freight_class
Freight Class
Derive a US LTL freight class from density. FREE. Density in pounds per cubic foot maps to a class on the published NMFC density scale. Typical input {"length": 48, "width": 40, "height": 36, "weight": 400} returns {"cubic_feet": 40.0, "density_pcf": 10.0, "density_class": "100", "caveat": "..."}. Use for a first estimate before a carrier quote. Not as a final classification: NMFC also weighs stowability, handling and liability, so a carrier can and does reclassify. Errors: on invalid, missing, or malformed input this tool never raises a protocol error — it returns {"error": "<what is wrong and how to fix it>"} (for example {"error": "dimensions produce zero volume"}). Every call is read-only and idempotent, so after correcting the input it is always safe to retry.
Read only Idempotent
Input schema
{'type': 'object', 'required': ['length', 'width', 'height', 'weight'], 'properties': {'units': {'enum': ['in_lb', 'cm_kg'], 'type': 'string', 'default': 'in_lb', 'description': '"in_lb" for inches and pounds, or "cm_kg" for centimetres and\nkilograms. Default "in_lb".'}, 'width': {'type': 'number', 'description': 'Second side. Must be greater than 0.', 'exclusiveMinimum': 0}, 'height': {'type': 'number', 'description': 'Third side, including the pallet. Must be greater than 0.', 'exclusiveMinimum': 0}, 'length': {'type': 'number', 'description': 'Longest side of the palletised freight. Must be greater than 0.', 'exclusiveMinimum': 0}, 'weight': {'type': 'number', 'description': 'Gross weight including the pallet. Must be greater than 0.', 'exclusiveMinimum': 0}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'additionalProperties': True}
landed_cost
Landed Cost
Total what a unit really costs once freight, duty and fees are in. FREE. Duty is applied to goods value, tax to goods plus duty plus freight — the common import treatment — and the order is spelled out in the response so you can check it against your own broker's method. Typical input {"unit_cost": 8.5, "quantity": 200, "freight_total": 640, "duty_pct": 6.5, "tax_pct": 0} returns {"goods": 1700.0, "duty": 110.5, "freight": 640.0, "tax": 0.0, "total_landed": 2450.5, "landed_unit_cost": 12.25, ...}. Use before setting a price on imported stock. Not for the margin that price leaves you — that is the dropship server's margin_check. Errors: on invalid, missing, or malformed input this tool never raises a protocol error — it returns {"error": "<what is wrong and how to fix it>"}. Every call is read-only and idempotent, so after correcting the input it is always safe to retry.
Read only Idempotent
Input schema
{'type': 'object', 'required': ['unit_cost'], 'properties': {'tax_pct': {'type': 'number', 'default': 0, 'minimum': 0, 'description': 'Import VAT or GST as a percentage of goods plus duty plus\nfreight, e.g. 20. Default 0.'}, 'duty_pct': {'type': 'number', 'default': 0, 'minimum': 0, 'description': 'Import duty as a percentage of goods value, e.g. 6.5.\nDefault 0.'}, 'quantity': {'type': 'integer', 'default': 1, 'minimum': 1, 'description': 'Units in the shipment. Must be at least 1. Default 1.'}, 'unit_cost': {'type': 'number', 'description': 'Ex-works cost of one unit in your currency. Must be\ngreater than 0.', 'exclusiveMinimum': 0}, 'other_fees': {'type': 'number', 'default': 0, 'minimum': 0, 'description': 'Brokerage, port and handling charges for the shipment.\nDefault 0.'}, 'freight_total': {'type': 'number', 'default': 0, 'minimum': 0, 'description': 'Total freight and insurance for the whole shipment,\nnot per unit. Default 0.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'additionalProperties': True}
parcel_fit
Parcel Fit
Pick the smallest box an item actually fits in, allowing for padding. FREE. Tries every rotation of the item against every box, so an item that only fits diagonally-oriented is still found. Typical input {"item_length": 10, "item_width": 6, "item_height": 4, "box_options": [[12, 9, 4], [14, 10, 6]]} returns {"fits": [{"box": [14, 10, 6], "cubic": 840.0, "slack": [2, 2, 0]}], "best": [14, 10, 6], "rejected": [...]}. Use when choosing packaging from stock. Not for what the carrier will bill once a box is chosen — that is dim_weight. Errors: on invalid, missing, or malformed input this tool never raises a protocol error — it returns {"error": "<what is wrong and how to fix it>"} (for example {"error": "box_options must contain at least one [l, w, h] box"}). Every call is read-only and idempotent, so after correcting the input it is always safe to retry.
Read only Idempotent
Input schema
{'type': 'object', 'required': ['item_length', 'item_width', 'item_height', 'box_options'], 'properties': {'padding': {'type': 'number', 'default': 1.0, 'minimum': 0, 'description': 'Cushioning allowance added to every item side before the\ncomparison, in the same unit. Default 1.0; use 0 for a bare fit.'}, 'item_width': {'type': 'number', 'description': "Item's second side, same unit. Must be greater than 0.", 'exclusiveMinimum': 0}, 'box_options': {'type': 'array', 'items': {'type': 'array', 'items': {'type': 'number'}}, 'description': 'Candidate inner box dimensions, each a list of exactly\nthree positive numbers, e.g. [[12, 9, 4], [14, 10, 6]].'}, 'item_height': {'type': 'number', 'description': "Item's third side, same unit. Must be greater than 0.", 'exclusiveMinimum': 0}, 'item_length': {'type': 'number', 'description': "Item's longest side, in inches. Must be greater than 0.", 'exclusiveMinimum': 0}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'additionalProperties': True}
rate_card
Rate Card
Turn a cost model into a customer-facing weight-banded price table. PREMIUM (license). Prices each band at its upper bound so you never under-charge inside a band, then rounds up to a tidy increment. Typical input {"base_cost": 4.2, "cost_per_lb": 0.65, "bands_lb": [1, 2, 5, 10], "margin_pct": 25} returns {"bands": [{"up_to_lb": 1, "cost": 4.85, "price": 6.5}, ...], "over_top_band": "quote individually"}. Use when publishing shipping prices customers pay. Not for the cut-off at which shipping becomes free — that is free_shipping_threshold. Errors: on invalid, missing, or malformed input this tool never raises a protocol error — it returns {"error": "<what is wrong and how to fix it>"} (for example {"error": "bands_lb must contain at least one upper bound"}). Every call is read-only and idempotent, so after correcting the input it is always safe to retry.
Read only Idempotent
Input schema
{'type': 'object', 'required': ['base_cost', 'cost_per_lb', 'bands_lb'], 'properties': {'bands_lb': {'type': 'array', 'items': {'type': 'number'}, 'description': 'Upper weight bound of each band in ascending order, e.g.\n[1, 2, 5, 10]. At least one band, each greater than 0.'}, 'round_to': {'type': 'number', 'default': 0.5, 'description': 'Increment to round each published price up to, e.g. 0.5 or\n1. Default 0.5.', 'exclusiveMinimum': 0}, 'base_cost': {'type': 'number', 'description': 'Fixed cost per shipment before weight, e.g. pick, pack and\nlabel. Must be greater than 0.', 'exclusiveMinimum': 0}, 'margin_pct': {'type': 'number', 'default': 0, 'minimum': 0, 'description': 'Margin added on top of cost, e.g. 25 for 25%. Default 0.'}, 'cost_per_lb': {'type': 'number', 'minimum': 0, 'description': 'Marginal cost per pound. Use 0 for a flat rate card.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'additionalProperties': True}
Added
free_shipping_threshold
Sept. 17, 2026, 12:36 p.m.
Added
rate_card
Sept. 17, 2026, 12:36 p.m.
Added
freight_class
Sept. 17, 2026, 12:36 p.m.
Added
landed_cost
Sept. 17, 2026, 12:36 p.m.
Added
parcel_fit
Sept. 17, 2026, 12:36 p.m.
Added
dim_weight
Sept. 17, 2026, 12:36 p.m.