Walmart MCP Server

Connect your AI agents to HasData's Walmart MCP server. Search products and read prices, seller details and customer reviews in structured JSON over streamable HTTP.

https://mcp.hasdata.com/api/mcp?apis=walmart

Transport: Streamable HTTP
Auth: OAuth or API key
Tools: 3 Walmart tools
Price: 10 credits / call

Get API Key Read the docs 1,000 free credits. No credit card required.

Data teams at

Playground

See the Walmart MCP server in action

Select a sample prompt to inspect the tool it chooses and the JSON payload your agent receives.

Find air fryers on Walmart and compare their prices and ratings.

Walmart · 3 tools Enter to send

Find air fryers on Walmart and compare their prices and ratings.

hasdata_walmart_search_getSearchResults · 200 OK sample call

Of these three options, the Ninja Air Fryer Pro XL is the cheapest and has the highest rating.

Ninja Air Fryer Pro XL, 5 qt · $79.97 · 4.6/5

Thyme & Table, 6 qt · $89.98 · 4.5/5

Gourmia toaster oven air fryer, 24L · $89.00 · 4.4/5

All three are sponsored listings.

hasdata_walmart_search_getSearchResults { "q": "air fryer", "sort": "bestMatch" }

{

"url": "https://api.hasdata.com/scrape/walmart/search/?q=air+fryer&sort=bestMatch",

"status": 200,

"json": {

"searchInformation": { "query": "air fryer", "storeId": "5745" },

"productResults": [

{ "id": "14140920286", "title": "Thyme & Table 6 Quart Air Fryer with Ceramic-Coated Nonstick Basket, Sand White",

"price": { "currentPrice": 89.98, "currentPriceDisplay": "$89.98" }, "reviews": { "rating": 4.5 }, "isSponsored": true },

{ "id": "1438286796", "title": "Gourmia French Door 6-Slice Digital Toaster Oven Air Fryer, 19 One-Touch Presets, 24L, Stainless Steel",

"price": { "currentPrice": 89, "currentPriceDisplay": "$89.00" }, "reviews": { "rating": 4.4 }, "isSponsored": true },

{ "id": "5144605607", "title": "Ninja Air Fryer Pro XL 5-Qt, 3-in-1, 400°F Air Crisp Technology, Nonstick Crisper Plate, AF140 Black",

"price": { "currentPrice": 79.97, "currentPriceDisplay": "$79.97" }, "reviews": { "rating": 4.6 }, "isSponsored": true }

]

}

Find air fryers on Walmart and compare their prices and ratings.

hasdata_walmart_search_getSearchResults · 200 OK sample call

Of these three options, the Ninja Air Fryer Pro XL is the cheapest and has the highest rating.

Ninja Air Fryer Pro XL, 5 qt · $79.97 · 4.6/5

Thyme & Table, 6 qt · $89.98 · 4.5/5

Gourmia toaster oven air fryer, 24L · $89.00 · 4.4/5

All three are sponsored listings.

hasdata_walmart_search_getSearchResults { "q": "air fryer", "sort": "bestMatch" }

{

"url": "https://api.hasdata.com/scrape/walmart/search/?q=air+fryer&sort=bestMatch",

"status": 200,

"json": {

"searchInformation": { "query": "air fryer", "storeId": "5745" },

"productResults": [

{ "id": "14140920286", "title": "Thyme & Table 6 Quart Air Fryer with Ceramic-Coated Nonstick Basket, Sand White",

"price": { "currentPrice": 89.98, "currentPriceDisplay": "$89.98" }, "reviews": { "rating": 4.5 }, "isSponsored": true },

{ "id": "1438286796", "title": "Gourmia French Door 6-Slice Digital Toaster Oven Air Fryer, 19 One-Touch Presets, 24L, Stainless Steel",

"price": { "currentPrice": 89, "currentPriceDisplay": "$89.00" }, "reviews": { "rating": 4.4 }, "isSponsored": true },

{ "id": "5144605607", "title": "Ninja Air Fryer Pro XL 5-Qt, 3-in-1, 400°F Air Crisp Technology, Nonstick Crisper Plate, AF140 Black",

"price": { "currentPrice": 79.97, "currentPriceDisplay": "$79.97" }, "reviews": { "rating": 4.6 }, "isSponsored": true }

]

}

What's the price, seller and selected variant for Walmart item 14977205582?

hasdata_walmart_product_getWalmartProduct · 200 OK sample call

$874.99 USD, sold by Digital World Shop.

Samsung Galaxy S25 Ultra, 256GB, Titanium Silver Blue. New and in stock.

The seller has a 4.1 rating.

hasdata_walmart_product_getWalmartProduct { "itemId": "14977205582" }

{

"url": "https://api.hasdata.com/scrape/walmart/product/?itemId=14977205582",

"status": 200,

"json": { "product": {

"itemId": "14977205582",

"title": "Samsung Galaxy S25 Ultra 256GB Unlocked Android Cell Phone with 200MP Camera, Titanium Blue",

"condition": "New", "availability": "IN_STOCK",

"price": { "currentPrice": 874.99, "currentPriceDisplay": "$874.99", "currency": "USD" },

"seller": { "name": "Digital World Shop", "rating": 4.1 },

"currentSelection": { "Capacity": "256GB", "Series": "Galaxy S25 ULTRA", "Color": "Titanium Silver Blue" }

} }

}

What do buyers like and dislike about Walmart item 1028936148?

hasdata_walmart_reviews_getWalmartReviews · 200 OK sample call

This restored iPhone 14 has a 3.9 rating. Buyers praise its condition but also report screen problems and poor warranty support.

A 5-star buyer says the phone arrived in like-new condition without visible scratches, shipped quickly and was ready to use.

A 3-star review is titled "All good - except for screen issues".

A 1-star buyer reports a broken iPhone, no warranty support and poor service.

All three reviews are from verified purchases.

hasdata_walmart_reviews_getWalmartReviews { "itemId": "1028936148", "page": 1, "sort": "mostRelevant" }

{

"url": "https://api.hasdata.com/scrape/walmart/reviews/?itemId=1028936148&page=1&sort=mostRelevant",

"status": 200,

"json": {

"reviewsInformation": { "itemId": "1028936148", "title": "Restored Apple iPhone 14 128GB Starlight LTE Cellular MPUN3LL/A", "rating": 3.9 },

"reviewResults": [

{

"id": "378308604",

"rating": 5,

"title": "Good seller",

"text": "The phone was for my daughters Christmas phone was in \"like new condition\" I did not see any blemishes or scratches. Fast shipping! When we turned it on it was up to date on software and ready for her to put her information in and start using right away.",

"verifiedPurchase": true

{ "id": "378723791", "rating": 3, "title": "All good - except for screen issues", "verifiedPurchase": true },

{ "id": "385695696", "rating": 1, "title": "Broken iPhone, No Warranty Support, Poor Service", "verifiedPurchase": true }

"pagination": { "currentPage": 1, "nextPage": 2 }

}

Tools

The Walmart tools your agent can call

3 tools

Typed parameters, required flags, and structured JSON fields for each tool. Search products, check prices and seller details, and read customer reviews.

+ hasdata_walmart_search_getSearchResults Search listings with q, catId or a Walmart search URL 11 params 10 credits

Try

Parameters of hasdata_walmart_search_getSearchResults
Parameter	Type	Required	Example
q	string	optional	"air fryer"
catId	string	optional	"976759_1086446_1229651"
domain	enum	optional	"walmart.com"
language	enum	optional	"en"
sort	enum	optional	"bestMatch"
url	string	optional	"https://www.walmart.com/search?q=air+fryer"
page	number	optional	1
minPrice	number	optional	50
maxPrice	number	optional	100
deliveryType	enum	optional	"shipping"
facet	string	optional	"brand:Ninja"

response

productResults
id
title
price
reviews
isSponsored
facets
pagination

+ hasdata_walmart_product_getWalmartProduct Read product details using itemId or a product URL 5 params 10 credits

Try

Parameters of hasdata_walmart_product_getWalmartProduct
Parameter	Type	Required	Example
itemId	string	optional	"14977205582"
url	string	optional	"https://www.walmart.com/ip/14977205582"
domain	enum	optional	"walmart.com"
language	enum	optional	"en"
otherOffers	boolean	optional	false

response

product
itemId
title
brand
price
seller
availability
currentSelection
variants
specifications

+ hasdata_walmart_reviews_getWalmartReviews Read written reviews using itemId or a product URL 10 params 10 credits

Try

Parameters of hasdata_walmart_reviews_getWalmartReviews
Parameter	Type	Required	Example
itemId	string	optional	"1028936148"
url	string	optional	"https://www.walmart.com/ip/1028936148"
domain	enum	optional	"walmart.com"
language	enum	optional	"en"
page	number	optional	1
sort	enum	optional	"mostRelevant"
rating	number	optional	1
aspectId	string	optional	"6049"
condition	string	optional	"5"
verifiedPurchasesOnly	boolean	optional	true

response

reviewsInformation
reviewResults
rating
title
text
verifiedPurchase
filters
pagination

Base calls cost 10 credits. Failed calls are not billed.

Connect

One endpoint, any MCP client

A config block for every major MCP client, in its native format. Authenticate with browser OAuth or an x-api-key header.

Claude Code

zsh — hasdata-walmart

$claude mcp add --transport http hasdata-walmart \

> https://mcp.hasdata.com/api/mcp?apis=walmart \

> --header "x-api-key: YOUR_API_KEY"

· One line, no restart. Run /mcp to confirm 3 tools.

Check the tools are thereIn the session

/mcp

hasdata-walmart · connected · 3 tools

Cursor

~/.cursor/mcp.json

{

"mcpServers": { "hasdata-walmart": {

"url": "https://mcp.hasdata.com/api/mcp?apis=walmart",

"headers": { "x-api-key": "YOUR_API_KEY" }

} }

}

· Add this entry to ~/.cursor/mcp.json. Servers already in the file stay as they are.

· Project-level config also works at .cursor/mcp.json

Check the tools are thereAfter saving the file

Settings → MCP

hasdata-walmart · 3 tools enabled

Claude Desktop

Recommended · OAuth connector

1.Settings → Connectors → Add custom connector

2.Paste https://mcp.hasdata.com/api/mcp?apis=walmart

3.Sign in with HasData

~/Library/Application Support/Claude/claude_desktop_config.json

{

"mcpServers": { "hasdata-walmart": {

"command": "npx",

"args": ["-y", "mcp-remote", "https://mcp.hasdata.com/api/mcp?apis=walmart",

"--header", "x-api-key:YOUR_API_KEY"]

} }

}

· Add this entry to ~/Library/Application Support/Claude/claude_desktop_config.json. Servers already in the file stay as they are.

· The config file only takes stdio servers, so a static key rides the mcp-remote bridge. On Windows the file lives at %APPDATA%\Claude\claude_desktop_config.json.

Check the tools are thereReopen the app

Settings → Connectors

hasdata-walmart · connected · 3 tools

VS Code / Copilot

.vscode/mcp.json

{

"servers": { "hasdata-walmart": {

"type": "http",

"url": "https://mcp.hasdata.com/api/mcp?apis=walmart",

"headers": { "x-api-key": "YOUR_API_KEY" }

} }

}

· Add this entry to .vscode/mcp.json. Servers already in the file stay as they are.

· Agent mode picks the server up on save.

Check the tools are thereAgent mode

Ctrl/⌘ + Shift + P → MCP: List Servers

hasdata-walmart · running · 3 tools

Windsurf

~/.codeium/windsurf/mcp_config.json

{

"mcpServers": { "hasdata-walmart": {

"serverUrl": "https://mcp.hasdata.com/api/mcp?apis=walmart",

"headers": { "x-api-key": "YOUR_API_KEY" }

} }

}

· Add this entry to ~/.codeium/windsurf/mcp_config.json. Servers already in the file stay as they are.

· Windsurf reads serverUrl, not url. Header auth only.

Check the tools are thereIn Cascade

Cascade → MCP servers

hasdata-walmart · 3 tools

Cline

cline_mcp_settings.json

{

"mcpServers": { "hasdata-walmart": {

"type": "streamableHttp",

"url": "https://mcp.hasdata.com/api/mcp?apis=walmart",

"headers": { "x-api-key": "YOUR_API_KEY" }

} }

}

· Add this entry to cline_mcp_settings.json. Servers already in the file stay as they are.

· Header auth only. The type field tells Cline this is a remote server, not a command.

Check the tools are thereIn the MCP panel

MCP Servers → Installed

hasdata-walmart · 3 tools

ChatGPT / Agents SDK

Recommended · OAuth connector

1.Settings → Security and login → Developer mode

2.Plugins → + → developer-mode app, paste https://mcp.hasdata.com/api/mcp?apis=walmart

3.Sign in with HasData

agent.py

from agents import Agent, HostedMCPTool

tool = HostedMCPTool(tool_config={

"type": "mcp",

"server_label": "hasdata-walmart",

"server_url": "https://mcp.hasdata.com/api/mcp?apis=walmart",

"authorization": "YOUR_API_KEY",

"require_approval": "never",

})

agent = Agent(name="Researcher", tools=[tool])

· The Agents SDK sends authorization as a Bearer token, which the endpoint accepts. The ChatGPT route needs no key: it signs in with OAuth.

Check the tools are thereRun the agent

Runner.run(agent, "…")

hasdata-walmart · 3 tools listed

Codex CLI

~/.codex/config.toml

[mcp_servers.hasdata-walmart]

url = "https://mcp.hasdata.com/api/mcp?apis=walmart"

env_http_headers = { "x-api-key" = "HASDATA_API_KEY" }

· Add this entry to ~/.codex/config.toml. Servers already in the file stay as they are.

· TOML, not JSON. Codex reads the key from the HASDATA_API_KEY environment variable, so export it in the shell that starts Codex.

Check the tools are thereIn the terminal

codex mcp list

hasdata-walmart · 3 tools

Gemini CLI

~/.gemini/settings.json

{

"mcpServers": { "hasdata-walmart": {

"httpUrl": "https://mcp.hasdata.com/api/mcp?apis=walmart",

"headers": { "x-api-key": "YOUR_API_KEY" }

} }

}

· Add this entry to ~/.gemini/settings.json. Servers already in the file stay as they are.

· httpUrl, not url: Gemini keeps url for SSE servers. Header auth only.

Check the tools are thereIn the session

/mcp

hasdata-walmart · 3 tools

Raw HTTP / curl

zsh — hasdata-walmart

$curl -N https://mcp.hasdata.com/api/mcp?apis=walmart \

> -H "x-api-key: YOUR_API_KEY" \

> -H "Content-Type: application/json" \

> -H "Accept: application/json, text/event-stream" \

> -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

· Fallback for any client not listed. Streamable HTTP wants both Accept types, and leaving one out returns 406.

Check the tools are thereCall it yourself

curl … tools/list

{ "tools": [ … 3 items ] }

Scope

Walmart plus whatever else you need

Name the services in the query string and the server exposes only their tools. Every one draws from the same key and the same balance.

Walmart 3 tools See the full MCP server →

https://mcp.hasdata.com/api/mcp?apis=walmart,google_serp,amazon

15tools in your server

Build vs Buy

Free on GitHub, paid in hours

Anyone can clone a free MCP to scrape Walmart. Whether that stays free depends on the shape of your project.

Scenario

A script I run once

Self-hosted from GitHubyour machine, your upkeep

$0/ mo, runs locally

+ 3–6 h onceof someone’s time

Setup (clone, wire, run)3–6 h once

Markup changesnot yet

Retries and concurrencynot needed

Proxy and hosting$0

Nothing to own. You get the answer and delete the folder.

mcp.hasdata.comFree tier

$0/ mo

+ 0 hof someone’s time

Setup one line

Parser upkeep included

Retries and concurrency included

~25 calls 250 of 1,000 credits

The free tier renews every month. No card.

leans self-hosted

Take the free repo

Nothing has to keep working tomorrow, so upkeep never appears. Both cost nothing, so take whichever is already in front of you.

A weekly report

Self-hosted from GitHubyour machine, your upkeep

$0–40/ mo

+ 2–4 h / moof someone’s time

Setup (proxy, hosting, wiring)3–6 h once

Markup changes2–4 h / mo

Retries and concurrency2–4 h once

Proxy and hosting$0–40 / mo

Someone looks at it when the numbers come back wrong, which is how you find out.

mcp.hasdata.comFree tier

$0/ mo

+ 0 hof someone’s time

Setup one line

Parser upkeep included

Retries and concurrency included

~100 calls a month 1,000 of 1,000 credits

Exactly the free tier, so a heavier month moves you to Startup.

dead even

Either works

The repo is free if you have somewhere to run it, ours is free up to the credit ceiling. The two to four hours a month decide it.

A pipeline in production

Self-hosted from GitHubyour machine, your upkeep

$40–120/ mo

+ 6–10 h / moof someone’s time

Setup (proxy, hosting, wiring)3–6 h once

Markup changes2–4 h / mo

Retries, concurrency, rate limits4–8 h once

Proxy and hosting$40–120 / mo

Someone owns this permanently, and it is never the top of their list.

mcp.hasdata.comStartup, 200K credits, 5 concurrent

$49/ mo

+ 0 hof someone’s time

Setup one line

Parser upkeep included

Retries and concurrency included

5,000 calls 50K of 200K credits

A quarter of the plan used, and the rest is headroom.

leans hosted

Use the hosted server

The proxy and hosting bill alone is in the range of the whole plan, and that is before anyone spends the six to ten hours.

A feature in my product

Self-hosted from GitHubyour machine, your upkeep

$300+/ mo

+ on-callof someone’s time

Setup (proxy, hosting, wiring)3–6 h once

Markup changes, plus on-call2–4 h / mo

Retries, concurrency, rate limitsongoing

Proxy and hosting$300+ / mo

The thing your customers touch depends on one volunteer's spare evening.

mcp.hasdata.comBasic, 1M credits, 15 concurrent

$99/ mo

+ 0 hof someone’s time

Setup one line

Parser upkeep included

Retries and concurrency included

50,000 calls 500K of 1M credits

Same endpoint at ten calls and at ten million. One invoice.

leans hosted

Use the hosted server

A third of the price, and nobody has to carry a pager for a dependency your customers touch.

Pricing

One balance, every interface

A flat monthly price against a known credit ceiling. Move up a plan when you outgrow it.

Free

$0 /mo

Free forever

100 tool calls / month

1,000 credits / month

1 concurrent request

Every MCP tool on every plan

Failed calls are not billed

One balance across MCP and REST

Community support

Start free

Startup

$49 /mo

$2.46 / 1k tool calls

20K tool calls / month

Billed annually Save $118

200K credits / month

5 concurrent requests

Every MCP tool on every plan

Failed calls are not billed

One balance across MCP and REST

Email support

Get started

Basic

Recommended

$99 /mo

$0.99 / 1k tool calls

100K tool calls / month

Billed annually Save $238

1M credits / month

15 concurrent requests

Every MCP tool on every plan

Failed calls are not billed

One balance across MCP and REST

Priority email support

Get started

Growth

$208 /mo

$0.69 / 1k tool calls

Billed annually Save $498

3M credits / month

50 concurrent requests

Every MCP tool on every plan

Failed calls are not billed

One balance across MCP and REST

Dedicated account manager

Get started

Monthly tool call volume

Free 20K 100K 300K 500K 1M 2M

Best fit

Basic

tool calls / mo

100K

Concurrency

$ / 1k tool calls

$0.99

Billed annually

$99 /mo

Get Started

Enterprise

Custom price based on required volume

Past 20M credits a month, or terms the self-serve plans do not cover. We shape the contract around your workload. Past 20M credits a month, or need terms the self-serve plans do not cover? We shape the contract, concurrency, and support around your workload.

Credits rollover

Unused credits carry into the next billing period.

Concurrency 2000+

Parallel request limits set to your peak load.

#1 request priority

Highest speed, always first in the queue.

Personal manager

A direct line to the founding team.

SSO

SAML single sign-on for the whole team.

SOC-2 compliance

Security review, DPA, and audit reports.

Talk to sales Quote within one business day

The same data, without the agent

▤ Walmart Scraper APIUse REST requests for product search, item details and reviews without an MCP client. Scraper API

FAQ

Before you wire it in

Is this Walmart's official MCP server?

No. HasData is an independent service for public Walmart data, not Walmart's seller or partner API. It cannot update listings, manage inventory or place orders. HasData is not affiliated with, endorsed by, or sponsored by Walmart. Walmart is a trademark of its respective owner.

Which inputs does the agent need?

Search needs a keyword, category ID or Walmart search URL. Product and review tools need an item ID or product URL. Search results expose product IDs for follow-up calls. A supplied URL determines the storefront and overrides the corresponding search or item parameters.

Can I select a Walmart store or ZIP code?

No. The tools do not accept a store or ZIP parameter. Walmart assigns the request's location, which can affect prices, pickup availability and delivery estimates. Do not treat the result as confirmed stock at a store of your choice.

Does it support Walmart Canada?

The tools accept walmart.com and walmart.ca through domain or a Walmart URL. Storefronts have separate catalogs and item IDs. Canadian search was verified in a recorded request. Product and review support is documented, but the examples on this page use Walmart.com.

How do competing seller offers affect a product call?

The price table covers the default product request. Enabling otherOffers collects competing seller offers through additional extraction and adds a charge even when none are found. Check the otherOffers option in the product documentation before enabling it.

Can the agent retrieve every matching product or review?

Pagination does not guarantee a complete catalog or review history. Walmart limits access to deeper search pages, and sponsored listings can repeat product IDs. Written review totals differ from rating totals. Use the returned pagination and deduplicate products by ID.

What happens if a call returns no useful data?

Check the tool result's status and body for errors or missing data before summarizing it. A recorded facet request returned HTTP 200 with an error instead of products. Check filter values, especially plus-containing facet strings, rather than treating HTTP success as proof of results.

Does the playground run a live agent?

No. It displays excerpts from recorded MCP calls with illustrative agent summaries. The product details and review values belong to those recordings. Connect your MCP client to make your own requests.

What happens when account credits run out?

Calls stop until the billing cycle renews or the account renews early. There is no metered overage. Concurrency depends on the selected plan, so limit parallel tool calls to that allowance.