# Bestbuy — how to use (mcp.ai)

Connect your Bestbuy account and use 8 tools for ecommerce straight from your AI agent. Connect with your own API key. Best Buy offers a suite of APIs providing access to product, store, category, and recommendation data.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_bestbuy?ms=1787291400000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `bestbuy_get_categories`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/bestbuy`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/bestbuy/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/bestbuy/get/categories` — Tool to retrieve Best Buy product categories. Use when you need to list or filter categories in the catalog.
  - body: { id?: string, name?: string, page?: integer, show?: string, sort?: string, format?: string, pageSize?: integer }
- `POST https://api.mcp.ai/api/bestbuy/get/category/details` — Tool to retrieve detailed information about a Best Buy category by its ID. Use when you need enriched metadata about a specific category.
  - body: { id: string, page?: integer, show?: string, apiKey: string, format?: string, pageSize?: integer }
- `POST https://api.mcp.ai/api/bestbuy/get/product/details` — Tool to retrieve detailed information about a specific product by SKU. Use after obtaining a valid SKU to fetch its attributes.
  - body: { sku: string, show?: string, format?: string }
- `POST https://api.mcp.ai/api/bestbuy/get/products` — Tool to retrieve products from Best Buy. Use when you need to fetch product listings with optional filters and sorting. Example: 'Get products for category abcat0101000 sorted by salePrice.dsc.'
  - body: { sku?: integer|string, upc?: string, name?: string, page?: integer, show?: string, sort?: string, pageSize?: integer, salePrice?: string, categoryPath.id?: string }
- `POST https://api.mcp.ai/api/bestbuy/get/review/details` — Tool to retrieve detailed information for a specific review by ID. Use after confirming the review ID.
  - body: { id: string }
- `POST https://api.mcp.ai/api/bestbuy/get/reviews` — Tool to retrieve product reviews. Use when you need customer feedback with filters or sorting. Use after obtaining product SKUs.
  - body: { sku?: string, page?: integer, show?: string, sort?: string, format?: string, maxScore?: integer, minScore?: integer, pageSize?: integer, reviewer?: string }
- `POST https://api.mcp.ai/api/bestbuy/get/store/details` — Tool to retrieve detailed information about a specific Best Buy store. Use when you have a valid store ID.
  - body: { show?: string, storeId: string }
- `POST https://api.mcp.ai/api/bestbuy/get/stores` — Tool to retrieve a list of Best Buy stores. Use when you need store listings with optional filters or geo-search after confirming your API key.
  - body: { geo?: object, city?: string, page?: integer, show?: string, sort?: string, state?: string, region?: string, storeId?: integer, pageSize?: integer, services?: string, storeType?: string, postalCode?: string }

## Example prompts
- "What can I do in Bestbuy?"
- "Show me a summary of my Bestbuy account"

## More
- Page: https://mcp.ai/bestbuy
- Agent spec (llms.txt): https://mcp.ai/bestbuy/llms.txt
- Postman collection: https://mcp.ai/bestbuy/postman.json