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' }
$ npx @usearazzo/cli validate find-a-pet.arazzo.yaml
find-a-pet.arazzo.yaml
39:17-39:22 error 9060201 in must be one of: 'path', 'query', 'header', 'cookie'
44:11-44:36 error 9050804 Step output values must be valid Arazzo Runtime Expressions.
✖ 2 problems (2 errors)
Works with
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.
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.
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.
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.
The tools
Five packages, all on npm as alphas. The toolkit is pre-1.0, and APIs may change before the stable release. Everything is built in the open, so you can read the code and tell exactly where each piece stands.
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