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.
Conéctate en tres pasos
Arrakis ofrece MCP por HTTP desde la misma dirección que este sitio. No hay nada que instalar.
-
Crea un token para tu agente
En la consola, abre API & agents y elige un token para un agente. Recibe los alcances read y rent, un límite de gasto y una duración máxima de alquiler. Desde la CLI:
arrakis tokens create --name eval-agent \ --scope read --scope rent \ --spend-limit 50 --max-rental-hours 6 --expires-in 7d -
Añade el endpoint MCP
Usa el token como cabecera bearer.
Conéctalo por MCPclaude mcp add --transport http arrakis $ARRAKIS_URL/mcp \ --header "Authorization: Bearer ark_..."{ "mcpServers": { "arrakis": { "url": "$ARRAKIS_URL/mcp", "headers": { "Authorization": "Bearer ark_..." } } } }Transport Streamable HTTP URL $ARRAKIS_URL/mcp Header Authorization: Bearer ark_...export ARRAKIS_TOKEN=ark_... export ARRAKIS_BASE_URL=$ARRAKIS_URL arrakis mcp$ARRAKIS_URLes la dirección de este sitio. Sustituyeark_...por un token de API de la consola. -
Dale una tarea
Dile cuánto puede durar la máquina. Tu agente lo pasa como hora de eliminación.
Ejecuta mi suite de evaluación en una B200: alquila una durante tres horas, ejecuta eval.py, trae los resultados y luego elimínala.
Trece herramientas
Cada herramienta indica su coste antes de que tu agente la llame. Los errores llegan con la explicación de la propia API.
| 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. | Precio por hora, hora a hora, hasta la eliminación |
| deploy_model | Sirve cualquier modelo de Hugging Face con vLLM, SGLang o llama.cpp en una máquina a su medida y devuelve su endpoint compatible con OpenAI y su clave de API. La máquina también tiene SSH root. | 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.
Caducidad
Los tokens de agente pueden caducar en la fecha que elijas. Un token caducado deja de funcionar en todas partes a la vez.
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.
Este sitio también es fácil de leer para agentes
Cada página tiene su versión en Markdown. Empieza por llms.txt.
- El índice para modelos de lenguaje/llms.txt
- Todo el sitio en un solo archivo/llms-full.txt
- Especificación OpenAPI 3.1/openapi.json
- Referencia interactiva de la API/docs
- El endpoint MCP y sus herramientas/docs/agents
- Buscar, alquilar, conectar y detener/docs/rent
- Resumen del mercado en vivo, sin token/v1/market/summary
- Precios en tiempo real de todas las GPU/gpus
- Esta página en Markdown/agents.html.md
Cosas que pedirle
Basta con pedirlo con naturalidad. Indica un límite de tiempo y un presupuesto, y tu agente respetará ambos.
Busca la GPU más barata con al menos 48 GB de memoria, alquílala dos horas y dime cómo entrar por SSH.
Haz ajuste fino con train.py en cuatro RTX 5090 durante un máximo de seis horas, trae los checkpoints y luego detén la máquina.
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
Todo lo demás está en la guía de MCP o en la referencia de la API.