ProductSource

https://productsource.io/docs
Admin
ProductSource provides real-time product data from over 450 retailers, including pricing, images,...
Tokens:4,045
Snippets:51
Trust Score:3.5
Update:1 month ago
Show doc for...
Tokens:
Raw
### get_new_listings

Source: https://productsource.io/docs

Get products newly discovered at retailers in the last N hours.

```APIDOC
## MCP Tool: get_new_listings

### Description
Products newly discovered at retailers in the last N hours. Be the first to know about new drops, restocks, and launches.

### Method
MCP Tool

### Endpoint
`get_new_listings`

### Parameters
- **hours** (int) - Optional - Default 24
- **category** (string) - Optional - Filter by category
- **brand** (string) - Optional - Filter by brand
- **retailer** (string) - Optional - Filter by retailer
- **limit** (int) - Optional - Default 50

### Response
Returns products newly listed at retailers.
```

--------------------------------

### Add ProductSource MCP server to Codex

Source: https://productsource.io/docs

Adds the ProductSource MCP server to Codex. Requires a free API key; replace YOUR_API_KEY with your actual key.

```bash
codex mcp add product-source --transport http https://mcp.productsource.io/mcp --header "Authorization: Bearer YOUR_API_KEY"
```

--------------------------------

### lookup_product

Source: https://productsource.io/docs.html

The core tool. Look up any product by UPC — returns everything: title, brand, description, images, specs, prices at every retailer, marketplace sell prices, margin estimates, and availability.

```APIDOC
## MCP Tool: lookup_product

### Description
Look up any product by UPC. Returns complete product data including title, brand, description, images, specs, prices at every retailer, marketplace sell prices, margin estimates, and availability.

### Method
MCP Tool

### Endpoint
lookup_product

### Parameters
- **upc** (string) - Required - 12 or 13 digit UPC/GTIN barcode

### Response
Structured JSON with complete product data.
```

--------------------------------

### MCP Config for ProductSource

Source: https://productsource.io/docs

MCP configuration for any MCP-compatible client. Uses streamable-http transport and requires a Bearer token.

```json
{
  "mcpServers": {
    "product-source": {
      "type": "streamable-http",
      "url": "https://mcp.productsource.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
```

--------------------------------

### search_products

Source: https://productsource.io/docs.html

Search the entire product catalog by keyword, brand, or category. Returns matching products with current lowest price.

```APIDOC
## MCP Tool: search_products

### Description
Search the entire product catalog by keyword, brand, or category. Returns matching products with current lowest price.

### Method
MCP Tool

### Endpoint
search_products

### Parameters
- **query** (string) - Required - Search query
- **brand** (string) - Optional - Filter by brand
- **category** (string) - Optional - Filter by category
- **limit** (int) - Optional - Default 25, max 100

### Response
Structured JSON with matching products and current lowest price.
```

--------------------------------

### Add ProductSource MCP server to Claude Code

Source: https://productsource.io/docs

Adds the ProductSource MCP server to Claude Code. Requires a free API key; replace YOUR_API_KEY with your actual key.

```bash
claude mcp add product-source --transport http https://mcp.productsource.io/mcp --header "Authorization: Bearer YOUR_API_KEY"
```

--------------------------------

### compare_prices

Source: https://productsource.io/docs.html

Compare current prices for a product across all retailers and marketplaces. Sorted lowest to highest with shipping costs and tax.

```APIDOC
## MCP Tool: compare_prices

### Description
Compare current prices for a product across all retailers and marketplaces. Sorted lowest to highest with shipping costs and tax.

### Method
MCP Tool

### Endpoint
compare_prices

### Parameters
- **upc** (string) - Required - UPC/GTIN barcode

### Response
Structured JSON with price comparisons sorted lowest to highest, including shipping costs and tax.
```

--------------------------------

### get_new_listings

Source: https://productsource.io/docs.html

Products newly discovered at retailers in the last N hours. Be the first to know about new drops, restocks, and launches.

```APIDOC
## MCP Tool: get_new_listings

### Description
Products newly discovered at retailers in the last N hours. Be the first to know about new drops, restocks, and launches.

### Method
MCP Tool

### Endpoint
get_new_listings

### Parameters
- **hours** (int) - Optional - Default 24
- **category** (string) - Optional - Filter by category
- **brand** (string) - Optional - Filter by brand
- **retailer** (string) - Optional - Filter by retailer
- **limit** (int) - Optional - Default 50

### Response
Structured JSON with newly listed products.
```

--------------------------------

### compare_prices

Source: https://productsource.io/docs

Compare current prices for a product across all retailers and marketplaces.

```APIDOC
## MCP Tool: compare_prices

### Description
Compare current prices for a product across all retailers and marketplaces. Sorted lowest to highest with shipping costs and tax.

### Method
MCP Tool

### Endpoint
`compare_prices`

### Parameters
- **upc** (string) - Required - 12 or 13 digit UPC/GTIN barcode

### Response
Returns price comparison data sorted lowest to highest.
```

--------------------------------

### lookup_product

Source: https://productsource.io/docs

The core MCP tool to look up a product by UPC and retrieve complete product data.

