MCP for AI clients

ImportYeti MCP Server allows you to connect ImportYeti data directly with AI assistants like Cursor, ChatGPT, Claude, Gemini, and other MCP-compatible applications.

Instead of manually searching ImportYeti and analyzing results yourself, you can ask your AI assistant questions and let it use ImportYeti data to find the information you need.

What is MCP?

MCP (Model Context Protocol) is a standard that allows AI applications to connect with external tools, APIs, and data sources.

Think of MCP as a bridge between your AI assistant and ImportYeti.

Without MCP: You search ImportYeti → export data → analyze results → ask AI for help.

With MCP: You ask your AI assistant a question → AI connects to ImportYeti → retrieves relevant data → provides an answer.

What can you do with ImportYeti MCP?

  • Find suppliers for a specific product
  • Discover companies importing a certain product
  • Analyze supplier relationships
  • Find potential competitors
  • Research shipping activity
  • Explore import/export trends

Example prompts:

  • “Use ImportYeti MCP to find companies importing electric scooters into the US.”
  • “Use ImportYeti MCP to find suppliers for stainless steel bottles.”
  • “Use ImportYeti MCP to analyze the top importers of coffee machines.”

Benefits of using ImportYeti MCP

  • Faster research — get answers directly from ImportYeti without switching between multiple tools
  • Work with data using natural language — ask questions the same way you would ask a colleague
  • Reduce manual analysis — let your AI assistant help you search, summarize, and interpret supply chain data
  • Connect ImportYeti with your existing workflow — use ImportYeti data inside AI tools you already use

Requirements

Before setting up ImportYeti MCP, you will need:

  • An ImportYeti account
  • An ImportYeti API Key
  • An MCP-compatible application (for example Cursor, ChatGPT, Claude, Gemini, etc.)

Get a key from My Account → Settings → API Credits Settings.

Endpoint

MCP endpoint
https://data.importyeti.com/mcp

Transport: Streamable HTTP (GET). Not versioned under /v1.0.

Authenticate with the same API key (IYApiKey or Authorization: Bearer YOUR_API_KEY), or sign in with your ImportYeti account when the client asks you to.

Setup in Cursor

Step 1: Install Cursor

Download and install Cursor from the official website. After installation, open Cursor and sign in.

Step 2: Open MCP Settings

  1. Open Settings
  2. Navigate to Tools & MCP
  3. Click Add New MCP Server

Step 3: Add ImportYeti MCP Server

Copy and paste the following configuration:

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

Replace YOUR_API_KEY with your actual ImportYeti API Key. Save the configuration.

Step 4: Start using ImportYeti MCP

Once the setup is complete, open Cursor Chat and start asking questions. You can explicitly tell Cursor to use ImportYeti MCP:

Use the ImportYeti MCP to find companies importing yoga mats into the US.

or:

Use ImportYeti MCP to analyze the biggest suppliers of wireless headphones.

Setup in Claude

Step 1: Open Claude Settings

Open Claude and go to Settings → Connectors

Step 2: Add a Custom Connector

Click Add and select Custom Connector. Enter the ImportYeti MCP server URL:

Server URL
https://data.importyeti.com/mcp

Then click Add or Connect.

Step 3: Authenticate with ImportYeti

Claude will ask you to authenticate with your ImportYeti account. Sign in using the account you use for ImportYeti and confirm that you want to connect Claude to ImportYeti.

Step 4: Start using ImportYeti in Claude

Once authentication is complete, your ImportYeti MCP server will be connected to Claude. You can now ask Claude to use ImportYeti when researching supply chain data.

For example:

Use ImportYeti to find companies importing stainless steel bottles into the US.

That’s it — you’re ready to use ImportYeti with Claude.

Setup in ChatGPT

Step 1: Open ChatGPT Settings

Open ChatGPT and go to Settings → Plugins → MCP

Step 2: Add an MCP Server

Click Add MCP Server. Enter the following:

  • Name: ImportYeti
  • Connection type: Streamable HTTP
  • URL: https://data.importyeti.com/mcp

Then click Save.

Step 3: Authenticate with ImportYeti

After adding the server, ChatGPT will ask you to authenticate with your ImportYeti account. Sign in using the account you use for ImportYeti and confirm the connection.

You don’t need to enter your ImportYeti API key — authentication is handled through your ImportYeti account.

Step 4: Start using ImportYeti in ChatGPT

Once authentication is complete, your ImportYeti MCP server will be connected to ChatGPT. You can now ask ChatGPT to use ImportYeti when researching supply chain data.

For example:

Use the ImportYeti MCP to find companies importing stainless steel bottles into the US.

Or:

Use the ImportYeti MCP to find the top suppliers for this company.

That’s it — you’re ready to use ImportYeti with ChatGPT.

Setup in Gemini

