{
  "info": {
    "name": "Bestbuy — mcp.ai",
    "description": "REST API for the Bestbuy MCP. Set {{apiKey}} to a workspace key (sk_live_…) created at https://mcp.ai/settings/api-keys.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{apiKey}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.mcp.ai/api/bestbuy",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "sk_live_...",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "bestbuy_get_categories",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/categories",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "categories"
          ]
        },
        "description": "Tool to retrieve Best Buy product categories. Use when you need to list or filter categories in the catalog.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": \"\",\n  \"name\": \"\",\n  \"page\": 0,\n  \"show\": \"\",\n  \"sort\": \"\",\n  \"format\": \"\",\n  \"pageSize\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "bestbuy_get_category_details",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/category/details",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "category",
            "details"
          ]
        },
        "description": "Tool to retrieve detailed information about a Best Buy category by its ID. Use when you need enriched metadata about a specific category.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": \"\",\n  \"page\": 0,\n  \"show\": \"\",\n  \"apiKey\": \"\",\n  \"format\": \"\",\n  \"pageSize\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "bestbuy_get_product_details",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/product/details",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "product",
            "details"
          ]
        },
        "description": "Tool to retrieve detailed information about a specific product by SKU. Use after obtaining a valid SKU to fetch its attributes.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"sku\": \"\",\n  \"show\": \"\",\n  \"format\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "bestbuy_get_products",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/products",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "products"
          ]
        },
        "description": "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": {
          "mode": "raw",
          "raw": "{\n  \"sku\": \"\",\n  \"upc\": \"\",\n  \"name\": \"\",\n  \"page\": 0,\n  \"show\": \"\",\n  \"sort\": \"\",\n  \"pageSize\": 0,\n  \"salePrice\": \"\",\n  \"categoryPath.id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "bestbuy_get_review_details",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/review/details",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "review",
            "details"
          ]
        },
        "description": "Tool to retrieve detailed information for a specific review by ID. Use after confirming the review ID.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "bestbuy_get_reviews",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/reviews",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "reviews"
          ]
        },
        "description": "Tool to retrieve product reviews. Use when you need customer feedback with filters or sorting. Use after obtaining product SKUs.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"sku\": \"\",\n  \"page\": 0,\n  \"show\": \"\",\n  \"sort\": \"\",\n  \"format\": \"\",\n  \"maxScore\": 0,\n  \"minScore\": 0,\n  \"pageSize\": 0,\n  \"reviewer\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "bestbuy_get_store_details",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/store/details",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "store",
            "details"
          ]
        },
        "description": "Tool to retrieve detailed information about a specific Best Buy store. Use when you have a valid store ID.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"show\": \"\",\n  \"storeId\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "bestbuy_get_stores",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/stores",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "stores"
          ]
        },
        "description": "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": {
          "mode": "raw",
          "raw": "{\n  \"geo\": {},\n  \"city\": \"\",\n  \"page\": 0,\n  \"show\": \"\",\n  \"sort\": \"\",\n  \"state\": \"\",\n  \"region\": \"\",\n  \"storeId\": 0,\n  \"pageSize\": 0,\n  \"services\": \"\",\n  \"storeType\": \"\",\n  \"postalCode\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    }
  ]
}