skip to main content
Browse documentation

Syncanix with Express

Make an Express API agent-ready: what discovery reads, how to run it, and how to ship the chat surface and MCP server.

Express apps compose routes across files โ€” a router defined in one module, mounted under a prefix in another. Syncanix discovery follows those mounts statically and emits full paths, so the catalog matches what your API actually serves.

What discovery reads

Discovery is static โ€” it reads your source, not your traffic. It composes full request paths across files, so mounted prefixes are part of every extracted route:

// app.ts
app.use('/api', ordersRouter);

// orders.router.ts
const ordersRouter = Router();
ordersRouter.get('/orders/:id', getOrder);      // โ†’ GET /api/orders/:id
ordersRouter.post('/orders/:id/refund', refund); // โ†’ POST /api/orders/:id/refund
Representative routes the extractor composes โ€” full paths, prefixes included.

The extractor follows app.use(prefix, router) mounts and Router().use() chains across files โ€” including default-imported routers โ€” so a route declared as /orders/:id inside a router mounted at /api is catalogued as GET /api/orders/:id.

Run discovery

From the repository root, run the init command. It detects the framework automatically, asks for consent before any LLM enrichment, and writes a deterministic catalog:

$ npx syncanix init
โœ“ detected framework
โœ“ scanned routes
โœ“ wrote .syncanix/catalog.json
โ†’ review your capabilities in the dashboard

Review the catalog

The catalog at .syncanix/catalog.json lists every capability discovery found โ€” method, path, and the enriched description your users will see. Review it like code before uploading: it is the contract your chat surface and MCP server expose.

Ship the surface

Once the catalog is uploaded, embed the widget for in-app chat and connect the per-tenant MCP server for Claude, ChatGPT, and Cursor. Every write action stays permission-gated, confirmed, and audited.

Next steps