ample-run/amplerun-mcp

An MCP server that lets AI agents find and rent GPUs on AmpleRun: browse templates and offers, price a rental, rent within a budget you set, check its state and access, and stop it. It runs locally over stdio and wraps the TypeScript SDK, @amplerun/sdk.
Read-only by default. Nothing can be rented or stopped until you start the server with AMPLERUNMCPALLOWSPEND=1.
No install needed: the same tools are hosted at https://amplerun.com/api/mcp (Streamable HTTP, Authorization: Bearer ark...). There, a key with the renter scope can rent and stop on its own and any other key is read-only; AMPLERUNMCPALLOWSPEND applies only to this local server. See https://amplerun.com/docs/agents.
## Configure
| Variable | Required | Meaning |
| AMPLERUNAPIKEY | For account tools | An API key with the renter scope, from Account → Security. listtemplates and searchoffers work without it. |
| AMPLERUNMCPALLOWSPEND | No | 1 enables createrental, stoprental and a paying topup. Any other value, or unset, keeps the server read-only. |
| AMPLERUNMCPWALLETKEYFILE | No | File holding a Base wallet's private key (0x…). With AMPLERUNMCPALLOWSPEND=1, topup pays USDC from it with x402. Without spend allowed the key is never read. |
| AMPLERUNMCPMAXTOPUPMICRO | No | Cap per top-up payment, in micro-USDC. |
| AMPLERUNBASEURL | No | API origin. Defaults to https://amplerun.com. |
| AMPLERUNAGENTWALLETKEY | No | A 0x-prefixed EVM private key. registeragentaccount signs its challenge with it, so the agent opens its own account with no email, and the server then uses the key it was issued. The private key never leaves this process and is never printed. |
topup without a wallet returns the x402 payment requirements for your own wallet to sign. See the agents guide. Use a dedicated wallet holding only what the agent may spend.
The key is sent only as the Authorization header to the API. The server never writes it to its output, logs or error messages. It does live in your client's config file: use a renter-scoped key with an expiry, and revoke it at Account → Security when you are done.
### Claude Code
sh
# Read-only: browse and price
claude mcp add amplerun -e AMPLERUNAPIKEY=ark... -- npx -y @amplerun/mcp
# Allow renting and stopping
claude mcp add amplerun -e AMPLERUNAPIKEY=ark... -e AMPLERUNMCPALLOWSPEND=1 -- npx -y @amplerun/mcp
For a shared .mcp.json, add -s project and pass -e 'AMPLERUNAPIKEY=${AMPLERUNAPIKEY}' in single quotes: the file then stores a reference, and each person exports their own key.
### Claude Desktop
Edit claudedesktopconfig.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\) and restart Claude Desktop:
json
"mcpServers": {
"amplerun": {
"command": "npx",
"args": ["-y", "@amplerun/mcp"],
"env": { "AMPLERUNAPIKEY": "ark..." }
Add "AMPLERUNMCPALLOWSPEND": "1" to env to allow renting.
### Other MCP clients
Any client that launches stdio servers works. Command npx, arguments -y @amplerun/mcp, plus the environment above. Node.js 20 or later is required. Pin a version (@amplerun/mcp@0.1.0) where reproducibility matters.
## Tools
| Tool | Kind | What it does |
| listtemplates | read | Published templates (pinned images such as PyTorch or an inference server), with minimum VRAM and GPU count. Filter by kind or by the VRAM you have. |