# H3aven developer resources

Machine-readable interfaces for agents and developers working with the public H3aven website. This hostname publishes a read-only site API, markdown content negotiation, and a Streamable HTTP MCP server. It does not expose authenticated product write APIs, OAuth, or webhooks.

## When to use these resources

Use them when an agent needs to explain what H3aven is, fetch the public contract-governance thesis, schedule a diagnosis, or attach H3aven as a read-only MCP server. Do not use them to mutate industrial contracts or to call private H3aven operational APIs.

## Public API

- Base: `https://h3aven.com/api/v1`
- OpenAPI: https://h3aven.com/openapi.json
- RFC 9727 catalog: https://h3aven.com/.well-known/api-catalog
- Errors: RFC 9457 `application/problem+json` with `code`, `detail`, and `resolution`

### Endpoints

- `GET /api/v1/site` — product overview and indexes
- `GET /api/v1/contact` — diagnosis calendar and WhatsApp
- `GET /api/v1/health` — liveness

No API key or OAuth is required. Unknown `/api` paths return JSON errors, not HTML.

## MCP server

- Streamable HTTP: https://h3aven.com/mcp
- Registry manifest: https://h3aven.com/server.json
- Server card: https://h3aven.com/.well-known/mcp/server-card.json
- AI catalog: https://h3aven.com/.well-known/ai-catalog.json

Tools: `h3aven_get_overview`, `h3aven_get_developer_resources`, `h3aven_get_contact`. All read-only.

## Markdown

Send `Accept: text/markdown` to `/`, `/team.html`, `/developers`, or any missing path. Responses use `Content-Type: text/markdown; charset=utf-8` and `Vary: Accept, Accept-Encoding`. Explicit siblings: `/index.md`, `/team.md`, `/developers.md`.

## Authentication and webhooks

The public website API and MCP server require no credentials. H3aven does not currently publish webhooks, event subscriptions, API keys, or OAuth on h3aven.com. Authenticated operational APIs live off this hostname; request access through a diagnosis.

## Site guide

- [llms.txt](https://h3aven.com/llms.txt)
- [sitemap.xml](https://h3aven.com/sitemap.xml)
- [Home](https://h3aven.com/)
- [Team](https://h3aven.com/team.html)