AgentMetal

@agentmetal/mcp

Servidor MCP que expone AgentMetal como herramientas, para que un agente pueda descubrir → pagar → aprovisionar → conectar por SSH → ejecutar comandos → gestionar → renovar su propio servidor Linux (VPS / instancia en la nube) sin registro humano. Las herramientas de pago firman pagos USDC sobre x402 v2 (o pagan con tarjeta); el resto son HTTP simple.

Herramientas

13 herramientas. Las herramientas de pago firman un pago USDC/x402; las herramientas restringidas por cuenta necesitan AGENTMETAL_API_KEY (am_live_…) y propiedad del servidor.

Herramienta	¿Paga?	¿Clave de cuenta?	Qué hace
get_catalog	—	—	Lista planes, ubicaciones y precios de complementos (ancho de banda, almacenamiento). El gancho de descubrimiento gratuito.
provision_server	✅ USDC	—	Aprovisiona un VPS (plan, days, ssh_key/via opcional, managed_key) → id, IPv4, SSH. Con managed_key:true, se genera un par de claves en el servidor, se autoriza y la clave privada se devuelve una única vez (almacenada solo cifrada) para permitir exec_command.
get_server	—	—	Estado, IPv4, vencimiento, ancho de banda, almacenamiento para un id de servidor
list_servers	—	—	Flota para una wallet/cuenta
extend_server	✅ USDC	—	Extiende un arrendamiento por N días
destroy_server	—	✅	Destruir ahora
reboot_server	—	✅	Reinicio suave de un servidor propiedad del usuario
server_logs	—	✅	Diagnóstico a nivel de hipervisor sin iniciar sesión: estado, acciones recientes del proveedor, una URL de consola VNC y métricas en vivo de CPU/disco/red (no existe registro de arranque de texto del lado del proveedor)
exec_command	—	✅	Ejecuta un comando de shell como root a través de SSH → exit_code/stdout/stderr. Requiere un servidor aprovisionado con managed_key:true. Acotado: timeout de 1–120 s, límite de salida de 256 KB.
get_firewall	—	—	Lee las reglas del firewall perimetral de una caja. Invocable desde la propia caja (identidad por IP de origen) o con una clave de cuenta.
manage_firewall	—	—	Abre/cierra puertos entrantes en el firewall perimetral de una caja (protocolo/puerto/source_ips). Desde la propia caja o con clave de cuenta; protegido contra bloqueo por SSH.
claim_account	—	—	Envía por correo electrónico un código de canje de un solo uso (vía AWS SES)
verify_claim	—	—	Canjea el código por una clave API de cuenta. Vincula una wallet pasando también wallet + wallet_signature.

Complementos (actualmente endpoints de API, aún no herramientas MCP separadas): almacenamiento extra ($0.01/GB/día, volumen de bloque adjunto) vía POST /v1/servers/{id}/storage y ancho de banda extra ($2/TB más allá de los 20 TB incluidos) vía POST /v1/servers/{id}/bandwidth.

Configuración (env)

Variable	Predeterminado	Propósito
AGENTMETAL_BASE_URL	https://api.agentmetal.dev	URL base de la API
WALLET_PRIVATE_KEY	—	Clave EVM 0x… utilizada para pagar los 402. Si se omite, las herramientas de pago fallan con un mensaje claro.
AGENTMETAL_NETWORK	eip155:8453	Red CAIP-2 (mainnet de Base)
AGENTMETAL_MAX_USDC	50	Límite de gasto por solicitud, en USDC
AGENTMETAL_API_KEY	—	Clave de cuenta am_live_…, requerida para destroy_server / reboot_server / server_logs / exec_command

Uso con 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"
      }
    }
  }
}

La wallet debe tener USDC en Base. El límite de gasto (AGENTMETAL_MAX_USDC) acota lo que cualquier llamada individual a una herramienta puede pagar; un 402 por encima del límite se rechaza antes de firmar.

Estado: cliente y servidor tienen pruebas unitarias y el protocolo de enlace stdio está verificado. El cobro en vivo de USDC necesita una wallet financiada + un facilitador x402 que admita el tipo exact / eip155:8453.