# Shopping price and stock MCP server for AI agents (/use-cases/shopping-prices)

Ask "where is the Nintendo Switch 2 cheapest right now, and who has it?" and your agent gets one price-sorted list. Each offer has its store, price and in-stock flag. It works in Claude, ChatGPT, Cursor and your own code.

## What you can call

| Function                                                   | What it does                                                                                                                          |
| ---------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| `bowmark.retail.search`                                    | Searches Walmart and Target in one call and returns price-sorted offers. Best Buy joins when you add your own Best Buy developer key. |
| `bowmark.pcparts.search`                                   | Compares PC parts prices across stores.                                                                                               |
| `bowmark.providers.walmart`, `target`, `bestbuy`, `amazon` | One store at a time, including product pages.                                                                                         |

## Try it

```js
const { results, warnings } = await bowmark.retail.search({ query: "Nintendo Switch 2" });
const inStock = results.filter(
  (o) => /switch 2/i.test(o.title) && o.inStock && o.price !== null,
);
return { cheapest: inStock[0] ?? null, warnings };
```

Stores return keyword matches, so accessories appear too. Filter on the title as above before reading the top price.

Add the MCP server to Claude Code with this command, then ask your agent. Other clients are on [Installation](/docs/installation).

```sh
claude mcp add bowmark --transport http https://api.bowmark.ai/mcp --header "Authorization: Bearer $BOWMARK_API_KEY"
```

## FAQ

### Does it show stock?

Yes. Each offer carries that store's own in-stock flag.

### Does it buy things?

No. It returns the product link and you buy on the store's site.

### Does it cover Amazon?

Not in the `retail.search` call. Amazon has its own functions on [its site page](/sites/amazon).

### What if a store does not answer?

The response has a `warnings` list that names it, so you never report "cheapest" from half the market.

### What does it cost?

Your first $10 is free, then you pay per call. See [Pricing](/docs/pricing).

## Next

Follow the [Quickstart](/docs/quickstart), or see [Walmart](/sites/walmart), [Target](/sites/target) and [Best Buy](/sites/bestbuy).
