{"apiVersion":"v1","directorySlug":"thepicks-mcp-459d3bbe0f","title":"ThePicks","description":"Discover beauty products picked by real people. Shop everyday favorites and exclusive finds. Exclusive Picks ship from the U.S.","pageUrl":"https://www.mcpbundles.com/skills/thepicks-mcp-459d3bbe0f","connectPath":"importable","connectAction":"import_server","catalogListing":false,"bundleSlug":null,"listingKind":"remote_mcp","kind":"provider","transportUrl":"https://api.thepicks.io/mcp","hostedMcpUrl":null,"toolCount":18,"toolInventoryStatus":"observed","refreshedAt":"2026-11-03T13:26:00.516172+00:00","registryName":"io.thepicks/thepicks-mcp-459d3bbe0f","registryVersion":"2026.11.3","registryEligible":true,"tools":[{"name":"search_products","description":"Search ThePicks for K-beauty products that real people picked for their shelves. Use for requests like \"a serum for oily skin\" or \"Beauty of Joseon sunscreen\". Supports keyword, category, brand and price filters. Returns products you can buy on thepicks.io, with prices in USD cents.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","properties":{"sort":{"enum":["relevance","popular","price_low","price_high","newest"],"type":"string"},"brand":{"type":"string","maxLength":60,"minLength":1},"limit":{"type":"integer","maximum":10,"minimum":1},"query":{"type":"string","maxLength":100,"minLength":2},"category":{"enum":["CLEANSER","TONER_MIST","ESSENCE","SERUM_AMPOULE","MOISTURIZER","SUNSCREEN","MASK","EYE_CARE","LIP_CARE","EXFOLIATOR","SPOT_CARE","BODY_CARE","HAIR_SCALP","SETS_BUNDLES","AMPOULE","EMULSION_LOTION","FACE_MIST","FACIAL_OIL","LIGHT_MOISTURIZER","CLEANSING_OIL","CLEANSING_BALM","MAKEUP_REMOVER","SCALP_CARE","SHAMPOO","HAND_CARE","FOOT_CARE","TOOLS_DEVICES","BEAUTY_SUPPLEMENTS"],"type":"string"},"maxPriceUsd":{"type":"number","maximum":10000,"minimum":0},"minPriceUsd":{"type":"number","maximum":10000,"minimum":0}}},"title":"Search K-beauty products","annotations":{"readOnlyHint":true,"untrustedContentHint":true},"logicalName":"search_products","displayName":"Search K-beauty products"},{"name":"get_product","description":"Get details for one ThePicks product by slug: price in USD cents, photos, key features, ratings, where it ships from, and comments from the people who picked it. Use after search results when the user wants to know more about a specific product.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["slug"],"properties":{"slug":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$","maxLength":200,"minLength":1}}},"title":"Get product details","annotations":{"readOnlyHint":true,"untrustedContentHint":true},"logicalName":"get_product","displayName":"Get product details"},{"name":"find_people","description":"Find people on ThePicks who share their K-beauty shelves, optionally by name or by skin type and skin concern (for example, people with dry skin who care about redness). Returns profile cards with a link to each shop.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","properties":{"sort":{"enum":["followers","popular","newest"],"type":"string"},"limit":{"type":"integer","maximum":10,"minimum":1},"query":{"type":"string","maxLength":60,"minLength":1},"concern":{"enum":["concern_blemishes","concern_dryness","concern_pores","concern_redness","concern_dark_spots","concern_fine_lines"],"type":"string"},"skinType":{"enum":["skin_type_oily","skin_type_dry","skin_type_combination","skin_type_sensitive","skin_type_normal"],"type":"string"}}},"title":"Find people to shop from","annotations":{"readOnlyHint":true,"untrustedContentHint":true},"logicalName":"find_people","displayName":"Find people to shop from"},{"name":"get_people_shop","description":"Open one person's ThePicks shop by shopSlug to see their shelves and the products on each, with their notes. Pass shelfSlug instead to open a single shelf. Use after find_people or when a product card shows who picked it.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","properties":{"shopSlug":{"type":"string","pattern":"^[a-z0-9][a-z0-9_-]*$","maxLength":100,"minLength":1},"shelfSlug":{"type":"string","pattern":"^[a-z0-9][a-z0-9_-]*$","maxLength":100,"minLength":1}}},"title":"Open a person's shop","annotations":{"readOnlyHint":true,"untrustedContentHint":true},"logicalName":"get_people_shop","displayName":"Open a person's shop"},{"name":"skin_match","description":"Match the user with people who share their skin type and concerns, plus the products those people use. Ask for skin type (or \"not_sure\") and up to two concerns (or [\"maintaining\"] if they just want to keep their skin as is). Pass productSlug to check how many matching people use one specific product.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["skinType","concerns"],"properties":{"category":{"enum":["CLEANSER","TONER_MIST","ESSENCE","SERUM_AMPOULE","MOISTURIZER","SUNSCREEN","MASK","EYE_CARE","LIP_CARE","EXFOLIATOR","SPOT_CARE","BODY_CARE","HAIR_SCALP","SETS_BUNDLES","AMPOULE","EMULSION_LOTION","FACE_MIST","FACIAL_OIL","LIGHT_MOISTURIZER","CLEANSING_OIL","CLEANSING_BALM","MAKEUP_REMOVER","SCALP_CARE","SHAMPOO","HAND_CARE","FOOT_CARE","TOOLS_DEVICES","BEAUTY_SUPPLEMENTS"],"type":"string"},"concerns":{"type":"array","items":{"anyOf":[{"enum":["concern_blemishes","concern_dryness","concern_pores","concern_redness","concern_dark_spots","concern_fine_lines"],"type":"string"},{"type":"string","const":"maintaining"}]},"maxItems":2},"skinType":{"enum":["skin_type_oily","skin_type_dry","skin_type_combination","skin_type_sensitive","skin_type_normal","not_sure"],"type":"string"},"productSlug":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$","maxLength":200,"minLength":1}}},"title":"Skin Match","annotations":{"readOnlyHint":true,"untrustedContentHint":true},"logicalName":"skin_match","displayName":"Skin Match"},{"name":"get_shipping_policy","description":"Get ThePicks shipping information for a country: whether ThePicks ships there, the free-shipping minimum, delivery time and duties. Shipping cost itself is calculated at checkout.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","properties":{"country":{"type":"string","pattern":"^[A-Za-z]{2}$"}}},"title":"Shipping policy","annotations":{"readOnlyHint":true,"untrustedContentHint":true},"logicalName":"get_shipping_policy","displayName":"Shipping policy"},{"name":"get_recommendations","description":"Get the most-picked K-beauty products on ThePicks right now, or products similar to one product (pass productSlug). Use when the user asks what is popular or wants alternatives.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","properties":{"limit":{"type":"integer","maximum":8,"minimum":1},"productSlug":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$","maxLength":200,"minLength":1}}},"title":"Popular picks","annotations":{"readOnlyHint":true,"untrustedContentHint":true},"logicalName":"get_recommendations","displayName":"Popular picks"},{"name":"cart_get","description":"Show the user's ThePicks cart in this chat: items, quantities, who gets credit, and an estimated total in USD cents. Use when the user asks what's in their cart.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","properties":{}},"title":"Show cart","annotations":{"readOnlyHint":true,"untrustedContentHint":true},"logicalName":"cart_get","displayName":"Show cart"},{"name":"cart_add","description":"Add a ThePicks product to the cart. Pass the product id (or slug) from a previous result and a quantity. If the product came from a person's shop, pass that person's shopSlug as peopleShopSlug with creditChoice \"shop\"; if the user asked to credit a specific person, use creditChoice \"user_choice\". Never guess a shopSlug.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","properties":{"quantity":{"type":"integer","default":1,"maximum":10,"minimum":1},"productId":{"type":"string","pattern":"^[a-f0-9]{24}$"},"productSlug":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$","maxLength":200,"minLength":1},"creditChoice":{"enum":["shop","user_choice"],"type":"string"},"peopleShopSlug":{"type":"string","pattern":"^[a-z0-9][a-z0-9_-]*$","maxLength":100,"minLength":1}}},"title":"Add to cart","logicalName":"cart_add","displayName":"Add to cart","annotations":{"untrustedContentHint":true,"readOnlyHint":true}},{"name":"cart_update","description":"Change the quantity of an item already in the ThePicks cart. Quantity 0 removes it. Use the productId from the cart.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["productId","quantity"],"properties":{"quantity":{"type":"integer","maximum":99,"minimum":0},"productId":{"type":"string","pattern":"^[a-f0-9]{24}$"}}},"title":"Change cart quantity","logicalName":"cart_update","displayName":"Change cart quantity","annotations":{"untrustedContentHint":true,"readOnlyHint":true}},{"name":"checkout_link","description":"Create a one-time link that opens this cart on thepicks.io, where the user enters shipping and pays. The link works once and expires after 10 minutes; if it expires, call this tool again. Payment never happens in chat.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","properties":{}},"title":"Get checkout link","logicalName":"checkout_link","displayName":"Get checkout link","annotations":{"untrustedContentHint":true,"readOnlyHint":true}},{"name":"order_status","description":"Check the status of orders the user placed on thepicks.io from a checkout link created in this chat: order number, status, and a link to the order page. Items, shipping details, refunds and cancellations are on that page.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","properties":{}},"title":"Check order status","annotations":{"readOnlyHint":true,"untrustedContentHint":true},"logicalName":"order_status","displayName":"Check order status"},{"name":"me_profile","description":"Return the id and display name of the ThePicks account connected to this chat (the nickname when one is set, otherwise the signup name). Use only to confirm which account is linked.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","properties":{}},"title":"Connected ThePicks account","annotations":{"readOnlyHint":true,"untrustedContentHint":true},"logicalName":"me_profile","displayName":"Connected ThePicks account"},{"name":"me_orders","description":"List the connected user's recent ThePicks orders: order number, status, items and total, with a link to each order page. Shipping address and payment details are only on that page. Refunds and cancellations happen on thepicks.io.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","properties":{"limit":{"type":"integer","default":5,"maximum":10,"minimum":1},"status":{"enum":["PAID","PROCESSING","SHIPPED","DELIVERED","CANCELED","REFUNDED","PARTIALLY_REFUNDED","REFUND_REQUESTED"],"type":"string"}}},"title":"My ThePicks orders","annotations":{"readOnlyHint":true,"untrustedContentHint":true},"logicalName":"me_orders","displayName":"My ThePicks orders"},{"name":"me_skin_profile","description":"Show the connected user's ThePicks skin profile (skin type, undertone, concerns, goals and other skin tags) plus the options available for each category. Use before me_skin_profile_update so you pass valid tagIds.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","properties":{}},"title":"My skin profile","annotations":{"readOnlyHint":true,"untrustedContentHint":true},"logicalName":"me_skin_profile","displayName":"My skin profile"},{"name":"me_skin_profile_update","description":"Replace the connected user's ThePicks skin profile with the given tagIds (from me_skin_profile options). Pass the full set the user wants to keep — tags not listed are removed. Confirm with the user before calling.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["tagIds"],"properties":{"tagIds":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9_]{1,64}$"},"maxItems":30,"minItems":1}}},"title":"Update my skin profile","logicalName":"me_skin_profile_update","displayName":"Update my skin profile","annotations":{"untrustedContentHint":true,"readOnlyHint":true}},{"name":"me_your_picks","description":"Products and people picked for the connected user from their ThePicks skin profile: personalized product picks and the people whose skin matches theirs. Needs a skin profile; otherwise say the user can set one up with me_skin_profile_update.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","properties":{"limit":{"type":"integer","default":8,"maximum":12,"minimum":1}}},"title":"My picks","annotations":{"readOnlyHint":true,"untrustedContentHint":true},"logicalName":"me_your_picks","displayName":"My picks"},{"name":"me_cart_merge","description":"Move the items in this chat's ThePicks cart into the connected user's ThePicks account cart. That cart is visible only in the ThePicks mobile app — the thepicks.io website keeps a separate cart and will not show these items; tell the user so. Only call when the user asks for it; this chat's cart is emptied. To buy on thepicks.io from this chat, use checkout_link instead.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","properties":{}},"title":"Move cart to my account","logicalName":"me_cart_merge","displayName":"Move cart to my account","annotations":{"untrustedContentHint":true,"readOnlyHint":true}}],"toolSource":"directory_preview","agentAction":"both","installLinks":[{"id":"cursor","label":"Cursor","href":"cursor://anysphere.cursor-deeplink/mcp/install?name=ThePicks&config=eyJ1cmwiOiAiaHR0cHM6Ly9hcGkudGhlcGlja3MuaW8vbWNwIn0%3D"},{"id":"vscode","label":"VS Code","href":"vscode:mcp/install?%7B%22name%22%3A%22ThePicks%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fapi.thepicks.io%2Fmcp%22%7D"},{"id":"vscode-insiders","label":"VS Code Insiders","href":"vscode-insiders:mcp/install?%7B%22name%22%3A%22ThePicks%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fapi.thepicks.io%2Fmcp%22%7D"},{"id":"claude-web","label":"Claude.ai","href":"https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=ThePicks&connectorUrl=https%3A%2F%2Fapi.thepicks.io%2Fmcp"},{"id":"codex","label":"Codex","copyText":"codex mcp add \"ThePicks\" --url \"https://api.thepicks.io/mcp\""},{"id":"chatgpt","label":"ChatGPT","href":"https://www.mcpbundles.com/docs/integrations/chatgpt"}],"catalogUrl":"https://www.mcpbundles.com/api/directory/v1/servers/thepicks-mcp-459d3bbe0f","callUrl":"https://www.mcpbundles.com/api/directory/v1/servers/thepicks-mcp-459d3bbe0f/tools/{tool}","mcpServerUrl":"https://api.thepicks.io/mcp","liveCatalogUrl":"https://www.mcpbundles.com/api/directory/v1/servers/thepicks-mcp-459d3bbe0f?live=1"}