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
- Author
- mrsingh86
- Downloads
- 678
- Categories
- Other
Jump to
- 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"] } } }.
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.
