Overview

Build with one durable loop: discover an executable capability, select the exact revision, and move the work toward a truthful outcome.

Add Darwin to your product

Search public capabilities and coordinate real work through one stable contract.

Start building Get an API key

Two operations, one workflow

TypeScript

SearchFind and rank executable capabilities.ActStart durable work from the selected revision.

import { DarwinClient } from '@darwinso/sdk';

const darwin = new DarwinClient({
  token: process.env.DARWIN_API_KEY!,
});

const found = await darwin.search({
  query: 'OCR that handles handwriting and tables',
  limit: 5,
});

const selected = found.results[0];

Understand Search →

const action = await darwin.startAction({
  capabilityId: selected.capabilityId,
  capabilityRevision: selected.capabilityRevision,
  inputs: { file: 'https://example.com/invoice.pdf' },
  requestId: crypto.randomUUID(),
});

// Keep action.actionId. It is the durable handle for this work.

Understand Act →

Search is read-only. Act preserves the selected capability revision and pauses whenever the user needs to supply information, connection, payment, or approval.

Choose how you build

REST API

Call the public v2 contract from any trusted server environment.

TypeScript and Python

Use generated clients with typed requests, responses, and errors.

MCP

Give a compatible AI client focused Search and Action tools.

What Darwin keeps explicit

Selection

Canonical ranking, match evidence, availability, and pricing stay visible before work starts.

Authority

Authentication, connection, payment, and approval remain separate decisions.

State

One actionId survives waits, browser handoffs, retries, and client restarts.

Start with the right guide

Developer quickstart

Make your first Search and start an Action in four steps.

Build with an Agent Skill

Teach an AI when to search, when to act, and when to stop for the user.

Service status · Pricing · Changelog

Last modified on September 21, 2026

Get Started

Search

Act

SDKs

Interfaces

Admin

Two operations, one workflow

Choose how you build

REST API

TypeScript and Python

MCP

What Darwin keeps explicit

Selection

Authority

State

Start with the right guide

Developer quickstart

Build with an Agent Skill

​Two operations, one workflow

​Choose how you build

REST API

TypeScript and Python

MCP

​What Darwin keeps explicit

Selection

Authority

State

​Start with the right guide

Developer quickstart

Build with an Agent Skill

Two operations, one workflow

Choose how you build

What Darwin keeps explicit

Start with the right guide