IXORTA agent discovery

Public API and agent documentation

IXORTA exposes a small public API for health checks, quotation requests and read-only machinery discovery. The current public endpoints do not require authentication.

Discovery resources

API catalog/.well-known/api-catalog
OpenAPI description/openapi.json
Agent skills/.well-known/agent-skills/index.json
MCP server card/.well-known/mcp/server-card.json
Markdown homepage/index.md
Authentication policy/auth.md

Public endpoints

GET /api/health

Returns current public website API health and discovery links.

POST /api/quote

Accepts a name, email and project message. Email delivery requires the configured Resend environment variables. The website retains a visible mailto fallback.

GET or POST /api/mcp

Provides a public read-only MCP server supporting initialization, tool discovery and three safe tools: division discovery, contact lookup and quotation-link preparation.

Markdown content negotiation

Agents can request a canonical HTML page with Accept: text/markdown. The response is served as Content-Type: text/markdown with an estimated x-markdown-tokens header. Browsers continue receiving HTML by default.

Authentication

No OAuth or OpenID Connect flow is required for the current public endpoints. IXORTA does not publish fake authorization, token or registration endpoints.