melba_catalogs_list
read-only
List catalogs. Returns every catalog owned by the calling organization. (scopes: catalogs:read)
Scopes: catalogs:read
Overview
The Melba MCP server exposes the Melba domain as Model Context Protocol primitives so any compliant client (Claude, ChatGPT, custom agents) can call Melba operations directly. The catalogue below is generated from the live /manifest.json endpoint at build time.
Tools
catalogs
melba_catalogs_create
Create a catalog. (scopes: catalogs:write)
Scopes: catalogs:write
melba_catalogs_get
read-only
Retrieve a single catalog by UUID. (scopes: catalogs:read)
Scopes: catalogs:read
melba_catalogs_update
Update a catalog by UUID. (scopes: catalogs:write)
Scopes: catalogs:write
melba_catalogs_delete
destructive
Delete a catalog by UUID. (scopes: catalogs:write)
Scopes: catalogs:write
orders
melba_orders_list
read-onlyhandcrafted
Search and list supplier purchase orders. Filter by status, supplier, date range. Use this to surface drafts that need sending or recent deliveries. (scopes: orders:read)
Scopes: orders:read
melba_orders_get
read-onlyhandcrafted
Retrieve a single supplier purchase order by UUID with all lines and totals. (scopes: orders:read)
Scopes: orders:read
recipes
melba_recipes_list
read-onlyhandcrafted
Search and list recipes from the calling organisation's catalogue. Supports free-text search, pagination, and tag filtering. Use this as the entry point before reading a single recipe or proposing a mutation. (scopes: recipes:read)
Scopes: recipes:read
melba_recipes_get
read-onlyhandcrafted
Retrieve a single recipe by its UUID with full composition (ingredients, sub-recipes, steps, costs). Returns 404 if the recipe is not in the organisation's catalogue. (scopes: recipes:read)
Scopes: recipes:read
Prompts
core
Plan mode — read before write, confirm before mutate
Use this prompt as a system instruction to enforce plan mode before any write/destructive action. Tells the LLM to read entities before mutating them, summarise the planned action in plain language, wait for explicit user confirmation, and require a verbatim echo for destructive operations.
melba_plan_mode
production
Plan production from upcoming sales
Aggregates sales for a target date, confronts the demand to current stock, and proposes a set of melba_tasks_create calls to cover the production gap.
melba_production_planning
stocks
Reorder low stock items by default supplier
Walks the LLM through identifying stocks below threshold, looking up the default supplier per product, grouping the deficit per supplier, and preparing one draft melba_orders_create payload per supplier.
melba_stock_reorder
finance
Invoice → purchase order proposal
Walks the LLM through extracting an invoice (PDF/image/paste), matching the supplier and line items against the user's Melba catalog, reconciling totals, and proposing a melba_orders_create call.
melba_invoice_analysisRecipe margin analysis with price + substitution proposals
Computes per-recipe cost-of-goods from composition + latest purchase prices, compares to selling prices on the chosen period, flags recipes below the target margin, and proposes two adjustment paths.
melba_margin_analysis
data
Free-form description → structured recipe
Walks the LLM through parsing a free-form recipe description, resolving ingredients and units against the catalog, applying Melba's recipe conventions, and proposing a melba_recipes_create call.
melba_recipe_creationCSV bulk import with confidence-scored column mapping
Profiles a CSV (delimiter, header, encoding), proposes a column→field mapping per Melba entity with a confidence score per column, lets the user confirm or correct the mapping, then bulk-imports.
melba_csv_import
hygiene
Weekly HACCP audit with anomaly flagging
Generates the HACCP report for the week (temperatures, cleaning, traceability) and flags anomalies for the user to review before producing the official PDF.
melba_haccp_audit
Resources
Units catalogue
JSON array of every Unit in the organisation's catalogue. Each entry carries id, name, symbol and conversion metadata. Read once at the start of a session to resolve unit names from natural language.
melba://catalogs/unitsAllergens catalogue
JSON array of every Allergen tracked by Melba (EU-14 + extras). Read when a user mentions an allergen by colloquial name to translate to the canonical UUID.
melba://catalogs/allergensStatus enums
Static catalogue of status enum values for Sale / Order / Task / Inventory. Use this to validate the status argument of any mutation tool before calling it.
melba://catalogs/status-valuesCurrencies catalogue
Reference list of currencies known to Melba (ISO 4217 code, name, symbol). Read to resolve a currency code from a natural-language mention before building a price / order payload.
melba://catalogs/currenciesOrganisations the current session can access
JSON array of organisations the authenticated user belongs to. REQUIRES an authenticated session. Cache is scoped to the session (1h) so a different api key sees a different list.
melba://catalogs/organizationsTop-100 suppliers of the current organisation
JSON listing of the org's top-100 suppliers (sorted by name asc). Use this to resolve a supplier name from natural language before crafting an Order payload.
melba://catalogs/suppliers