# Veraius

> Agentic Resource Planning (ARP) platform: multi-tenant chat, retrieval-augmented answering over business data, action agents, and workflow orchestration. Public surfaces are discovery-only; every data API requires an OIDC bearer token.

Agents should authenticate first (see Authentication), then connect over MCP or call the versioned REST API under `/api/v1/`. Append `/index.md` to a public page path, or send `Accept: text/markdown`, to receive Markdown instead of HTML.

## Authentication

- [auth.md](https://web.veraius.com/auth.md): how an agent obtains a bearer token, end to end
- [Protected resource metadata](https://web.veraius.com/.well-known/oauth-protected-resource): RFC 9728
- [Authorization server metadata](https://web.veraius.com/.well-known/oauth-authorization-server): RFC 8414, includes the `agent_auth` extension
- [OpenID configuration](https://sso.veraius.com/realms/veraius/.well-known/openid-configuration): Keycloak issuer discovery

## Capabilities

- [MCP server card](https://web.veraius.com/.well-known/mcp/server-card.json): Streamable HTTP transport, tool list, auth scheme
- [Agent skills index](https://web.veraius.com/.well-known/agent-skills/index.json): published SKILL.md documents with digests
- [API catalog](https://web.veraius.com/.well-known/api-catalog): RFC 9727 linkset over every public surface
- [ARD manifest](https://web.veraius.com/.well-known/ard.json): Agentic Resource Discovery entries; search them at `POST https://web.veraius.com/ard/search`
- [OpenAPI](https://web.veraius.com/openapi/public.json): public endpoint schema

## Operations

- [Readiness](https://web.veraius.com/health/ready): dependency-aware readiness probe
- [Liveness](https://web.veraius.com/health/live): process liveness probe

## Optional

- [Full context](https://web.veraius.com/llms-full.txt): every document above inlined into one fetch
- [Sitemap](https://web.veraius.com/sitemap.xml): crawlable public pages
- [Signing keys](https://web.veraius.com/.well-known/http-message-signatures-directory): Web Bot Auth public keys