MCP 서버

Moltline Shipping Maths

com.moltlinestudio/shipping
비즈니스 및 운영 커머스 및 리테일 공개 · 연결 가능 MCP 2025-11-25

이 MCP로 할 수 있는 일

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.
읽기 전용 멱등성
입력 스키마
{'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}
출력 스키마
{'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.
읽기 전용 멱등성
입력 스키마
{'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}
출력 스키마
{'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.
읽기 전용 멱등성
입력 스키마
{'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}
출력 스키마
{'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.
읽기 전용 멱등성
입력 스키마
{'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}
출력 스키마
{'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.
읽기 전용 멱등성
입력 스키마
{'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}
출력 스키마
{'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.
읽기 전용 멱등성
입력 스키마
{'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}
출력 스키마
{'type': 'object', 'additionalProperties': True}
추가됨
free_shipping_threshold
2026년 9월 17일 12:36 PM
추가됨
rate_card
2026년 9월 17일 12:36 PM
추가됨
freight_class
2026년 9월 17일 12:36 PM
추가됨
landed_cost
2026년 9월 17일 12:36 PM
추가됨
parcel_fit
2026년 9월 17일 12:36 PM
추가됨
dim_weight
2026년 9월 17일 12:36 PM