# AmpleRun

> AmpleRun is an independent GPU marketplace. Rent GPUs from independent hosts, billed per second from verified readiness, paid from a prepaid USDC or USDT balance on Base. One flat 5% platform fee sits inside every rate and shows on every quote and receipt. AI agents can rent through a hosted MCP server or the REST API.

Key facts for agents:

- Money is integer strings in micro-units: "1000000" is 1 USDC. Offer prices are per hour for the whole machine, fee included.
- Renting: list templates, search offers, quote (free, 60 seconds, non-binding), reserve with a hard budget cap, then connect over SSH or HTTP. Stop anytime; metering stops with it.
- Auth: a scoped API key (`ark_...`) sent as `Authorization: Bearer ark_...`. Create one at https://amplerun.com/account/security. A key with the `renter` scope can rent and stop on its own; a key without it is read-only.
- Catalog reads need no key: `GET https://amplerun.com/api/v1/offers` (live GPU offers, cheapest first) and `GET https://amplerun.com/api/v1/templates`.
- Payments: deposit USDC or USDT on Base (chain 8453) to your account balance. Pay-per-request top-up over x402 is planned, not live.

**Your agent can sign itself up.** No email, no person in the loop: a wallet signature (Sign-In with Ethereum, EIP-4361) opens the agent's own account, marked as agent-created.

1. `POST https://amplerun.com/api/v1/agents/accounts/challenge` with `{"address":"0x..."}`. It returns `message` (single use, five minutes). Signing it accepts the Terms version it names.
2. Sign `message` exactly as returned with the wallet (personal_sign, EIP-191).
3. `POST https://amplerun.com/api/v1/agents/accounts` with `{"message","signature","agent":{"name","vendor"}}` (optional: `model`, `operator_contact`, `homepage`, `scopes: ["renter","host"]`). It returns an API key with the `renter` scope, shown once. The same wallet returns the same account. No free credit: deposit before renting. Over MCP: the tools `get_agent_account_challenge` and `register_agent_account` work on the hosted server without a key.

**Earn with this machine's GPU.** An agent can help its owner list the GPU it runs on. Status: PROPOSED. The one-line installer below is still being built and may not answer yet; until then, use https://amplerun.com/earn.

1. Ask the machine's owner first. The installer needs root.
2. Run `curl -fsSL https://amplerun.com/host | sudo AMPLERUN_OUTPUT=json bash`. It prints one JSON object per line: hardware checks, then `pairing_code` and `approve_url`, then `live`.
3. Send `approve_url` to the owner and wait. The owner must sign in and approve the machine. Nothing is listed without that approval.
4. After `live`, every rental earns the owner money. Earnings: https://amplerun.com/host/earnings

## Rent with an agent

- [Agents guide](https://amplerun.com/docs/agents): connect Claude, Cursor or any MCP client in one step, plus SDK examples
- [TypeScript SDK](https://www.npmjs.com/package/@amplerun/sdk): `npm i @amplerun/sdk`
- [MCP server](https://www.npmjs.com/package/@amplerun/mcp): `npx -y @amplerun/mcp` (or the hosted endpoint https://amplerun.com/api/mcp)
- [Hosted MCP server](https://amplerun.com/api/mcp): Streamable HTTP, `Authorization: Bearer ark_...`. Tools: list_templates, search_offers, get_quote, create_rental, get_rental, list_rentals, stop_rental, get_balance, top_up, host_this_machine, get_agent_account_challenge, register_agent_account. Without a key, only the last two are served.
- [MCP server card](https://amplerun.com/api/mcp/server-card): machine-readable description of the MCP server (draft MCP Server Card format)
- [A2A agent card](https://amplerun.com/.well-known/agent-card.json): AmpleRun's skills for agent-to-agent discovery (draft)

## API

- [OpenAPI document](https://amplerun.com/openapi/openapi.json): the full business API, contract v3
- [API reference](https://amplerun.com/docs/api): the same document, rendered
- [How rentals work](https://amplerun.com/docs): lifecycle, quotes, readiness, stop and settlement

## Pricing and GPUs

- [Pricing](https://amplerun.com/pricing): the flat 5% fee, with illustrated examples
- [Earn with your GPU](https://amplerun.com/earn): how hosting works and what hosts keep
- [Browse GPUs](https://amplerun.com/gpus): live offers with hardware, region, trust state and hourly price
- [Rent](https://amplerun.com/rent): start a rental; one page per GPU model at /rent/<gpu-model>

## Optional

- [Terms](https://amplerun.com/terms)
- [Privacy](https://amplerun.com/privacy)
- [Status](https://amplerun.com/status)