READ-ONLY DISTRIBUTION

Developer API and MCP

Use stable public metadata for calculator discovery, input schemas, formula descriptions, assumptions and review provenance. MyClockLedger does not expose browser-local values, drafts, favorites or calculation history.

Public API v1

API indexVersioned entry point and endpoint map.Calculator catalogAll calculators, categories, canonical URLs and provenance status.OpenAPI 3.1Machine-readable read-only API contract.Formula profilesReviewed versions, effective dates, scope and sources.Execution contractsAllowlisted schemas, formula versions, outputs and policy boundaries.

Individual records use https://api.myclockledger.com/v1/calculators/{slug}.json. Files are generated from the source registry during every production build.

Remote MCP server

The active MCP server is a separate Cloudflare Worker at https://mcp.myclockledger.com/mcp. Its health endpoint is https://mcp.myclockledger.com/health. It uses stateless Streamable HTTP and exposes metadata tools plus five strictly allowlisted planning calculations.

Current boundary: Execution tools accept only bounded numeric calculation fields defined in the public contract. They reject unknown fields, do not accept names or identifiers, do not persist inputs, and do not determine legal, payroll or tax compliance.

Versioning and provenance

API paths are versioned. Calculator records include canonical URLs, typed inputs, formula text, assumptions, privacy boundaries and formal review data where available. Breaking schema changes require a new API version.