Luceed MCP
OfficialServer Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| SSH_ENABLED | No | Whether to open a local SSH forward for an IP-whitelisted Luceed instance. | |
| MCP_HTTP_PATH | No | The unguessable HTTP path for the MCP endpoint, e.g. `/mcp-a8f3…`. | |
| MCP_TRANSPORT | No | The MCP transport to use: `stdio` (default) or `http`. | |
| MCP_AUTH_TOKEN | No | Bearer / `X-API-Key` token required when using HTTP transport. | |
| LUCEED_BASE_URL | Yes | The Luceed API base URL. Must include `/datasnap/rest/`. | |
| LUCEED_PASSWORD | Yes | Luceed API password (HTTP Basic auth). | |
| LUCEED_USERNAME | Yes | Luceed API username (HTTP Basic auth; prefer a read-only user). |
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 |
|---|---|
| luceed_catalogB | List all mapped Luceed read-only resources/actions/paths. Filter with resource id or magento_only=true for endpoints used by Magento Debuglabs/Luceed. |
| luceed_pingA | Health check: verify Luceed credentials/connectivity via skladista/lista. |
| luceed_artikliC | Products (artikli): Product catalog: by code, barcode, UID, name, group, brand, attribute, list. Actions: sifra, sifradio, barcode, uid, naziv, lista, grupa, grupa_naziv, robna_marka, robna_marka_naziv, atribut, dokumenti, dodaci, prijevodi, sastavnice_sifra, sastavnice_uid. |
| luceed_artikli_popustiC | Items on sale / discounts: Articles currently on sale (artiklipopusti). Actions: lista, sifra. |
| luceed_bundleC | Bundle items: Bundle article definitions and components. Actions: lista, lista_uid, lista_b2b. |
| luceed_skladistaC | Warehouses: Warehouse and business unit master data. Actions: lista, sifra. |
| luceed_stanje_zaliheC | Stock status: Stock and availability by warehouse / article / barcode / attribute. Actions: skladiste, skladiste_artikl, vrsta_skladista, vrsta_skladista_artikl, artikl, barcode, artikl_uid, atribut. |
| luceed_stanje_zalihe_dobavljaciC | Supplier stock: Supplier stock levels (StanjeZaliheDobavljaci). Actions: lista, artikl, dobavljac, artikl_dobavljac. |
| luceed_stanje_zalihe_serijskiC | Serial-number stock: Stock status by serial number. Actions: artikl, serijski. |
| luceed_cijeneB | Current prices: Current selling price including promotions. Actions: sifra, barcode, partner, loyalty. |
| luceed_cjenikC | Price list: Service partner price list. Actions: lista. |
| luceed_cjenik_partnerC | Partner price list: Partner-specific price lists and diffs. Actions: sifra, uid, getdiff. |
| luceed_akcijeC | Sales campaigns 1.0: Promotional campaigns (akcije). Actions: lista. |
| luceed_prodajne_akcijeC | Sales campaigns 2.0: Sales campaigns v2 (prodajneakcije). Actions: lista. |
| luceed_prodajni_uvjetiD | Sales conditions: Sales conditions for partners. Actions: partneri. |
| luceed_partneriC | Partners / customers: Partner master data lookup. Actions: sifra, oib, naziv, prezime, email, uid, gln, grupa, nivo, korisnici. |
| luceed_usersC | Users: Loyalty / web users (read). Actions: listatip, listaprezime, listaime, uid, username. |
| luceed_mjestaC | Locations / cities: Places (mjesta) — Magento uses mjesta/list for full list. Actions: list, sifra, naziv, postanskibroj. |
| luceed_vrste_placanjaC | Payment types: Payment type master data. Actions: list. |
| luceed_grupe_artikalaC | Product groups: Article groups. Actions: lista, sifra, naziv, dodaci. |
| luceed_robne_markeC | Brands: Brand / robne marke list. Actions: lista. |
| luceed_sifrarniciC | Code lists: Generic Luceed code lists (countries, etc.). Magento uses drzava. Actions: list, list_one, fulllist, info, naziv, sifra, uid. |
| luceed_statusiC | Statuses: Status definitions by domain. Actions: lista, domena, nalozi_prodaje. |
| luceed_prijevodiC | Translations: Translation records for tables. Actions: lista. |
| luceed_varijanteC | Variants: Product variants. Actions: lista. |
| luceed_bodoviC | Scoring / points: Loyalty scoring system data. Actions: lista. |
| luceed_tecajna_listaC | Exchange rates: Currency exchange rate list. Actions: lista. |
| luceed_crm_razloziC | CRM visit causes: CRM visit reason codes. Actions: lista. |
| luceed_predmetiC | Cases (predmeti): CRM / case records. Actions: lista, sifra, uid. |
| luceed_mpracuniC | Retail invoices: Maloprodajni računi — list and fetch retail invoices. Actions: lista, uid, broj, nalogprodaje, barcode, pdf. |
| luceed_mpobracunB | Retail sales calculations: Retail turnover by payment type or by product — use for 'how much sales'. Actions: placanja, artikli. |
| luceed_nalozi_prodajeA | Sales orders (nalozi prodaje): B2B / wholesale sales orders — heavily used by Magento sync. IMPORTANT: Luceed does NOT sort or paginate. For 'latest N orders' prefer tool luceed_recent_sales_orders (it sorts by date/number). Raw statusi results are unsorted and require a status filter. Actions: statusi, partner, izmjena_status, uid, b2b, dokumenti, placanja_predujmom, dokumenti_isporuke_uid, dokumenti_isporuke_b2b, prijevoznica_pdf. |
| luceed_vpracuniC | Wholesale invoices: VP računi — wholesale invoices. Actions: uid, broj, nalogprodaje, lista_period, lista_partner, lista_skladiste, pdf. |
| luceed_racuni_predujmaD | Advance payment invoices: Računi predujma. Actions: uid, b2b, pdf. |
| luceed_narudzbeC | Purchase orders (narudžbe): Purchase orders — retrieve and status changes. Actions: statusi, partner, partner_statusi, izmjena_status, uid, broj, zaprimljene_kolicine. |
| luceed_nalozi_povrataC | Return orders: Return orders (NaloziPovrata). Actions: uid, b2b, izmjena_status, zaprimljene_kolicine. |
| luceed_nalozi_proizvodnjeC | Production orders: Production orders (NaloziProizvodnje). Actions: uid, statusi, partner, izmjena_status, dokumenti_isporuke_uid, dokumenti_isporuke_b2b. |
| luceed_radni_naloziC | Work / service orders: Radni nalozi (service work orders). Actions: uid, webkod, partner, partner_uid, stavke. |
| luceed_skladisni_dokumentiC | Warehouse documents: Skladišni dokumenti. Actions: uid, barcode. |
| luceed_hotelC | Hotel: Hotel reservations, registrations, guest overview. Actions: rezervacije_lista, rezervacije_uid, prijave, lista, gosti. |
| luceed_poklon_bonoviC | Gift vouchers: Gift voucher validity / balance. Actions: stanje. |
| luceed_recent_sales_ordersA | PREFERRED for 'last N sales orders / nalozi prodaje'. Fetches NaloziProdaje by status + date window, dedupes, sorts newest-first (datum then broj), and returns only |
| luceed_retail_sales_summaryA | Convenience: retail sales totals by payment type for a PJ + date range (wraps mpobracun/placanja). Prefer this for 'how much sales'. |
| luceed_retail_sales_by_productC | Convenience: retail sales by product (wraps mpobracun/artikli). |
| luceed_getA | Raw read-only GET for any relative datasnap/rest path not covered (or for ad-hoc exploration). Mutating paths blocked when LUCEED_READ_ONLY=true. Prefer catalog tools when possible. Example: artikli/sifra/111 |
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 45 tools
Several tools share overlapping domains, such as sales campaigns v1 vs v2, retail sales wrappers vs raw mpobracun, stock status variants (regular, supplier, serial), and multiple order types, which can cause misselection. However, descriptions often clarify use cases and explicitly state preferences (e.g., 'PREFERRED for last N sales orders'), mitigating some confusion.
All tools use a consistent luceed_ prefix and snake_case, making names predictable. However, the set mixes resource-name tools (luceed_artikli, luceed_partneri) with convenience/action tools (luceed_retail_sales_summary, luceed_recent_sales_orders, luceed_get) rather than a uniform verb_noun pattern.
With 45 tools, the set is heavy for an agent to manage, and several tools could be consolidated (sales campaign versions, retail sales wrappers, stock status variants). While the ERP domain is broad, the volume risks overwhelming agents and increases selection difficulty.
For a read-only ERP integration, the surface covers most major resources (products, stock, prices, partners, orders, invoices, CRM, hotel) and includes luceed_get and luceed_catalog for ad-hoc gaps. Write operations are largely absent, but this appears intentional for the read-only scope.