Realry MCP Server
Search and compare fashion products on Realry.com directly from Claude AI. Realry aggregates 6,000+ brands across luxury and contemporary stores worldwide.
Connect to Claude
- 1. Open claude.ai and sign in
- 2. Click the grid icon → Connectors → Add custom connector
- 3. Enter the server URL:
https://realry.com/mcp
Requires a Claude Pro or Team plan. Alternatively, use the setup guide to generate a personal URL token.
Authentication
Option A — OAuth 2.1 (recommended)
Claude handles the full OAuth flow automatically. No manual token management needed.
| Step | What happens |
|---|---|
| 1 | Claude discovers OAuth server via /.well-known/oauth-authorization-server |
| 2 | User is redirected to Realry's consent page and clicks Allow |
| 3 | Claude receives an access token (1 hr) and refresh token (30 days) |
| 4 | Tokens are refreshed automatically — no re-auth required |
OAuth 2.1 Authorization Code + PKCE (RFC 7636). Realry never sees your Claude credentials.
Option B — Personal URL token (legacy)
Sign in at realry.com → My Account → MCP Token → Generate token. Use the personal URL as the connector URL: https://realry.com/mcp/{"{your-token}"}
Tools
All tools are read-only. No data is written to Realry or any external service.
search_products
Search Products
search_products
Search Products
Search fashion products. Put only the product in query (short noun phrase, 1-4 words); put gender, price, colour, and brand in their own parameters; use category only for whole-category or ambiguous queries. Sentences and extra words in query hurt relevance.
Bad: {"query": "women's black linen summer dress under $100"}. Good: {"query": "linen dress", "gender": "women", "colors": "black", "price_max": 100}. Good: {"query": "patagonia fleece", "brand": "Patagonia"}.
| Parameter | Type | Description |
|---|---|---|
query
*
|
string | Product as a short noun phrase (e.g. "linen dress", "running shoes"). No gender, price, colour or filler words. When the shopper named a brand, keep it in query and set brand too. |
page
|
number | Page number (default: 1) |
page_length
|
number | Results per page (default: 5, max: 36) |
sort
|
string | Omit for best match (default). new · likes · views · sales · pricelow · pricehigh |
price_min
|
number | Minimum price in the market currency for country (USD US, GBP GB, EUR euro markets, JPY JP, KRW KR) |
price_max
|
number | Maximum price in the market currency for country — e.g. "under $100" goes here as 100, not in query |
sale_only
|
boolean | Return only discounted products |
min_discount
|
number | Minimum discount % (e.g. 30) |
gender
|
string | women · men · kids |
category
|
string | CLOTHING · SHOES · BAG · ACC — set only for whole-category or ambiguous queries; ACC = accessories, jewellery, watches, eyewear, hats, fragrance & beauty |
brand
|
string | Brand name or slug (e.g. Nike). Keep the brand in query too; unknown brands are dropped from the filter only. |
colors
|
string | English colour names, comma-separated (e.g. "black" or "black,white") |
* required
get_price_comparison
Compare Prices
get_price_comparison
Compare Prices
Compare prices for a product across all stores carrying it, sorted cheapest first with direct purchase links.
| Parameter | Type | Description |
|---|---|---|
product_id
*
|
string | Product ID from search_products result |
* required
get_new_arrivals
New Arrivals
get_new_arrivals
New Arrivals
Browse the latest new arrivals, sorted by recency. Optionally filter by product keyword, price, gender, colour, brand, or category.
| Parameter | Type | Description |
|---|---|---|
query
|
string | Optional product as a short noun phrase (e.g. "linen dress", "running shoes"). No gender, price, colour or filler words — use the other parameters. |
page
|
number | Page number (default: 1) |
page_length
|
number | Results per page (default: 5, max: 36) |
sort
|
string | Omit for best match (default). new · likes · views · sales · pricelow · pricehigh |
price_min
|
number | Minimum price in the market currency for country (USD US, GBP GB, EUR euro markets, JPY JP, KRW KR) |
price_max
|
number | Maximum price in the market currency for country — e.g. "under $100" goes here as 100, not in query |
sale_only
|
boolean | Return only discounted products |
min_discount
|
number | Minimum discount % (e.g. 30) |
gender
|
string | women · men · kids |
category
|
string | CLOTHING · SHOES · BAG · ACC — set only for whole-category or ambiguous queries; ACC = accessories, jewellery, watches, eyewear, hats, fragrance & beauty |
brand
|
string | Brand name or slug (e.g. Nike). Keep the brand in query too; unknown brands are dropped from the filter only. |
colors
|
string | English colour names, comma-separated (e.g. "black" or "black,white") |
get_sale_products
Sale Products
get_sale_products
Sale Products
Browse products currently on sale, sorted by popularity. Filter by discount percentage, price range, gender, colour, brand, or category.
| Parameter | Type | Description |
|---|---|---|
query
|
string | Optional product as a short noun phrase (e.g. "linen dress", "running shoes"). No gender, price, colour or filler words — use the other parameters. |
page
|
number | Page number (default: 1) |
page_length
|
number | Results per page (default: 5, max: 36) |
sort
|
string | Omit for best match (default). new · likes · views · sales · pricelow · pricehigh |
price_min
|
number | Minimum price in the market currency for country (USD US, GBP GB, EUR euro markets, JPY JP, KRW KR) |
price_max
|
number | Maximum price in the market currency for country — e.g. "under $100" goes here as 100, not in query |
sale_only
|
boolean | Return only discounted products |
min_discount
|
number | Minimum discount % (e.g. 30) |
gender
|
string | women · men · kids |
category
|
string | CLOTHING · SHOES · BAG · ACC — set only for whole-category or ambiguous queries; ACC = accessories, jewellery, watches, eyewear, hats, fragrance & beauty |
brand
|
string | Brand name or slug (e.g. Nike). Keep the brand in query too; unknown brands are dropped from the filter only. |
colors
|
string | English colour names, comma-separated (e.g. "black" or "black,white") |
get_trending_products
Trending Products
get_trending_products
Trending Products
Browse products trending on Realry, ranked by user likes. Optionally filter by product keyword, price, gender, colour, brand, or category.
| Parameter | Type | Description |
|---|---|---|
query
|
string | Optional product as a short noun phrase (e.g. "linen dress", "running shoes"). No gender, price, colour or filler words — use the other parameters. |
page
|
number | Page number (default: 1) |
page_length
|
number | Results per page (default: 5, max: 36) |
sort
|
string | Omit for best match (default). new · likes · views · sales · pricelow · pricehigh |
price_min
|
number | Minimum price in the market currency for country (USD US, GBP GB, EUR euro markets, JPY JP, KRW KR) |
price_max
|
number | Maximum price in the market currency for country — e.g. "under $100" goes here as 100, not in query |
sale_only
|
boolean | Return only discounted products |
min_discount
|
number | Minimum discount % (e.g. 30) |
gender
|
string | women · men · kids |
category
|
string | CLOTHING · SHOES · BAG · ACC — set only for whole-category or ambiguous queries; ACC = accessories, jewellery, watches, eyewear, hats, fragrance & beauty |
brand
|
string | Brand name or slug (e.g. Nike). Keep the brand in query too; unknown brands are dropped from the filter only. |
colors
|
string | English colour names, comma-separated (e.g. "black" or "black,white") |
find_similar
Find Similar Products
find_similar
Find Similar Products
Find products similar to a given item. Ideal for "show me more like this" or "find alternatives".
| Parameter | Type | Description |
|---|---|---|
product_id
*
|
string | Product ID from search_products result |
* required
get_price_history
Price History
get_price_history
Price History
Get the 30-day price history of a product. Helps users decide if now is a good time to buy.
| Parameter | Type | Description |
|---|---|---|
product_id
*
|
string | Product ID from search_products result |
* required
get_deals
Hot Deals
get_deals
Hot Deals
Browse the hottest discounted products. Optionally filter by gender.
| Parameter | Type | Description |
|---|---|---|
gender
|
string | women · men. Omit for all. |
page_length
|
number | Results (default: 5, max: 36) |
search_brands
Search Brands
search_brands
Search Brands
Search for fashion brands by name. Returns brand IDs usable with get_brand_products.
| Parameter | Type | Description |
|---|---|---|
query
*
|
string | Brand name (e.g. "nike", "gucci", "zara") |
limit
|
number | Number of results (default: 8) |
* required
get_brand_products
Brand Products
get_brand_products
Brand Products
Get featured products from a specific brand. Use search_brands first to find the brand_id.
| Parameter | Type | Description |
|---|---|---|
brand_id
*
|
string | Brand ID from search_brands result |
* required
compare_products
Compare Products
compare_products
Compare Products
Compare 2–5 products side-by-side — shows best price, discount rate, and store count. Ideal for "which is cheaper?" questions.
| Parameter | Type | Description |
|---|---|---|
product_ids
*
|
array of string | List of 2–5 Product IDs to compare |
* required
Suggested Workflows
Search → Compare prices
search_products → get_price_comparison
"Find Nike Air Max and compare prices across stores"
Search → Find alternatives
search_products → find_similar
"Show me similar products to this jacket"
Search → Check price trend
search_products → get_price_history
"Is the price of this bag going up or down?"
Decide between options
search_products → compare_products
"Compare these 3 sneakers — which is the best deal?"
Brand exploration
search_brands → get_brand_products
"Show me Stone Island's featured items"
Deal hunting
get_sale_products
"Show me women's items with at least 30% off"
Protocol Reference
| Endpoint | https://realry.com/mcp |
| Transport | Streamable HTTP |
| Protocol version | 2024-11-05 |
| RPC format | JSON-RPC 2.0 |
| Authentication | OAuth 2.1 + PKCE (recommended) · Personal URL token (legacy) |
| Batch requests | Supported |
| CORS | Enabled (*) |
Supported methods
| Method | Description |
|---|---|
initialize |
Handshake — returns server info and capabilities |
tools/list |
Returns all 11 tools and their input schemas |
tools/call |
Executes a tool with given arguments |
ping |
Health check |
Data & Privacy
- ✓ Realry does not receive your Claude account credentials or personal information
- ✓ All tools are read-only — no user data is written or modified
- · Search queries are logged anonymously for service quality
- · Product links use Realry's redirect endpoint — affiliate tracking is server-side and transparent