# Auro: public entry for agents

Documentation 2026.11.01.3 · Contract `auroflow/public-agent/v1`.

> Public reading needs no account. Execution requires a verified Auro account,
> its own agent credential, current account admission and compatible tools. Never ask for Google or SSH access.

## Connect and start

- [Connect your agent](https://auroflow.club/connect-agent.md): create your own revocable Bearer key, including Google accounts; HTTP or stdio setup and a no-generation connection check.
- [Compact first-run instructions](https://auroflow.club/agent-quickstart.md): one recipe, stable IDs, live zero-cost gates and same-ID recovery.
- MCP: `https://api.auroflow.club/v1/mcp`. Start with `auroflow_agent_start {}`.
- Resume through `auroflow_list {kind:"films", limit:5}` then `auroflow_get {view:"next"}` for an observed owned ID.
- Prefer `film`, `audio` or `graphics` discovery. Audio exposes 14 tools for narration, Vids Music, own sources and WAV mixes; filters do not change permissions.
- Store `AUROFLOW_API_TOKEN` in the original secure environment. Basic Auth remains an alternative. OAuth-only remote clients without headers or stdio are currently unsupported. Reading-only chats can prepare, not execute.

## Choose one maintained recipe

- [Voces, locución, canción y mezcla](https://auroflow.club/skills/auroflow-audio-production/SKILL.md): Voces de Vids, narración literal, disponibilidad musical y mezcla WAV de fuentes propias.
- [Montaje y mezcla de audio](https://auroflow.club/skills/auroflow-editing/SKILL.md): Ordenar y recortar tomas; editar voz, música, sonido y capas sin regenerar fuentes.
- [Empezar con Auroflow](https://auroflow.club/skills/auroflow/SKILL.md): Conexión, elección de receta y recuperación del mismo trabajo.
- [Películas, anuncios, documentales y series](https://auroflow.club/skills/auroflow-film-production/SKILL.md): Del resumen o la URL al guion, reparto, dirección visual, tomas y montaje; una receta por tipo de pieza.
- [Personajes e ingredientes](https://auroflow.club/skills/auroflow-ingredients-video/SKILL.md): Referencias visuales y Character con su voz guardada.
- [Textos, gráficas y motion graphics](https://auroflow.club/skills/auroflow-graphics-layers/SKILL.md): Títulos, rótulos, infografías y gráficas animadas (HyperFrames o Remotion) que se corrigen sin regenerar tomas.
- [Explicaciones cortas](https://auroflow.club/skills/auroflow-short-explainer/SKILL.md): Investigación, guion y diagramas originales con renderer local.
- [Narración, tiempos y subtítulos](https://auroflow.club/skills/auroflow-narration-timing/SKILL.md): Voz independiente con ElevenLabs, tiempos observados y subtítulos SRT/ASS por palabra.

## Read only what the operation needs

- [Versioned packages and hashes](https://auroflow.club/skills/manifest.json): selected bundles include mandatory shared references; credentials are separate.
- [General entry skill](https://auroflow.club/SKILL.md) and MCP resources/list + resources/read.
- [Voice gallery](https://auroflow.club/voces), [Vids narration contract](https://auroflow.club/vids-voices.md).
- [Audio production](https://auroflow.club/audio-production.md): literal narration, gated Vids Music and own-source WAV mixing with same-ID recovery. Vids Music requires live exact-zero checks; Flow Music remains a separate blocked included-budget provider.
- [Narration and editable finishing](https://auroflow.club/production-finishing.md): `auroflow_capabilities {area:"production"}` and pure `auroflow_plan_finishing`; owned completed WAV sources, typed graphics and same-ID recovery.
- [Searchable manual](https://auroflow.club/docs), [complete Markdown](https://auroflow.club/guide.md), [same text mirror](https://auroflow.club/llms-full.txt).
- [OpenAPI](https://api.auroflow.club/openapi.json): exact schemas when needed. [Changes](https://auroflow.club/agent-changelog.md).

## Invariants

Persist stable IDs and exact requests before writes. Planning is not authorization,
live readiness or a zero-cost quote. Check both Auro and Flow cost exactly zero
before each authorized render, with Agent disabled and owned references. Keep
spoken dialogue literal. After uncertainty read the SAME resource; never retry
Generate under a new ID. Check inner http_status/isError, current revisions and
bounded polling. Chrome, queues and server assembly stay on Auro. Completed
media and model transcripts are not human audiovisual approval. Jobs and videos
are visible in the verified-members community; prompts/references/email/balance
stay private. A titled showcase post needs a separate user instruction.

Public [service metadata](https://auroflow.club/service.json) is an aggregate;
account_check_required means consult your authenticated account. Key expiry,
promotion expiry and service access are distinct. Permanent accounts may be
exempt from a temporary-access expiry. Live account/capability checks prevail.
403 access_restricted is a current admission restriction even with valid
credentials; report it and never switch identities or roles to bypass it.