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

O Arrakis oferece MCP via HTTP com streaming no mesmo endereço deste site, em `/mcp`. Não há nada para instalar. Abaixo, `$ARRAKIS_URL` é o endereço deste site e `ark_...` é um token de API.

## Conecte-se em três etapas

1. **Crie um token para seu agente.** No console, abra API & agents e escolha um token para agente: escopos read e rent, um limite de gastos e uma duração máxima de aluguel. Pela CLI:

   ```sh
   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.

   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_..." }
       }
     }
   }
   ```

   Qualquer cliente: transporte HTTP com streaming, URL `$ARRAKIS_URL/mcp`, cabeçalho `Authorization: Bearer ark_...`.

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

3. **Dê uma tarefa a ele.** Diga quanto tempo a máquina pode durar; seu agente passa isso como horário de remoção. Por exemplo: “Rode minha suíte de avaliação em uma H100: alugue uma por 3 horas, rode python eval.py, traga results/ de volta e depois encerre a máquina.”

## O que seu agente não pode fazer

- Gastar além do limite do token.
- Alugar uma máquina sem horário de remoção.
- Alugar por mais tempo que a duração máxima de aluguel do token.
- Criar um token com mais poder que o seu.
- Ver ou mexer nas máquinas de outra conta.
- Adicionar saldo. Só pagamentos confirmados fazem isso.

## Doze ferramentas

| 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. | O preço por hora, uma hora de cada vez, 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, então um agente descontrolado não consegue acumular uma conta.
- **Validade.** Os tokens de agente podem expirar na data que você escolher.

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

Como funciona: [/partners](/pt/partners.html.md). As regras: [termos de parceria](/pt/partner-terms.html.md). Passo a passo para um agente: [a skill de parceiro](/skills/arrakis-partner/SKILL.md).

## Pontos de entrada legíveis por máquina

- [/llms.txt](/pt/llms.txt): o índice para modelos de linguagem
- [/llms-full.txt](/pt/llms-full.txt): todo o site em um só arquivo
- [/openapi.json](/openapi.json): especificação OpenAPI 3.1
- [/docs](/pt/docs): referência interativa da API
- [/docs/mcp.md](/pt/docs/mcp.md): o endpoint MCP e as ferramentas
- [/docs/agent-walkthrough.md](/pt/docs/agent-walkthrough.md): buscar, alugar e parar, passo a passo
- [/partners](/pt/partners.html.md): o programa de parceiros, para pessoas e agentes
- [/skill.md](/skill.md): alugar GPUs no Arrakis, em forma de Agent Skill
- [/skills/arrakis-partner/SKILL.md](/skills/arrakis-partner/SKILL.md): o programa de parceiros em forma de Agent Skill
- [/v1/market/summary](/v1/market/summary): resumo do mercado em tempo real, sem token
- [/sitemap.xml](/sitemap.xml)

Cada página deste site tem uma versão em Markdown: `/` é `/index.html.md`, `/agents` é `/agents.html.md`, `/careers` é `/careers.html.md`.

## O que pedir

- “Encontre a GPU mais barata com pelo menos 48 GB de memória, alugue por 2 horas e me diga como entrar por SSH.”
- “Faça o ajuste fino com train.py em 4 RTX 4090 por até 6 horas, traga os checkpoints de volta e pare a máquina quando a execução terminar.”
- “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

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