> ## Documentation Index
> Fetch the complete documentation index at: https://docs.spreadjam.com/llms.txt
> Use this file to discover all available pages before exploring further.

# jam-nodes

> An extensible, type-safe workflow node framework for building automation pipelines in TypeScript.

## What is jam-nodes?

jam-nodes is a modular framework for building automation workflows in TypeScript. It provides typed node definitions with Zod schema validation, a registry for managing nodes, an execution context with variable interpolation, and a playground for testing nodes.

## Architecture

```
@jam-nodes/core       -> Types, NodeRegistry, ExecutionContext, defineNode utility
@jam-nodes/nodes      -> Built-in node definitions (logic, transform, AI, integrations)
@jam-nodes/playground -> CLI tool for testing nodes interactively
```

core is dependency-free (except Zod + jsonpath-plus). nodes depends on core. playground provides a CLI and web interface for testing.

## Explore the Docs

> [card] [Quick Start](https://docs.spreadjam.com/quickstart.md)
>
> Install packages, create a registry, and run your first node in minutes.

> [card] [Core API](https://docs.spreadjam.com/core/types.md)
>
> Types, registry, execution context, and utility functions.

> [card] [Built-in Nodes](https://docs.spreadjam.com/nodes/overview.md)
>
> 16 ready-to-use nodes for logic, transforms, integrations, and AI.

> [card] [Playground](https://docs.spreadjam.com/playground/overview.md)
>
> Test nodes interactively with the CLI or web playground.

> [card] [Create Custom Nodes](https://docs.spreadjam.com/creating-nodes.md)
>
> Build your own nodes with Zod schemas and register them with the editor.

> [card] [MCP Integration](https://docs.spreadjam.com/mcp.md)
>
> Connect AI agents to jam-nodes documentation via MCP servers.

## Key Features

* **Type-safe** -- Zod schemas for all inputs and outputs with full TypeScript inference
* **Extensible** -- Create custom nodes with `defineNode` and register them
* **Playground** -- CLI and web interface for testing nodes interactively
* **Variable interpolation** -- `{{variable}}` syntax with JSONPath and nested path resolution
* **Credentials injection** -- Nodes receive API credentials via context and make direct HTTP calls
* **Approval workflows** -- Built-in support for human-in-the-loop approval
* **Notifications** -- Nodes can emit notifications through configurable channels


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.