Agentes e MCP

Dê a um agente um token com o qual ele não consegue gastar demais e conecte-o via MCP.

Dê ao agente um token só dele

Em API & agents, crie um token para o agente só com o necessário:

Escopos read e rent (não manage nem billing).
Um limite de gastos em dólares, uma duração máxima de aluguel em horas e uma data de validade.

O token aparece uma única vez. Guarde-o no cofre de segredos do agente, nunca em um prompt nem em um repositório. Um token com limite precisa definir um horário de desligamento em todo aluguel, e um aluguel que passaria do limite é recusado.

Conecte-se pelo MCP

O endpoint MCP é $ARRAKIS_URL/mcp, com o token do agente. Ele usa o HTTP com streaming do MCP, com respostas em JSON simples.

Claude Code:

Shell

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

Cursor (mcp.json):

JSON

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

Ferramentas

Ferramenta	O que faz
`search_gpus`	Encontra máquinas, as melhores primeiro: o que a GPU pode fazer, o preço e a confiabilidade do host. Recomenda uma e diz por quê. Filtros: tipo de GPU, mínimo e máximo de GPUs, memória, preço máximo por GPU-hora, país.
`get_market_summary`	Preços e disponibilidade em tempo real por família de GPU.
`get_balance`	O que o saldo pode pagar.
`rent_gpu`	Aluga uma máquina e a retorna com o comando SSH. Inicializa um `template_id` ou qualquer `image` pública. Gera cobrança.
`deploy_model`	Serve um modelo do Hugging Face com vLLM, SGLang ou llama.cpp em uma máquina dimensionada para ele e retorna o endpoint e a chave de API (Implantar um modelo). Gera cobrança.
`list_images`	As imagens do Arrakis e as que você salvou, para usar em `template_id`.
`list_instances`	Suas máquinas.
`get_instance`	Uma máquina, atualizada, com qualquer aviso do host dela.
`get_events`	O que aconteceu com suas máquinas: prontas, encerradas e por quê (se o host as encerrou ou não) e os avisos dos hosts delas. Todo resultado de ferramenta também traz os alertas do último dia.
`terminate_instance`	Desliga e remove uma máquina.
`schedule_removal`	Define quando uma máquina se remove sozinha.
`get_partner_earnings`	Parceiros: seus códigos e seu link, os clientes que você trouxe, o que você ganhou e se o programa de parceiros está aberto.
`join_partner_program`	Inscreve a conta no programa de parceiros, se o titular dela concordar (/partners).

Repetir nunca aluga duas vezes

Dê a cada aluguel planejado uma idempotency_key estável. Repetir com a mesma chave retorna a mesma máquina em vez de gerar uma segunda cobrança. Pelo MCP, uma chamada sem chave que repete a mesma máquina, o mesmo nome e as mesmas horas em até 10 minutos também retorna a primeira máquina.

Um bom primeiro prompt

É um agente? Esta página em Markdown.