mcp-us-import-records-buyer-finder

US Import Records Buyer Finder MCP Server

An MCP server for the Mamba Labs US Import Records Buyer Finder actor on Apify. Find US importers and their overseas suppliers from customs records.

What's Inside

• What it does
• Quick start
• Prerequisites
• Example prompts
• Tool
• Inputs
• Pricing
• Full actor documentation
• License

What it does

Search company names and get one row per US importer or overseas supplier, with shipment counts and last shipment dates. Ask for profiles to add trading partners, HS codes, product descriptions, and recent shipments, up to 20 a run.

All of the work runs on Apify. This package is a thin client that starts the actor run, waits for it, and hands back the dataset rows.

Quick start

You need Node.js 18 or newer and an Apify account with an API token.

Add this to your Claude Desktop config (claude_desktop_config.json), Cursor, or any MCP client:

{
  "mcpServers": {
    "mamba-us-import-records-buyer-finder": {
      "command": "npx",
      "args": [
        "-y",
        "@mambalabsdev/mcp-us-import-records-buyer-finder"
      ],
      "env": {
        "APIFY_TOKEN": "your-apify-token"
      }
    }
  }
}

Restart the client. The find_us_importers tool appears.

Prerequisites

• Node.js 18 or newer.
• An Apify API token from console.apify.com/account/integrations, set as APIFY_TOKEN. The server lists its tool without a token; a call needs one.

Example prompts

• "Find US importers with pickleball in their name that shipped this year."
• "Who supplies Pickleball Central, and from which countries?"
• "Which overseas suppliers named Zhejiang ship the most to the US?"

Tool

find_us_importers. One tool. Example arguments:

{
  "search": [
    "pickleball"
  ],
  "max_results": 20
}

Inputs

Every buyer facing input of the actor. Omitted inputs take the actor's own defaults.

Input	Type	Required	Description
search	array	no	Company name words, for example pickleball or walmart. The site matches company names, not what a company imports. Up to 50 terms.
company_urls	array	no	ImportYeti company or supplier links to read in full, up to 20 a run.
mode	string	no	importers: US companies importing. suppliers: overseas companies shipping to the US. both: either.
date_from	string	no	Optional, YYYY-MM-DD. Drops companies whose last shipment is older.
min_shipments	number	no	Optional. Drops companies with fewer shipments in total.
max_results	number	no	Up to 1000. Default 100. The site served about 140 rows per term in testing, so a broad term can stop sooner.
include_profiles	boolean	no	true adds trading partners, their countries, HS codes, product descriptions, and recent shipments to the first rows, up to Maximum profiles. Priced as a profile row.
max_profiles	number	no	Up to 20, because the site limits page views per address and this actor stops there. Each profile adds about 7 seconds.
max_charge_usd	string	no	Optional. The run stops before a charge that would pass this amount. Summary rows are always returned.

Pricing

Pay per event on Apify, billed to your Apify account. Prices in USD.

Event	Free plan	Bronze	Silver	Gold
company-row, one company from search	$0.0025	$0.002375	$0.00225	$0.002125
company-profile-row, one company with its profile read	$0.008	$0.0076	$0.0072	$0.0068
apify-actor-start, per run start	$0.002	$0.002	$0.002	$0.002

Summary rows, refused input, filtered rows, and refused pages are free. Mamba Labs pays the platform costs of the run, Apify proxy traffic included.

Full actor documentation

apify.com/mambalabs/us-import-records-buyer-finder

License

MIT. See LICENSE.