Consulta voar desde tu app de IA

Debes ser owner o admin de una organización de GitHub con voar instalado. En una app que admita servidores MCP remotos con OAuth, agrega esta dirección:

https://api.voar.dev/mcp

El transporte es Streamable HTTP: la conexión funciona por internet, sin instalar un servidor local de voar.

Cuando la app abra voar, inicia sesión, elige la organización y autoriza el acceso. Cada conexión recibe su propia clave de solo lectura. No pegues claves ni contraseñas en la conversación.

Después de conectar, pide:

Muéstrame los últimos 5 trabajos de mi organización y dime si alguno no pudo empezar.

La app puede consultar los trabajos y explicar su estado, costo y el motivo registrado cuando una máquina no arrancó. No puede leer los logs del trabajo.

• get_account: saldo, unidades gratis del mes, máquinas activas y trabajos en cola. Requiere account:read.
• list_jobs: trabajos recientes con estado, conclusión, tamaño de máquina, horarios, costo y el motivo si no arrancaron. Acepta limit de 1 a 100 y before en ISO 8601. Requiere jobs:read.
• get_usage: consumo y costo diarios de los trabajos terminados. Acepta month como AAAA-MM; si se omite, usa el mes actual en America/Sao_Paulo. Requiere usage:read.

La conexión solo consulta la organización elegida. No inicia ni cancela trabajos, no compra crédito ni cambia límites. No recibe código fuente, logs de ejecución, secretos del flujo de trabajo ni datos de tarjeta.

Para cortar el acceso, abre tu organización en el panel, ve a Configuración y revoca la clave de la app. Desconectar solo en la app de IA puede dejar la clave activa. También deja de funcionar si quien la autorizó sale de la organización o pierde el rol de owner o admin.

Abrir el panel

Ver cómo usan tus datos las apps de IA conectadas

Usa el endpoint anterior con un cliente MCP que admita OAuth 2.1 con PKCE. Un cliente que admita el encabezado Bearer también puede usar una clave creada en la Configuración de la organización. La API REST comparte los mismos permisos y datos.

Para probar la API REST, crea una clave con account:read, guárdala en VOAR_API_KEY y consulta el resumen de tu organización:

curl https://api.voar.dev/v1/account \  -H "Authorization: Bearer $VOAR_API_KEY"

Abrir la especificación OpenAPI

Una unidad es un minuto en la máquina de 2 vCPU. Las máquinas más grandes cuentan más unidades por minuto. Los campos que terminan en Micros usan millonésimas de la moneda que devuelve get_account.

Los agentes sin navegador local pueden acceder con un código de dispositivo y client_id=voar-agent. Inicia en /oauth/device_authorization, abre el verification_uri recibido, autoriza el código y consulta /oauth/token con el intervalo indicado.

• Si la app vuelve a pedirte acceso o devuelve 401, la clave ya no sirve: se revocó, la GitHub App salió de la organización o quien la autorizó dejó de ser owner o admin. Conecta de nuevo con una cuenta owner o admin. Una clave revocada no se puede recuperar.
• Si recibes 403, la clave se creó sin el permiso que pide la herramienta. En Configuración, crea otra clave con el permiso que falta.
• Si no puedes autorizar otra conexión, revoca una clave que no uses en Configuración e inténtalo otra vez. La lista incluye las claves creadas por apps de IA.
• Si recibes 429, espera el tiempo indicado en Retry-After antes de reintentar. Las claves de la misma organización comparten el límite.
• Si tu app no admite un servidor remoto con OAuth, usa un cliente MCP que lo admita o consulta la API REST con una clave.