Open source · Apache 2.0

OpenAPI Describes Each Call. Arazzo Describes the API Workflow.

You've probably scripted your API workflow by hand, and it breaks quietly when the API changes. Write it as an Arazzo document instead. UseArazzo validates it, runs it against live APIs, and shows you exactly what happened at each step.

Founded by two industry veterans with over 15 years of combined experience building and maintaining core Swagger/OpenAPI tooling. Meet the team →

$ node
> const { ArazzoRunner } = await import('@usearazzo/runner')
> const runner = await ArazzoRunner.load('find-a-pet.arazzo.yaml')
> const inputs = { status: 'available' }
> const result = await runner.execute('findAPet', { inputs })
> result.steps.map((step) => [step.stepId, step.successful])
[ [ 'findPets', true ], [ 'getPet', true ] ]
> result.outputs
{ petId: 11, name: 'doggie' }

Works with

Arazzo Arazzo Specification
OpenAPI OpenAPI Specification (source descriptions)

Why API workflows still get improvised

A single API call is a solved problem. OpenAPI describes it, generators wrap it, and every HTTP client can make it. The order you call the endpoints in, what you carry from one response into the next request, and how you know you are done have no such home. That part lives in scripts, in tribal knowledge, and in agents that work out the call order at runtime. If you maintain an API, test one, or build agents on top of one, you have written that glue yourself. It is rarely reviewed, rarely versioned alongside the API it drives, and it breaks quietly when the API changes. Improvisation is exactly what you don't want in production.

Read why it still happens →

What it does

Plenty of tools will tell you whether an Arazzo document is well formed. Far fewer will run it. UseArazzo does both, and tells you what happened.

The UseArazzo pipeline: an Arazzo document is described once, validated with every violation located, run step by step against live APIs, and read back as a trace of each step with the outputs and final status. arazzo: 1.0.1workflows:- workflowId: findAPetsteps:- stepId: findPets- stepId: getPet 01 Describe an Arazzo document in your repository - name: petIdin: pathsvalue: $steps.findPets…✖ error at 39:17 02 Validate every violation, with its location findPetsgetPetAPI 03 Run each step, against live APIs findPetsgetPetcompletedpetId: 11, name: 'doggie' 04 Read the trace steps, outputs, final status
Get started

Why UseArazzo

Deterministic execution

A workflow that ran yesterday runs the same today. Agents can choose which workflow to run, not improvise the steps inside it.

The standard is the product

UseArazzo implements Arazzo exactly as the specification defines it. When something needs fixing, the fix goes upstream into the specification, not into private extensions that only one tool can read.

See the upstream contributions →

Portable artifacts

Plain Arazzo documents in your repository, driven from your own code, your CI pipeline, or an agent. If you stop using the toolkit, your API workflows keep working.

Compatibility

What the toolkit can validate and run today.

Document Versions Validate Run
Workflow Document: Arazzo 1.0.0, 1.0.1, 1.1.0 ✓ Yes ✓ Yes
Source Description: OpenAPI 2.0, 3.0.x, 3.1.x ✓ Yes ✓ Yes
Source Description: OpenAPI 3.2.x ✗ No ✗ No
Source Description: Arazzo 1.0.0, 1.0.1, 1.1.0 ✓ Yes ✓ Yes
Source Description: AsyncAPI any ✗ No ✗ No

On the roadmap

None of this is built yet. It's where the toolkit is headed, published here so you can tell what exists today from what doesn't.

Language Service

An LSP-compatible library bringing Arazzo intelligence to any editor or tool: validation, completion, hover, go-to-definition, and find references.

Editor

A browser-based editor for authoring and validating Arazzo workflows with real-time feedback.

VS Code Extension

Arazzo authoring inside VS Code: real-time validation, semantic linting, autocompletion, and live preview.

GitHub Actions

Validation and run results reported where the work happens: violations annotated on the diff, the step-by-step run trace rendered into the job summary, and the check status driven by step outcomes rather than a single pass or fail.

Agent Skills

A set of task-shaped skills teaching agents to work the toolchain: authoring workflows from an API description, validating and fixing them, and reading a run trace when a step fails.

MCP Server

A generic Model Context Protocol server exposing validation and execution over any Arazzo document, so agents can check and run workflows with no build step.

MCP Compiler

Compiles a specific workflow into a dedicated MCP server: one typed tool per workflow, with real input schemas, for production agent deployments.

Arazzo Transformers

Explicit, versioned transformations for reshaping data between steps, declared as ordinary API calls the toolchain can validate rather than arbitrary code that needs a sandbox to run.

Community

Built in the open

Every part of UseArazzo is open source under Apache 2.0, and it runs on your machine. Contributions, issues, and questions are welcome.

Get help from the maintainers

UseArazzo is free to use. If you have a question, an idea, or a bug to report, Discussions is a good place to start, and you are welcome to email the maintainers directly about anything else.

Talk to the maintainers