Trimtab AIS
About
Machine-readable ship & port truth for AI agents — free MCP server over continuously own-recorded AIS at 8 US container gateways. Method published, no key, no signup.
Details
- Transport
- SSE
- License
- Apache-2.0
Explore
- Covered: the eight US container gateways above
- Recorded but thin: Chennai/Ennore/Kattupalli; JNPT, Mundra, Pipavav, Hazira, Vizhinjam
- Not covered: mid-ocean (terrestrial AIS only, no satellite), cargo (AIS sees ships, never
- Archive begins 26 July 2026, with one disclosed gap (2026-07-26 17:20Z → 2026-07-27 12:16Z)
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Trimtab AISCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
The README includes setup instructions such as { "mcpServers": { "trimtab-ais": { "command": "npx", "args": ["-y", "trimtab-ais"] } } }.
gateway_conditions
Get live port conditions at the 8 major US container gateways (LA/Long Beach, NY-NJ, Savannah, Houston, Charleston, Norfolk, Oakland, Seattle-Tacoma): which ships are at berth and at anchor right now, by vessel class, with container-terminal detail. Own-recorded terrestrial AIS, refreshed continuously. No API key required.
vessel_status
Track the live status of a ship by name (partial ok) or MMSI: current position, physical state (underway / anchored / moored — detected from movement physics, not the crew-set flag), gateway zone, terminal if berthed, speed and declared destination, at US container gateways. No API key required.
has_vessel_berthed
Check whether a ship has physically berthed (moored) at a US container gateway within a lookback window — arrival truth independent of carrier milestone codes. Returns each berthing event with timestamps and terminal when known. No API key required.
recent_events
List recent observed vessel events at US container gateways — arrivals, anchorings, berthings, departures (ZONE_ENTER/LEAVE, ANCHOR_START/END, BERTH_START/END, DEPARTED) — with timestamps, from own-recorded live AIS. No API key required.
list_instruments
List every Trimtab US Trade Ledger instrument and data series: US Census port-level trade (imports and exports by US port, partner country, commodity), live AIS vessel observation, ETA reliability. Each series carries a provenance grade (observed / reported / modelled) and its trust state. Start here. No API key required.
describe_series
Describe one data series in full: what it measures, unit, source and method, citation string, temporal coverage, and current trust state. Series span US port trade (Census-recorded) and ship observations (AIS). No API key required.
query_series
Fetch the data of a series — monthly US port trade by country and commodity, vessel events, ETA reliability — as periods and values. Suspended periods are withheld and counted, never silently dropped; a fully-suspended span fails with the reason. Free, CC BY 4.0. No API key required.
check_agreement
Compare independent instruments against each other — US Census customs records vs live AIS observation of the same gateways. Where they disagree, one is wrong. Returns the recorded checks touching a series, their latest results, and any resulting suspension. No API key required.
search_series
Search all US trade and shipping series by plain-language terms (e.g. "imports from india", "houston", "vessel arrivals") across names, descriptions, instruments and units. No API key required.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"trimtab ais": {
"trimtab-ais": {
"command": "npx",
"args": [
"trimtab-ais",
"gateway",
"us_savannah"
]
}
}
}
}McpServers
{
"trimtab-ais": {
"command": "npx",
"args": [
"trimtab-ais",
"gateway",
"us_savannah"
]
}
}Trimtab US Trade Ledger — MCP server for US tariff & trade data
What US importers actually paid at the border — free, no API key, no signup.Official duty receipts by product and origin, monthly since 2017, reconciled monthly against the US Treasury's own customs receipts (both books: assessed at entry and kept after refunds — May and June 2026 ran negative). Plus the current HTS rulebook with Federal Register citations, CBP classification rulings, HS code search, US containerised imports by origin × commodity × gateway (revision-tracked), and a frozen 2026 archive of own-recorded AIS ship movements. Every response carries its method, its provenance, and its limits, so your agent can verify instead of trust.
Published byTrimtabist— the independent observatory for US trade. 20 pre-registered ruled studies (nulls published), a public corrections log, and the whole collection pipeline open attrimtab-pipeline.
Official MCP registry:com.trimtabist/us-tariff-ledger· 13 tools + an archive router · docs for agents:trimtabist.com/llms.txt· connect guides:trimtabist.com/connect
Carrier tracking data doesn't mean what it says. The same event label can mean "alongside the dock" for one carrier and "waiting at anchor" for another — a difference of hours to days, which is exactly the difference that decides a demurrage clock, a drayage appointment, or a customer promise. Meanwhile the carriers have been closing their doors to automated readers: several now block AI crawlersby nameinrobots.txt, and not one of the top ten runs a public developer portal.
So the software now making shipping decisions is arguing from paperwork it cannot check. This instrument offers the other half:physics. A ship is either moving or it isn't; it is either alongside a container terminal or it isn't. AIS says so, we record it continuously, and we publish what we see — including what we can't.
claude mcp add --transport http trimtab-ais https://ais.trimtabist.com/mcp
Claude Desktop or any MCP client (HTTP transport):
{ "mcpServers": { "trimtab-ais": { "url": "https://ais.trimtabist.com/mcp" } } }
{ "mcpServers": { "trimtab-ais": { "command": "npx", "args": ["-y", "trimtab-ais"] } } }
import { gatewayConditions, vesselStatus, hasVesselBerthed } from 'trimtab-ais'; const la = await gatewayConditions('us_la_longbeach'); // → { gateways: [{ at_berth: { by_class: { container: 8, tanker: 3, ... } }, // at_anchor: { ... }, container_terminals: { "LA Pier 400 (APM)": [...] } }], // as_of, method, coverage, source, attribution } await vesselStatus('MSC DARLENE'); // → moored, container, 366 m, LA Terminal Island (Fenix/Everport), since 2026-07-26T14:47Z await hasVesselBerthed('EVER MEGA', 72); // → { berthed: true, events: [{ at, gateway, terminal, queue_wait_min }] }
npx trimtab-ais gateway us_savannah npx trimtab-ais vessel "ONE ORPHEUS" npx trimtab-ais berthed "MSC DARLENE" 48
Or straight over HTTPS — it is plain JSON-RPC:
curl -X POST https://ais.trimtabist.com/mcp -H 'Content-Type: application/json' \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call", "params":{"name":"gateway_conditions","arguments":{"gateway":"us_ny_nj"}}}'
US Trade Ledger series tools (Census-recorded port trade + cross-checks):
Gateways:us_la_longbeachus_ny_njus_savannahus_houstonus_charlestonus_norfolkus_oaklandus_seattle_tacoma
What it covers — and what it doesn't
An instrument that hides its blind spots isn't an instrument.
- Covered:the eight US container gateways above.
- Recorded but thin:Chennai/Ennore/Kattupalli; JNPT, Mundra, Pipavav, Hazira, Vizhinjam, Colombo — terrestrial receivers are sparse there, so coverage is partial to absent. Published, not papered over.
- Not covered:mid-ocean (terrestrial AIS only, no satellite), cargo (AIS sees ships, never boxes), rates, schedules, or anything a carrier declares rather than does.
- Archive begins 26 July 2026,with one disclosed gap (2026-07-26 17:20Z → 2026-07-27 12:16Z) from the instrument's first day. Durations that began before recording started are lower bounds, and say so.
Read the method →— sources, state-machine thresholds, how container ships are distinguished from bulkers (AIS type codes can't), known limits, and the correction policy. Written so a stranger can reproduce the numbers, or prove them wrong.
DataCC BY 4.0, codeApache 2.0. Use it commercially, build on it, redistribute it — with attribution:
Trimtab AIS (ais.trimtabist.com), built by Mrigank Singh
Not for regulatory or safety-of-life reliance; no warranty. If you find it wrong,tell me— corrections are published, with the size of the error quantified.
Built and maintained byMrigank Singh, who moves containers for a living — co-founder & COO of Intoglo, an India→US freight forwarder. This is the live-observation layer of the Trimtab US Trade Ledger, which measures what trade data actually says versus what actually happens.
Transaction-complete hotel booking over MCP — 300K+ properties, real hotel confirmation numbers, loyalty points, secure checkout. Hotels are merchant of record. Builders set their own booking fee via Stripe Connect. Built on proven distribution infrastructure.
An MCP server for AI video generation. MCP server for AI video generation. Lets Claude, ChatGPT, OpenClaw , Hermes & other agents create AI videos and publish them to YouTube, TikTok, Instagram etc..
Institutional research and manager diligence reports on hedge funds, venture capital and private equity managers. Summary of filings, personnel changes, media screening and social signals delivered to you in minutes.
ALTER - identity infrastructure for the AI economy
D2C eCommerce fulfillment platform: manage orders, inventory, shipments, campaigns, and billing via AI agents
Apigene MCP Gateway is the runtime layer that connects AI agents to APIs and MCP servers via Model Context Protocol.
MCP to interface with multiple blockchains, staking, DeFi, swap, bridging, wallet management, DCA, Limit Orders, Coin Lookup, Tracking and more.
MCP server for Bitnovo Pay integration with AI agents. Provides cryptocurrency payment capabilities through Bitnovo Pay API. Features include payment creation, status checking, QR code generation, and webhook management with support for multiple tunnel providers (ngrok, zrok, manual).
Shop for gift cards, esims, phone topups. Pay with cards and crypto.
You built it, now get users! GoToMarket MCP server
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
