maritime_search_wrecks
Query historical shipwreck databases across VOC, EIC, UKHO, NOAA, and other archives. Filter by ship name, date range, region, cause, status, depth, flag, or vessel type.
Instructions
Search for maritime shipwreck records across all archives.
Queries wreck databases for known and suspected wreck sites. All search parameters are optional and combined with AND logic. Supports cursor-based pagination.
Archives with wreck data: - maarer: MAARER VOC Wrecks, 1595-1795 - eic: English East India Company wrecks, 1600-1874 - carreira: Portuguese Carreira da India wrecks, 1497-1835 - galleon: Spanish Manila Galleon wrecks, 1565-1815 - soic: Swedish East India Company wrecks, 1731-1813 - ukho: UK Hydrographic Office Global Wrecks, 1500-2024 - noaa: NOAA Wrecks & Obstructions (AWOIS), 1600-2024
Args: ship_name: Ship name or partial name (case-insensitive) date_range: Date range as "YYYY/YYYY" or "YYYY-MM-DD/YYYY-MM-DD" region: Geographic region filter (e.g., cape, pacific, gulf_of_mexico) cause: Loss cause filter - storm, reef, fire, battle, grounding, scuttled, collision, unknown status: Wreck discovery status - found, unfound, approximate min_depth_m: Minimum estimated depth in metres max_depth_m: Maximum estimated depth in metres min_cargo_value: Minimum cargo value in guilders flag: Vessel nationality/flag (substring match, e.g. "UK", "NL", "US") vessel_type: Vessel type classification (substring match, e.g. "liner", "warship") gp_quality: NOAA position accuracy code (1=High, 2=Medium, 3=Low, 4=Poor) archive: Restrict to specific archive - maarer, eic, carreira, galleon, soic, ukho, noaa (default: all) max_results: Maximum results per page (default: 100, max: 500) cursor: Pagination cursor from a previous result's next_cursor field output_mode: Response format - "json" (default) or "text"
Returns: JSON or text with matching wreck records and pagination metadata
Tips for LLMs: - Use region to focus on a geographic area (e.g., "cape", "pacific") - Set status="unfound" to find wrecks that have not been located - If has_more is true, pass next_cursor as cursor to get the next page - Follow up with maritime_get_wreck for full details including position - Use maritime_export_geojson to map wreck positions - Use flag to filter by nationality (e.g. "UK", "NL", "US") - Use vessel_type to filter by ship classification (e.g. "liner", "warship") - Use gp_quality=1 to find NOAA wrecks with high-accuracy positions
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ship_name | No | ||
| date_range | No | ||
| region | No | ||
| cause | No | ||
| status | No | ||
| min_depth_m | No | ||
| max_depth_m | No | ||
| min_cargo_value | No | ||
| flag | No | ||
| vessel_type | No | ||
| gp_quality | No | ||
| archive | No | ||
| max_results | No | ||
| cursor | No | ||
| output_mode | No | json |