🛍️

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.

11 tools OAuth 2.1 + PKCE Streamable HTTP JSON-RPC 2.0 Read-only · No destructive actions

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 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

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

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

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

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 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 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

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 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 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 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

Support

📖 Setup guide ✉️ [email protected] 🌐 realry.com

Realry MCP — Developer Documentation

Realry MCP Server

Connect to Claude

Authentication

Tools

Suggested Workflows

Protocol Reference

Data & Privacy

Support

What are we styling?

Let’s find your look.

Which of these feel like you?

Swipe right on what you’d wear.

Any Brands or Stores you already love?

What are you shopping for most?

You’re all set.

Forget password

Reset Link Sent

Realry MCP Server

Connect to Claude

Authentication

Tools

Suggested Workflows

Protocol Reference

Data & Privacy

Support

Contact Sales

Preferences saved

What are we styling?

Welcome to Realry

Forget password

Reset Link Sent