Documentation

Overview

Build and deploy a dynamic sub-agent from a Python project.

What the SDK does

Recurse SDK turns an application directory into a portable bundle that can be deployed as an MCP tool. The directory describes the task, accepted inputs, model, prompt, and Python functions the agent can call.

Use build_bundle from Python when you want to validate and package an application. Use the CLI when you want to log in and deploy it.

Python
from recurse import build_bundle

bundle_bytes, bundle_record = build_bundle("./my-agent")

What you can build

Recurse is suited to work where one attempt should improve in response to measured results: tuning a model, optimizing a query, testing a generated artifact, or any other loop with a clear definition of done.

A deployed application keeps the tool interface declared by your project, so an MCP-compatible agent can call it without learning how the application was authored.