API reference

Transcribe an audio file via a webhook-capable provider (Pattern 4). Returns a JobHandle; poll the get-job-status tool with the returned job_id (every 1-2s) until status is 'completed'. 2 credits per call.

Generate an image from a text prompt. Returns a JobHandle; poll the get-job-status tool with the returned job_id (every 1-2s) until status is 'completed'. 3 credits per call.

Fetch a URL and return a title + preview snippet. 1 credit per call.

Transcribe an audio file via a webhook-capable provider (Pattern 4). Returns a JobHandle; poll the get-job-status tool with the returned job_id (every 1-2s) until status is 'completed'. 2 credits per call.

Save a confirmed scanned item (product, expiry date, quantity).

Look up a product name by barcode: our own cache first, then Open Food Facts. Returns found=false if neither has it — caller falls back to manual name entry. Public (no auth required), same as the future standalone 'BiH Barcode Lookup' MCP server (PLAN.md).

Home-screen summary: active items split into red/yellow/green urgency bands (<=1 / 2-3 / 4-7+ days to expiry, DLCScan pattern from PLAN.md), plus totals.

Correct a data-entry mistake on an already-saved item — product name, expiry date, quantity, received date, or batch number. Distinct from expiry-update-quantity (daily recount ritual): this is for fixing a typo at any time, not the routine 'what's left today' check. Only fields actually provided are changed; the rest are left untouched.

List the caller's scanned items grouped by expiry date, optionally filtered to a date range and/or status (active/handled/all).

Mark a scanned item as handled (sold/removed), or soft-delete it.

Otpisano/vraćeno report for a date range (filtered on when it was resolved, not its expiry date) — product, expiry date, reason, quantity per row, plus totals. Feeds the dashboard card + print/PDF export.

Read the expiry date off a product-label photo via AI vision. Returns a suggestion for the caller to confirm/edit; does not save anything.

Resolve an item as 'otpisano' (written off/discarded), 'vraceno' (returned to supplier), or 'prodano' (sold, no write-off/return) for a specific quantity — works on an ACTIVE item (resolves it on the spot) or on an already-handled one (just re-annotates why, correcting a mis-click). A partial write-off is normal: quantity here can be less than the item's current stock (e.g. 3 of 10 spoiled, the rest still sold normally).

Update how many units of a scanned item are left (daily recount by staff — there is no POS integration, so this is the only way the app learns a sale happened). Reaching 0 auto-marks the item handled.

Generate an image from a text prompt. Returns a JobHandle; poll the get-job-status tool with the returned job_id (every 1-2s) until status is 'completed'. 3 credits per call.

Get the status, progress, and final result of an async job. Pass the job_id returned by an async tool (e.g. generate-image, transcribe-audio). Poll every 1-2 seconds (back off to 5-10s after 30s) until status is 'completed' (read the result field) or 'failed' / 'dead' (read error_message).

Fetch a URL and return a title + preview snippet. 1 credit per call.

Enqueue a slow doubling task and return a JobHandle; poll the get-job-status tool with the returned job_id (every 1-2s) until status is 'completed'.

Greet someone by name.