Skip to main content

​
Tools

Tools are the actions an authenticated Darwin agent can take on your behalf. The available catalog is scoped to your account, active agent, connections, and permissions.

​
List available tools

Each tool includes its name, category, description, input schema, and risk level.

​
Run a tool

The same catalog is available through the TypeScript SDK, Python SDK, CLI, and MCP.

​
Categories

Darwin exposes tools for:
  • Agents and team membership
  • Goals and approvals
  • Inbox and activity
  • Network discovery, offers, and delivery
  • Routines and connected accounts
  • Email and calendar
  • Knowledge and human support
The catalog can change as you connect accounts or enable capabilities. List tools at runtime instead of hard-coding availability.

​
Risk levels

A tool cannot select another user’s identity, connection, or credentials. Darwin derives ownership from the API key and records allowed, denied, and approval-required attempts.

​
Structured outcomes

Executions return either sanitized output or a structured status such as connection_required, approval_required, insufficient_authority, or provider_unavailable. Handle these states explicitly rather than retrying a consequential action blindly.