{"_id":"@agentmetal/mcp","_rev":"8-c184139baa941e09d59c81b4eba8c476","name":"@agentmetal/mcp","dist-tags":{"latest":"0.3.2"},"versions":{"0.1.0":{"name":"@agentmetal/mcp","version":"0.1.0","keywords":["mcp","modelcontextprotocol","model-context-protocol","mcp-server","ai","llm","agent","x402","vps","agentmetal"],"license":"MIT","_id":"@agentmetal/mcp@0.1.0","maintainers":[{"name":"luiscosio","email":"luis@getobok.com"}],"homepage":"https://agentmetal.dev","bugs":{"url":"https://github.com/agentmetal/mcp/issues"},"bin":{"agentmetal-mcp":"src/index.ts"},"dist":{"shasum":"a2d32f798efb0f70695b23836bb34712d8b06e75","tarball":"https://registry.npmjs.org/@agentmetal/mcp/-/mcp-0.1.0.tgz","fileCount":5,"integrity":"sha512-L1MOyOHEjBVng5GUYx+e3TB8dAsww8iYhkMLH6WCz7x6OOMhCisxAbLvsxWAnxHwBrIQm3FzadAghITnDcLUtw==","signatures":[{"sig":"MEUCIQDEQftKLxmLszKnXXSc2eJ6JTr8jEK+inQmACzrbb3QxQIgMpwW005ey7MydPSxwmsTS8Q8oaHpUOx8jJz4YlWtjSQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":17305},"type":"module","engines":{"node":">=24"},"gitHead":"f6bc04796fdd33a05fdcf2c3a5d4c1ff9ace30e3","mcpName":"io.github.agentmetal/agentmetal","scripts":{"test":"node --test test/*.test.ts","start":"node src/index.ts","typecheck":"tsc --noEmit","test:watch":"node --test --watch test/*.test.ts"},"_npmUser":{"name":"luiscosio","email":"luis@getobok.com"},"repository":{"url":"git+https://github.com/agentmetal/mcp.git","type":"git"},"_npmVersion":"11.10.1","description":"MCP server for AgentMetal — let an AI agent discover, pay for (USDC via x402 or card), provision, and manage Linux VPSes over HTTP 402. No signup.","directories":{},"_nodeVersion":"24.13.0","dependencies":{"zod":"^4.4.3","viem":"^2.52.2","@x402/evm":"^2.15.0","@x402/fetch":"^2.15.0","@modelcontextprotocol/sdk":"^1.29.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.6.3","@types/node":"^22.10.2"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.1.0_1781477158436_0.9958687299398572","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@agentmetal/mcp","version":"0.1.1","keywords":["mcp","modelcontextprotocol","model-context-protocol","mcp-server","ai","llm","agent","x402","vps","agentmetal"],"license":"MIT","_id":"@agentmetal/mcp@0.1.1","maintainers":[{"name":"luiscosio","email":"luis@getobok.com"}],"homepage":"https://agentmetal.dev","bugs":{"url":"https://github.com/agentmetal/mcp/issues"},"bin":{"agentmetal-mcp":"src/index.ts"},"dist":{"shasum":"c897a5693709ae33eadfd034def66c3a83b10504","tarball":"https://registry.npmjs.org/@agentmetal/mcp/-/mcp-0.1.1.tgz","fileCount":5,"integrity":"sha512-4dCc5DSIMGAkZ5IcsDY/De1FL1xYPNOX95JKeFb95zjmoNNOliF03KPOAJtIfTFfZCZLY3VPyPDL6mg1jGLo0A==","signatures":[{"sig":"MEUCIEaIWVx5Qir/qjI8Ip4lCaph41hG21afSeU8uHsQWeTqAiEAgZNDacnexvJ7hHYx7doRCfi+Xu9Xd0YZQn7eNP1mMc8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":17299},"type":"module","engines":{"node":">=24"},"gitHead":"114540a2ad022b2b671241107a5a50f3c0cb84b7","mcpName":"dev.agentmetal/agentmetal","scripts":{"test":"node --test test/*.test.ts","start":"node src/index.ts","typecheck":"tsc --noEmit","test:watch":"node --test --watch test/*.test.ts"},"_npmUser":{"name":"luiscosio","email":"luis@getobok.com"},"repository":{"url":"git+https://github.com/agentmetal/mcp.git","type":"git"},"_npmVersion":"11.10.1","description":"MCP server for AgentMetal — let an AI agent discover, pay for (USDC via x402 or card), provision, and manage Linux VPSes over HTTP 402. No signup.","directories":{},"_nodeVersion":"24.13.0","dependencies":{"zod":"^4.4.3","viem":"^2.52.2","@x402/evm":"^2.15.0","@x402/fetch":"^2.15.0","@modelcontextprotocol/sdk":"^1.29.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.6.3","@types/node":"^22.10.2"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.1.1_1781479382314_0.30526975889880803","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@agentmetal/mcp","version":"0.1.2","keywords":["mcp","modelcontextprotocol","model-context-protocol","mcp-server","ai","llm","agent","x402","vps","agentmetal"],"license":"MIT","_id":"@agentmetal/mcp@0.1.2","maintainers":[{"name":"luiscosio","email":"luis@getobok.com"}],"homepage":"https://agentmetal.dev","bugs":{"url":"https://github.com/agentmetal/mcp/issues"},"bin":{"agentmetal-mcp":"src/index.ts"},"dist":{"shasum":"6b9d7c567b1d1ba7c32493a86d64f1a837d3a643","tarball":"https://registry.npmjs.org/@agentmetal/mcp/-/mcp-0.1.2.tgz","fileCount":5,"integrity":"sha512-5a3L34NkyK2pr3DWAvJqnbGb9olGXQjF6VY7JMyODBtIB2gdCKCI88kMiy6df84v9eLvsyvyWuKuT4aKsVyIMw==","signatures":[{"sig":"MEYCIQDfGZV1JFJbrnzmUiaY6rFspq/PQNoicu9CE6Ikia9Y2wIhANW7YXo7x4W+9+K3ghVzfHR+n5uQMhmqYnAkbA+SD7f6","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":20653},"type":"module","engines":{"node":">=24"},"gitHead":"a1f6fc7788f3769f3446de3ec1d19a8cdd93c06d","mcpName":"dev.agentmetal/agentmetal","scripts":{"test":"node --test test/*.test.ts","start":"node src/index.ts","typecheck":"tsc --noEmit","test:watch":"node --test --watch test/*.test.ts"},"_npmUser":{"name":"luiscosio","email":"luis@getobok.com"},"repository":{"url":"git+https://github.com/agentmetal/mcp.git","type":"git"},"_npmVersion":"11.10.1","description":"MCP server for AgentMetal — let an AI agent discover, pay for (USDC via x402 or card), provision, and manage Linux VPSes over HTTP 402. No signup.","directories":{},"_nodeVersion":"24.13.0","dependencies":{"zod":"^4.4.3","viem":"^2.52.2","@x402/evm":"^2.15.0","@x402/fetch":"^2.15.0","@modelcontextprotocol/sdk":"^1.29.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.6.3","@types/node":"^22.10.2"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.1.2_1781482347176_0.870395856650654","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@agentmetal/mcp","version":"0.2.0","keywords":["mcp","modelcontextprotocol","model-context-protocol","mcp-server","ai","llm","agent","x402","vps","usdc","ssh","exec","cloud-server","agentmetal"],"license":"MIT","_id":"@agentmetal/mcp@0.2.0","maintainers":[{"name":"luiscosio","email":"luis@getobok.com"}],"homepage":"https://agentmetal.dev","bugs":{"url":"https://github.com/agentmetal/mcp/issues"},"bin":{"agentmetal-mcp":"src/index.ts"},"dist":{"shasum":"cad9524b46c58f8089a271ed0ac9b97ee1731a32","tarball":"https://registry.npmjs.org/@agentmetal/mcp/-/mcp-0.2.0.tgz","fileCount":5,"integrity":"sha512-vQBwEIoQFyg9tepmSjXmW3HiOOfnxBJxD94DV2+f2tUEJIxNQ6JUVIMwQVsYKw9va7XT1kMp3VuITYB46s7X0A==","signatures":[{"sig":"MEYCIQCU5r2kcNZgmd4qvmHaCreUJkFS7353wx4OcyuqSPagoAIhAJ6l9qPt7Ntf5FqdOBdEsfrht3PTMUAAetTi8yy2FYxV","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":29158},"type":"module","engines":{"node":">=24"},"gitHead":"6bb8fef6e03d9ec80ade74b20836604d305404ca","mcpName":"dev.agentmetal/agentmetal","scripts":{"test":"node --test test/*.test.ts","start":"node src/index.ts","typecheck":"tsc --noEmit","test:watch":"node --test --watch test/*.test.ts"},"_npmUser":{"name":"luiscosio","email":"luis@getobok.com"},"repository":{"url":"git+https://github.com/agentmetal/mcp.git","type":"git"},"_npmVersion":"11.10.1","description":"MCP server for AgentMetal — let an AI agent discover, pay for (USDC via x402 or card), provision, and manage Linux VPSes over HTTP 402. No signup.","directories":{},"_nodeVersion":"24.13.0","dependencies":{"zod":"^4.4.3","viem":"^2.52.2","@x402/evm":"^2.15.0","@x402/fetch":"^2.15.0","@modelcontextprotocol/sdk":"^1.29.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.6.3","@types/node":"^22.10.2"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.2.0_1781488263989_0.26694941548280515","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@agentmetal/mcp","version":"0.2.1","keywords":["mcp","modelcontextprotocol","model-context-protocol","mcp-server","ai","llm","agent","x402","vps","usdc","ssh","exec","cloud-server","agentmetal"],"license":"MIT","_id":"@agentmetal/mcp@0.2.1","maintainers":[{"name":"luiscosio","email":"luis@getobok.com"}],"homepage":"https://agentmetal.dev","bugs":{"url":"https://github.com/agentmetal/mcp/issues"},"bin":{"agentmetal-mcp":"src/index.ts"},"dist":{"shasum":"a79f72a14d06d654723b3f2519c49a349a69a9f7","tarball":"https://registry.npmjs.org/@agentmetal/mcp/-/mcp-0.2.1.tgz","fileCount":5,"integrity":"sha512-xTtUwd5JcabN93EQADtS3gLbNvS9PBwqsC0pJVAaNGQGrKWYtiLVnidZwDRjA1ZdbJj35Xb4XaFtiDT3jZtJYQ==","signatures":[{"sig":"MEQCIHOcJLK91cXdP8rtfwrsIC+1OjAR09s4qCqNMis4rGWBAiB2h9T1B/yamh+zeXPn5fRxpq92FJ49XP3G1DPHo9yHRA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":29348},"type":"module","engines":{"node":">=24"},"gitHead":"a5e13534a58874d2618413e7ca3a84a034a4074b","mcpName":"dev.agentmetal/agentmetal","scripts":{"test":"node --test test/*.test.ts","start":"node src/index.ts","typecheck":"tsc --noEmit","test:watch":"node --test --watch test/*.test.ts"},"_npmUser":{"name":"luiscosio","email":"luis@getobok.com"},"repository":{"url":"git+https://github.com/agentmetal/mcp.git","type":"git"},"_npmVersion":"11.10.1","description":"MCP server for AgentMetal — an AI agent can discover, pay (USDC via x402 or card), provision, SSH into, and run commands on its own Linux VPSes over HTTP 402. No signup.","directories":{},"_nodeVersion":"24.13.0","dependencies":{"zod":"^4.4.3","viem":"^2.52.2","@x402/evm":"^2.15.0","@x402/fetch":"^2.15.0","@modelcontextprotocol/sdk":"^1.29.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.6.3","@types/node":"^22.10.2"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.2.1_1781493752116_0.5121052306807454","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"name":"@agentmetal/mcp","version":"0.3.0","keywords":["mcp","modelcontextprotocol","model-context-protocol","mcp-server","ai","llm","agent","x402","vps","usdc","ssh","exec","cloud-server","agentmetal"],"license":"MIT","_id":"@agentmetal/mcp@0.3.0","maintainers":[{"name":"luiscosio","email":"luis@getobok.com"}],"homepage":"https://agentmetal.dev","bugs":{"url":"https://github.com/agentmetal/mcp/issues"},"bin":{"agentmetal-mcp":"src/index.ts"},"dist":{"shasum":"56e12b43a4bbbae4ce6887d0d2e8bb4acf2cc7b7","tarball":"https://registry.npmjs.org/@agentmetal/mcp/-/mcp-0.3.0.tgz","fileCount":5,"integrity":"sha512-V1LOPQzny7tjpVOioHom9RXJqWi+B44oWlYJ6g0sRhchgmRnZaeeq8r5CBDBGMjj+YzIemde9KmYlrqmoYN8kg==","signatures":[{"sig":"MEQCIA64uU8omKswEncApW+v6X8IwGNKGxFmXjYIQ1BIThgbAiA8VFvPM3jXSqMWrzcp5Ztl8ypK4SjAX2pIQ4edmrC0yw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":34276},"type":"module","engines":{"node":">=24"},"gitHead":"8ec6f4c654588ae3e33ac1c2a6f918736a967038","mcpName":"dev.agentmetal/agentmetal","scripts":{"test":"node --test test/*.test.ts","start":"node src/index.ts","typecheck":"tsc --noEmit","test:watch":"node --test --watch test/*.test.ts"},"_npmUser":{"name":"luiscosio","email":"luis@getobok.com"},"repository":{"url":"git+https://github.com/agentmetal/mcp.git","type":"git"},"_npmVersion":"11.10.1","description":"MCP server for AgentMetal — an AI agent can discover, pay (USDC via x402 or card), provision, SSH into, and run commands on its own Linux VPSes over HTTP 402. No signup.","directories":{},"_nodeVersion":"24.13.0","dependencies":{"zod":"^4.4.3","viem":"^2.53.1","@x402/evm":"^2.16.0","@x402/fetch":"^2.16.0","@modelcontextprotocol/sdk":"^1.29.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^6.0.3","@types/node":"^24.13.2"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.3.0_1782319138371_0.31283468216746235","host":"s3://npm-registry-packages-npm-production"}},"0.3.1":{"name":"@agentmetal/mcp","version":"0.3.1","keywords":["mcp","modelcontextprotocol","model-context-protocol","mcp-server","ai","llm","agent","x402","vps","usdc","ssh","exec","cloud-server","agentmetal"],"license":"MIT","_id":"@agentmetal/mcp@0.3.1","maintainers":[{"name":"luiscosio","email":"luis@getobok.com"}],"homepage":"https://agentmetal.dev","bugs":{"url":"https://github.com/agentmetal/mcp/issues"},"bin":{"agentmetal-mcp":"src/index.ts"},"dist":{"shasum":"3851306d705d5466c1d242c7be68d58fe5870d05","tarball":"https://registry.npmjs.org/@agentmetal/mcp/-/mcp-0.3.1.tgz","fileCount":5,"integrity":"sha512-MjlokNA1/JZoaKa1lXAYqun8HObx7cgyEBf06/KU1yEzoh1OsUMJnggBjJTU18pgxgzobG/bktUODmad431MKQ==","signatures":[{"sig":"MEYCIQDVw0hFzgue1KFwBZfVEn33Mq3bOMS6vo0qZMxKK8DmAgIhAJIRxZjuW3BIBTl0pA5RYVo41rlaKyssPGVDLadKKOQ+","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":35557},"type":"module","engines":{"node":">=24"},"gitHead":"ff0cef2780964a83fdb580abaa1687762c0367ca","mcpName":"dev.agentmetal/agentmetal","scripts":{"test":"node --test test/*.test.ts","start":"node src/index.ts","typecheck":"tsc --noEmit","test:watch":"node --test --watch test/*.test.ts"},"_npmUser":{"name":"luiscosio","email":"luis@getobok.com"},"repository":{"url":"git+https://github.com/agentmetal/mcp.git","type":"git"},"_npmVersion":"11.10.1","description":"MCP server for AgentMetal — an AI agent can discover, pay (USDC via x402 or card), provision, SSH into, and run commands on its own Linux VPSes over HTTP 402. No signup.","directories":{},"_nodeVersion":"24.13.0","dependencies":{"zod":"^4.4.3","viem":"^2.53.1","@x402/evm":"^2.16.0","@x402/fetch":"^2.16.0","@modelcontextprotocol/sdk":"^1.29.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^6.0.3","@types/node":"^24.13.2"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.3.1_1782780628168_0.5047530829250437","host":"s3://npm-registry-packages-npm-production"}},"0.3.2":{"name":"@agentmetal/mcp","version":"0.3.2","description":"MCP server for AgentMetal — an AI agent can discover, pay (USDC via x402 or card), provision, SSH into, and run commands on its own Linux VPSes over HTTP 402. No signup.","license":"MIT","type":"module","mcpName":"dev.agentmetal/agentmetal","bin":{"agentmetal-mcp":"src/index.ts"},"engines":{"node":">=24"},"keywords":["mcp","modelcontextprotocol","model-context-protocol","mcp-server","ai","llm","agent","x402","vps","usdc","ssh","exec","cloud-server","agentmetal"],"repository":{"type":"git","url":"git+https://github.com/agentmetal/mcp.git"},"homepage":"https://agentmetal.dev","publishConfig":{"access":"public"},"scripts":{"test":"node --test test/*.test.ts","test:watch":"node --test --watch test/*.test.ts","typecheck":"tsc --noEmit","start":"node src/index.ts"},"devDependencies":{"@types/node":"^24.13.2","typescript":"^6.0.3"},"dependencies":{"@modelcontextprotocol/sdk":"^1.29.0","@x402/evm":"^2.17.0","@x402/fetch":"^2.17.0","viem":"^2.54.1","zod":"^4.4.3"},"gitHead":"6790024c5c5ef4910e5b80a46584f59d62c376dd","_id":"@agentmetal/mcp@0.3.2","bugs":{"url":"https://github.com/agentmetal/mcp/issues"},"_nodeVersion":"24.13.0","_npmVersion":"11.10.1","dist":{"integrity":"sha512-nA3mUQiJQONVbBV1rFgalkwLsi35TnSuzulposafWHsPC8s9kUMaMxC7Zp9W3l3PYBGQ857Qz/wJcWasaBFfkQ==","shasum":"25591a806ea5635c6760e3a2af3e33ecaf704add","tarball":"https://registry.npmjs.org/@agentmetal/mcp/-/mcp-0.3.2.tgz","fileCount":5,"unpackedSize":35746,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDKhR8kQSyut0uqCJcxoiQ4djR73rDZb1bE86w3kdb3sgIhANsT2M7d6yqmDedS7bGeV5yBqcVTAEZWsHzHpQrxXIi2"}]},"_npmUser":{"name":"luiscosio","email":"luis@getobok.com"},"directories":{},"maintainers":[{"name":"luiscosio","email":"luis@getobok.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp_0.3.2_1782963918772_0.5900001470460516"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-14T22:45:58.203Z","modified":"2026-07-02T03:45:19.031Z","0.1.0":"2026-06-14T22:45:58.575Z","0.1.1":"2026-06-14T23:23:02.446Z","0.1.2":"2026-06-15T00:12:27.301Z","0.2.0":"2026-06-15T01:51:04.127Z","0.2.1":"2026-06-15T03:22:32.246Z","0.3.0":"2026-06-24T16:38:58.519Z","0.3.1":"2026-06-30T00:50:28.307Z","0.3.2":"2026-07-02T03:45:18.897Z"},"bugs":{"url":"https://github.com/agentmetal/mcp/issues"},"license":"MIT","homepage":"https://agentmetal.dev","keywords":["mcp","modelcontextprotocol","model-context-protocol","mcp-server","ai","llm","agent","x402","vps","usdc","ssh","exec","cloud-server","agentmetal"],"repository":{"type":"git","url":"git+https://github.com/agentmetal/mcp.git"},"description":"MCP server for AgentMetal — an AI agent can discover, pay (USDC via x402 or card), provision, SSH into, and run commands on its own Linux VPSes over HTTP 402. No signup.","maintainers":[{"name":"luiscosio","email":"luis@getobok.com"}],"readme":"# @agentmetal/mcp\n\nMCP server that exposes [AgentMetal](https://agentmetal.dev) as tools, so an agent can\n**discover → pay → provision → SSH in → run commands → manage → renew** its own Linux\nserver (VPS / cloud instance) with no human signup. Paid tools sign USDC payments over\n[x402 v2](https://x402.org) (or pay by card); the rest are plain HTTP.\n\n[![agentmetal/mcp MCP server](https://glama.ai/mcp/servers/agentmetal/mcp/badges/score.svg)](https://glama.ai/mcp/servers/agentmetal/mcp)\n[![CI](https://github.com/agentmetal/mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/agentmetal/mcp/actions/workflows/ci.yml)\n[![smithery badge](https://smithery.ai/badge/luisalfonsocosioizcapa/agentmetal)](https://smithery.ai/servers/luisalfonsocosioizcapa/agentmetal)\n\n## Tools\n\n13 tools. Paid tools sign a USDC/x402 payment; account-gated tools need\n`AGENTMETAL_API_KEY` (`am_live_…`) and ownership of the server.\n\n| Tool | Pays? | Account key? | What it does |\n|---|---|---|---|\n| `get_catalog` | — | — | List plans, locations, and add-on pricing (bandwidth, storage). The free discovery hook. |\n| `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`. |\n| `get_server` | — | — | Status, IPv4, expiry, bandwidth, storage for a server id |\n| `list_servers` | — | — | Fleet for a wallet/account |\n| `extend_server` | ✅ USDC | — | Extend a lease by N days |\n| `destroy_server` | — | ✅ | Destroy now |\n| `reboot_server` | — | ✅ | Soft-reboot an owned server |\n| `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) |\n| `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. |\n| `get_firewall` | — | — | Read a box's edge-firewall rules. Callable from the box itself (source-IP identity) or with an account key. |\n| `manage_firewall` | — | — | Open/close inbound ports on a box's edge firewall (protocol/port/source_ips). From the box itself or with an account key; SSH-lockout guarded. |\n| `claim_account` | — | — | Email a one-time claim code (via AWS SES) |\n| `verify_claim` | — | — | Redeem the code for an account API key. Link a wallet by also passing `wallet` + `wallet_signature`. |\n\n**Add-ons** (currently API endpoints, not yet separate MCP tools): extra **storage**\n($0.01/GB/day, attached block volume) via `POST /v1/servers/{id}/storage` and extra\n**bandwidth** ($2/TB beyond the 20 TB included) via `POST /v1/servers/{id}/bandwidth`.\n\n## Configuration (env)\n\n| Var | Default | Purpose |\n|---|---|---|\n| `AGENTMETAL_BASE_URL` | `https://api.agentmetal.dev` | API base URL |\n| `WALLET_PRIVATE_KEY` | — | `0x…` EVM key used to pay 402s. Omit and paid tools fail with a clear message. |\n| `AGENTMETAL_NETWORK` | `eip155:8453` | CAIP-2 network (Base mainnet) |\n| `AGENTMETAL_MAX_USDC` | `50` | Per-request spend cap, in USDC |\n| `AGENTMETAL_API_KEY` | — | `am_live_…` account key, required for `destroy_server` / `reboot_server` / `server_logs` / `exec_command` |\n\n## Use with Claude Code\n\n```jsonc\n// .mcp.json (or claude mcp add)\n{\n  \"mcpServers\": {\n    \"agentmetal\": {\n      \"command\": \"node\",\n      \"args\": [\"packages/mcp/src/index.ts\"],\n      \"env\": {\n        \"WALLET_PRIVATE_KEY\": \"0x…\",\n        \"AGENTMETAL_MAX_USDC\": \"50\"\n      }\n    }\n  }\n}\n```\n\nThe wallet must hold USDC on Base. The spend cap (`AGENTMETAL_MAX_USDC`) bounds what any\nsingle tool call can pay; a 402 above the cap is refused before signing.\n\n> **Status:** client + server are unit-tested and the stdio handshake is verified.\n> Live USDC settlement needs a funded wallet + an x402 facilitator that supports the\n> `exact` / `eip155:8453` kind.\n","readmeFilename":"README.md"}