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
https://data.importyeti.com/mcpTransport: 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
- Open Settings
- Navigate to Tools & MCP
- Click Add New MCP Server
Step 3: Add ImportYeti MCP Server
Copy and paste the following configuration:
{
"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:
https://data.importyeti.com/mcpThen 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:
https://data.importyeti.com/mcpFollow 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 tool | REST equivalent | Credits |
|---|---|---|
| search_companies | GET /v1.0/company/search | Free |
| get_company | GET /v1.0/company/{company} | 1 data credit |
| search_suppliers | GET /v1.0/supplier/search | Free |
| get_supplier | GET /v1.0/supplier/{supplier} | 1 data credit |
| top_suppliers_by_product | GET /v1.0/product/{product}/suppliers | 1 per 10 |
| top_companies_by_product | GET /v1.0/product/{product}/companies | 1 per 10 |
| get_us_import_bol | GET /v1.0/bol/{number} | 0.1 |
| power_query_us_import | GET /v1.0/powerquery/us-import/bols | 1 per 10 |
| top_us_importers | GET /v1.0/powerquery/us-import/companies | 1 per 10 |
| top_overseas_suppliers | GET /v1.0/powerquery/us-import/suppliers | 1 per 10 |
| get_us_export_bol | GET /v1.0/powerquery/us-export/bols/{bolNumber} | 0.1 |
| power_query_us_export | GET /v1.0/powerquery/us-export/bols | 1 per 10 |
| top_us_export_companies | GET /v1.0/powerquery/us-export/companies | 1 per 10 |
| get_mx_import_declaration | GET /v1.0/powerquery/mx-import/declarations/{id} | 0.1 |
| power_query_mx_import | GET /v1.0/powerquery/mx-import/declarations | 1 per 10 |
| top_mx_import_companies | GET /v1.0/powerquery/mx-import/companies | 1 per 10 |
| top_mx_import_suppliers | GET /v1.0/powerquery/mx-import/suppliers | 1 per 10 |
| top_mx_import_brokers | GET /v1.0/powerquery/mx-import/brokers | 1 per 10 |
| get_mx_export_declaration | GET /v1.0/powerquery/mx-export/declarations/{id} | 0.1 |
| power_query_mx_export | GET /v1.0/powerquery/mx-export/declarations | 1 per 10 |
| top_mx_export_companies | GET /v1.0/powerquery/mx-export/companies | 1 per 10 |
| top_mx_export_suppliers | GET /v1.0/powerquery/mx-export/suppliers | 1 per 10 |
| top_mx_export_brokers | GET /v1.0/powerquery/mx-export/brokers | 1 per 10 |
Troubleshooting
ImportYeti MCP is not showing up
Try:
- Confirm your API key is correct
- Restart the app
- Check that the MCP server is enabled in Settings → Tools & MCP
- 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:
- Signed in with a personal Google Account, not a work or school account
- Have access to Gemini Spark
- 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 aftercompany/orsupplier/) - 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.