# Promenaut for AI agents

Guidance for AI agents reading or integrating with promenaut.ai.

Promenaut is the agentic workforce platform for regulated enterprise: people and AI agents in one governed workforce, with the oversight, traceability and control a CIO can stand behind. The platform is provisioned per engagement and is not a self-serve public API.

## Reading the site

- Every page is server-side prerendered, so all content is available without executing JavaScript.
- Any page is also available as Markdown via content negotiation: send `Accept: text/markdown`.
- A site map for language models is at [/llms.txt](https://www.promenaut.ai/llms.txt).
- A full page list is at [/sitemap.xml](https://www.promenaut.ai/sitemap.xml).

## Focused docs

- [/api.md](https://www.promenaut.ai/api.md) — the public API (endpoints, versioning, errors, rate limits).
- [/auth.md](https://www.promenaut.ai/auth.md) — how access and authentication work.
- [/developers.md](https://www.promenaut.ai/developers.md) — developer overview.
- [/mcp.md](https://www.promenaut.ai/mcp.md) — MCP server status.
- [/openapi.json](https://www.promenaut.ai/openapi.json) — machine-readable API description.
- **MCP:** Streamable HTTP server at `https://www.promenaut.ai/api/mcp` (discovery: [/.well-known/mcp/server-card.json](https://www.promenaut.ai/.well-known/mcp/server-card.json)).
- **A2A:** Agent-to-Agent JSON-RPC endpoint at `https://www.promenaut.ai/api/a2a` (card: [/.well-known/agent-card.json](https://www.promenaut.ai/.well-known/agent-card.json)). Send `message/send` with a data part `{"skill":"submit_contact","input":{...}}`.

## Calling the API

The public endpoints accept and return JSON. Errors are structured JSON with `code`, `message`, and `hint`. Responses carry `X-API-Version` and an advisory `RateLimit-Policy` header. See [/api.md](https://www.promenaut.ai/api.md).

To reach the team programmatically (for example to request a demo), POST to `/api/v1/contact`. The API is zero-auth (no key needed); add `"test": true` to any request body to validate in sandbox mode without submitting anything.

## Getting platform access

Access to the Promenaut platform and any integration surface is arranged as part of an engagement, scoped to your environment. Email hello@promenaut.ai or use the contact endpoint.