API & MCP

Everything a person can do on Trackwell SLA Calculator, a program or AI agent can do with the same inputs and get the identical result.

HTTP API

POST https://trackwellslacalculator.usefulweb.app/api/v1/calculate – run Trackwell SLA Calculator
GET https://trackwellslacalculator.usefulweb.app/api/v1/tool – inputs, output schema, examples
OpenAPI 3.1: /openapi.json · /openapi.yaml
Errors: application/problem+json; 422 includes per-field errors.

Trackwell SLA Calculator

Adds an SLA target (for example 4h or 2d of business time) to the moment a ticket was opened, skipping nights, weekends and holidays, and tells you the due time. With an “as of” or “stopped at” time it also shows elapsed business time, time left and whether the SLA was breached, minus paused periods such as “waiting for customer”.

Inputs of Trackwell SLA Calculator
Field	Type	Default	Description
`start` (required)	datetime	"2026-11-20T16:30"	Ticket opened at (local time)
`target`	text	"4h"	SLA target (business time). For example 30m, 4h, 1d 4h or 2d. One day = the length of one working day.
`days`	multiselect (sun, mon, tue, wed, thu, fri, sat)	["mon","tue","wed","thu","fri"]	Working days
`dayStart`	time	"09:00"	Working day starts
`dayEnd`	time	"17:00"	Working day ends
`utcOffset`	text	"+00:00"	UTC offset of these times. For example +01:00 for CET in winter. Fixed offset: daylight saving changes are not applied.
`holidays`	list	[]	Holidays (one date per line)
`asOf`	datetime	—	Check at (local time, optional). Shows elapsed and remaining business time at this moment.
`stop`	datetime	—	Responded or resolved at (optional). Stops the clock: the SLA was met or breached.
`pauses`	table	[]	Paused periods (waiting for customer). Local times as YYYY-MM-DDTHH:MM.

Example request

Incident opened Friday 16:30, 4 business hours, Mon–Fri 9–17

curl -X POST https://trackwellslacalculator.usefulweb.app/api/v1/calculate -H 'content-type: application/json' -d '{"start":"2026-11-20T16:30","target":"4h","asOf":"2026-11-23T10:00"}'

Every result contains

inputs (normalised, defaults applied), summary, result (validated against the published schema), units, assumptions, sources, warnings, computedAt and links.

MCP (Model Context Protocol)

Streamable HTTP endpoint: https://trackwellslacalculator.usefulweb.app/mcp – protocol revisions 2026-07-28 (stateless) and 2025-11-25 / 2025-06-18 / 2025-03-26 (initialize handshake).
Tools: trackwell_sla_calculator
Local stdio connector: node src/mcp-stdio.ts --tool=trackwell-sla-calculator

{
  "mcpServers": {
    "trackwell-sla-calculator": { "type": "http", "url": "https://trackwellslacalculator.usefulweb.app/mcp" }
  }
}