Skip to main content
Glama

Walmart Product Research: search API

nexscope_data_walmart_search
Read-only

Walmart Product Research: search API.

Input Schema

NameRequiredDescriptionDefault
pageNoPagination page number, the maximum value is `100`.
sortNoSort by: `price_low` (price from low to high), `price_high` (price from high to low), `best_seller` (best selling), `best_match` (best match). Uses default relevance ordering when not specified.
deviceNoDevice type: `desktop`, `tablet`, `mobile`.desktop
keywordNoSearch keyword, maximum length 1024 characters; provide at least one with `categoryId`.
storeIdNoStore ID to filter products by a specific store.
maxPriceNoHighest price.
minPriceNolowest price.
softSortNoWhether to sort by relevance; set to `false` to disable.
spellingNoWhether to enable spelling correction.
categoryIdNoCategory ID, provide at least one with `keyword`; `0` means all departments, for example `976759_976787`.
jsonRestrictorNoJSON field limiter.
nextDayEnabledNoWhether to display only NextDay delivery results.

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

C2.1/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint=true, destructiveHint=false and openWorldHint=true, so the safety profile is covered structurally. The description adds nothing beyond that: no note that results are live scraped Walmart listings, no rate limit, pagination cap, or result-size expectations. It does not contradict the annotations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness2/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The sentence is short but entirely redundant with the title, so there is no waste to trim and equally no information front-loaded. This is under-specification rather than concision.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness1/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

A 12-parameter open-world search tool with no output schema needs the description to convey result shape, pagination depth, and how it differs from the many sibling Walmart tools. A single restated title leaves every one of those gaps unaddressed.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, and each of the 12 parameters is documented inline, including the keyword/categoryId co-requirement and sort enum values. Because the schema carries the full parameter burden, the baseline of 3 applies; the description contributes nothing extra but also nothing harmful.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose2/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description restates the title verbatim ('Walmart Product Research: search API') and adds no independent statement of what the tool does. An agent learns only that it is a search endpoint for Walmart data, and cannot distinguish it from siblings like nexscope_walmart_search, nexscope_data_st_walmart_keyword_research or nexscope_data_st_walmart_product_analysis. This is the tautology case.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

There is no when-to-use, when-not-to-use, or alternative-routing guidance at all. With several closely named Walmart siblings available, the description gives the agent no basis for choosing between them; the choice falls entirely to guessing from names.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.