Arrakis para agentes
Seu agente pode buscar no mercado, alugar uma GPU, rodar o job e desligar a máquina. Você decide o orçamento antes de começar, e ele não consegue passar disso.
Conecte-se em três etapas
O Arrakis oferece MCP via HTTP no mesmo endereço deste site. Não há nada para instalar.
-
Crie um token para seu agente
No console, abra API & agents e escolha um token para agente. Ele recebe os escopos read e rent, um limite de gastos e uma duração máxima de aluguel. Pela CLI:
arrakis tokens create --name eval-agent \ --scope read --scope rent \ --spend-limit 50 --max-rental-hours 6 --expires-in 7d -
Adicione o endpoint MCP
Use o token como cabeçalho bearer.
Conecte-se pelo 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_URLé o endereço deste site. Substituaark_...por um token de API do console. -
Dê uma tarefa a ele
Diga quanto tempo a máquina pode durar. Seu agente passa isso como horário de remoção.
Rode minha suíte de avaliação em uma B200: alugue uma por três horas, rode o eval.py, traga os resultados e depois encerre a máquina.
Treze ferramentas
Cada ferramenta informa quanto custa antes que seu agente a chame. Os erros voltam com a explicação da própria API.
| Ferramenta | O que faz | Custo |
|---|---|---|
| search_gpus | Lista as máquinas disponíveis, as melhores primeiro, segundo o que a GPU pode fazer, o preço e a confiabilidade do host, com filtros por GPU, quantidade, memória, preço por GPU-hora e país. Recomenda uma e diz por quê. | Grátis |
| get_market_summary | O menor preço e a oferta de cada família de GPU neste momento. | Grátis |
| get_balance | O saldo da conta, quanto as máquinas em execução custam por hora, quando o dinheiro acaba e o limite do token. | Grátis |
| rent_gpu | Aluga uma máquina por no máximo termination_hours e retorna o comando SSH, o custo no pior caso e quantas horas o saldo cobre. Repetir a chamada retorna a mesma máquina. | Preço por hora, hora a hora, até a remoção |
| deploy_model | Serve qualquer modelo do Hugging Face com vLLM, SGLang ou llama.cpp em uma máquina dimensionada para ele e retorna o endpoint compatível com a API da OpenAI e a chave de API. A máquina também tem SSH root. | Preço por hora, hora a hora, até a remoção |
| list_images | As imagens que uma máquina pode inicializar: as do Arrakis e as da própria conta, incluindo as privadas. rent_gpu também aceita qualquer imagem pública. | Grátis |
| list_instances | As máquinas que a conta está rodando. | Grátis |
| get_instance | O estado, o comando SSH e o horário de remoção de uma máquina, com qualquer aviso do host dela. | Grátis |
| get_events | O que aconteceu com as máquinas da conta: prontas, encerradas e por quê (se o host as encerrou ou não) e os avisos dos hosts delas. | Grátis |
| terminate_instance | Desliga uma máquina na hora. A cobrança para junto. | Encerra as cobranças |
| schedule_removal | Muda o horário de remoção de uma máquina. | Altera o custo máximo |
| get_partner_earnings | Para parceiros: seus códigos, o link e a mensagem para compartilhar, os clientes que você trouxe, o que você ganhou e pode sacar, e se o programa de parceiros está aberto. | Grátis |
| join_partner_program | Inscreve a conta no programa de parceiros, se o titular dela concordar: um código de parceiro, um link e uma mensagem para compartilhar. | Grátis |
O que mantém seguro o gasto sem supervisão
Essas regras ficam na API, então valem igualmente para MCP, CLI e HTTP puro.
Limites de gastos
Um token com limite conta cada aluguel no pior caso, preço por hora vezes as horas até a remoção, e recusa o que passaria do limite.
Remoção obrigatória
Um token com limite não pode alugar sem termination_hours, nem além da duração máxima de aluguel.
Repetição segura
A mesma idempotency_key sempre retorna a mesma máquina. Repetir nunca aluga duas vezes.
Tokens com escopo
Os escopos read, rent, manage e billing são separados. Um token não pode emitir outro com escopos que ele não tem.
Pré-pago por hora
Um aluguel paga a primeira hora adiantada e cada hora seguinte quando ela começa. Quando o saldo não cobre, a máquina para.
Validade
Os tokens de agente podem expirar na data que você escolher. Um token expirado para de funcionar em todo lugar ao mesmo tempo.
Quando um host dá aviso ou retoma uma máquina
Uma máquina spot pode ser retomada a qualquer momento, e qualquer host pode falhar. O Arrakis avisa seu agente na hora.
Alertas em cada resultado
Cada resultado de ferramenta MCP traz os alertas do último dia: um aviso de remoção ou de manutenção do host, um host que parou de responder, uma máquina encerrada pelo host, um saldo prestes a acabar.
Um feed de eventos
get_events e GET /v1/events listam os eventos de cada máquina: pronta, encerrada e por quê, e os avisos do host dela.
Um webhook assinado
Defina uma URL em Notifications, no console, e seus agentes recebem cada evento assim que ele acontece, assinado com Arrakis-Signature.
Nada é cobrado enquanto está fora do ar
Nenhuma hora é cobrada enquanto o host de uma máquina não responde, e toda hora iniciada depois que um host retomou a máquina é devolvida.
Ganhe quando seu agente trouxer clientes
Qualquer pessoa pode participar do programa de parceiros, inclusive agentes de IA. Você recebe um código de parceiro, um link e uma parte do que pagam os clientes que você traz.
Participe com uma só chamada
join_partner_program inscreve no programa a conta para a qual seu agente trabalha, se você concordar, e retorna o código, o link e uma mensagem para compartilhar.
Uma parte de cada pagamento
Clientes novos no Arrakis que pagam com seu código recebem um desconto no primeiro pagamento. Você ganha uma parte de tudo o que eles pagarem depois disso, inclusive as recargas automáticas.
Só os seus clientes
get_partner_earnings lista os clientes que seu link trouxe, com o que cada um pagou e rendeu a você, nunca quem eles são. Coloque tags nos seus links para ver qual publicação funcionou.
Dinheiro ou GPUs
Saque para o seu banco pelo Stripe, ou transfira os ganhos para o seu saldo e gaste-os em máquinas na hora. Onde quer que recomende o Arrakis, diga que você ganha com indicações.
Este site também é fácil de ler para agentes
Cada página tem uma versão em Markdown. Comece pelo llms.txt.
- O índice para modelos de linguagem/llms.txt
- Todo o site em um só arquivo/llms-full.txt
- Especificação OpenAPI 3.1/openapi.json
- Referência interativa da API/docs
- O endpoint MCP e as ferramentas/docs/agents
- Buscar, alugar, conectar e parar/docs/rent
- Resumo do mercado em tempo real, sem token/v1/market/summary
- Preços em tempo real de todas as GPUs/gpus
- Esta página como Markdown/agents.html.md
O que pedir
Pedidos simples funcionam. Diga um limite de tempo e um orçamento, e seu agente vai respeitar os dois.
Encontre a GPU mais barata com pelo menos 48 GB de memória, alugue por duas horas e me diga como entrar por SSH.
Faça o ajuste fino com train.py em quatro RTX 5090 por até seis horas, traga os checkpoints de volta e depois pare a máquina.
Veja se há uma H200 disponível. Se houver, me diga o preço por GPU-hora e o país onde ela roda.
Perguntas sobre agentes e GPUs
O resto está no guia de MCP ou na referência da API.