# Retailed — how to use (mcp.ai)

Connect your Retailed account and use 6 tools for ecommerce straight from your AI agent. Connect with your own API key. Retailed is a global developer-first platform providing retail and resale marketplace APIs with access to product data, pricing information, and inventory management from major platforms like StockX, GOAT, Chrono24, and 50+ retail websites including sneakers, streetwear, watches, and luxury goods.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_retailed?ms=1787291280000`
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. `retailed_get_goat_prices`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/retailed`
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/retailed/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/retailed/get/goat/prices` — Tool to retrieve pricing information for a specific product on GOAT. Use when you need up-to-date size-based pricing. Call after confirming product_id.
  - body: { size?: string, country?: string, product_id: string }
- `POST https://api.mcp.ai/api/retailed/get/stock/x/product` — Tool to retrieve detailed StockX product information, including variant-level data. Use when you need comprehensive metadata from StockX by SKU or URL. Response is structured per variant; aggregate pr
  - body: { sku?: string, url?: string, include_market?: boolean }
- `POST https://api.mcp.ai/api/retailed/get/stockx/search` — Tool to search StockX marketplace for products and pricing information. Use when you have a search term and need up-to-date listings on StockX. Note: SKU identifiers and size labels in results may dif
  - body: { page?: integer, limit?: integer, query: string }
- `POST https://api.mcp.ai/api/retailed/get/stockx/trends` — Tool to get the latest trending products from StockX. Use when you want to discover current trending items.
  - body: { page?: integer, order?: string, sort_by?: string, per_page?: integer, product_type?: string }
- `POST https://api.mcp.ai/api/retailed/get/usage` — Tool to retrieve current API usage statistics. The only mechanism to check remaining API credits; call proactively before long-running analyses to prevent mid-run quota exhaustion.
- `POST https://api.mcp.ai/api/retailed/search/products` — Search for products in Retailed database matching query criteria. Uses Retailed's granular querying language with support for filtering by name, SKU, brand. SKUs and size labels are not standardized a
  - body: { page?: integer, sort?: string, limit?: integer, domain?: string, source?: string }

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

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