appie-mcp
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
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| ah_loginA | Check authentication status or verify session with Albert Heijn. Returns member identity, Bonus card details, and connection status. |
| ah_get_profileA | Get customer loyalty profile, name, email, and 13-digit Bonus card number. |
| ah_search_productsA | Search the Albert Heijn grocery catalog by keyword. Returns matching products with current prices, previous prices, active bonus discounts, unit prices, and web links. Results are cached for up to 30 minutes. |
| ah_get_productA | Get detailed information for a specific Albert Heijn product: description, nutritional values, allergens, unit sizes, and pricing. Product pages are cached for up to 24 hours. |
| ah_get_product_alternativesA | Find direct brand alternatives, store-brand swaps, or dietary substitutes for a product. Cached for up to 24 hours. |
| ah_get_categoriesA | Get top-level supermarket product shelves and categories (e.g. Aardappel/groente/fruit, Bakkerij, Zuivel). Cached for up to 24 hours. |
| ah_get_bonus_offersA | Browse active national Bonus folder discounts, promotions (e.g. 1+1 gratis, 2e halve prijs), and validity windows. The folder is far larger than one page: walk |
| ah_get_personal_bonusA | Retrieve the 5 personalized weekly Bonus Box promotions for the logged-in Albert Heijn member. Cached for up to 30 minutes. |
| ah_get_shopping_listA | Get the user's primary in-app shopping list ('Boodschappenlijst'): items, free-text notes, and checked states. Always fetched live, never cached. |
| ah_add_to_shopping_listA | Add one or more free-text items or products to the user's Albert Heijn shopping list. WRITES to the real AH account. |
| ah_remove_from_shopping_listB | Remove an item from the primary shopping list by its item ID. |
| ah_get_favorite_listsA | Get user's saved custom favorite lists (e.g. 'Weekly Staples', 'Party') with item counts. |
| ah_check_favorite_list_itemB | Tick an item off as collected (checked=true) or un-tick it in a favorite list. |
| ah_list_receiptsA | List in-store cash register receipts (kassabonnen) with date, store name, and total. Pagination is real: page and size walk the whole history, and a size above 100 is fetched in 100-row windows. Always fetched live, never cached. |
| ah_get_receipt_detailsA | Get detailed line items, unit prices, discounts, and total amount for a specific store receipt. A closed receipt is immutable, so it is cached for 30 days. |
| ah_get_promo_digestA | Answer 'of the things I frequently buy, what is on Bonus discount right now?'. Mines receipts inside the requested window — paging back to the oldest receipt that falls in it, up to 150 — and cross-references them against active offers. |
| ah_search_recipesA | Search the official Albert Heijn Allerhande recipe collection by dish name, ingredient, or keyword. Cached for up to 24 hours. |
| ah_get_recipe_detailsA | Get full cooking steps and structured ingredient list (with product mappings) for an Allerhande recipe. Cached for up to 24 hours. |
| ah_search_storesA | Search nearby Albert Heijn stores by postal code or city name to check opening hours, distance, and facilities. Cached for up to 24 hours. |
| ah_get_clearance_bargainsA | Fetch today-only dynamic clearance markdowns (vandaag-af / 35% discount items) for a given store ID. Cached for up to 30 minutes. |
| ah_get_search_suggestionsA | Get search autocompletion suggestions and related grocery query keywords from Albert Heijn. Cached for up to 30 minutes. |
| ah_get_predictive_favoritesA | Fetch predictive favorite recommendations and frequently reordered products predicted by Albert Heijn. Cached for up to 30 minutes. |
| ah_activate_personal_bonusB | Activate selected weekly Bonus Box promotions for a given Bonus card number. |
| ah_get_products_bulkA | Fetch product details in bulk for multiple Albert Heijn product IDs (e.g. ['wi196825', 'wi187593']). Cached for up to 24 hours. |
| ah_get_sub_categoriesA | Fetch child subcategories for a specific supermarket category ID. Cached for up to 24 hours. |
| ah_get_cartA | Read-only view of the user's active Albert Heijn online shopping cart and order summary. Always fetched live, never cached. |
| ah_cache_statsA | Report the in-process response cache: enabled state, hits, misses, hit rate, stored entries and evictions. Use to verify that cached Albert Heijn responses are reused instead of re-fetched. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 27 tools
Most tools target an unambiguous resource+action pair (search_products vs get_product vs get_products_bulk, get_bonus_offers vs get_personal_bonus vs activate_personal_bonus). The main overlap is ah_login vs ah_get_profile, which both return member identity and Bonus card details, plus mild overlap between ah_get_search_suggestions and ah_search_products. ah_cache_stats is a developer/meta tool sitting among user-facing ones, but it is still clearly distinct.
All tools use a consistent ah_ prefix with snake_case and a verb_noun pattern (get_*, search_*, add_*, remove_*, activate_*, check_*, list_*). Minor deviations exist: ah_login is a bare verb and ah_cache_stats is noun-only without an action verb. Otherwise highly predictable.
27 tools is heavy and sits at the top of the scale, though the grocery domain is genuinely broad (catalog, categories, stores, bonus, receipts, lists, recipes, profile). Some tools feel like internal plumbing rather than agent primitives (ah_cache_stats, ah_get_promo_digest could arguably fold into bonus tools). Borderline heavy but not gratuitous.
Coverage is strong: read paths for products, categories, stores, recipes, receipts, bonus offers and lists, plus writes for shopping list and Bonus activation. The notable gap is the cart, which is read-only (ah_get_cart) with no add-to-cart or quantity update, and favorite lists cannot be created or edited beyond checking items. Agents can work around the cart gap by using the shopping list.