Product & Market Research

Mercado Market Intelligence MCP Tool

Returns normalized public ecommerce research data with a fixed read-only provider path.

MCP tool name

nexscope_mercado_market_intelligence

Equivalent REST API path

https://api.nexscope.ai/api/skill-api/v1/skills/mercado-market-intelligence/run

JSON-RPC method

tools/call

Authentication

Send the user API key as a bearer token on every MCP JSON-RPC request.

Authorization: Bearer nk_xxxxxxxxxxxxxxxxx

If authentication is missing or invalid, ask the user to open API Access and copy a valid key before calling this tool.

Call this MCP tool

Use tools/call with the MCP tool name below. The arguments object should match the table on this page.

{
  "jsonrpc": "2.0",
  "id": "mercado-market-intelligence-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_mercado_market_intelligence",
    "arguments": {
      "arguments": {
        "query": "celulares",
        "limit": 10,
        "market_code": "MLM"
      },
      "toolName": "search_categories"
    }
  }
}

REST API equivalent

POST https://api.nexscope.ai/api/skill-api/v1/skills/mercado-market-intelligence/run

Canonical detail URL

https://www.nexscope.ai/mcp-map/mercado-market-intelligence

Arguments

toolName: search_categories

Name	Type	Required	Description
`toolName`	`string`	required	Mercado research operation Constant: search_categories
`arguments`	`object`	required	Arguments for the selected operation
`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
`arguments.limit`	`integer`	optional	Maximum number of records Default: 100 Minimum: 1 Maximum: 100

toolName: industry_overview

Name	Type	Required	Description
`toolName`	`string`	required	Mercado research operation Constant: industry_overview
`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: search_product_snapshots

Name	Type	Required	Description
`toolName`	`string`	required	Mercado research operation Constant: search_product_snapshots
`arguments`	`object`	required	Arguments for the selected operation
`arguments.market_code`	`string`	optional	Mercado market code: MLM, MLB, MLA, MLC, or MCO Allowed: MLM, MLB, MLA, MLC, MCO Default: MLM
`arguments.keyword`	`string`	optional	Product search keyword
`arguments.category_id`	`string`	optional	Mercado category ID
`arguments.sku_id`	`string`	optional	Mercado product SKU ID
`arguments.product_url`	`string`	optional	Mercado product URL Format: uri Pattern: ^https?://
`arguments.shop_id`	`string`	optional	Mercado shop ID
`arguments.shop_query`	`string`	optional	Shop search query
`arguments.price_min`	`number`	optional	Price min value used by this API operation. Minimum: 0
`arguments.price_max`	`number`	optional	Price 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.sales_30d_max`	`integer`	optional	Sales 30d 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.historical_total_sales_max`	`integer`	optional	Historical total sales 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.review_count_max`	`integer`	optional	Review count max value used by this API operation. Minimum: 0
`arguments.rating_min`	`number`	optional	Rating min value used by this API operation. Minimum: 0 Maximum: 5
`arguments.rating_max`	`number`	optional	Rating max value used by this API operation. Minimum: 0 Maximum: 5
`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.listing_date_max`	`string`	optional	Listing date max value used by this API operation. Pattern: ^\d{8}$\|^\d{4}-\d{2}-\d{2}$
`arguments.stock_type`	`string`	optional	Stock type value used by this API operation.
`arguments.shop_type`	`string`	optional	Shop type value used by this API operation. Allowed: cross_border, local
`arguments.product_status`	`string \| integer`	optional	Product status value used by this API operation.
`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.page`	`integer`	optional	Page number, starting at 1 Default: 1 Minimum: 1
`arguments.limit`	`integer`	optional	Maximum number of records Default: 100 Minimum: 1 Maximum: 100

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
`toolName`	`string`	required	Mercado research operation Constant: product_sales_trend
`arguments`	`object`	required	Arguments for the selected operation
`arguments.sku_id`	`string`	required	Mercado product SKU 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
`arguments.days`	`integer`	optional	Sales-trend lookback days Default: 730 Minimum: 1 Maximum: 731

toolName: image_search_products

Name	Type	Required	Description
`toolName`	`string`	required	Mercado research operation Constant: image_search_products
`arguments`	`object`	required	Arguments for the selected operation
`arguments.image_url`	`string`	optional	Public image URL for image search Format: uri Pattern: ^https?://
`arguments.image_base64`	`string`	optional	Base64 image input for image search 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
`arguments.page`	`integer`	optional	Page number, starting at 1 Default: 1 Minimum: 1
`arguments.limit`	`integer`	optional	Maximum number of records Default: 50 Minimum: 1

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
`toolName`	`string`	required	Mercado research operation Constant: review_search
`arguments`	`object`	required	Arguments for the selected operation
`arguments.sku_id`	`string`	required	Mercado product SKU 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
`arguments.page`	`integer`	optional	Page number, starting at 1 Default: 1 Minimum: 1
`arguments.limit`	`integer`	optional	Maximum number of records Default: 20 Minimum: 1 Maximum: 100

Response fields

Treat structuredContent as the programmatic API response payload.

No response field schema is defined for this tool.

Examples

Example arguments

{
  "arguments": {
    "query": "celulares",
    "limit": 10,
    "market_code": "MLM"
  },
  "toolName": "search_categories"
}

Example structuredContent

{
  "operation": "search_categories",
  "total": 1,
  "data": {
    "records": [
      {
        "taxonomy_code": "MLM1055",
        "taxonomy_name": "Cell Phones"
      }
    ],
    "record_count": 1
  }
}