
MCP server for AmpleRun: AI agents find, rent and pay for GPUs (USDC on Base, x402), register their
MCP server for AmpleRun: AI agents find, rent and pay for GPUs (USDC on Base, x402), register their own account, and host their owner's GPU.
·
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 AMPLERUN_MCP_ALLOW_SPEND=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; AMPLERUN_MCP_ALLOW_SPEND applies only to this local server. See https://amplerun.com/docs/agents.
| Variable | Required | Meaning |
|---|---|---|
AMPLERUN_API_KEY | For account tools | An API key with the renter scope, from Account → Security. list_templates and search_offers work without it. |
AMPLERUN_MCP_ALLOW_SPEND | No | 1 enables create_rental, stop_rental and a paying top_up. Any other value, or unset, keeps the server read-only. |
AMPLERUN_MCP_WALLET_KEY_FILE | No | File holding a Base wallet's private key (0x…). With AMPLERUN_MCP_ALLOW_SPEND=1, top_up pays USDC from it with x402. Without spend allowed the key is never read. |
AMPLERUN_MCP_MAX_TOPUP_MICRO | No | Cap per top-up payment, in micro-USDC. |
AMPLERUN_BASE_URL | No | API origin. Defaults to https://amplerun.com. |
AMPLERUN_AGENT_WALLET_KEY | No | A 0x-prefixed EVM private key. register_agent_account 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. |
top_up 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.
# Read-only: browse and price
claude mcp add amplerun -e AMPLERUN_API_KEY=ark_... -- npx -y @amplerun/mcp
# Allow renting and stopping
claude mcp add amplerun -e AMPLERUN_API_KEY=ark_... -e AMPLERUN_MCP_ALLOW_SPEND=1 -- npx -y @amplerun/mcpFor a shared .mcp.json, add -s project and pass -e 'AMPLERUN_API_KEY=${AMPLERUN_API_KEY}' in single quotes: the file then stores a reference, and each person exports their own key.
Edit claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\) and restart Claude Desktop:
{
"mcpServers": {
"amplerun": {
"command": "npx",
"args": ["-y", "@amplerun/mcp"],
"env": { "AMPLERUN_API_KEY": "ark_..." }
}
}
}Add "AMPLERUN_MCP_ALLOW_SPEND": "1" to env to allow renting.
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/[email protected]) where reproducibility matters.
| Tool | Kind | What it does |
|---|---|---|
list_templates | 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. |
search_offers | read | Machines you can rent now, cheapest first. Filters: GPU model, minimum VRAM, maximum hourly price, region, GPU count, template fit. |
get_quote | read | A free, non-binding 60-second quote for a template on an offer, with the fee split. Nothing is reserved. |
create_rental | write | Quotes and reserves in one step. Requires an explicit budget_micro; returns the rental_id. |
get_rental | read | State, charge so far and, once running, access details (endpoints, SSH command, per-rental endpoint key for model templates). |
list_rentals | read | Your rentals with state and charge, to find a rental_id again. |
stop_rental | write | Stops a rental and its metering. Stopping again is harmless. |
get_balance | read | USDC and USDT balances: spendable, held, pending, disputed, withdrawable, 30-day spend. |
top_up | read, or write with a wallet | Adds USDC with x402. Without a wallet it returns the payment requirements; with AMPLERUN_MCP_WALLET_KEY_FILE and spending allowed it pays them. The credit lands after Base finality. |
host_this_machine | read | How to list this machine's GPU so its owner earns: the installer command, steps and earnings links. Runs nothing; the owner must approve. The installer answers at amplerun.com/host (Linux with an NVIDIA GPU, rented whole, for now). |
get_agent_account_challenge | write | Step 1 of an agent opening its own account: an EIP-4361 message for its wallet to sign. |
register_agent_account | write | Step 2: the signed message returns an agent-tagged account and an API key (shown once). No free credit. On the hosted server both work without a key, and they are the only tools served without one. |
Read tools carry readOnlyHint; write tools carry destructiveHint, so clients that honour annotations can ask before each write. In an auto-approve mode the environment flag and the budget are the guards, so leave AMPLERUN_MCP_ALLOW_SPEND unset unless the agent may spend.
"1000000" is 1 USDC. They are passed through exactly as the API returns them, never converted to floats.fee_split in get_quote and create_rental is the most a rental can cost (the smaller of the full-duration estimate and your budget) split with the ledger's formula: fee = floor(charge × platform_fee_bps / 10000), host share = charge − fee.budget_micro is a hard cap. AmpleRun holds it from your balance and meters from verified readiness, so the final charge can be lower.create_rental sends one Idempotency-Key for its quote and its reservation and returns it. Retrying with the same idempotency_key never creates a second rental. If the first attempt reserved, the retry is refused, usually because the machine is now taken and otherwise with IDEMPOTENCY_CONFLICT, and list_rentals shows the rental. If the first attempt failed or never reached AmpleRun, the retry reserves normally.
The MCP deployment options are a hosted remote server, a bundled local server (MCPB), or a local stdio process. This package is the third, distributed through npm, because:
AMPLERUN_MCP_ALLOW_SPEND is a per-install setting. A shared remote server could only offer one policy for everyone.Update 2026-09-26: the hosted Streamable HTTP server now exists (apps/web/server/mcp.ts), authenticated with the caller's own API key per request and holding no keys; the owner chose scope-gated spending there. Still open: OAuth for clients that only accept OAuth connectors, and an MCPB bundle for Claude Desktop users without Node.js.
This repository mirrors the MCP server that AmpleRun ships as @amplerun/mcp. Issues and pull requests are welcome here.
npm install
npm test # builds this package, then runs the tests
npm run typecheck
node dist/index.js # speaks MCP on stdin/stdout; diagnostics on stderrtest/server.test.ts drives every tool through a real MCP client with the SDK stubbed. test/stdio.test.ts spawns the built server over stdio against a local HTTP stub of the API.
Built on @modelcontextprotocol/server 2.1.0 (the official TypeScript SDK, v2).
Pick your client and paste the snippet. Each one is the same server, written the way that client expects it.
claude mcp add amplerun -- npx -y @amplerun/mcp{
"mcpServers": {
"amplerun": {
"env": {
"AMPLERUN_API_KEY": ""
},
"args": [
"-y",
"@amplerun/mcp"
],
"command": "npx"
}
}
}code --add-mcp '{"name":"amplerun","env":{"AMPLERUN_API_KEY":""},"args":["-y","@amplerun/mcp"],"command":"npx"}'[mcp_servers.amplerun]
command = "npx"
args = ["-y", "@amplerun/mcp"]Runs locally on your device. Your client starts the server itself, so nothing has to be hosted.
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/mcp/amplerun-mcp to learn what the "@amplerun/mcp" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
claude mcp add amplerun -e AMPLERUN_API_KEY=ark_... -- npx -y @amplerun/mcp
claude mcp add amplerun -e AMPLERUN_API_KEY=ark_... -e AMPLERUN_MCP_ALLOW_SPEND=1 -- npx -y @amplerun/mcp| Name | What it does |
|---|---|
get_agent_account_challenge | Step 1 of 2. Returns an EIP-4361 (Sign-In with Ethereum) message for a wallet address this agent controls, valid five minutes, single use. Signing it accepts the AmpleRun Terms version it names. Sign |
register_agent_account | Step 2 of 2. Opens an AmpleRun account for this AI agent, tagged as agent-created, with its wallet as the verified payout wallet, and returns an API key (shown once; keep it secret). The same wallet a |
Read live from the server on November 15, 2026.
Maintain this server? Claiming proves you own the listing and earns the last 4 points.
Claim this listingPaste this line near the top of your repository's README. The badge always renders the current score.
[](https://aiagentslisting.com/mcp/amplerun-mcp)Nothing comparable is listed yet.
No tagged releases on record.
Connect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "amplerun-mcp" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
One email a week. New agents, MCP servers and skills, and what is actually getting traction.