# Autonoma

> Agentic end-to-end testing. Autonoma deploys a preview environment for a pull request, runs end-to-end tests against it, and reports what broke.

This host serves the Autonoma web application, which is behind a session and not useful to scrape - the public site is https://getautonoma.com. If you are an agent, use the machine-readable surfaces below.

## Agent surfaces

- [Resource catalog](https://api.autonoma.app/.well-known/ai-catalog.json): Every surface below as an Agentic Resource Discovery document, in one fetch. Start here.
- [Autonoma MCP](https://api.autonoma.app/v1/mcp): Every Autonoma tool on one server. Onboard an application: choose how previews are built, apply configuration, trigger a deploy, validate the test-data SDK, and take the app live. Then debug what Autonoma flags on a pull request: analysis findings, preview deploy status, build and runtime logs, secrets, and scenario recipes. Authenticate with an API key or OAuth. Docs: https://docs.autonoma.app/mcp/
- [Autonoma MCP (debugging alias)](https://api.autonoma.app/v1/mcp/debug): Alias for the Autonoma MCP above, kept for existing configurations. Same server and same tools; its connect-time guidance leads with debugging a reviewed pull request. New integrations should use /v1/mcp. Docs: https://docs.autonoma.app/mcp/
- [Autonoma MCP (onboarding alias)](https://api.autonoma.app/v1/mcp/onboarding): Alias for the Autonoma MCP above, kept for existing configurations. Same server and same tools; its connect-time guidance leads with onboarding a new application. New integrations should use /v1/mcp. Docs: https://docs.autonoma.app/mcp/configure-preview/
- [Autonoma preview environments API](https://api.autonoma.app/v1/previewkit/openapi.json): REST API for preview environments: environment status, secrets, deploy and teardown. Authenticate with an API key.

## Authentication

Send `Authorization: Bearer <key>` with an Autonoma API key. This needs no browser, so it works from CI and from agents running anywhere. Create a key at https://autonoma.app/settings/api-keys.

OAuth is also supported for clients that can open a browser on the same machine; an unauthenticated request describes both options in its response body.

## Documentation

- [Documentation](https://docs.autonoma.app/llms.txt): Full documentation index, in the same format as this file.
- [MCP guide](https://docs.autonoma.app/mcp/): Connecting a coding agent, including headless setups.
- [Preview environments](https://docs.autonoma.app/preview-environments/secrets/): Configuring builds, secrets and test data.