You can connect ImportYeti to Gemini using our MCP server. Once connected, you can use ImportYeti data directly through Gemini.

Before you start, make sure you have:

  • A personal Google Account (work or school accounts are currently not supported)
  • Access to Gemini Spark
  • Keep Activity enabled in your Gemini settings
  • Your ImportYeti MCP server URL
  • An active ImportYeti account

You don't need to install a separate Spark app. Spark is available within Gemini when your account is eligible.

Custom MCP apps are currently available only within Gemini Spark. Google also requires users to be eligible for Spark and have Keep Activity turned on.

Step 1: Open Gemini

Go to gemini.google.com and sign in with your personal Google Account.

You can also use the Gemini Mac app if Spark is available on your account.

Step 2: Open Connected Apps

In Gemini, go to Settings & help → Connected Apps.

If you don't see Connected Apps, first open Personal Intelligence, then select Connected Apps.

Step 3: Add ImportYeti

Under Custom apps for Spark, find Add a custom app. Paste your ImportYeti MCP server URL and click Next:

Server URL
https://data.importyeti.com/mcp

Follow the on-screen instructions to complete the connection and authentication. You don't need to enter your ImportYeti API key — authentication is handled through your ImportYeti account.

Step 4: Use ImportYeti in Gemini

Once connected, open a Spark task and type @ to see your connected apps. Select ImportYeti, then ask your question.

For example:

@ImportYeti Find the top suppliers of stainless steel bottles in the US.

Gemini will then use ImportYeti as a connected data source for your request.

That’s it — you’re ready to use ImportYeti with Gemini.

Credits

Each tool mirrors a REST route and charges the same way. Tool results include requestCost, creditsRemaining, data, and executionTime when applicable.

Tools

MCP toolREST equivalentCredits
search_companiesGET /v1.0/company/searchFree
get_companyGET /v1.0/company/{company}1 data credit
search_suppliersGET /v1.0/supplier/searchFree
get_supplierGET /v1.0/supplier/{supplier}1 data credit
top_suppliers_by_productGET /v1.0/product/{product}/suppliers1 per 10
top_companies_by_productGET /v1.0/product/{product}/companies1 per 10
get_us_import_bolGET /v1.0/bol/{number}0.1
power_query_us_importGET /v1.0/powerquery/us-import/bols1 per 10
top_us_importersGET /v1.0/powerquery/us-import/companies1 per 10
top_overseas_suppliersGET /v1.0/powerquery/us-import/suppliers1 per 10
get_us_export_bolGET /v1.0/powerquery/us-export/bols/{bolNumber}0.1
power_query_us_exportGET /v1.0/powerquery/us-export/bols1 per 10
top_us_export_companiesGET /v1.0/powerquery/us-export/companies1 per 10
get_mx_import_declarationGET /v1.0/powerquery/mx-import/declarations/{id}0.1
power_query_mx_importGET /v1.0/powerquery/mx-import/declarations1 per 10
top_mx_import_companiesGET /v1.0/powerquery/mx-import/companies1 per 10
top_mx_import_suppliersGET /v1.0/powerquery/mx-import/suppliers1 per 10
top_mx_import_brokersGET /v1.0/powerquery/mx-import/brokers1 per 10
get_mx_export_declarationGET /v1.0/powerquery/mx-export/declarations/{id}0.1
power_query_mx_exportGET /v1.0/powerquery/mx-export/declarations1 per 10
top_mx_export_companiesGET /v1.0/powerquery/mx-export/companies1 per 10
top_mx_export_suppliersGET /v1.0/powerquery/mx-export/suppliers1 per 10
top_mx_export_brokersGET /v1.0/powerquery/mx-export/brokers1 per 10

Troubleshooting

ImportYeti MCP is not showing up

Try:

  1. Confirm your API key is correct
  2. Restart the app
  3. Check that the MCP server is enabled in Settings → Tools & MCP
  4. Make sure your API key has available credits — see Credits

Authentication error

Check that your configuration includes Authorization: Bearer YOUR_API_KEY and that there is a space between Bearer and your API key.

Gemini does not show Connected Apps or ImportYeti

Custom MCP apps only work inside Gemini Spark. Check that you:

  1. Signed in with a personal Google Account, not a work or school account
  2. Have access to Gemini Spark
  3. Have Keep Activity enabled in Gemini settings

Tips for agents

  • Always search before get — never guess slugs
  • Use the slug from search key (the part after company/ or supplier/)
  • Pick the dataset that matches the question (US vs Mexico, import vs export)
  • Dates are mm/dd/yyyy

Need help?

ImportYeti MCP is continuously improving, and we would love your feedback. If you experience any issues or have suggestions, contact our team. We are happy to help you get started and provide support while we continue improving the experience.

See also core concepts and authentication.