/docs/api

API Documentation

The public Kroonen AI surface is small and intentionally so. A read-only telemetry endpoint streams the Genesis 1B training run, and a Turnstile-gated endpoint delivers contact messages. Everything below is documented in an OpenAPI 3.1 specification and is discoverable through the site's machine-readable catalog.

Catalog

API Catalog

GET /api/genesis-status None (public)

Genesis 1B training status

Returns the current training step, most recent loss, run state, and an ETA for the Genesis 1B one-billion-parameter run. Cached for 60 seconds. Safe for polling.

Example response

{
  "step": 41233,
  "loss": 2.7311,
  "state": "running",
  "etaMs": 1787000000000
}

POST /api/contact Turnstile-gated

Submit a contact message

Delivers a contact-form message via email. Requires a valid Cloudflare Turnstile token (action "contact") and a JSON body. This endpoint is intentionally human-gated and is not a target for automated agents; use it to reach a person.

Example response

{
  "success": true,
  "message": "Message sent successfully!"
}

Agent discovery documents

Kroonen AI publishes a full set of machine-readable discovery documents so autonomous agents can find, authenticate to, and use the site. They are linked from the homepage via Link response headers (RFC 8288).

/.well-known/api-catalog — RFC 9727 linkset catalog of the API.
/docs/openapi.json — OpenAPI 3.1 specification.
/.well-known/oauth-authorization-server — OAuth 2.0 metadata (RFC 8414).
/.well-known/oauth-protected-resource — protected resource metadata (RFC 9728).
/auth.md — agent registration instructions.
/.well-known/mcp/server-card.json — MCP server card (SEP-1649).
/.well-known/agent-skills/index.json — agent skills discovery index.
/.well-known/ai-catalog.json — ARD agentic resource manifest.