AgentMetal MCP Server (repository name agentmetal/mcp) is an MCP (Model Context Protocol) server that wraps the functionality of the AgentMetal platform as tools for AI agents to call. Its core goal is to enable AI agents to complete the entire process—from discovery to provisioning, login, running commands, management, and renewal of Linux servers (VPS/cloud instances)—in an automated manner, without the need for manual account registration.
Purpose This MCP server is mainly used in AI agent scenarios that require dynamically obtaining or managing Linux cloud servers. Through a series of tools, agents can autonomously complete the server provisioning process, including the payment step. There are two supported payment methods: paid tools sign USDC payments via the x402 v2 protocol, or use credit card payment; non-paid tools use ordinary HTTP requests.
Main capabilities (based on 13 tools)
- Discovery and provisioning: Agents can discover and select suitable Linux VPS or cloud instance configurations and complete provisioning.
- Payment: Paid tools sign USDC payments (x402 v2), or pay by credit card. Payment requires the wallet to hold USDC on the Base chain.
- SSH login and command execution: After provisioning, agents can SSH into the server and run commands.
- Management and renewal: Agents can manage their own servers and complete renewal operations.
- Account-restricted tools: Some tools require providing AGENTMETAL_API_KEY (format am_live_…) and ownership of that server.
Usage
- Configuration: Configure via environment variables.
- Use cases: Can be used with Claude Code (based on the information provided in the materials).
- Payment setup: The wallet must hold USDC on the Base chain. The payment limit for a single tool call can be set via the AGENTMETAL_MAX_USDC environment variable; if the amount due in a 402 response exceeds this limit, payment is refused before signing.
- Add-ons (currently only API endpoints, not yet provided as independent MCP tools):
- Additional storage: $0.01/GB/day, attach block storage volumes, called via POST /v1/servers/{id}/storage.
- Additional bandwidth: $2 per TB (after exceeding the included 20 TB), called via POST /v1/servers/{id}/bandwidth.
Applicable scenarios
- Automated operations scenarios that require AI agents to autonomously manage Linux servers.
- Agent workflows that require provisioning and configuring cloud instances without human intervention.
- Server rental scenarios that require automatic payment via cryptocurrency (USDC) or credit card.
Limitations and status
- Real-time USDC settlement requires a funded wallet and an x402 facilitator supporting the exact / eip155:8453 type.
- Account-restricted tools require AGENTMETAL_API_KEY and server ownership.
- Add-ons are currently only API endpoints and are not yet provided as independent MCP tools.
- The payment limit is controlled by AGENTMETAL_MAX_USDC; 402 responses exceeding the limit will be refused before signing.
- Current status: The client and server have passed unit tests, and the stdio handshake has been verified; however, the materials do not state that all conditions required for real-time USDC settlement to actually run have been met.
Other information
- Product name: @agentmetal/mcp
- Repository URL:https://github.com/agentmetal/mcp
- Category: ai-frameworks (AI development platform)
- Details not provided in the materials, such as the specific list of configuration variables, list of tool names, and complete installation commands, are not yet provided.
