soclasica_gift_ideas

What it does

soclasica_gift_ideas reads the Soclasica catalog and returns beauty gift ideas. You can start from one of eight gift guides, set a maximum price in US dollars, or combine both. Each result is a product record with a name, brand, price, stock state and link. Buying happens on soclasica.com.

The tool is class Read, so it changes nothing. It needs no account and is idempotent: the same arguments describe the same read. It is for gift discovery, not for orders or account settings.

When an assistant should call it

Call it when someone asks for beauty gift ideas and would benefit from a short, price-aware list: stocking fillers, secret Santa, gifts under $50, luxe gifts, gifts for her, for mum, for a beauty lover or a cosy theme. Use max_price_usd when the user gives a budget and omit it when the guide is enough.

Use the result to present options and send the buyer to the product URL on soclasica.com. Do not expect it to return order history, order status or marketing preferences; those belong to soclasica_list_my_orders, soclasica_get_order_status and soclasica_set_marketing_emails. For a general catalog search, soclasica_search_products is the separate tool on this website.

The free connector at https://onelifevibe.com/mcp/free is the no-sign-in, read-only, rate-limited route. The account connector at https://onelifevibe.com/mcp also serves it, but calls carry no token or identity there, so it never returns account data.

Inputs and an example call

All inputs are optional. guide accepts stocking-fillers, secret-santa, under-50, luxe, for-her, for-mum, beauty-lover or cosy. max_price_usd is an integer from 1 to 10000 and keeps only products at or under that price in US dollars. limit is an integer from 1 to 24 and sets how many products come back; the default is 12.

Example call on the free connector at https://onelifevibe.com/mcp/free: method tools/call, name soclasica_gift_ideas, arguments guide under-50 and limit 6. That asks for six Soclasica gift ideas from the under-50 guide. Leave guide out if you only want a price-capped list, and leave max_price_usd out if the guide is the only filter.

The tool becomes available on the connectors when soclasica.com lists it as an anonymous tool. Until then, the connectors do not offer it, so check availability before wiring a flow around it.

What comes back

A successful result has three parts. guide is either null or an object with slug, name and url for the selected guide. order_by describes the ordering the service used. products is the list of matching items.

Each product has slug, name, brand, price_cents, currency, in_stock and url. price_cents is the price in cents and currency names the currency, so format both together before showing a price. in_stock is the stock state. url is the product link on soclasica.com, where buying happens.

The shape is stable and contains no account data. That holds even when the call reaches the account connector: this tool is called with no token or identity there.

Errors, limits and safety

Validate inputs before sending. guide must be one of the eight listed values, max_price_usd must be an integer in 1 to 10000, and limit must be an integer in 1 to 24. An unknown guide or an out-of-range number is not a valid request. The default limit is 12, so set limit when you need a shorter answer.

The tool is non-destructive and idempotent; retrying the same read is safe from the tool's side. The free connector is rate-limited, so avoid tight retry loops and treat a throttled call as a reason to pause. If your client does not list soclasica_gift_ideas at all, check whether soclasica.com lists it as an anonymous tool; until it does, the connectors do not offer it.

Do not send an account token expecting this tool to use it. It needs no account and never returns account data. If you need order information, call the website's order tools instead.