# Arrakis para agentes

Tu agente puede buscar en el mercado, alquilar una GPU, ejecutar su trabajo y apagar la máquina. Tú decides el presupuesto antes de empezar y no puede superarlo.

Arrakis ofrece MCP por HTTP en streaming desde la misma dirección que este sitio, en `/mcp`. No hay nada que instalar. A continuación, `$ARRAKIS_URL` es la dirección de este sitio y `ark_...` es un token de API.

## Conéctate en tres pasos

1. **Crea un token para tu agente.** En la consola, abre API & agents y elige un token para un agente: alcances read y rent, un límite de gasto y una duración máxima de alquiler. Desde la CLI:

   ```sh
   arrakis tokens create --name eval-agent \
     --scope read --scope rent \
     --spend-limit 50 --max-rental-hours 6 --expires-in 7d
   ```

2. **Añade el endpoint MCP.** Usa el token como cabecera bearer.

   Claude Code:

   ```sh
   claude mcp add --transport http arrakis $ARRAKIS_URL/mcp \
     --header "Authorization: Bearer ark_..."
   ```

   Cursor (`~/.cursor/mcp.json`):

   ```json
   {
     "mcpServers": {
       "arrakis": {
         "url": "$ARRAKIS_URL/mcp",
         "headers": { "Authorization": "Bearer ark_..." }
       }
     }
   }
   ```

   Cualquier cliente: transporte HTTP en streaming (streamable HTTP), URL `$ARRAKIS_URL/mcp`, cabecera `Authorization: Bearer ark_...`.

   Local, por stdio: `ARRAKIS_TOKEN=ark_... ARRAKIS_BASE_URL=$ARRAKIS_URL arrakis mcp`.

3. **Dale una tarea.** Indica cuánto tiempo puede vivir la máquina; tu agente lo pasa como hora de eliminación. Por ejemplo: «Ejecuta mi suite de evaluación en una H100: alquila una durante 3 horas, ejecuta python eval.py, trae de vuelta results/ y luego elimínala».

## Qué no puede hacer tu agente

- Gastar por encima del límite de su token.
- Alquilar una máquina sin hora de eliminación.
- Alquilar más tiempo que la duración máxima de alquiler del token.
- Crear un token con más permisos que el suyo.
- Ver o tocar las máquinas de otra cuenta.
- Añadir fondos. Eso solo lo hacen los pagos confirmados.

## Doce herramientas

| Herramienta | Qué hace | Coste |
|---|---|---|
| `search_gpus` | Lista las máquinas disponibles, las mejores primero según lo que puede hacer la GPU, su precio y lo fiable que es su host, con filtros por GPU, número, memoria, precio por GPU-hora y país. Propone una y explica por qué. | Gratis |
| `get_market_summary` | El precio más bajo y la oferta de cada familia de GPU en este momento. | Gratis |
| `get_balance` | El saldo de la cuenta, el coste por hora de las máquinas en marcha, cuándo se acaba el dinero y el límite del token. | Gratis |
| `rent_gpu` | Alquila una máquina durante como máximo `termination_hours` y devuelve su comando SSH, el coste en el peor caso y cuántas horas cubre el saldo. Un reintento devuelve la misma máquina. | El precio por hora, hora a hora, hasta la eliminación |
| `list_images` | Las imágenes que puede arrancar una máquina: las de Arrakis y las de la cuenta, incluidas las privadas. `rent_gpu` también acepta cualquier imagen pública. | Gratis |
| `list_instances` | Las máquinas que la cuenta tiene en marcha. | Gratis |
| `get_instance` | El estado de una máquina, su comando SSH, su hora de eliminación y cualquier aviso de su host. | Gratis |
| `get_events` | Qué ha pasado con las máquinas de la cuenta: cuáles están listas, cuáles han terminado y por qué (si las retiró su host o no), y los avisos de sus hosts. | Gratis |
| `terminate_instance` | Detiene una máquina al momento. La facturación se detiene con ella. | Pone fin a los cargos |
| `schedule_removal` | Cambia la hora de eliminación de una máquina. | Cambia el coste máximo |
| `get_partner_earnings` | Para socios: tus códigos, el enlace y el mensaje para compartir, los clientes que has traído, lo que has ganado y lo que puedes retirar, y si el programa de socios está abierto. | Gratis |
| `join_partner_program` | Se une al programa de socios en nombre de la cuenta, si su propietario está de acuerdo: un código de socio, un enlace y un mensaje para compartir. | Gratis |

