# AmpleRun documentation

> Official guides and contract-derived reference for renting compute, building agents and hosting hardware.

Read the guide for your task. The machine API origin is https://amplerun-api.spiry.org; this documentation site is static and never holds your keys.

Source revision: 52fe29dec9e62f2a54368baa379642768bb2b2e4. Contract: 3.0.0.

## Start here

- [Agent authentication](https://docs.amplerun.com/agents/authentication.md): Use scoped Bearer keys and wallet signatures without exposing credentials.
- [Connect through MCP](https://docs.amplerun.com/agents/mcp.md): Configure the hosted or local server and understand the different spending gates.
- [Use the AmpleRun Agent Skill](https://docs.amplerun.com/agents/skill.md): Give an agent a reusable workflow with explicit budgets, state checks, and cleanup.
- [Budgets and receipts](https://docs.amplerun.com/billing/budgets-and-receipts.md): Understand holds, micro-units, readiness-gated charges, and your itemized bill.
- [Add funds with a deposit](https://docs.amplerun.com/billing/deposits.md): Read current network instructions and distinguish pending, spendable, and withdrawable credit.
- [Withdraw a balance](https://docs.amplerun.com/billing/withdrawals.md): Use confirmed destinations and inspect withdrawal state rather than assuming a payout time.
- [Fund with x402](https://docs.amplerun.com/billing/x402.md): Inspect payment requirements before enabling wallet-signed top-ups.
- [Escrow and metering](https://docs.amplerun.com/concepts/escrow-metering.md): Follow credit from reservation hold through accepted runtime to the receipt.
- [Security and trust boundaries](https://docs.amplerun.com/concepts/security.md): Understand account authority, signed host software, and independent-host workload limits.
- [Hardware and hosting tiers](https://docs.amplerun.com/hosting/hardware-and-tiers.md): Match the workload to the machine and distinguish discovery from qualification.
- [Choose a host mode](https://docs.amplerun.com/hosting/modes.md): Understand Dedicated, Idle, and Co-listed availability before offering capacity.
- [Updates and earnings](https://docs.amplerun.com/hosting/updates-and-earnings.md): Keep the signed host agent current and distinguish revenue from completed payouts.
- [AmpleRun documentation](https://docs.amplerun.com/index.md): Rent compute, build agent workflows, and host hardware with clear budgets and verifiable usage.
- [Errors and recovery](https://docs.amplerun.com/reference/errors.md): Handle structured errors without duplicate writes or hidden spending changes.
- [SDKs and HTTP clients](https://docs.amplerun.com/reference/sdk.md): Use the published TypeScript client or a plain HTTP client with explicit origins.
- [Access and inference](https://docs.amplerun.com/renting/access-and-inference.md): Connect only after readiness and keep rental credentials separate from account credentials.
- [Catalogs and quotes](https://docs.amplerun.com/renting/catalog-and-quotes.md): Choose a compatible template and offer, then inspect the immutable quote.
- [Rental lifecycle and retries](https://docs.amplerun.com/renting/lifecycle.md): Track readiness, stop deliberately, and recover from ambiguous requests without duplicate rentals.
- [Set up an agent account](https://docs.amplerun.com/start/agent.md): Register with a wallet signature, store the API key, and prepare a bounded rental workflow.
- [Build with the API](https://docs.amplerun.com/start/developer.md): Discover compatible compute and request a quote with the TypeScript SDK.
- [Become a host](https://docs.amplerun.com/start/host.md): Install the signed host agent, pair your machine, and review its listing.
- [Rent your first machine](https://docs.amplerun.com/start/renter.md): Go from choosing a workload to stopping it and checking your receipt.
- [Get support](https://docs.amplerun.com/support.md): Collect the right identifiers and redacted evidence for a rental, deposit, or host issue.

## Reference and machine-readable files

- [REST API reference](https://docs.amplerun.com/reference/api.md): All 104 operations, generated from the contract.
- [Schema definitions](https://docs.amplerun.com/reference/schemas.md): Shared request and response types.
- [OpenAPI 3.1](https://docs.amplerun.com/openapi.json): Importable API specification; absolute production servers only.
- [Everything](https://docs.amplerun.com/llms-full.txt): Complete public documentation.
- [Revision manifest](https://docs.amplerun.com/version.json): Source and content hashes.
- [Structured index](https://docs.amplerun.com/index.json): Select pages by audience and task; read their Markdown URLs instead of loading the full corpus.
- [Agent Skill](https://amplerun-public.spiryone.workers.dev/skills/amplerun/SKILL.md): The official reusable agent workflow.