← Terminal49CONTENT HISTORY
WHAT CHANGED
Update to Terminal49
Snapshot Oct 25, 2026 · 18:21 UTC · version 1.1.0
Collection source: downloaded plugin package.
First saved snapshot
No earlier snapshot is available to establish a change.
Save Terminal49 and check future changes in Following.
Up to 10 plugins free · no card required.
Compare saved observations
Download comparison JSONFull technical diff · 0 changed fields
Full snapshot data
{
"description": "Research US ocean imports with Terminal49 trade intelligence MCP tools, built from bill-of-lading records for US ocean imports since January 2022 and refreshed daily. Use it to see what a competitor or any named company imports (volumes, origin countries, US ports, carriers, products, trend), to find who imports a product and where it is sourced from, and to track market trends by port, coast, carrier, origin, or commodity. Use it whenever someone asks about another company's imports, top importers of a product, sourcing countries or lanes, port or carrier volumes, or how US import volumes are changing, even if they don't say \"trade intelligence\".",
"included_files": [
{
"relative_path": "references/data-guide.md",
"size_in_bytes": 4794
}
],
"name": "trade-intelligence",
"skill_md_contents": "---\nname: trade-intelligence\ndescription: Research US ocean imports with Terminal49 trade intelligence MCP tools, built from bill-of-lading records for US ocean imports since January 2022 and refreshed daily. Use it to see what a competitor or any named company imports (volumes, origin countries, US ports, carriers, products, trend), to find who imports a product and where it is sourced from, and to track market trends by port, coast, carrier, origin, or commodity. Use it whenever someone asks about another company's imports, top importers of a product, sourcing countries or lanes, port or carrier volumes, or how US import volumes are changing, even if they don't say \"trade intelligence\".\n---\n\n# Trade intelligence (Terminal49 MCP)\n\nTerminal49 trade intelligence covers US ocean imports from US Customs\nbill-of-lading records, from January 2022 to today, refreshed daily. Answer\nmarket questions from it with the Terminal49 MCP trade tools. These tools read\nmarket data, not the user's own shipments.\n\nThe person you're helping is usually in logistics, procurement, or sales at an\nimporter, forwarder, or broker. They want to understand a competitor, a\nproduct's supply chain, or a market well enough to make a decision. Give them\nthe answer and the few numbers that support it, not a data dump.\n\n## Access\n\nThe trade tools use the same OAuth connection as the other Terminal49 tools.\nSign-in happens in the browser, so never ask the user for sign-in details in\nchat.\n\nTrade intelligence is enabled per account. If a tool says it is not enabled,\ntell the user to contact support@terminal49.com to turn it on. Don't retry, and\ndon't invent figures. `get_trade_data_coverage` and `whoami` both report\nwhether it is enabled.\n\n## Pick the tool\n\n| Question | Tools |\n| --- | --- |\n| Which company is this, what does it import | `search_importers`, then `get_importer_profile` |\n| Which HS code is this product | `search_commodities` |\n| Who imports a product, or through a port, or from a country | `rank_importers` |\n| How has volume changed over time | `get_trade_trends` (market) or `get_importer_profile` with `months` 24 (one company) |\n| What is the mix or share | `get_trade_breakdown` |\n| How current is the data, how far back it goes | `get_trade_data_coverage` |\n\nMost answers take two to five calls.\n\n## How to work\n\n1. **Resolve the company or product first.** For a company, call\n `search_importers` with `name` and use the exact `company_name` it returns.\n For a product, call `search_commodities` and check `common_goods` to confirm\n the HS4 code is the user's product. If more than one company or code fits,\n say which you used, or ask when the choice changes the answer.\n2. **Call the tool that answers the question directly.**\n - For one company's trend, call `get_importer_profile` with `months` 24 and\n compare the latest months with the same months a year earlier. Don't use\n `get_trade_trends` with a `company` filter for this: it matches every\n company whose name contains the text.\n - History starts in January 2022. `get_trade_trends` defaults to the last 24\n months; set `since` for a longer view, and don't describe the default\n window as the start of the data.\n - Rankings don't say who is a forwarder. When it matters (it usually does in\n \"who imports X\"), check the top names with `search_importers` and weigh\n `share_as_notify_party` with the name and product mix.\n3. **Check before you present.** A sudden drop in the latest period is usually\n the current, incomplete month: set `until` to the last full month. A company\n much smaller than expected may be split across names, shipping under a\n forwarder, or keeping its name off the records. Merge carrier spelling\n variants before computing shares.\n4. **Answer first.** Lead with the takeaway in one to three sentences, then a\n compact table. Round numbers (87k containers, USD 290M est.), name the period,\n and keep only the caveats that change the conclusion.\n\n`references/data-guide.md` explains what the data covers, the filters and\ndimensions, and the caveats in detail. Read it before a market-trend or\nbreakdown question, and when a result looks wrong.\n\n## Speak the user's language\n\nField names and data mechanics don't belong in the answer. Say \"listed as the\nparty to notify on the shipping documents, which is usually a forwarder or\ncustoms broker\", not \"notify party share\". Say \"the company imports under\nseveral US locations\", not \"state rows\". Never describe tool limits (\"the tool\nonly returns the top five\"); if a limit affects the answer, say what's missing\nin plain terms.\n\n## Common questions\n\n### Competitor research: \"what does <company> import?\"\n\nSearch the name, then call `get_importer_profile` with `months` 24 and no\nstate. Cover volume and trend against a year earlier, top origin countries, US\nports and destination states, carriers and their shares, main products (HS4\nwith estimated value), and anything notable, such as a shift between ports or\ncarriers, a new origin country, or seasonality. If the company looks smaller\nthan the user expects, say that some of its freight may be booked under a\nforwarder.\n\n### Sourcing: \"who imports <product>, and where does it come from?\"\n\nCall `search_commodities` for the HS4 code, then:\n\n- importers: `rank_importers` with `hs4` (add `port_of_discharge` or\n `origin_country` to narrow);\n- origins and lanes: `get_trade_breakdown` with `dims` `origin_country` and\n `pod` and `filters.hs4`, or `get_trade_trends` grouped by `origin_country` to\n show shifts (for example, China to Vietnam) over time.\n\n### Market trends: ports, carriers, lanes, products\n\nUse `get_trade_trends` for change over time (`interval` month for a year or\nless, quarter for two to three years) and `get_trade_breakdown` for share at a\npoint in time. Give chart-ready tables (period by series), the filters used,\nand a short read of what changed. Use full months, and compare like periods\n(the same months a year earlier) to avoid seasonality.\n"
}SHA-256 of public snapshot: 425b1137e1a22f2373e3de9297e8e6aef2434548ecff3cd06e82ed6497e52404