ametller-origen-skill
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| ametller_get_shopping_guideA | Return the Ametller Origen shopping playbook: how to present products (ALWAYS as a photo-grid artifact), fill and review the real cart, and reorder past shops. Call this once at the start of any Ametller task — before searching or adding to the cart — and follow it. |
| ametller_auth_statusB | Check whether the Ametller Origen session is valid. |
| ametller_loginA | Open a browser window to sign in to Ametller Origen. The user logs in (and handles any 2FA); the session is then saved so all other tools work. Call this when not signed in, or when a tool reports the session expired. |
| ametller_search_productsA | Find a product and its id (needed before ametller_add_to_cart). Use a short term; Catalan works best (e.g. 'llet', 'pa'). Returns matches with ids and prices. |
| ametller_get_productA | Get details for a single product by id. |
| ametller_get_cartA | Show the current real shopping cart (items, quantities, total). |
| ametller_get_purchase_historyA | List past online orders (date, total, status, item count), by page or as the full bounded history. |
| ametller_get_order_itemsA | List the products in a past order (without adding anything). Defaults to the most recent order if order_id is omitted. |
| ametller_ingest_offline_ticketsA | Store normalized Ametller receipts already read through Claude's connected Gmail integration. Pass only receipt fields, never the raw email body. This is the primary offline-ticket path; it does not modify Gmail. |
| ametller_sync_offline_ticketsA | Optional local automation fallback: refresh the private ticket cache with Python 3 and an authenticated gws CLI. Prefer connected Gmail plus ametller_ingest_offline_tickets for normal users. |
| ametller_get_offline_ticketsA | Read privately cached offline Ametller shop tickets in bounded pages of at most 5, or set summary=true for compact frequent-product and category-leader analytics without returning raw receipts. Refresh with connected Gmail plus ametller_ingest_offline_tickets, or use the optional gws sync. |
| ametller_purchase_insightsA | Analyze full online order history plus optional cached offline tickets: frequent products, spend by month/category, official product images, and backtested repeat-purchase suggestions. In Claude Desktop, renders an interactive view; nothing is added unless the user checks products and presses the real-basket approval button. |
| ametller_add_to_cartA | Add a product to the real cart by id (get the id from ametller_search_products first). If already present, increases the quantity. Returns the updated cart with its total. |
| ametller_set_quantityA | Set the exact quantity of a product in the cart. Quantity 0 removes it. Returns the updated cart. |
| ametller_remove_from_cartA | Remove a product from the cart entirely. Returns the updated cart. |
| ametller_preview_reorder | Read a past order and revalidate each line against the current catalog, availability, pack, and quantity. Reports unresolved, unavailable, and promotion/bonus lines without changing the basket. Show this preview and obtain explicit approval before applying a reorder. |
| ametller_reorder_order | After ametller_preview_reorder and explicit user approval, freshly revalidate and add only the exact approved subset to the basket. Never checks out. Snapshots and verifies the existing basket, and restores it on any failed apply. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| Ametller purchase insights | Interactive purchase analytics and explicitly approved smart basket suggestions. |
TDQS
Scored across 15 tools
Most tools target distinct actions (auth, search, cart, history, offline tickets, insights), and descriptions clearly separate them. Minor overlap exists between remove_from_cart and set_quantity with quantity 0, and between ingest/sync_offline_tickets, but the descriptions resolve the intended use.
All tools share the ametller_ prefix and snake_case convention, and most use a clear verb_noun form such as search_products or add_to_cart. A few names omit the verb (auth_status, purchase_insights) and login is verb-only, so the pattern is not perfectly uniform.
Fifteen tools is at the top of the typical range but each maps to a distinct step in the shopping workflow: auth, discover, cart, history, offline tickets, and insights. It feels slightly heavy due to the meta shopping-guide tool and the fallback sync tool, but not bloated.
The surface covers auth, product lookup, full cart manipulation, order history and item retrieval, offline ticket ingest/reading, and analytics. Reordering is supported indirectly through get_order_items plus add_to_cart, and checkout appears intentionally left to the user's real-basket approval.