# Actual Developer Documentation

> Build with Actual to coordinate verified physical outcomes.

> ## Agent Instructions
> Treat availability labels as authoritative. Do not present planned surfaces as live.
> The product MCP can act on Actual Jobs; the documentation MCP cannot.

## Docs

- [Actual developer documentation](https://docs.askactual.com/index.md): Build experiences that coordinate work toward verified physical outcomes.
- [Quickstart](https://docs.askactual.com/quickstart.md): Preview the intended Actual API integration flow.
- [Availability](https://docs.askactual.com/availability.md): Which Actual developer surfaces are available and which are planned.
- [Job lifecycle](https://docs.askactual.com/concepts/job-lifecycle.md): How a durable Job moves from Objective to verified Outcome.
- [Authority and Approvals](https://docs.askactual.com/concepts/authority-approvals.md): How Actual keeps consequential actions under User control.
- [Evidence and Verification](https://docs.askactual.com/concepts/evidence-verification.md): Why provider claims and execution records do not by themselves prove an Outcome.
- [Authentication and idempotency](https://docs.askactual.com/guides/authentication-idempotency.md): Prepare secure, repeat-safe requests for the planned Actual API.
- [Events and webhooks](https://docs.askactual.com/guides/events-webhooks.md): Planned surfaces for following durable Job changes.
- [Errors](https://docs.askactual.com/guides/errors.md): Handle planned Actual API failures without weakening authority or retry safety.
- [SDK overview](https://docs.askactual.com/sdks/overview.md): Choose between Actual's Effect SDK and Speakeasy-generated clients.
- [Effect SDK](https://docs.askactual.com/sdks/effect.md): The planned Actual-owned Effect-native client.
- [TypeScript SDK](https://docs.askactual.com/sdks/typescript.md): The planned Speakeasy-generated TypeScript and JavaScript client.
- [Python SDK](https://docs.askactual.com/sdks/python.md): The planned Speakeasy-generated Python client.
- [Go SDK](https://docs.askactual.com/sdks/go.md): The planned Speakeasy-generated Go client.
- [Actual's two MCP servers](https://docs.askactual.com/mcp/overview.md): Choose product actions or documentation search without confusing their authority.
- [Product MCP](https://docs.askactual.com/mcp/product.md): The planned authenticated MCP surface for Actual product actions.
- [Documentation MCP](https://docs.askactual.com/mcp/docs.md): Use Mintlify's MCP to search Actual's public developer documentation.
- [API reference](https://docs.askactual.com/api-reference/overview.md): Status of Actual's canonical HTTP API reference.
- [Join the waitlist](https://docs.askactual.com/api-reference/waitlist/join-the-early-access-waitlist.md): Registers an email address for Actual early access. Repeated addresses return the same response and do not reveal prior membership.

## OpenAPI Specs

- [actual-v1.openapi](https://docs.askactual.com/openapi/actual-v1.openapi.json)