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.

  1. 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
  2. Adicione o endpoint MCP

    Use o token como cabeçalho bearer.

    Conecte-se pelo MCP
    claude mcp add --transport http arrakis $ARRAKIS_URL/mcp \
      --header "Authorization: Bearer ark_..."

    $ARRAKIS_URL é o endereço deste site. Substitua ark_... por um token de API do console.

  3. 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.

FerramentaO que fazCusto
search_gpusLista 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_summaryO menor preço e a oferta de cada família de GPU neste momento.Grátis
get_balanceO 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_gpuAluga 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_modelServe 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_imagesAs 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_instancesAs máquinas que a conta está rodando.Grátis
get_instanceO estado, o comando SSH e o horário de remoção de uma máquina, com qualquer aviso do host dela.Grátis
get_eventsO 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_instanceDesliga uma máquina na hora. A cobrança para junto.Encerra as cobranças
schedule_removalMuda o horário de remoção de uma máquina.Altera o custo máximo
get_partner_earningsPara 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_programInscreve 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.

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.

Existe um servidor MCP para alugar GPUs?
Sim. O Arrakis mantém um servidor MCP remoto em https://arrakis.goodailabs.com/mcp, via HTTP com streaming e token bearer. As ferramentas dele buscam no mercado de GPU em tempo real, alugam uma máquina com horário de remoção em qualquer imagem pública, consultam o saldo e desligam máquinas.
Como deixo o Claude Code alugar uma GPU?
Crie no console um token de agente com limite de gastos e rode claude mcp add --transport http arrakis https://arrakis.goodailabs.com/mcp --header "Authorization: Bearer ark_...". O Claude Code então pode buscar, alugar e desligar GPUs, sem conseguir gastar além do limite.
O Cursor e outros agentes podem usar o Arrakis?
Sim. Qualquer cliente MCP que se conecte a servidores remotos via HTTP com streaming pode usar /mcp com um token bearer. Um cliente que só roda servidores locais pode usar o arrakis mcp, que oferece as mesmas ferramentas via stdio. Qualquer coisa que chame uma API REST pode usar os endpoints em /openapi.json.
Como impedir que um agente de IA gaste demais com GPUs?
Dê a ele um token próprio com limite de gastos e duração máxima de aluguel. O Arrakis recusa qualquer aluguel cujo custo no pior caso passaria do limite, todo aluguel do token precisa ter um horário de remoção, e repetir com a mesma chave de idempotência nunca aluga duas vezes.
O que acontece se meu agente travar com uma GPU rodando?
A máquina se remove mesmo assim no horário de remoção, então um agente travado não deixa uma GPU cobrando. Todas as máquinas também aparecem no console, onde você pode pará-las.
Um agente precisa de conta própria?
Não. Um agente trabalha na sua conta com um token que você cria. As permissões, o limite de gastos e a validade do token são todo o orçamento dele, e você pode revogá-lo a qualquer momento.
Meu agente de IA pode ganhar dinheiro com o Arrakis?
Sim. Qualquer conta do Arrakis pode participar do programa de parceiros, e um agente pode inscrever no programa a conta para a qual trabalha, com a ferramenta join_partner_program, se o titular da conta concordar. O agente recebe um código de parceiro e um link. Clientes novos no Arrakis que pagam com esse código recebem um desconto no primeiro pagamento, e a conta ganha uma parte do que eles pagam, em dinheiro pelo Stripe ou como crédito para GPUs. Onde quer que recomende o Arrakis, o agente deve dizer que ganha com indicações.

Dê ao seu agente um orçamento, não um cartão de crédito.