How to Use the JSONCargo Maritime MCP in Cursor

Q: Can I use JSONCargo Maritime to test my port filtering logic in Cursor?

Yes. Tell the agent to run listmaritimeports and write a filter for US-based terminals. It will use the live database response to verify the code it just wrote.

Build maritime logistics dashboards faster by feeding live vessel data straight into Cursor.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect JSONCargo Maritime MCP to Cursor

Create your Vinkius account to connect JSONCargo Maritime to Cursor and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup JSONCargo Maritime with Cursor

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Inject Live Vessel Data

Writing logistics code usually involves mocking up fake ship data. With Cursor Agent mode, you skip that entirely. The AI hits `search_maritime_vessels` and pulls real IMO numbers directly into your TypeScript interfaces. You ask your agent to build a tracking widget. It uses `get_current_voyage_details` to grab an active transit log, looks at the actual JSON response, and writes the parsing logic based on real metadata. Your code works on the first run.

Port Logistics in Cursor MCP Server

Building port management tools requires accurate coordinate mapping. Cursor calls `list_maritime_ports` to fetch the exact latitude, longitude, and congestion levels from the JSONCargo database while you code. The agent sees the exact data structure of the ports. It writes the filtering functions and UI components to match that specific schema. You never have to guess what the API payload looks like.

Instant API Validation

Debugging a broken logistics dashboard is frustrating when you don't know if the backend is down. Cursor solves this by running `check_api_status` right in the editor. Your AI client tells you if the MCP Server is operational before you start tracing bugs. If the heartbeat is active, you know the problem is in your code. You can then ask the agent to query a specific ship and watch it step through the response. It acts as both your developer and your API testing tool.

Setup guide

Set up JSONCargo Maritime MCP in Cursor

Prerequisites

Cursor installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP Settings

Go to Cursor Settings → MCP or open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and search for "MCP: Add Server".
2

Add the JSONCargo Maritime MCP

Cursor will create or open .cursor/mcp.json in your project root. Paste the JSON snippet on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Enable Agent mode

Open Composer (Cmd+I / Ctrl+I) and switch to Agent mode using the dropdown at the top. MCP tools are only available in Agent mode.
4

Verify the connection

Ask Cursor something like "List my recent JSONCargo Maritime transactions." If the MCP tools are loaded correctly, Cursor will call the JSONCargo Maritime tools automatically. You can also check Settings → MCP for a green status indicator.

.cursor/mcp.json

{
  "mcpServers": {
    "jsoncargo-maritime-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by JSONCargo. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect JSONCargo Maritime now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about JSONCargo Maritime MCP in Cursor

Create an mcp.json file in your .cursor directory. Add the JSONCargo Maritime MCP Server details under the mcpServers key and enable Agent mode in your chat panel.

Yes. Once configured, you just ask it to build a feature using vessel data. The agent will autonomously decide to use the search or voyage tools to get the context it needs.

Yes. Tell the agent to run `list_maritime_ports` and write a filter for US-based terminals. It will use the live database response to verify the code it just wrote.

The JSONCargo service might be down or rate-limiting you. Have the agent execute `check_api_status` to get the current latency and heartbeat metrics.

The server only processes maritime transit logs and port coordinates. Cursor sends your specific query parameters to the MCP Server, but your local codebase remains on your machine and never touches the external logistics database.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript