MCPサーバー

Container Tracking MCP

io.github.lxxmng/container-tracking
ビジネス・業務 公開・接続可能 MCP 2025-11-25

このMCPでできること

Tracks ocean containers and bills of lading, including shipment status, vessel positions, ETAs, port congestion, and demurrage risk.

add_container
Start tracking a new container or Bill of Lading. Returns confirmation once tracking is set up. First status update arrives within 15 minutes.
外部アクセスあり 冪等
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['identifier', 'identifier_type'], 'properties': {'tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Optional tags for organisation (e.g. ["client-acme", "vessel-gulsun"])'}, 'identifier': {'type': 'string', 'description': 'Container number (e.g. MRKU5004867) or B/L number'}, 'identifier_type': {'enum': ['container_id', 'bill_of_lading'], 'type': 'string', 'description': 'Whether the identifier is a container number or B/L number'}}, 'additionalProperties': False}
出力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ok', 'result'], 'properties': {'ok': {'type': 'boolean', 'description': 'False never appears here â\x80\x94 failures arrive as tool errors.'}, 'code': {'type': 'string', 'description': 'On an empty result: NOT_FOUND (no record after asking) or NO_EVENTS (record, nothing filed).'}, 'data': {'type': 'object', 'properties': {'id': {'type': ['string', 'null'], 'description': 'The tracked reference that was created'}, 'status': {'type': ['string', 'null']}, 'message': {'type': ['string', 'null']}, 'bl_number': {'type': ['string', 'null']}, 'container_number': {'type': ['string', 'null']}}, 'additionalProperties': True}, 'result': {'enum': ['data', 'empty'], 'type': 'string', 'description': '"empty" means the query succeeded and there is nothing to report.'}, 'message': {'type': 'string', 'description': 'On an empty result: what the emptiness means.'}}, 'additionalProperties': False}
get_container_detail
Full status for a single container: current status, route, ETA with confidence, carrier, vessel, all events, and AI-generated shipment narrative. Use this when asked about a specific container.
外部アクセスあり 冪等
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['container_id'], 'properties': {'container_id': {'type': 'string', 'description': 'Container number (e.g. MRKU5004867) or B/L number (e.g. SEGU3103001)'}}, 'additionalProperties': False}
出力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ok', 'result'], 'properties': {'ok': {'type': 'boolean', 'description': 'False never appears here â\x80\x94 failures arrive as tool errors.'}, 'code': {'type': 'string', 'description': 'On an empty result: NOT_FOUND (no record after asking) or NO_EVENTS (record, nothing filed).'}, 'data': {'type': 'object', 'properties': {'id': {'type': ['string', 'null']}, 'eta': {'type': ['string', 'null'], 'description': 'ISO 8601'}, 'events': {'anyOf': [{'type': 'array', 'items': {'type': 'object', 'properties': {'type': {'type': ['string', 'null']}, 'location': {'type': ['string', 'null']}, 'timestamp': {'type': ['string', 'null'], 'description': 'ISO 8601'}}, 'additionalProperties': True}}, {'type': 'null'}], 'description': 'Filed milestones, newest first'}, 'status': {'type': ['string', 'null']}, 'carrier': {'type': ['string', 'null'], 'description': 'SCAC of the operating line'}, 'bl_number': {'type': ['string', 'null']}, 'reference': {'type': ['string', 'null'], 'description': 'On an empty result: the reference that was asked for'}, 'identifier': {'type': ['string', 'null'], 'description': 'Container number or B/L as tracked'}, 'vessel_imo': {'type': ['string', 'null']}, 'origin_name': {'type': ['string', 'null']}, 'vessel_name': {'type': ['string', 'null']}, 'ai_narrative': {'type': ['string', 'null'], 'description': 'Plain-language summary of where the box is'}, 'container_number': {'type': ['string', 'null']}, 'destination_name': {'type': ['string', 'null']}, 'eta_confidence_pct': {'type': ['number', 'null']}, 'demurrage_free_days_left': {'type': ['number', 'null']}}, 'additionalProperties': True}, 'result': {'enum': ['data', 'empty'], 'type': 'string', 'description': '"empty" means the query succeeded and there is nothing to report.'}, 'message': {'type': 'string', 'description': 'On an empty result: what the emptiness means.'}}, 'additionalProperties': False}
get_demurrage_free_time
Free time (days) before demurrage, detention or storage charges start, for a carrier at a port or country. Returns the carrier's OWN published figure when available, otherwise an INDICATIVE cross-carrier average (flagged is_estimate, shown without prejudice). Use for 'how many free days does <carrier> give at <port>'.
読み取り専用 外部アクセスあり
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'category': {'enum': ['demurrage', 'detention', 'combined_dd', 'free_time_storage'], 'type': 'string', 'default': 'demurrage', 'description': 'demurrage (in-port), detention (out-of-port), combined_dd, or free_time_storage'}, 'direction': {'enum': ['import', 'export', 'both'], 'type': 'string', 'default': 'import'}, 'carrier_code': {'type': 'string', 'description': 'SCAC, e.g. CMDU (CMA CGM), MAEU (Maersk), HLCU (Hapag), ZIMU (ZIM). Omit to get the indicative cross-carrier average directly.'}, 'country_iso2': {'type': 'string', 'description': 'ISO-3166 alpha-2, e.g. FR. Used when no port is given, or as fallback grain.'}, 'port_unlocode': {'type': 'string', 'description': '5-char UN/LOCODE, e.g. FRMRS (Marseille). Provide this or country_iso2.'}, 'container_type': {'type': 'string', 'default': '40GP', 'description': 'e.g. 20GP, 40GP, 40HC, 20RF'}}, 'additionalProperties': False}
出力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ok', 'result'], 'properties': {'ok': {'type': 'boolean', 'description': 'False never appears here â\x80\x94 failures arrive as tool errors.'}, 'code': {'type': 'string', 'description': 'On an empty result: NOT_FOUND (no record after asking) or NO_EVENTS (record, nothing filed).'}, 'data': {'type': 'object', 'properties': {'basis': {'type': ['string', 'null']}, 'source': {'type': ['string', 'null']}, 'category': {'type': ['string', 'null'], 'description': 'demurrage | detention | combined_dd | free_time_storage'}, 'free_days': {'type': ['number', 'null']}, 'is_estimate': {'type': ['boolean', 'null'], 'description': "True means this is an indicative cross-carrier average, not the line's own figure"}, 'carrier_code': {'type': ['string', 'null']}, 'country_iso2': {'type': ['string', 'null']}, 'port_unlocode': {'type': ['string', 'null']}}, 'additionalProperties': True}, 'result': {'enum': ['data', 'empty'], 'type': 'string', 'description': '"empty" means the query succeeded and there is nothing to report.'}, 'message': {'type': 'string', 'description': 'On an empty result: what the emptiness means.'}}, 'additionalProperties': False}
get_demurrage_report
Demurrage and detention risk report: which containers are near or past their free days, the daily rates, and the projected cost. Call this when asked about demurrage risk or detention fees. Free days are resolved per shipment from the customer's own contract terms first, then the carrier's published tariff, then a cross-carrier benchmark — `terms_source` and `confidence` on each item say which was used, so an estimated tariff figure must be reported as estimated, not as their contract. Read the counters before drawing a conclusion: `unassessable_containers` are boxes whose free time could not be resolved at all (an empty item list alongside a non-zero count means "cannot assess", NEVER "no risk"), `uncosted_containers` are at risk with no daily rate on file (so `total_at_risk_usd` is a floor, not the exposure), and `truncated: true` means the fleet is larger than the report. Pass container_id to assess a single shipment: `scope_container.verdict` is one of at_risk / within_free_time / not_discharged / no_terms / no_destination / not_demurrage_eligible.
読み取り専用 外部アクセスあり
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'container_id': {'type': 'string', 'description': 'Optional: scope to a single container ID. Omit for portfolio-wide report.'}}, 'additionalProperties': False}
出力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ok', 'result'], 'properties': {'ok': {'type': 'boolean', 'description': 'False never appears here â\x80\x94 failures arrive as tool errors.'}, 'code': {'type': 'string', 'description': 'On an empty result: NOT_FOUND (no record after asking) or NO_EVENTS (record, nothing filed).'}, 'data': {'type': 'object', 'properties': {'truncated': {'type': ['boolean', 'null']}, 'containers': {'anyOf': [{'type': 'array', 'items': {}}, {'type': 'null'}]}, 'coverage_note': {'type': ['string', 'null']}, 'scope_container': {'anyOf': [{}, {'type': 'null'}]}, 'total_exposure_usd': {'type': ['number', 'null']}, 'assessed_containers': {'type': ['number', 'null']}, 'uncosted_containers': {'type': ['number', 'null']}, 'candidates_considered': {'type': ['number', 'null']}, 'unassessable_containers': {'type': ['number', 'null'], 'description': 'Boxes we could not cost â\x80\x94 not boxes with zero exposure'}}, 'additionalProperties': True}, 'result': {'enum': ['data', 'empty'], 'type': 'string', 'description': '"empty" means the query succeeded and there is nothing to report.'}, 'message': {'type': 'string', 'description': 'On an empty result: what the emptiness means.'}}, 'additionalProperties': False}
get_port_congestion
Current congestion level at one or more ports: average wait hours, vessels at anchor, and congestion level (low/moderate/high/severe). Provide UN/LOCODE codes like NLRTM, GBFXT, DEHAM, CNSHA.
読み取り専用 外部アクセスあり
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['port_codes'], 'properties': {'port_codes': {'type': 'array', 'items': {'type': 'string'}, 'minItems': 1, 'description': 'UN/LOCODE port codes (e.g. ["NLRTM", "GBFXT"]). Get them from container details if unsure.'}}, 'additionalProperties': False}
出力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ok', 'result'], 'properties': {'ok': {'type': 'boolean', 'description': 'False never appears here â\x80\x94 failures arrive as tool errors.'}, 'code': {'type': 'string', 'description': 'On an empty result: NOT_FOUND (no record after asking) or NO_EVENTS (record, nothing filed).'}, 'data': {'type': 'object', 'properties': {'ports': {'anyOf': [{'type': 'array', 'items': {'type': 'object', 'properties': {'name': {'type': ['string', 'null']}, 'unlocode': {'type': ['string', 'null']}, 'updated_at': {'type': ['string', 'null']}, 'avg_wait_hours': {'type': ['number', 'null']}, 'congestion_level': {'type': ['string', 'null']}, 'vessels_at_anchor': {'type': ['number', 'null']}}, 'additionalProperties': True}}, {'type': 'null'}]}}, 'additionalProperties': True}, 'result': {'enum': ['data', 'empty'], 'type': 'string', 'description': '"empty" means the query succeeded and there is nothing to report.'}, 'message': {'type': 'string', 'description': 'On an empty result: what the emptiness means.'}}, 'additionalProperties': False}
get_shipment_summary
Overview of your entire container portfolio: total active, exceptions, arriving soon, demurrage risk. Use this as the starting point for any shipment question.
読み取り専用 外部アクセスあり
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'filter': {'enum': ['all', 'exceptions', 'arriving_soon', 'demurrage_risk'], 'type': 'string', 'default': 'all', 'description': 'Focus on a specific subset: all (default), exceptions, arriving_soon, demurrage_risk'}}, 'additionalProperties': False}
出力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ok', 'result'], 'properties': {'ok': {'type': 'boolean', 'description': 'False never appears here â\x80\x94 failures arrive as tool errors.'}, 'code': {'type': 'string', 'description': 'On an empty result: NOT_FOUND (no record after asking) or NO_EVENTS (record, nothing filed).'}, 'data': {'type': 'object', 'properties': {'containers': {'anyOf': [{'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': ['string', 'null']}, 'eta': {'type': ['string', 'null'], 'description': 'ISO 8601'}, 'status': {'type': ['string', 'null']}, 'carrier': {'type': ['string', 'null'], 'description': 'SCAC of the operating line'}, 'bl_number': {'type': ['string', 'null']}, 'identifier': {'type': ['string', 'null'], 'description': 'Container number or B/L as tracked'}, 'vessel_imo': {'type': ['string', 'null']}, 'origin_name': {'type': ['string', 'null']}, 'vessel_name': {'type': ['string', 'null']}, 'container_number': {'type': ['string', 'null']}, 'destination_name': {'type': ['string', 'null']}, 'eta_confidence_pct': {'type': ['number', 'null']}, 'demurrage_free_days_left': {'type': ['number', 'null']}}, 'additionalProperties': True}}, {'type': 'null'}]}, 'exceptions': {'type': ['number', 'null']}, 'total_active': {'type': ['number', 'null']}, 'arriving_this_week': {'type': ['number', 'null']}, 'demurrage_risk_usd': {'type': ['number', 'null']}}, 'additionalProperties': True}, 'result': {'enum': ['data', 'empty'], 'type': 'string', 'description': '"empty" means the query succeeded and there is nothing to report.'}, 'message': {'type': 'string', 'description': 'On an empty result: what the emptiness means.'}}, 'additionalProperties': False}
get_vessel_position
Last known AIS position for a vessel: lat/lng, speed, heading, navigation status, and how old the fix is. Use the vessel IMO from get_container_detail. IMPORTANT: an AIS position is a LAST KNOWN fix, not a live feed. Read `position_age_hours` and `position_freshness` (live <6h, recent <24h, stale <72h, outdated >=72h, unknown = no fix time recorded) and state the age when you report the location. Terrestrial AIS cannot see a ship mid-ocean, so an outdated fix is normal and is still useful evidence of where the vessel was — but never present it as where the vessel is now. `position_updated_at` is the time WE last wrote the row and is NOT the fix age; do not use it to answer "how current is this?".
読み取り専用 外部アクセスあり
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['imo'], 'properties': {'imo': {'type': 'string', 'description': 'IMO number of the vessel (e.g. 9463297)'}}, 'additionalProperties': False}
出力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ok', 'result'], 'properties': {'ok': {'type': 'boolean', 'description': 'False never appears here â\x80\x94 failures arrive as tool errors.'}, 'code': {'type': 'string', 'description': 'On an empty result: NOT_FOUND (no record after asking) or NO_EVENTS (record, nothing filed).'}, 'data': {'type': 'object', 'properties': {'imo': {'type': ['string', 'null']}, 'lat': {'type': ['number', 'null']}, 'lng': {'type': ['number', 'null']}, 'name': {'type': ['string', 'null']}, 'source': {'type': ['string', 'null']}, 'nav_status': {'type': ['string', 'null']}, 'heading_deg': {'type': ['number', 'null']}, 'speed_knots': {'type': ['number', 'null']}, 'position_fix_at': {'type': ['string', 'null'], 'description': 'When the position was actually fixed'}, 'position_is_stale': {'type': ['boolean', 'null'], 'description': 'True means do not quote this as current'}, 'position_age_hours': {'type': ['number', 'null']}, 'position_freshness': {'type': ['string', 'null']}}, 'additionalProperties': True}, 'result': {'enum': ['data', 'empty'], 'type': 'string', 'description': '"empty" means the query succeeded and there is nothing to report.'}, 'message': {'type': 'string', 'description': 'On an empty result: what the emptiness means.'}}, 'additionalProperties': False}
追加
get_demurrage_free_time
2026年10月3日2:42
追加
add_container
2026年10月3日2:42
追加
get_port_congestion
2026年10月3日2:42
追加
get_demurrage_report
2026年10月3日2:42
追加
get_vessel_position
2026年10月3日2:42
追加
get_container_detail
2026年10月3日2:42
追加
get_shipment_summary
2026年10月3日2:42