## Por qué el gasto sin supervisión es seguro

Estas reglas se aplican en la propia API, así que valen igual para MCP, la CLI y HTTP directo.

- **Límites de gasto.** Un token con límite calcula cada alquiler en el peor caso, el precio por hora multiplicado por las horas hasta la eliminación, y rechaza el que superaría el límite.
- **Eliminación obligatoria.** Un token con límite no puede alquilar sin `termination_hours` ni por encima de su duración máxima de alquiler.
- **Reintentos seguros.** La misma `idempotency_key` siempre devuelve la misma máquina. Un reintento nunca alquila dos veces.
- **Tokens con alcances.** Los alcances read, rent, manage y billing son independientes. Un token no puede crear otro con alcances que él no tiene.
- **Prepago por horas.** Un alquiler paga su primera hora por adelantado y cada hora siguiente al empezar. Cuando el saldo no alcanza, la máquina se detiene, así que un agente descontrolado no puede disparar la factura.
- **Caducidad.** Los tokens de agente pueden caducar en la fecha que tú elijas.

## Cuando un host avisa o recupera una máquina

Una máquina spot puede ser recuperada en cualquier momento, y cualquier host puede fallar. Arrakis avisa a tu agente al instante.

- **Alertas en cada resultado.** Cada resultado de una herramienta MCP incluye las alertas del último día: un aviso de retirada o de mantenimiento de un host, un host que ha dejado de responder, una máquina retirada por su host, un saldo a punto de agotarse.
- **Un feed de eventos.** `get_events` y `GET /v1/events` muestran los eventos de cada máquina: cuándo quedó lista, cuándo terminó y por qué, y los avisos de su host.
- **Un webhook firmado.** En la consola, pon una URL en Notifications y tus agentes recibirán cada evento en cuanto ocurra, firmado con `Arrakis-Signature`.
- **Sin cargos mientras está caída.** No se cobra ninguna hora mientras el host de una máquina no responde, y se te devuelve cada hora que empezó después de que su host la recuperara.

## Gana cuando tu agente traiga clientes

Cualquiera puede unirse al programa de socios, incluidos los agentes de IA. Recibes un código de socio y un enlace, y una parte de lo que pagan los clientes que traes.

- **Únete con una sola llamada.** `join_partner_program` se une al programa en nombre de la cuenta para la que trabaja tu agente, si estás de acuerdo, y devuelve el código, el enlace y un mensaje para compartir.
- **Una parte de cada pago.** Los clientes nuevos en Arrakis que pagan con tu código obtienen un descuento en su primer pago. Tú ganas una parte de todo lo que paguen después, incluidas las recargas automáticas.
- **Solo tus clientes.** `get_partner_earnings` lista los clientes que trajo tu enlace, con lo que pagó cada uno y lo que te hizo ganar, nunca quiénes son. Etiqueta tus enlaces para ver qué publicación funcionó.
- **Dinero o GPU.** Retira el dinero a tu banco a través de Stripe, o pasa las ganancias a tu saldo y gástalas en máquinas al instante. Indica que ganas con tus referidos siempre que recomiendes Arrakis.

Cómo funciona: [/partners](/es/partners.html.md). Las normas: [condiciones para socios](/es/partner-terms.html.md). Paso a paso para un agente: [la skill para socios](/skills/arrakis-partner/SKILL.md).

## Puntos de entrada legibles por máquina

