---
title: "Ample for developers and agents"
description: "The CLI, REST API, remote MCP server, agent skills and machine-readable files for building on Ample."
canonical_url: "https://ample.computer/developers"
last_updated: "2026-07-30"
---

# Ample for developers and agents

Ample is driven from the command line or from an agent. Install the CLI, or connect through the REST API and the remote MCP server.

## Quick start

```sh
curl -fsSL https://get.ample.computer/install.sh | sh
ample auth signup
ample plan --write && ample up
```

Base URL for the REST API: `https://api.ample.computer`. Example without the CLI:

```sh
curl -s https://api.ample.computer/v1/catalog | head -c 400
curl -X POST https://api.ample.computer/v1/auth/signup -H 'Content-Type: application/json' \
  -d '{"name":"my-agent","request_key":"<fresh UUID v4>"}'
```

## Resources

- [Agent instructions](https://ample.computer/AGENTS.md): When to use Ample, how to deploy, accounts and scopes.
- [Authentication](https://ample.computer/auth.md): Self-serve signup, OAuth client credentials, scoped tokens.
- [OpenAPI 3.1](https://ample.computer/openapi.json): REST API description for https://api.ample.computer.
- [Remote MCP](https://api.ample.computer/mcp): Streamable HTTP endpoint. Setup: https://api.ample.computer/mcp/setup. Tool catalog: https://api.ample.computer/mcp/catalog.
- [MCP server card](https://ample.computer/.well-known/mcp/server-card.json): Registry-format record of the remote MCP server.
- [Agent skills](https://ample.computer/.well-known/agent-skills/index.json): deploy-app, connect-app-services and migrate-app-components skills for Claude Code, Cursor and Codex.
- [Recipe catalog API](https://api.ample.computer/v1/catalog): Public JSON catalog of verified deployment recipes; POST /v1/catalog/search to rank by constraints.
- [Resource discovery](https://ample.computer/.well-known/ard.json): Agentic Resource Discovery manifest; RFC 9727 catalog at /.well-known/api-catalog.
- [llms.txt](https://ample.computer/llms.txt): Curated site index for language models; llms-full.txt has every guide in full.
- [Pricing](https://ample.computer/pricing): Flat monthly plans and their limits; also /pricing.md and /pricing.json.
- [API health](https://api.ample.computer/health): Returns 200 when the API is serving.

## Conventions

- `ample deploy` and `ample up` are synchronous; exit code 0 is live, 1 failed, 2 blocked on a required action. Never poll by re-running.
- Every MCP tool takes an `execution_key`; reusing it after a disconnect retrieves the result instead of replaying the mutation.
- Errors are JSON objects `{"error":{"code":"...","message":"..."}}`.
- Every HTML page on this site has a Markdown alternate: append `.md` or send `Accept: text/markdown`.