Luceed MCP

Read-only Model Context Protocol bridge to Tomsoft Luceed ERP web services (datasnap/rest).

Connect Claude, ChatGPT, Cursor, or any MCP client and ask things like “How much retail sales did we have last week?”

Coverage: 39 resources / 149 GET actions from Luceed Web Services 2.206. Write APIs (*/snimi, status mutations, etc.) are intentionally excluded.

Built by Debug Labs

Maintained by Debug Labs d.o.o. — a Croatia-based software company specializing in Luceed ERP integrations, Magento / e‑commerce sync, and custom B2B automation around Tomsoft Luceed.

If you need help wiring Luceed to your webshop, marketplace, BI tools, or AI assistants (this MCP included), get in touch:

• Website: https://debug-labs.hr

• GitHub: splacento-incomm/Luceed-mcp

This open-source MCP adapter is independent of Tomsoft. Luceed® is a product of Tomsoft d.o.o.

Related MCP server: Odoo MCP Improved

Official Luceed API docs

Luceed exposes a RESTful JSON API with HTTP Basic authentication. Access is granted per customer — contact the Luceed instance owner for credentials and allowed methods.

• Documentation hub: Luceed API | Tomsoft Docs

• Spec PDFs (HR / EN, v2.206) are linked from that page
  (pagination, changed-data only)

This MCP maps the documented GET surface into discoverable tools (luceed_catalog). Official field-level docs stay with Tomsoft and are not redistributed here.

Architecture

Claude / ChatGPT / Cursor
        │  MCP (stdio or Streamable HTTP)
        ▼
   luceed-mcp  (Node.js) — Debug Labs
        │  optional SSH -L tunnel (IP whitelist)
        ▼
   Luceed datasnap/rest  (HTTP Basic, GET only)

Requirements

• Node.js 20+

• Luceed API user (prefer read-only) + base URL

• Optional: SSH bastion if Luceed whitelists a single IP

Quick start (local / stdio)

git clone https://github.com/splacento-incomm/Luceed-mcp.git
cd Luceed-mcp
cp .env.example .env   # set LUCEED_* credentials
npm install
npm run build
npm run start:stdio

Cursor / Claude Desktop

{
  "mcpServers": {
    "luceed": {
      "command": "node",
      "args": ["/absolute/path/to/Luceed-mcp/dist/index.js"],
      "env": {
        "MCP_TRANSPORT": "stdio",
        "LUCEED_BASE_URL": "http://127.0.0.1:18080/datasnap/rest/",
        "LUCEED_USERNAME": "readonly_user",
        "LUCEED_PASSWORD": "secret"
      }
    }
  }
}

Remote deploy (Docker) — Claude + ChatGPT

Use HTTP transport behind a reverse proxy. Put the MCP on an unguessable path and require MCP_AUTH_TOKEN.

git clone https://github.com/splacento-incomm/Luceed-mcp.git
cd Luceed-mcp
cp .env.example .env
# MCP_TRANSPORT=http
# MCP_HTTP_PATH=/mcp-<long-random-token>
# MCP_AUTH_TOKEN=<another-long-secret>
# LUCEED_* (+ SSH_* if needed)

docker compose up --build -d
curl -s http://127.0.0.1:8080/healthz

Point Claude / ChatGPT custom MCP connectors at:

https://your-domain.example/mcp-<long-random-token>

with header Authorization: Bearer <MCP_AUTH_TOKEN>.

Full server notes: docs/SETUP.md.

Tools

Ask the model to call luceed_catalog first.

Resources

artikli, artikli_popusti, bundle, skladista, stanje_zalihe, stanje_zalihe_dobavljaci, stanje_zalihe_serijski, cijene, cjenik, cjenik_partner, akcije, prodajne_akcije, prodajni_uvjeti, partneri, users, mjesta, vrste_placanja, grupe_artikala, robne_marke, sifrarnici, statusi, prijevodi, varijante, bodovi, tecajna_lista, crm_razlozi, predmeti, mpracuni, mpobracun, nalozi_prodaje, vpracuni, racuni_predujma, narudzbe, nalozi_povrata, nalozi_proizvodnje, radni_nalozi, skladisni_dokumenti, hotel, poklon_bonovi

Example — luceed_nalozi_prodaje:

{
  "action": "statusi",
  "statusi": "01,02",
  "od_datuma": "2024-01-01",
  "do_datuma": "2024-01-31"
}

→ NaloziProdaje/statusi/[01,02]/1.1.2024/31.1.2024

Config

See .env.example and docs/SETUP.md.

Need a Luceed integration?

Debug Labs builds production Luceed connectors for e‑commerce, logistics, and reporting — Magento product/stock/order sync, B2B portals, and AI tooling like this MCP.

debug-labs.hr · open an issue on this repo for MCP-specific questions.

License

MIT — © Debug Labs d.o.o. / contributors

Luceed® / Tomsoft® names are trademarks of their respective owners. Official web-service documentation remains Tomsoft’s intellectual property and is not redistributed in this repository. See docs.tomsoft.hr/luceedapi.