Connect to Suppliers MCP

MCP server URL · Streamable HTTP

https://suppliers-mcp.ekholabs.com/mcp

MCP protocol versions

Supports revision 2026-07-28 and earlier handshake-based clients through 2025-11-25. Your client selects its supported protocol automatically. Suppliers MCP v0.1.0 is the product version, not the protocol version.

Connect Codex

Add the server URL in your MCP settings and choose OAuth. Complete Google sign-in in the browser, then return to Codex.

Command-line setup

Terminal

codex mcp add suppliers --url https://suppliers-mcp.ekholabs.com/mcp
codex mcp login suppliers

Run these commands on your own computer. The login command opens your browser for Google sign-in.

Codex MCP documentation

Connect Claude

In Claude Code, add the server, open /mcp, select suppliers, and follow the Google sign-in prompt.

Command-line setup

Terminal

claude mcp add --transport http suppliers https://suppliers-mcp.ekholabs.com/mcp

Claude Code MCP documentation

Connect your agent

For Kubernetes, remote services, and other headless environments.

Sign in with Google. Sign in here on your own computer, not on the remote machine.
Create a token for your agent. Give it a recognizable name. Copy the token once into your environment’s secret manager.
Connect without a browser. Your agent uses the token as its bearer credential. Return here to view your tokens or revoke one independently.

Signing out of this page does not revoke your agent tokens. Revoke a token to stop that agent; offboarding stops all access.

Headless connection example

Inject your saved token as SUPPLIERS_MCP_TOKEN through your secret manager. Configure your MCP client with the server URL above and an Authorization: Bearer header. Never hard-code the token.

HTTP connectivity check

curl --config - https://suppliers-mcp.ekholabs.com/mcp <<EOF
header = "Authorization: Bearer ${SUPPLIERS_MCP_TOKEN}"
header = "Content-Type: application/json"
header = "Accept: application/json, text/event-stream"
data = "{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"initialize\",\"params\":{\"protocolVersion\":\"2025-11-25\",\"capabilities\":{},\"clientInfo\":{\"name\":\"my-agent\",\"version\":\"1.0\"}}}"
EOF

Expected result: server information and capabilities. Your MCP client handles the rest of the protocol. Keep shell tracing disabled when handling secrets.

Try your first search

Use Suppliers MCP to find suppliers of stainless steel coach screws in US import records. Wait and poll until the search finishes. Show company names, source links, and any coverage warnings. Do not invent missing details.

Expected result: a supplier list with source links and coverage warnings, or an explicit empty result. The assistant waits and polls while the search runs.

For classification without a supplier lookup:

Use Suppliers MCP to classify green coffee beans for the US at six-digit HS level. Explain the candidates and any uncertainty.

Expected result: ranked six-digit HS-code candidates with classification context. An ambiguous product may need more detail; these examples don’t guarantee a particular code.

A search returns a task ID first. Follow poll_after_seconds and treat eta_seconds as an estimate, not a deadline. An empty result is possible and is not necessarily a connection error.

Tools & defaults

classify_product: Find ranked HS-code candidates. Defaults to jurisdiction: "US" and hs_granularity: 6. Use a two-letter country code, not a country name. Cached classifications may be reused for 30 days.
find_suppliers: Start a US-import search. Supply product; defaults are role: "supplier" and hs_granularity: 6. Supplier means shipper/exporter; consignee means receiving importer. There is no country selector for this tool.
get_supplier_search: Poll using the returned task_id and the same user and client that started the search. Stop at done or error. Completed results are retained for 24 hours.

HS depth accepts 4, 6, 8, or 10 digits. Supplier results are discovery evidence, not a complete market census. Missing contact details remain empty; sampling warnings must stay visible.

If something gets stuck

Google sign-in succeeds, but access is denied

Check that you selected your approved work account, not a personal Google account. Contact your EkhoLabs onboarding contact if access has not been provisioned or was revoked. Signing in does not itself grant access.

The connection asks for a client ID or secret

Update your MCP client to a version supporting OAuth Client ID Metadata Documents (CIMD). Do not enter Google or server administrator credentials. If your client still requires manual registration, contact your onboarding contact.

A search is taking longer than expected

Keep polling the same task at the returned interval. Repeatedly starting new searches creates more work and consumes your quota. The ETA can change with queue time and upstream response time.

No companies were returned

Read the warnings first. Check your product wording and whether US import records are relevant. A completed empty result means no matching companies were returned, not that no such supplier exists.

I need help from EkhoLabs

Send your work email, client name and version, approximate time, task ID if available, and the error text to your onboarding contact. Never send access tokens, API keys, or callback URLs.