Connection
Use the remote Streamable HTTP endpoint
Add the endpoint to an MCP-compatible client. Hosted clients cannot reach localhost, so use the production URL below.
Primary endpoint
https://www.yugalinks.com/mcpThe compatibility endpoint https://commerce-mcp.yugalinks.com/mcp remains available.
Discovery check
curl https://www.yugalinks.com/mcp/.well-known/mcp.jsonSmithery
Search for nsubnet/yugalinks-commerce in Smithery. OpenCode users can install it with:
npx -y smithery mcp add "https://mcp.smithery.ai/nsubnet" --name nsubnet --client opencodeWhy use it
From a broad question to a checkable trade result
The connector is useful when you need a precise country, product or corridor result instead of a headline estimate. Responses include figures, filters, coverage and source details so a researcher can inspect what the number means.
Find markets
Compare reported exports, imports and bilateral corridors for a defined year.
Inspect products
Move from an HS2 category to an HS4 or HS6 product and check the underlying flow.
Prioritize research
Use calculated opportunity and risk indicators as directional research aids, not guarantees.
Tool surface
Eleven read-only tools
lookup_countriesFind country names and ISO3 codes.
lookup_productsFind HS codes and product descriptions.
list_trade_datasetsDiscover the approved commerce-data dataset catalog.
search_trade_datasetsSearch up to eight named datasets with bounded filters.
get_global_tradeRead global yearly merchandise flows.
get_country_tradeRead country imports, exports, balance and growth.
get_product_tradeRead yearly merchandise flows for HS2, HS4 or HS6 products.
get_corridor_tradeRead exporter-importer goods corridors.
get_lane_riskRead bounded lane-risk observations.
get_export_opportunitiesRead calculated export-opportunity indicators.
get_lane_pageRead one public exporter-importer-HS6 lane page.
Practical examples
Query the data directly
In an MCP client, ask for these results in plain language. With curl, the JSON-RPC response wraps the readable result inside content[0].text.
List datasets
curl -sS -X POST https://www.yugalinks.com/mcp \
-H 'Content-Type: application/json' \
-H 'User-Agent: Mozilla/5.0' \
--data '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_trade_datasets","arguments":{}}}' \
| jq -r '.result.content[0].text' | jqGet India trade
curl -sS -X POST https://www.yugalinks.com/mcp \
-H 'Content-Type: application/json' \
-H 'User-Agent: Mozilla/5.0' \
--data '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get_country_trade","arguments":{"country_iso3":"IND","year":2024,"limit":5}}}' \
| jq -r '.result.content[0].text' | jqCompare India and Germany
curl -sS -X POST https://www.yugalinks.com/mcp \
-H 'Content-Type: application/json' \
-H 'User-Agent: Mozilla/5.0' \
--data '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"get_corridor_trade","arguments":{"exporter_iso3":"IND","importer_iso3":"DEU","year":2024,"limit":5}}}' \
| jq -r '.result.content[0].text' | jqExplore an opportunity indicator
curl -sS -X POST https://www.yugalinks.com/mcp \
-H 'Content-Type: application/json' \
-H 'User-Agent: Mozilla/5.0' \
--data '{"jsonrpc":"2.0","id":4,"method":"tools/call","params":{"name":"get_export_opportunities","arguments":{"exporter_iso3":"IND","importer_iso3":"USA","hs_code":"870899","year":2024,"limit":10}}}' \
| jq -r '.result.content[0].text' | jqUse jq to unwrap the JSON returned by the MCP protocol. Use lookup_products to confirm an HS code before interpreting a product result.
Coverage and use
Reported observations, clearly labeled
The primary source is OECD Balanced International Merchandise Trade Statistics, HS 2017, covering 1995-2024 where observations are available. The underlying trade observations are public; this connector adds a queryable interface, bounded responses and a small analytics layer.
Read-only
The connector does not modify data or user accounts.
Bounded
Requests and responses have size, row and rate limits.
Provenance
Responses include provider, edition, coverage and source links.
Interpret calculated indicators carefully
Opportunity and risk values are calculated research aids based on reported observations. They are not forecasts, guarantees, investment advice or a substitute for checking buyers, tariffs, regulations, logistics and current market evidence.
Query carefully
- Use ISO3 country codes such as
IND,USAandDEU. - Use HS2, HS4 or six-digit HS6 product codes and confirm the description with
lookup_products. - Filter by year and country pair before interpreting an opportunity or risk indicator.
- Validate commercially important decisions against the linked source and current market evidence.