# Darwin

> Learn how Darwin turns intent into completed work, or build Darwin into your own product with APIs, SDKs, CLI, and MCP.

- [Overview](https://darwin.so/docs/overview/home.md): Search for what can do it. Act to make it happen.
- [How it works](https://darwin.so/docs/overview/how-it-works.md): Search for an exact capability, then act on it through any Darwin interface.
- [Rate limits](https://darwin.so/docs/overview/rate-limits.md): The free Search allowance across Darwin API, MCP, and web.
- [Search](https://darwin.so/docs/features/search.md): Find the best executable capability for an intent.
- [Search quickstart](https://darwin.so/docs/features/search/quickstart.md): Find an executable capability and preserve the exact result for Act.
- [Search modes](https://darwin.so/docs/features/search/modes.md): Choose the smallest Search request that matches your discovery task.
- [Search best practices](https://darwin.so/docs/features/search/best-practices.md): Write useful queries and preserve trustworthy discovery results.
- [Evaluate Search](https://darwin.so/docs/features/search/evaluate.md): Measure ranking quality with representative intents and executable outcomes.
- [Search reliability](https://darwin.so/docs/features/search/reliability.md): Handle limits, transient failures, pagination, and stale results safely.
- [Search with MCP](https://darwin.so/docs/features/search/mcp.md): Let an MCP client discover public capabilities through Darwin.
- [Act](https://darwin.so/docs/features/act.md): Move a selected capability toward an outcome.
- [Act quickstart](https://darwin.so/docs/features/act/quickstart.md): Start durable work from an exact Search result and follow it to a truthful outcome.
- [Action lifecycle](https://darwin.so/docs/features/act/lifecycle.md): Model durable work as explicit states and available next actions.
- [Act best practices](https://darwin.so/docs/features/act/best-practices.md): Keep execution explicit, idempotent, reviewable, and recoverable.
- [Approvals and interactions](https://darwin.so/docs/features/act/approvals.md): Review exact terms and complete sensitive browser steps without widening authority.
- [Evaluate Act](https://darwin.so/docs/features/act/evaluate.md): Test execution quality, truthful states, authority boundaries, and recovery.
- [Act reliability](https://darwin.so/docs/features/act/reliability.md): Retry mutations safely and recover long-running work from its durable action ID.
- [Act with MCP](https://darwin.so/docs/features/act/mcp.md): Coordinate durable work through Darwin’s six focused Action tools.
- [Search](https://darwin.so/docs/reference/search.md): Find and rank executable public capabilities.
- [Start action](https://darwin.so/docs/reference/act-start.md): Start durable work from an exact Search result.
- [Get action](https://darwin.so/docs/reference/act-status.md): Get the current state and required next step for an action.
- [List actions](https://darwin.so/docs/reference/act-list.md): List current, nonterminal actions available to the caller.
- [Update action](https://darwin.so/docs/reference/act-update.md): Give an action clarification or requested information.
- [Approve action](https://darwin.so/docs/reference/act-approve.md): Approve, reject, or request changes to an exact reviewed payload.
- [Stop action](https://darwin.so/docs/reference/act-stop.md): Stop the current queued or running turn.

## OpenAPI Specs

- [openapi-v2](/docs/openapi-v2.json)
- [openapi](/docs/openapi.json)
- [product-openapi](/docs/product-openapi.json)

## Optional

- [Get API Key](https://darwin.so/settings?tab=developer)
- [OpenAPI Spec](https://darwin.so/docs/openapi-v2.json)
- [MCP](https://darwin.so/docs/mcp/overview)
- [Python SDK](https://pypi.org/project/darwin-sdk/)
- [TypeScript SDK](https://www.npmjs.com/package/@darwinso/sdk)
- [Web](https://darwin.so)