Product & Market Research
Mercado Libre Market Research MCP
Research Mercado Libre categories, products, sales trends, and reviews. Call the Mercado Market Intelligence API via REST or MCP with your Nexscope API key.
Mercado Libre Market Research AI Prompts & Use Cases
After connecting this MCP tool to your AI assistant, you can ask the questions below. Replace bracketed placeholders with your own inputs and use the supported values in Arguments.
New to Nexscope MCP? Follow the connection guide, then use the prompts below. The Integration and Parameters & Response tabs contain the connection steps, call example, and technical reference.
1. Find Mercado Categories
Prompt: Find Mercado Libre categories matching [category phrase] in [Mexico, Brazil, Argentina, Chile or Colombia]. Return at most [result limit] matches.
2. Review A Mercado Category
Prompt: Show the industry overview for Mercado Libre category [category ID] in [selected market]. Summarize the available category data.
3. Review Product Sales Trends
Prompt: Show the available sales trend for Mercado Libre product [SKU] in [selected market] over [lookback days]. Keep missing dates and values explicit.
4. Find Products From An Image Link
Prompt: Find Mercado Libre products resembling the image at [public image URL] in [selected market]. Return [result limit] matches on page [page number] and stop.
5. Find Products From An Uploaded Image
Prompt: Find Mercado Libre products resembling [my uploaded image] in [selected market]. Return [result limit] matches on page [page number] and stop.
6. Read Product Reviews
Prompt: Get reviews for Mercado Libre product [SKU] in [selected market]. Return [result limit] reviews on page [page number] and summarize only the returned sample.
7. Find Product Snapshots By Keyword
Prompt: Find Mercado Libre product snapshots for [keyword] in [selected market]. Return [result limit] records from page [page number] and keep snapshot dates visible.
8. Find Product Snapshots By Category ID
Prompt: Find Mercado Libre product snapshots for [category ID] in [selected market]. Return [result limit] records from page [page number] and keep snapshot dates visible.
9. Find Product Snapshots By Sku
Prompt: Find Mercado Libre product snapshots for [SKU] in [selected market]. Return [result limit] records from page [page number] and keep snapshot dates visible.
10. Find Product Snapshots By Product Link
Prompt: Find Mercado Libre product snapshots for [product link] in [selected market]. Return [result limit] records from page [page number] and keep snapshot dates visible.
11. Find Product Snapshots By Shop ID
Prompt: Find Mercado Libre product snapshots for [shop ID] in [selected market]. Return [result limit] records from page [page number] and keep snapshot dates visible.
12. Find Product Snapshots By Shop Search Phrase
Prompt: Find Mercado Libre product snapshots for [shop search phrase] in [selected market]. Return [result limit] records from page [page number] and keep snapshot dates visible.
13. Find Product Snapshots By Historical Total Sales
Prompt: Find Mercado Libre snapshots matching [keyword] in [selected market] with [historical total sales within my chosen bounds]. Keep the selected bounds and snapshot scope clear.
14. Find Product Snapshots By Listing Date
Prompt: Find Mercado Libre snapshots matching [keyword] in [selected market] with [listing date within my chosen bounds]. Keep the selected bounds and snapshot scope clear.
15. Find Product Snapshots By Price
Prompt: Find Mercado Libre snapshots matching [keyword] in [selected market] with [price within my chosen bounds]. Keep the selected bounds and snapshot scope clear.
16. Find Product Snapshots By Rating
Prompt: Find Mercado Libre snapshots matching [keyword] in [selected market] with [rating within my chosen bounds]. Keep the selected bounds and snapshot scope clear.
17. Find Product Snapshots By Review Count
Prompt: Find Mercado Libre snapshots matching [keyword] in [selected market] with [review count within my chosen bounds]. Keep the selected bounds and snapshot scope clear.
18. Find Product Snapshots By Sales 30D
Prompt: Find Mercado Libre snapshots matching [keyword] in [selected market] with [sales 30d within my chosen bounds]. Keep the selected bounds and snapshot scope clear.
19. Review Product Snapshots By Product Status
Prompt: Find Mercado Libre snapshots matching [keyword] in [selected market], using [my selected product status]. Show only the returned records.
20. Review Product Snapshots By Sort By
Prompt: Find Mercado Libre snapshots matching [keyword] in [selected market], using [my selected sort by]. Show only the returned records.
21. Review Product Snapshots By Sort Order
Prompt: Find Mercado Libre snapshots matching [keyword] in [selected market], using [my selected sort order]. Show only the returned records.
22. Find Local Or Cross-Border Sellers
Prompt: Find Mercado Libre product snapshots matching [keyword] in [selected market] from [local or cross-border sellers]. Return page 1 with up to10 results and keep the snapshot dates visible.
What You Need to Provide
Replace bracketed inputs with your own values. Use only the documented marketplace, period and input formats.
Returned estimates and rankings describe the selected data and period; missing values are not zero and a page of results is not the full market.
Step 1 · Connect
Connect Your AI Assistant
Connect a compatible MCP client to Nexscope, then select this tool from your assistant. Use the connection settings in your client to complete authentication.
POST https://api.nexscope.ai/mcp
MCP-Protocol-Version: 2025-11-25
Content-Type: application/jsonAuthentication
Use OAuth 2.1 Authorization Code with PKCE and the mcp:tools scope. API keys remain supported as a compatibility option.
Authorization: Bearer nk-xxxxxxxxxxxxxxxxxUsing an API key? Get your key from API Access and include it in the Authorization header shown above.
Call this MCP tool
nexscope_mercado_market_intelligencehttps://api.nexscope.ai/mcptools/callInitialize an MCP 2025-11-25 Streamable HTTP session at https://api.nexscope.ai/mcp, then use tools/call.
{
"jsonrpc": "2.0",
"id": "mercado-market-intelligence-1",
"method": "tools/call",
"params": {
"name": "nexscope_mercado_market_intelligence",
"arguments": {
"arguments": {
"limit": 10,
"market_code": "MLM",
"query": "celulares"
},
"toolName": "search_categories"
}
}
}MCP 2025-11-25 · Streamable HTTPProgress is delivered on the original POST SSE response. GET SSE carries notifications; reconnecting must query existing asynchronous work rather than submit again.
Arguments
toolName: search_categories
| Name | Type | Required | Description |
|---|---|---|---|
arguments | object | required | Arguments for the selected operation |
arguments.limit | integer | optional | Maximum number of records Default: 100 Minimum: 1 Maximum: 100 |
arguments.market_code | string | optional | Mercado market code: MLM, MLB, MLA, MLC, or MCO Allowed: MLM, MLB, MLA, MLC, MCO Default: MLM |
arguments.query | string | optional | Category search query |
toolName | string | required | Mercado research operation Constant: search_categories |
toolName: industry_overview
| Name | Type | Required | Description |
|---|---|---|---|
arguments | object | required | Arguments for the selected operation |
arguments.category_id | string | required | Mercado category ID Minimum length: 1 |
arguments.market_code | string | optional | Mercado market code: MLM, MLB, MLA, MLC, or MCO Allowed: MLM, MLB, MLA, MLC, MCO Default: MLM |
toolName | string | required | Mercado research operation Constant: industry_overview |
toolName: search_product_snapshots
| Name | Type | Required | Description |
|---|---|---|---|
arguments | object | required | Arguments for the selected operation |
arguments.category_id | string | optional | Mercado category ID |
arguments.historical_total_sales_max | integer | optional | Historical total sales max value used by this API operation. Minimum: 0 |
arguments.historical_total_sales_min | integer | optional | Historical total sales min value used by this API operation. Minimum: 0 |
arguments.keyword | string | optional | Product search keyword |
arguments.limit | integer | optional | Maximum number of records Default: 100 Minimum: 1 Maximum: 100 |
arguments.listing_date_max | string | optional | Listing date max value used by this API operation. Pattern: ^\d{8}$|^\d{4}-\d{2}-\d{2}$ |
arguments.listing_date_min | string | optional | Listing date min value used by this API operation. Pattern: ^\d{8}$|^\d{4}-\d{2}-\d{2}$ |
arguments.market_code | string | optional | Mercado market code: MLM, MLB, MLA, MLC, or MCO Allowed: MLM, MLB, MLA, MLC, MCO Default: MLM |
arguments.page | integer | optional | Page number, starting at 1 Default: 1 Minimum: 1 |
arguments.price_max | number | optional | Price max value used by this API operation. Minimum: 0 |
arguments.price_min | number | optional | Price min value used by this API operation. Minimum: 0 |
arguments.product_status | string | integer | optional | Product status value used by this API operation. |
arguments.product_url | string | optional | Mercado product URL Format: uri Pattern: ^https?:// |
arguments.rating_max | number | optional | Rating max value used by this API operation. Minimum: 0 Maximum: 5 |
arguments.rating_min | number | optional | Rating min value used by this API operation. Minimum: 0 Maximum: 5 |
arguments.review_count_max | integer | optional | Review count max value used by this API operation. Minimum: 0 |
arguments.review_count_min | integer | optional | Review count min value used by this API operation. Minimum: 0 |
arguments.sales_30d_max | integer | optional | Sales 30d max value used by this API operation. Minimum: 0 |
arguments.sales_30d_min | integer | optional | Sales 30d min value used by this API operation. Minimum: 0 |
arguments.shop_id | string | optional | Mercado shop ID |
arguments.shop_query | string | optional | Shop search query |
arguments.shop_type | string | optional | Shop type value used by this API operation. Allowed: cross_border, local |
arguments.sku_id | string | optional | Mercado product SKU ID |
arguments.sort_by | string | optional | Snapshot result sort field Allowed: sales_30d, historical_total_sales, price, listing_date, rating, review_count, title Default: sales_30d |
arguments.sort_order | string | optional | Sort direction: asc or desc Allowed: asc, desc Default: desc |
arguments.stock_type | string | optional | Stock type value used by this API operation. |
toolName | string | required | Mercado research operation Constant: search_product_snapshots |
Any of option 1 — requires keyword
| Name | Type | Required | Description |
|---|---|---|---|
arguments | any | required | Arguments for the selected operation |
Any of option 2 — requires category_id
| Name | Type | Required | Description |
|---|---|---|---|
arguments | any | required | Arguments for the selected operation |
Any of option 3 — requires sku_id
| Name | Type | Required | Description |
|---|---|---|---|
arguments | any | required | Arguments for the selected operation |
Any of option 4 — requires product_url
| Name | Type | Required | Description |
|---|---|---|---|
arguments | any | required | Arguments for the selected operation |
Any of option 5 — requires shop_id
| Name | Type | Required | Description |
|---|---|---|---|
arguments | any | required | Arguments for the selected operation |
Any of option 6 — requires shop_query
| Name | Type | Required | Description |
|---|---|---|---|
arguments | any | required | Arguments for the selected operation |
toolName: product_sales_trend
| Name | Type | Required | Description |
|---|---|---|---|
arguments | object | required | Arguments for the selected operation |
arguments.days | integer | optional | Sales-trend lookback days Default: 730 Minimum: 1 Maximum: 731 |
arguments.market_code | string | optional | Mercado market code: MLM, MLB, MLA, MLC, or MCO Allowed: MLM, MLB, MLA, MLC, MCO Default: MLM |
arguments.sku_id | string | required | Mercado product SKU ID Minimum length: 1 |
toolName | string | required | Mercado research operation Constant: product_sales_trend |
toolName: image_search_products
| Name | Type | Required | Description |
|---|---|---|---|
arguments | object | required | Arguments for the selected operation |
arguments.image_base64 | string | optional | Base64 image input for image search Minimum length: 1 |
arguments.image_url | string | optional | Public image URL for image search Format: uri Pattern: ^https?:// |
arguments.limit | integer | optional | Maximum number of records Default: 50 Minimum: 1 |
arguments.market_code | string | optional | Mercado market code: MLM, MLB, MLA, MLC, or MCO Allowed: MLM, MLB, MLA, MLC, MCO Default: MLM |
arguments.page | integer | optional | Page number, starting at 1 Default: 1 Minimum: 1 |
toolName | string | required | Mercado research operation Constant: image_search_products |
Any of option 1 — requires image_url
| Name | Type | Required | Description |
|---|---|---|---|
arguments | any | required | Arguments for the selected operation |
Any of option 2 — requires image_base64
| Name | Type | Required | Description |
|---|---|---|---|
arguments | any | required | Arguments for the selected operation |
toolName: review_search
| Name | Type | Required | Description |
|---|---|---|---|
arguments | object | required | Arguments for the selected operation |
arguments.limit | integer | optional | Maximum number of records Default: 20 Minimum: 1 Maximum: 100 |
arguments.market_code | string | optional | Mercado market code: MLM, MLB, MLA, MLC, or MCO Allowed: MLM, MLB, MLA, MLC, MCO Default: MLM |
arguments.page | integer | optional | Page number, starting at 1 Default: 1 Minimum: 1 |
arguments.sku_id | string | required | Mercado product SKU ID Minimum length: 1 |
toolName | string | required | Mercado research operation Constant: review_search |
Response fields
Treat structuredContent as the programmatic API response payload.
| Name | Type | Required | Description |
|---|---|---|---|
code | integer | required | 0 means accepted or successful; nonzero is a platform error. |
cost | string | required | Elapsed milliseconds, never credits; -1 outside web requests. |
data | any | required | Data value used by this API operation. |
msg | string | null | required | Msg value used by this API operation. |
time | string | required | Server local time: yyyy-MM-dd HH:mm:ss. |
traceId | string | null | required | Trace id value used by this API operation. |
ts | string | required | Epoch milliseconds. |
Any of option 1 — requires operation, data
| Name | Type | Required | Description |
|---|---|---|---|
data | object | required | Data value used by this API operation. |
data.charged | boolean | optional | Charged value used by this API operation. |
data.data | object | required | Data value used by this API operation. |
data.operation | string | required | Operation value used by this API operation. Allowed: search_categories, industry_overview, search_product_snapshots, product_sales_trend, image_search_products, review_search |
data.total | integer | optional | Total value used by this API operation. Minimum: 0 |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data | null | required | Data value used by this API operation. |
Format Illustration
Illustrative example with fictional data, not a live tool call.
Illustrative Question
Find Mercado Libre categories matching “celulares” in Mexico.
Illustrative Response Explanation
The illustrative result contains one category, “Cell Phones”, with taxonomy code MLM1055. Use the returned category identifier when preparing a category-specific research request.
About this sample: Illustrative format example, not a live query. The published REST sample uses a different result envelope; this pair follows the documented MCP category-search request and response format.
View the Published Sample Data (JSON)
Published REST data example. Use Parameters & Response for MCP arguments when calling this tool.
Data Example
Sample request and response
Request parameters
{
"toolName": "product_sales_trend",
"arguments": {
"sku_id": "MLM44553940",
"market_code": "MLM",
"days": 90
}
}Response
{
"code": 0,
"msg": null,
"data": {
"providerCharged": true,
"data": {
"data_available": true,
"range_end_date": "2026-09-19",
"monthly_order_series": [
{
"month": "2026-06",
"orders": 921
},
{
"month": "2026-07",
"orders": 1594
},
{
"month": "2026-08",
"orders": 1451
},
{
"month": "2026-09",
"orders": 718
}
],
"range_start_date": "2026-06-22",
"market_code": "MLM",
"product_code": "MLM44553940",
"weekly_order_series": [
{
"week": "2026-W26",
"orders": 713
},
{
"week": "2026-W27",
"orders": 630
},
{
"week": "2026-W28",
"orders": 286
},
{
"week": "2026-W29",
"orders": 290
},
{
"week": "2026-W30",
"orders": 383
},
{
"week": "2026-W31",
"orders": 324
},
{
"week": "2026-W32",
"orders": 355
},
{
"week": "2026-W33",
"orders": 347
},
{
"week": "2026-W34",
"orders": 326
},
{
"week": "2026-W35",
"orders": 275
},
{
"week": "2026-W36",
"orders": 285
},
{
"week": "2026-W37",
"orders": 352
},
{
"week": "2026-W38",
"orders": 118
}
],
"requested_day_count": 90,
"notices": [
"Only 87 daily records were found in the requested 90-day window."
],
"input_method": "daily_history",
"aggregation_period": {
"timezone_mode": "server_local_date",
"month_mode": "calendar_month",
"week_mode": "iso_week"
},
"data_coverage": {
"full_coverage": false,
"coverage_end_date": "2026-09-16",
"coverage_start_date": "2026-06-22",
"requested_day_count": 90,
"covered_day_count": 87
},
"covered_day_count": 87
},
"rawResponse": {
"isError": false,
"structuredContent": {
"data_available": true,
"range_end_date": "2026-09-19",
"monthly_order_series": [
{
"month": "2026-06",
"orders": 921
},
{
"month": "2026-07",
"orders": 1594
},
{
"month": "2026-08",
"orders": 1451
},
{
"month": "2026-09",
"orders": 718
}
],
"range_start_date": "2026-06-22",
"market_code": "MLM",
"product_code": "MLM44553940",
"weekly_order_series": [
{
"week": "2026-W26",
"orders": 713
},
{
"week": "2026-W27",
"orders": 630
},
{
"week": "2026-W28",
"orders": 286
},
{
"week": "2026-W29",
"orders": 290
},
{
"week": "2026-W30",
"orders": 383
},
{
"week": "2026-W31",
"orders": 324
},
{
"week": "2026-W32",
"orders": 355
},
{
"week": "2026-W33",
"orders": 347
},
{
"week": "2026-W34",
"orders": 326
},
{
"week": "2026-W35",
"orders": 275
},
{
"week": "2026-W36",
"orders": 285
},
{
"week": "2026-W37",
"orders": 352
},
{
"week": "2026-W38",
"orders": 118
}
],
"requested_day_count": 90,
"notices": [
"Only 87 daily records were found in the requested 90-day window."
],
"input_method": "daily_history",
"aggregation_period": {
"timezone_mode": "server_local_date",
"month_mode": "calendar_month",
"week_mode": "iso_week"
},
"data_coverage": {
"full_coverage": false,
"coverage_end_date": "2026-09-16",
"coverage_start_date": "2026-06-22",
"requested_day_count": 90,
"covered_day_count": 87
},
"covered_day_count": 87
},
"content": [
{
"text": "{\n \"market_code\": \"MLM\",\n \"product_code\": \"MLM44553940\",\n \"range_start_date\": \"2026-06-22\",\n \"range_end_date\": \"2026-09-19\",\n \"requested_day_count\": 90,\n \"data_available\": true,\n \"data_coverage\": {\n \"requested_day_count\": 90,\n \"covered_day_count\": 87,\n \"full_coverage\": false,\n \"coverage_start_date\": \"2026-06-22\",\n \"coverage_end_date\": \"2026-09-16\"\n },\n \"aggregation_period\": {\n \"month_mode\": \"calendar_month\",\n \"week_mode\": \"iso_week\",\n \"timezone_mode\": \"server_local_date\"\n },\n \"notices\": [\n \"Only 87 daily records were found in the requested 90-day window.\"\n ],\n \"covered_day_count\": 87,\n \"monthly_order_series\": [\n {\n \"month\": \"2026-06\",\n \"orders\": 921\n },\n {\n \"month\": \"2026-07\",\n \"orders\": 1594\n },\n {\n \"month\": \"2026-08\",\n \"orders\": 1451\n },\n {\n \"month\": \"2026-09\",\n \"orders\": 718\n }\n ],\n \"weekly_order_series\": [\n {\n \"week\": \"2026-W26\",\n \"orders\": 713\n },\n {\n \"week\": \"2026-W27\",\n \"orders\": 630\n },\n {\n \"week\": \"2026-W28\",\n \"orders\": 286\n },\n {\n \"week\": \"2026-W29\",\n \"orders\": 290\n },\n {\n \"week\": \"2026-W30\",\n \"orders\": 383\n },\n {\n \"week\": \"2026-W31\",\n \"orders\": 324\n },\n {\n \"week\": \"2026-W32\",\n \"orders\": 355\n },\n {\n \"week\": \"2026-W33\",\n \"orders\": 347\n },\n {\n \"week\": \"2026-W34\",\n \"orders\": 326\n },\n {\n \"week\": \"2026-W35\",\n \"orders\": 275\n },\n {\n \"week\": \"2026-W36\",\n \"orders\": 285\n },\n {\n \"week\": \"2026-W37\",\n \"orders\": 352\n },\n {\n \"week\": \"2026-W38\",\n \"orders\": 118\n }\n ],\n \"input_method\": \"daily_history\"\n}",
"type": "text"
}
]
},
"contentText": "{\n \"market_code\": \"MLM\",\n \"product_code\": \"MLM44553940\",\n \"range_start_date\": \"2026-06-22\",\n \"range_end_date\": \"2026-09-19\",\n \"requested_day_count\": 90,\n \"data_available\": true,\n \"data_coverage\": {\n \"requested_day_count\": 90,\n \"covered_day_count\": 87,\n \"full_coverage\": false,\n \"coverage_start_date\": \"2026-06-22\",\n \"coverage_end_date\": \"2026-09-16\"\n },\n \"aggregation_period\": {\n \"month_mode\": \"calendar_month\",\n \"week_mode\": \"iso_week\",\n \"timezone_mode\": \"server_local_date\"\n },\n \"notices\": [\n \"Only 87 daily records were found in the requested 90-day window.\"\n ],\n \"covered_day_count\": 87,\n \"monthly_order_series\": [\n {\n \"month\": \"2026-06\",\n \"orders\": 921\n },\n {\n \"month\": \"2026-07\",\n \"orders\": 1594\n },\n {\n \"month\": \"2026-08\",\n \"orders\": 1451\n },\n {\n \"month\": \"2026-09\",\n \"orders\": 718\n }\n ],\n \"weekly_order_series\": [\n {\n \"week\": \"2026-W26\",\n \"orders\": 713\n },\n {\n \"week\": \"2026-W27\",\n \"orders\": 630\n },\n {\n \"week\": \"2026-W28\",\n \"orders\": 286\n },\n {\n \"week\": \"2026-W29\",\n \"orders\": 290\n },\n {\n \"week\": \"2026-W30\",\n \"orders\": 383\n },\n {\n \"week\": \"2026-W31\",\n \"orders\": 324\n },\n {\n \"week\": \"2026-W32\",\n \"orders\": 355\n },\n {\n \"week\": \"2026-W33\",\n \"orders\": 347\n },\n {\n \"week\": \"2026-W34\",\n \"orders\": 326\n },\n {\n \"week\": \"2026-W35\",\n \"orders\": 275\n },\n {\n \"week\": \"2026-W36\",\n \"orders\": 285\n },\n {\n \"week\": \"2026-W37\",\n \"orders\": 352\n },\n {\n \"week\": \"2026-W38\",\n \"orders\": 118\n }\n ],\n \"input_method\": \"daily_history\"\n}",
"type": "rawMcpToolResult",
"total": 4,
"costTime": 724,
"charged": true,
"textParsedAsJson": false,
"toolName": "product_sales_trend"
}
}View the MCP Request & Response Format
Examples
Illustrative example with fictional data, not a live tool call.
The JSON-RPC envelope below illustrates how the shown arguments and payload fit into MCP. It is not captured network traffic or proof of a successful call. Workflow-only examples do not include a result.
MCP Request
{
"jsonrpc": "2.0",
"id": "mercado-market-intelligence-example",
"method": "tools/call",
"params": {
"name": "nexscope_mercado_market_intelligence",
"arguments": {
"arguments": {
"limit": 10,
"market_code": "MLM",
"query": "celulares"
},
"toolName": "search_categories"
}
}
}MCP Response Format
{
"jsonrpc": "2.0",
"id": "mercado-market-intelligence-example",
"result": {
"content": [
{
"type": "text",
"text": "{\"code\":0,\"cost\":\"-1\",\"data\":{\"data\":{\"record_count\":1,\"records\":[{\"taxonomy_code\":\"MLM1055\",\"taxonomy_name\":\"Cell Phones\"}]},\"operation\":\"search_categories\",\"total\":1},\"msg\":null,\"time\":\"2026-01-01 00:00:00\",\"traceId\":null,\"ts\":\"0\"}"
}
],
"structuredContent": {
"code": 0,
"cost": "-1",
"data": {
"data": {
"record_count": 1,
"records": [
{
"taxonomy_code": "MLM1055",
"taxonomy_name": "Cell Phones"
}
]
},
"operation": "search_categories",
"total": 1
},
"msg": null,
"time": "2026-01-01 00:00:00",
"traceId": null,
"ts": "0"
},
"isError": false
}
}