```APIDOC
## MCP Tool: lookup_product

### Description
Look up any product by UPC and retrieve complete product data including title, brand, description, images, specs, prices at every retailer, marketplace sell prices, margin estimates, and availability.

### Method
MCP Tool

### Endpoint
`lookup_product`

### Parameters
- **upc** (string) - Required - 12 or 13 digit UPC/GTIN barcode

### Response
Returns structured JSON with complete product data.
```

--------------------------------

### Authentication header

Source: https://productsource.io/docs

Authentication header for all API requests. Replace ps_live_your_api_key with your actual API key.

```http
Authorization: Bearer ps_live_your_api_key
```

--------------------------------

### check_availability

Source: https://productsource.io/docs.html

Check in-stock status at specific retailers or across all 450+ sources. Know where to buy right now.

```APIDOC
## MCP Tool: check_availability

### Description
Check in-stock status at specific retailers or across all 450+ sources. Know where to buy right now.

### Method
MCP Tool

### Endpoint
check_availability

### Parameters
- **upc** (string) - Required - UPC/GTIN barcode
- **retailers** (string array) - Optional - List of retailers to check

### Response
Structured JSON with in-stock status.
```

--------------------------------

### get_images

Source: https://productsource.io/docs

Retrieve all product images from every retailer, deduplicated.

```APIDOC
## MCP Tool: get_images

### Description
Every product image from every retailer, deduplicated. Multiple angles, lifestyle shots, packaging — all in one call.

### Method
MCP Tool

### Endpoint
`get_images`

### Parameters
- **upc** (string) - Required - 12 or 13 digit UPC/GTIN barcode

### Response
Returns deduplicated product images from all retailers.
```

--------------------------------

### search_products

Source: https://productsource.io/docs

Search the product catalog by keyword, brand, or category.

```APIDOC
## MCP Tool: search_products

### Description
Search the entire product catalog by keyword, brand, or category. Returns matching products with current lowest price.

### Method
MCP Tool

### Endpoint
`search_products`

### Parameters
- **query** (string) - Required - Search keyword
- **brand** (string) - Optional - Filter by brand
- **category** (string) - Optional - Filter by category
- **limit** (int) - Optional - Default 25, max 100

### Response
Returns matching products with current lowest price.
```

--------------------------------

### get_images

Source: https://productsource.io/docs.html

Every product image from every retailer, deduplicated. Multiple angles, lifestyle shots, packaging — all in one call.

```APIDOC
## MCP Tool: get_images

### Description
Every product image from every retailer, deduplicated. Multiple angles, lifestyle shots, packaging — all in one call.

### Method
MCP Tool

### Endpoint
get_images

### Parameters
- **upc** (string) - Required - UPC/GTIN barcode

### Response
Structured JSON with deduplicated product images.
```

--------------------------------

### find_deals

Source: https://productsource.io/docs.html

Find products with the highest verified margin between retail source price and marketplace sell price.

```APIDOC
## MCP Tool: find_deals

### Description
Find products with the highest verified margin between retail source price and marketplace sell price.

### Method
MCP Tool

### Endpoint
find_deals

### Parameters
- **category** (string) - Optional - Filter by category
- **brand** (string) - Optional - Filter by brand
- **min_margin** (number) - Optional - Default 20%
- **limit** (int) - Optional - Default 25

### Response
Structured JSON with products and their margins.
```

--------------------------------

### find_deals

Source: https://productsource.io/docs

Find products with the highest verified margin between retail source price and marketplace sell price.

```APIDOC
## MCP Tool: find_deals

### Description
Find products with the highest verified margin between retail source price and marketplace sell price.

### Method
MCP Tool

### Endpoint
`find_deals`

### Parameters
- **category** (string) - Optional - Filter by category
- **brand** (string) - Optional - Filter by brand
- **min_margin** (number) - Optional - Default 20%
- **limit** (int) - Optional - Default 25

### Response
Returns products with highest verified margin.
```

--------------------------------

### check_availability

Source: https://productsource.io/docs

Check in-stock status at specific retailers or across all sources.

```APIDOC
## MCP Tool: check_availability

### Description
Check in-stock status at specific retailers or across all 450+ sources. Know where to buy right now.

### Method
MCP Tool

### Endpoint
`check_availability`

### Parameters
- **upc** (string) - Required - 12 or 13 digit UPC/GTIN barcode
- **retailers** (string array) - Optional - List of retailer names

### Response
Returns in-stock status at specified retailers or all sources.
```

--------------------------------

### get_price_history

Source: https://productsource.io/docs

Retrieve historical price data for a product.

```APIDOC
## MCP Tool: get_price_history

### Description
Historical price data for a product across retailers and marketplaces. See trends, spot drops, time your buys.

### Method
MCP Tool

### Endpoint
`get_price_history`

### Parameters
- **upc** (string) - Required - 12 or 13 digit UPC/GTIN barcode
- **days** (int) - Optional - Default 30, max 365

### Response
Returns historical price data.
```

--------------------------------

### get_price_history

Source: https://productsource.io/docs.html

Historical price data for a product across retailers and marketplaces. See trends, spot drops, time your buys.

```APIDOC
## MCP Tool: get_price_history

### Description
Historical price data for a product across retailers and marketplaces. See trends, spot drops, time your buys.

### Method
MCP Tool

### Endpoint
get_price_history

### Parameters
- **upc** (string) - Required - UPC/GTIN barcode
- **days** (int) - Optional - Default 30, max 365

### Response
Structured JSON with historical price data.
```
Tokens:
Raw