# JSONCargo Maritime MCP for AI Agents AI Agent Connect > JSONCargo Maritime lets you track global vessels and audit voyage statuses through your AI client. It pulls real-time shipping data, port metadata, and vessel identifiers so you can manage logistics without jumping between different maritime portals. ## Overview - **Category:** data-analytics - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_VbfvVvGmiqzmJNkJ4cVoj7Wzm5gS95KjzczjQQ8a/ai-agent-connect - **Tags:** maritime-data, vessel-tracking, logistics-api, voyage-monitoring, port-data, real-time-tracking ## Description You can now turn your AI agent into a maritime consultant that knows exactly what's happening on the water. Instead of digging through multiple shipping websites or manually cross-referencing port codes, you just ask your agent for the specifics. It handles the heavy lifting of searching for ships by name or IMO, pulling current voyage details, and identifying global ports. This is a huge win for anyone who needs to keep a pulse on trade routes or verify vessel positions without the usual headache of manual data entry. By adding this to your setup in the Vinkius catalog, you get a direct line to real-time logistics data. It makes auditing shipping patterns or identifying vessel types a matter of a quick conversation. You get precise metadata for every ship and port, ensuring your supply chain research stays accurate. You don't have to worry about missing a status update or getting a port code wrong because the agent pulls the data directly from the source. It's about moving from searching for information to actually using it to make decisions about your cargo, your routes, and your timeline. Whether you are tracking a specific container ship across the Pacific or trying to map out every port in a new trade region, the agent provides the data you need in plain English. It removes the friction between your high-level logistics questions and the messy reality of maritime data. ## Tools ### check_api_status Check if the JSONCargo service is currently online. This helps you confirm the data connection is active before you start a long research project. ### get_current_voyage_details Get full metadata for a vessel's current trip. This lets you see the current status and destination of a specific ship without manual searching. ### list_maritime_ports List all global ports in the database. You can use this to find specific location codes and terminal data for trade route planning. ### search_maritime_vessels Search for ships by name or IMO number. This provides quick access to vessel metadata like flags, types, and identifiers. ## Prompt Examples **Prompt:** ``` Search for vessel 'Ever Given' using JSONCargo. ``` **Response:** ``` I've retrieved the details for Ever Given! It is a Container Ship with IMO number 9811000. Would you like the current voyage metadata or the vessel's flag information? ``` **Prompt:** ``` What is the current voyage status for vessel ID 'VES-123'? ``` **Response:** ``` I've identified the current voyage for VES-123! It is currently identified as 'En Route' from Singapore to Rotterdam. The current position was updated recently. I can provide the full track metadata if you'd like. ``` **Prompt:** ``` List all maritime ports in 'Netherlands'. ``` **Response:** ``` I've retrieved the port catalog for the Netherlands! Notable entries include Rotterdam (NLRTM) and Amsterdam (NLAMS). I can provide the full LOCODE and terminal metadata for each of these sites. ``` ## Capabilities ### Find ships by name or IMO Search for specific vessels to get their current flag, type, and identifiers. ### See current voyage status Get the latest trip details and position for any ship in the database. ### Look up global ports Retrieve a list of global ports with their specific location codes. ### Get unique vessel identifiers Pull specific IDs to help with deep-dive supply chain classification. ### Check if the service is up Verify that the shipping data feed is active and operational. ## Use Cases ### Finding a specific ship's location I need to see where the 'Ever Given' is right now. The agent uses `search_maritime_vessels` and `get_current_voyage_details` to find the ship and its current route. ### Identifying port codes for a region What are the port codes for the Netherlands? The agent uses `list_maritime_ports` to pull a list of all ports in that region. ### Verifying data feed availability Is the shipping data feed still up? The agent uses `check_api_status` to confirm the service is operational. ### Auditing a specific vessel's voyage Check the current voyage for vessel ID VES-123. The agent uses `get_current_voyage_details` to provide the route from Singapore to Rotterdam. ## Benefits - Skip manual portal searching with `search_maritime_vessels` to get instant vessel metadata. - Get live voyage updates with `get_current_voyage_details` to see exactly where a ship is right now. - Find every port you need for trade planning using `list_maritime_ports` to grab LOCODEs quickly. - Verify your supply chain data by pulling unique vessel identifiers directly into your chat. - Know your data source is active by using `check_api_status` to monitor the service health. ## How It Works The bottom line is you get real-time maritime data in your chat without opening a single extra browser tab. 1. Subscribe to the Connector on Vinkius. 2. Add your JSONCargo API key to your client. 3. Ask your agent to find vessels or port data. ## Frequently Asked Questions **How can JSONCargo Maritime help with my supply chain?** It gives you a direct way to track vessels and ports in real time. You can ask your agent to find specific ships or check their current voyage status to keep your logistics moving. **Can I find a ship by its IMO number using JSONCargo Maritime?** Yes, you can search for any ship using its unique IMO number. Your agent will pull back the vessel's flag, type, and current voyage information instantly. **Does JSONCargo Maritime provide port location codes?** It does. You can ask the agent to list ports in a specific region, and it will provide the correct LOCODEs and location data for your planning. **How do I get voyage status updates with JSONCargo Maritime?** You just ask your agent for the current voyage details of a specific vessel. It will tell you the current status, such as whether the ship is en route or at port. **Is JSONCargo Maritime good for trade research?** It's excellent for identifying maritime logistics markers and vessel types. You can quickly audit vessel metadata to understand regional trade constraints. **How does JSONCargo Maritime handle vessel identification?** It allows you to search for vessels by name or IMO number. This makes it easy to identify specific ships and pull their metadata into your current workflow. **How do I find my JSONCargo API Key?** Log in to your [**JSONCargo account**](https://api.jsoncargo.com/), navigate to your dashboard, and you will find your API Key in the 'Access Tokens' section. Copy and paste it below. **What vessel identifiers are supported?** The API supports searching by vessel name, IMO number, and unique JSONCargo identifiers. **Does it support real-time positions?** Yes. The `get_current_voyage_details` tool retrieves the most recent position and status metadata for active vessels.