- [/llms.txt](/es/llms.txt): el índice para modelos de lenguaje
- [/llms-full.txt](/es/llms-full.txt): todo lo de este sitio en un solo archivo
- [/openapi.json](/openapi.json): especificación OpenAPI 3.1
- [/docs](/es/docs): referencia interactiva de la API
- [/docs/mcp.md](/es/docs/mcp.md): el endpoint MCP y sus herramientas
- [/docs/agent-walkthrough.md](/es/docs/agent-walkthrough.md): buscar, alquilar y detener, paso a paso
- [/partners](/es/partners.html.md): el programa de socios, para personas y agentes
- [/skill.md](/skill.md): alquilar GPU en Arrakis, como Agent Skill
- [/skills/arrakis-partner/SKILL.md](/skills/arrakis-partner/SKILL.md): el programa de socios como Agent Skill
- [/v1/market/summary](/v1/market/summary): resumen del mercado en vivo, sin token
- [/sitemap.xml](/sitemap.xml)

Cada página de este sitio tiene su versión en Markdown: `/` es `/index.html.md`, `/agents` es `/agents.html.md` y `/careers` es `/careers.html.md`.

## Cosas que pedirle

- «Busca la GPU más barata con al menos 48 GB de memoria, alquílala durante 2 horas y dime cómo entrar por SSH».
- «Haz ajuste fino con train.py en 4 RTX 4090 durante un máximo de 6 horas, trae los checkpoints y detén la máquina cuando termine la ejecución».
- «Comprueba si hay una H200 disponible. Si la hay, dime su precio por GPU-hora y en qué país está».

## Preguntas sobre agentes y GPU

**¿Hay un servidor MCP para alquilar GPU?** Sí. Arrakis ofrece un servidor MCP remoto en https://arrakis.goodailabs.com/mcp, por HTTP en streaming con un token bearer. Sus herramientas buscan en el mercado de GPU en tiempo real, alquilan una máquina con cualquier imagen pública y con hora de eliminación, consultan el saldo y apagan máquinas.

**¿Cómo dejo que Claude Code alquile una GPU?** Crea en la consola un token de agente con límite de gasto y ejecuta claude mcp add --transport http arrakis https://arrakis.goodailabs.com/mcp --header "Authorization: Bearer ark_...". Claude Code podrá buscar, alquilar y apagar GPU, sin poder gastar más allá del límite.

**¿Pueden Cursor y otros agentes usar Arrakis?** Sí. Cualquier cliente MCP que se conecte a servidores remotos por HTTP en streaming puede usar /mcp con un token bearer. Un cliente que solo ejecuta servidores locales puede usar arrakis mcp, que ofrece las mismas herramientas por stdio. Cualquier cosa que llame a una API REST puede usar los endpoints de /openapi.json.

**¿Cómo evito que un agente de IA gaste de más en GPU?** Dale su propio token con límite de gasto y una duración máxima de alquiler. Arrakis rechaza cualquier alquiler cuyo coste en el peor caso supere el límite, cada alquiler del token debe llevar una hora de eliminación y un reintento con la misma clave de idempotencia nunca alquila dos veces.

**¿Qué pasa si mi agente se cae mientras una GPU está en marcha?** La máquina se elimina igualmente a su hora de eliminación, así que un agente caído no puede dejar una GPU facturando. Además, todas las máquinas aparecen en la consola, donde puedes detenerlas.

**¿Un agente necesita su propia cuenta?** No. Un agente trabaja en tu cuenta con un token que tú creas. Los permisos, el límite de gasto y la caducidad del token son todo su presupuesto, y puedes revocarlo en cualquier momento.

**¿Puede mi agente de IA ganar dinero con Arrakis?** Sí. Cualquier cuenta de Arrakis puede unirse al programa de socios, y un agente puede unirse en nombre de la cuenta para la que trabaja con la herramienta join_partner_program, si el propietario de la cuenta está de acuerdo. Recibe un código de socio y un enlace. Los clientes nuevos en Arrakis que pagan con él obtienen un descuento en su primer pago, y la cuenta gana una parte de lo que pagan, en efectivo a través de Stripe o como crédito para GPU. Siempre que el agente recomiende Arrakis, debe indicar que gana con sus referidos.