AgentMetal

@agentmetal/mcp

Servidor MCP que expõe AgentMetal como ferramentas, para que um agente possa descobrir → pagar → provisionar → entrar via SSH → executar comandos → gerenciar → renovar seu próprio servidor Linux (VPS / instância de nuvem) sem cadastro humano. Ferramentas pagas assinam pagamentos USDC via x402 v2 (ou pagamento com cartão); as demais são HTTP simples.

Ferramentas

13 ferramentas. Ferramentas pagas assinam um pagamento USDC/x402; ferramentas restritas por conta precisam de AGENTMETAL_API_KEY (am_live_…) e posse do servidor.

Ferramenta	Paga?	Chave de conta?	O que faz
get_catalog	—	—	Lista planos, localizações e preços de complementos (largura de banda, armazenamento). O gancho de descoberta gratuito.
provision_server	✅ USDC	—	Provisiona uma VPS (plan, days, opcional ssh_key/via, managed_key) → id, IPv4, SSH. Com managed_key:true, um par de chaves no servidor é gerado, autorizado, e a chave privada é retornada uma única vez (armazenada apenas criptografada) para permitir exec_command.
get_server	—	—	Status, IPv4, expiração, largura de banda, armazenamento para um id de servidor
list_servers	—	—	Frota para uma carteira/conta
extend_server	✅ USDC	—	Estende um aluguel por N dias
destroy_server	—	✅	Destruir agora
reboot_server	—	✅	Reinicialização suave (soft-reboot) de um servidor próprio
server_logs	—	✅	Diagnóstico em nível de hipervisor sem entrar no sistema: status, ações recentes do provedor, URL de console VNC e métricas ao vivo de CPU/disco/rede (não há log de inicialização de texto no lado do provedor)
exec_command	—	✅	Executa um comando de shell como root via SSH → exit_code/stdout/stderr. Requer um servidor provisionado com managed_key:true. Limitado: timeout de 1–120 s, teto de saída de 256 KB.
get_firewall	—	—	Lê as regras do firewall de borda de uma máquina. Chamável a partir da própria máquina (identidade por IP de origem) ou com chave de conta.
manage_firewall	—	—	Abre/fecha portas de entrada no firewall de borda de uma máquina (protocolo/porta/source_ips). A partir da própria máquina ou com chave de conta; protegido contra bloqueio de SSH.
claim_account	—	—	Envia por e-mail um código de uso único (via AWS SES)
verify_claim	—	—	Resgata o código por uma chave de API de conta. Vincule uma carteira passando também wallet + wallet_signature.

Complementos (atualmente endpoints de API, ainda não ferramentas MCP separadas): armazenamento extra ($0,01/GB/dia, volume de bloco anexado) via POST /v1/servers/{id}/storage e largura de banda extra ($2/TB além do 20 TB incluído) via POST /v1/servers/{id}/bandwidth.

Configuração (env)

Variável	Padrão	Finalidade
AGENTMETAL_BASE_URL	https://api.agentmetal.dev	URL base da API
WALLET_PRIVATE_KEY	—	Chave EVM 0x… usada para pagar 402s. Se omitida, ferramentas pagas falham com uma mensagem clara.
AGENTMETAL_NETWORK	eip155:8453	Rede CAIP-2 (mainnet Base)
AGENTMETAL_MAX_USDC	50	Limite de gasto por solicitação, em USDC
AGENTMETAL_API_KEY	—	Chave de conta am_live_…, necessária para destroy_server / reboot_server / server_logs / exec_command

Uso com Claude Code

// .mcp.json (or claude mcp add)
{
  "mcpServers": {
    "agentmetal": {
      "command": "node",
      "args": ["packages/mcp/src/index.ts"],
      "env": {
        "WALLET_PRIVATE_KEY": "0x…",
        "AGENTMETAL_MAX_USDC": "50"
      }
    }
  }
}

A carteira deve ter USDC na Base. O limite de gasto (AGENTMETAL_MAX_USDC) limita o que qualquer chamada de ferramenta individual pode pagar; um 402 acima do limite é recusado antes da assinatura.

Status: cliente + servidor têm testes unitários e o handshake via stdio é verificado. A liquidação ao vivo em USDC precisa de uma carteira com fundos + um facilitador x402 que suporte o tipo exact / eip155:8453.