• REGISTRY
  • CODES
  • LOCATION
  • HUMAN

How to lookup port location data with your AI

Connect JSONCargo Maritime to your AI client to access global maritime registries. Once connected, your agent can pull port codes and location details on demand.

Ask AI about this page

Short answer

How can I find port LOCODEs and locations with AI?

Your AI uses the JSONCargo Maritime connector to pull data from global port registries. It finds the specific LOCODEs and location details you need to verify maritime destinations. You get the exact registry information through your chat interface.

Where your data lands.

The outcomes of your request.

The AI processes your query and delivers these specific maritime details.

REGISTRY

Verified port names

The AI pulls official names from the global registry. You get standardized names to use in your logistics documents.

CODES

Accurate LOCODEs

Your agent retrieves the five-letter UN/LOCODE for any port. This ensures your shipping data matches international standards.

LOCATION

Geographic verification

The AI provides the specific location data associated with a port. You can use this to confirm the correct destination for cargo.

HUMAN

Final data review

The AI presents the registry matches for you to check. You decide which port is the correct one for your specific shipment.

The workflow

What your AI does when you ask for port data.

The AI acts as a direct interface to the maritime registry.

  1. Identify port request

    Your agent analyzes your prompt to find the specific port or region you are looking for.

    list_maritime_ports
  2. Query the registry

    The AI searches the global maritime database for matching port entries.

    list_maritime_ports
  3. Retrieve LOCODEs

    The agent pulls the specific five-letter codes and location details from the registry results.

    list_maritime_ports
  4. Deliver results

    The AI formats the port names and codes into a clear list for your review.

    list_maritime_ports

Try it

Copy these to start.

Use these prompts to get port data immediately.

Starting points

Replace the bracketed text with the specific port or country you need to look up.

JSONCargo Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_VbfvVvGmiqzmJNkJ4cVoj7Wzm5gS95KjzczjQQ8a/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — JSONCargo capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "jsoncargo-maritime-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_VbfvVvGmiqzmJNkJ4cVoj7Wzm5gS95KjzczjQQ8a/mcp"
    }
  }
}
Copy into chat04
  • Find the LOCODE for the port of [Rotterdam].

  • List all maritime ports in [Singapore].

  • What is the port code for [Hamburg]?

  • Search for ports located in [the United Arab Emirates].

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect JSONCargo Maritime once, then ask.

Connect the MCP to your client with one click. Your credentials stay encrypted on our side, and you can start asking questions right away.

Connect JSONCargo Maritime to your AI

FAQ

How this task behaves.

  • 01

    Can the AI change port registry data?

    No. The AI can only read data from the registry. It cannot edit or delete any official maritime records.

  • 02

    Does the AI track live ships?

    No. This connector is for port registries and LOCODE lookups, not for real-time vessel tracking.

  • 03

    Can I use this with Cursor or VS Code?

    Yes. You can use this with any MCP-compatible client, including Cursor and VS Code.

  • 04

    Will the AI book my freight?

    No. The AI only provides the location and code data. You must perform all booking and logistics through your own tools.

  • 05

    How does the AI handle port name typos?

    The AI searches the registry for the closest matching port name to help correct your input.

  • More questions about JSONCargo Maritime? The Connector page answers them. See everything the JSONCargo Maritime Connector can do

Connect JSONCargo to Claude, Cursor, ChatGPT & more