convez.ai
MCP ServerDevOps & InfraestruturaAvançado
agentmetal

AgentMetal MCP — Provisionamento Autônomo de VPS

agentmetal/mcp

IA provisiona e gerencia VPS autonomamente com pagamento em USDC/cartão

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que expõe a plataforma AgentMetal, permitindo que agentes de IA descubram, paguem, provisionem e gerenciem servidores Linux (VPS) de forma autônoma usando USDC ou cartão de crédito. Integra pagamento HTTP 402 com autenticação SSH, execução de comandos root e renovação de leases sem intervenção humana.

Instalação

$npx convez-ai agentmetal/mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
2
Forks
1
Acompanhando
0
Saúde
50%
Último commit
há 1 semana
Versão
v0.2.1
Issues abertas
1
Contribuidores
1

Casos de uso

  • Agentes criarem infraestrutura sob demanda para rodar workloads temporários
  • Automatizar deploy, monitoramento e scaling de servidores sem signup manual
  • Pagamento automático de recursos cloud via carteira crypto ou cartão

Veredito

Ferramenta audaciosa que remove atrito humano no provisionamento de infraestrutura. Excelente para casos de uso onde agentes precisam de compute real, mas requer cuidado com limites de gasto e acesso a chave privada EVM.

README

A tradução para o português deste README ainda está na fila.

@agentmetal/mcp

MCP server that exposes AgentMetal as tools, so an agent can discover → pay → provision → SSH in → run commands → manage → renew its own Linux server (VPS / cloud instance) with no human signup. Paid tools sign USDC payments over x402 v2 (or pay by card); the rest are plain HTTP.

agentmetal/mcp MCP server CI smithery badge

Tools

11 tools. Paid tools sign a USDC/x402 payment; account-gated tools need AGENTMETAL_API_KEY (am_live_…) and ownership of the server.

ToolPays?Account key?What it does
get_catalog——List plans, locations, and add-on pricing (bandwidth, storage). The free discovery hook.
provision_server✅ USDC—Provision a VPS (plan, days, optional ssh_key/via, managed_key) → id, IPv4, SSH. With managed_key:true, a server-side keypair is generated, authorized, and the private key returned once (stored only encrypted) to enable exec_command.
get_server——Status, IPv4, expiry, bandwidth, storage for a server id
list_servers——Fleet for a wallet/account
extend_server✅ USDC—Extend a lease by N days
destroy_server—✅Destroy now
reboot_server—✅Soft-reboot an owned server
server_logs—✅Hypervisor-level diagnostics without logging in: status, recent provider actions, a VNC console URL, and live CPU/disk/net metrics (no text boot log exists provider-side)
exec_command—✅Run a shell command as root over SSH → exit_code/stdout/stderr. Requires a server provisioned with managed_key:true. Bounded: 1–120 s timeout, 256 KB output cap.
claim_account——Email a one-time claim code (via AWS SES)
verify_claim——Redeem the code for an account API key

Add-ons (currently API endpoints, not yet separate MCP tools): extra storage ($0.01/GB/day, attached block volume) via POST /v1/servers/{id}/storage and extra bandwidth ($2/TB beyond the 20 TB included) via POST /v1/servers/{id}/bandwidth.

Configuration (env)

VarDefaultPurpose
AGENTMETAL_BASE_URLhttps://api.agentmetal.devAPI base URL
WALLET_PRIVATE_KEY—0x… EVM key used to pay 402s. Omit and paid tools fail with a clear message.
AGENTMETAL_NETWORKeip155:8453CAIP-2 network (Base mainnet)
AGENTMETAL_MAX_USDC50Per-request spend cap, in USDC
AGENTMETAL_API_KEY—am_live_… account key, required for destroy_server / reboot_server / server_logs / exec_command

Use with 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"
      }
    }
  }
}

The wallet must hold USDC on Base. The spend cap (AGENTMETAL_MAX_USDC) bounds what any single tool call can pay; a 402 above the cap is refused before signing.

Status: client + server are unit-tested and the stdio handshake is verified. Live USDC settlement needs a funded wallet + an x402 facilitator that supports the exact / eip155:8453 kind.

Ver o original no GitHub

Bom para

Relacionados