Trimtab AIS

Trimtab US Trade Ledger — servidor MCP para dados de tarifas e comércio dos EUA

O que importadores dos EUA realmente pagaram na fronteira — gratuito, sem chave de API, sem cadastro. Recibos oficiais de tarifas por produto e origem, mensais desde 2017, conciliados mensalmente com os recibos alfandegários do próprio Tesouro dos EUA (ambos os livros: avaliados na entrada e mantidos após reembolsos — maio e junho de 2026 ficaram negativos). Além disso, o livro de regras HTS atual com citações do Federal Register, decisões de classificação da CBP, busca de códigos HS, importações conteinerizadas dos EUA por origem × mercadoria × gateway (com rastreamento de revisões) e um arquivo congelado de 2026 dos movimentos de navios AIS registrados. Cada resposta carrega seu método, sua proveniência e seus limites, para que seu agente possa verificar em vez de confiar.

Publicado por Trimtabist — o observatório independente do comércio dos EUA. 20 estudos regrados pré-registrados (nulos publicados), um registro público de correções e todo o pipeline de coleta aberto em trimtab-pipeline.

Endpoint (HTTP streamable, sem autenticação):

https://trimtabist.com/mcp

Registro oficial MCP: com.trimtabist/us-tariff-ledger · 13 ferramentas + um roteador de arquivos · documentação para agentes: trimtabist.com/llms.txt · guias de conexão: trimtabist.com/connect

Por quê

Os dados de rastreamento de transportadoras não significam o que dizem. O mesmo rótulo de evento pode significar "ao lado do cais" para uma transportadora e "aguardando na âncora" para outra — uma diferença de horas a dias, que é exatamente a diferença que decide um relógio de demurrage, um agendamento de drayage ou uma promessa ao cliente. Enquanto isso, as transportadoras vêm fechando suas portas para leitores automatizados: várias agora bloqueiam rastreadores de IA por nome em robots.txt, e nenhuma das dez maiores opera um portal público para desenvolvedores.

Então, o software que agora toma decisões de embarque está argumentando com base em papéis que não pode verificar. Este instrumento oferece a outra metade: física. Um navio está se movendo ou não; está ao lado de um terminal de contêineres ou não. O AIS diz isso, nós registramos continuamente e publicamos o que vemos — incluindo o que não podemos.

Adicione ao seu agente

Claude Code:

claude mcp add --transport http trimtab-ais https://ais.trimtabist.com/mcp

Claude Desktop ou qualquer cliente MCP (transporte HTTP):

{ "mcpServers": { "trimtab-ais": { "url": "https://ais.trimtabist.com/mcp" } } }

Clientes que exigem stdio:

{ "mcpServers": { "trimtab-ais": { "command": "npx", "args": ["-y", "trimtab-ais"] } } }

Use a partir do código

npm i 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 }] }

Ou pelo shell, sem instalação:

npx trimtab-ais gateway us_savannah
npx trimtab-ais vessel "ONE ORPHEUS"
npx trimtab-ais berthed "MSC DARLENE" 48

Ou diretamente via HTTPS — é JSON-RPC puro:

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"}}}'

As ferramentas

Ferramenta	Respostas
gateway_conditions	O que está acontecendo em um gateway agora — navios atracados e ancorados, classificados (contêiner / granel geral / tanque / serviço), com terminais de contêineres nomeados
vessel_status	Onde um navio está, o que está fisicamente fazendo, qual terminal, desde quando, destino declarado
has_vessel_berthed	Se um navio atracou dentro de uma janela de retrospectiva — timestamp, terminal, espera na ancoragem se houver fila
recent_events	O fluxo de eventos: chegadas, ancoragens, atracações, partidas e notas semânticas

Ferramentas da série US Trade Ledger (comércio portuário registrado pelo Census + verificações cruzadas):

Ferramenta	Respostas
list_instruments	Cada instrumento e série de dados, com grau de proveniência e estado de confiança — comece aqui
describe_series	O que uma série mede: unidade, fonte, método, citação, cobertura
query_series	Os dados: comércio portuário mensal dos EUA por país e mercadoria, eventos de navios, confiabilidade de ETA
check_agreement	Registros alfandegários do Census vs. observação AIS ao vivo — onde instrumentos independentes discordam, um está errado
search_series	Encontre séries em linguagem simples: "importações da índia", "houston", "chegadas de navios"

Gateways: us_la_longbeach us_ny_nj us_savannah us_houston us_charleston us_norfolk us_oakland us_seattle_tacoma

O que cobre — e o que não cobre

Um instrumento que esconde seus pontos cegos não é um instrumento.

• Coberto: os oito gateways de contêineres dos EUA acima.
• Registrado, mas limitado: Chennai/Ennore/Kattupalli; JNPT, Mundra, Pipavav, Hazira, Vizhinjam, Colombo — os receptores terrestres são escassos lá, então a cobertura é parcial a ausente. Publicado, não mascarado.
• Não coberto: meio-oceano (somente AIS terrestre, sem satélite), carga (o AIS vê navios, nunca contêineres), tarifas, cronogramas ou qualquer coisa que uma transportadora declare em vez de fazer.
• O arquivo começa em 26 de julho de 2026, com uma lacuna divulgada (2026-07-26 17:20Z → 2026-07-27 12:16Z) desde o primeiro dia do instrumento. Durações que começaram antes do início do registro são limites inferiores, e assim são declaradas.

Leia o método → — fontes, limites de máquina de estados, como navios de contêineres são distinguidos de graneleiros (códigos de tipo AIS não conseguem), limites conhecidos e a política de correção. Escrito para que um estranho possa reproduzir os números ou provar que estão errados.

Licença e citação

Dados CC BY 4.0, código Apache 2.0. Use comercialmente, construa em cima, redistribua — com atribuição:

Trimtab AIS (ais.trimtabist.com), construído por Mrigank Singh

Não para confiabilidade regulatória ou de segurança de vida; sem garantia. Se encontrar algo errado, me avise — correções são publicadas, com o tamanho do erro quantificado.

---

Construído e mantido por Mrigank Singh, que move contêineres para viver — cofundador e COO da Intoglo, um agente de carga Índia→EUA. Esta é a camada de observação ao vivo do Trimtab US Trade Ledger, que mede o que os dados comerciais realmente dizem versus o que realmente acontece.