importyeti light logo
Menu
Live Model Context Protocol server

Global trade data, wired straight into your AI agent

Point Claude, Cursor, ChatGPT, or any MCP client at one URL and it instantly gains tools to search US import & export bills of lading and Mexico customs declarations — who trades what, with whom, through which ports, and when.

Server endpoint

Authenticate with your ImportYeti API key as a bearer token. No shared keys — every request uses the caller's own key and its own credit balance.

1

Grab your API key

Get your ImportYeti API key at importyeti.com/yeti-api.

2

Add the connector

Drop the URL and key into your client's MCP config (examples below).

3

Ask away

Your agent now has 23 live trade-data tools across five datasets. No copy-pasting API docs.

Connect your client

Replace YOUR_API_KEY with your ImportYeti API key in every example.

Cursor

native remote MCP

Add to .cursor/mcp.json (project) or ~/.cursor/mcp.json (global).

{
  "mcpServers": {
    "importyeti": {
      "url": "https://data.importyeti.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Claude Desktop

via mcp-remote

Edit claude_desktop_config.json. The mcp-remote bridge forwards your key.

{
  "mcpServers": {
    "importyeti": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://data.importyeti.com/mcp",
        "--header",
        "Authorization: Bearer YOUR_API_KEY"
      ]
    }
  }
}

Claude.ai / ChatGPT

Custom Connector

In Settings → Connectors → Add custom connector, set the URL and add an authentication header.

Server URL:  https://data.importyeti.com/mcp
Header name:  Authorization
Header value: Bearer YOUR_API_KEY

Any MCP client / curl

raw HTTP

The endpoint speaks JSON-RPC over Streamable HTTP. Quick check:

curl -X POST https://data.importyeti.com/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Available tools

23 tools backed by the ImportYeti Data API — US import/export, Mexico import/export, profiles, and single-document lookups. Your agent picks the right one automatically.

Profiles & lookups
search_companiesFind US importers by name, phone, or website.
get_companyImporter profile: suppliers, HS codes, lanes, stats.
search_suppliersFind overseas suppliers by name, phone, or website.
get_supplierSupplier profile: US customers, HS codes, country.
get_us_import_bolLook up one US import bill of lading by number.
get_us_export_bolLook up one US export bill of lading by number.
get_mx_import_declarationLook up one Mexico import declaration.
get_mx_export_declarationLook up one Mexico export declaration.
US import
power_query_us_importSearch US import shipments with full detail.
top_us_importersRank biggest US importers by any filter.
top_overseas_suppliersRank biggest overseas suppliers to the US.
top_suppliers_by_productFind suppliers specialized in a product.
top_companies_by_productFind US buyers specialized in a product.
US export
power_query_us_exportSearch US export shipments.
top_us_export_companiesRank biggest US exporters by any filter.
Mexico import
power_query_mx_importSearch Mexico import customs declarations.
top_mx_import_companiesRank Mexican importers.
top_mx_import_suppliersRank foreign suppliers to Mexico.
top_mx_import_brokersRank Mexico import customs brokers.
Mexico export
power_query_mx_exportSearch Mexico export customs declarations.
top_mx_export_companiesRank foreign buyers of Mexican exports.
top_mx_export_suppliersRank Mexican exporters.
top_mx_export_brokersRank Mexico export customs brokers.

Prefer plain REST?

Everything the MCP server can do is also available as a documented REST API, if you'd rather integrate it directly into your own code.