Node-RED Custom Nodes

Run custom TypeScript code in a secure V8 sandbox. Full access to MCP tools, LLM, and storage via the SDK. Supports multi-output: configure 1-5 output ports and return an array to route data to different paths.

Config: Write TypeScript code. Set the number of outputs (1-5). Return a single value or an array for multi-output.

Send a prompt to the LLM. Supports template variables using {{input}} to inject data from the previous node.

Config: Write your prompt template. Use {{input}} to reference the output of the previous node.

Template engine for building LLM prompts. Use ${context} and ${input} placeholders to inject data from upstream nodes. Great for crafting structured prompts with dynamic data.

Config: Write your template text with ${context} and ${input} variables.

Send messages to an LLM with per-node configuration. Accepts two inputs: context (from osf-context, sent as system message) and prompt (from osf-prompt-tpl, sent as user message). Supports JSON mode for structured output.

Config: Set LLM URL, model, temperature, and toggle JSON mode. Connect osf-context and osf-prompt-tpl as inputs.

Validate and parse JSON output against a schema. If validation fails, automatically retries by asking the LLM to fix the output. Ensures structured, reliable data from LLM responses.

Config: Define a JSON schema. Set max retry attempts (1-5).

Aggregates data from multiple upstream nodes into a single JSON object. Each input is keyed by the source node's label. Connect multiple nodes into one context to collect data before sending it to an LLM.

Config: Optional: Override key names for each input source.

Make HTTP requests to external APIs. Supports GET, POST, PUT, DELETE with custom headers, authentication, and JSON mode. URL supports template variables.

Config: Set method, URL, headers, auth token, timeout, and JSON mode.

Conditional branching. Route the flow to different paths based on the previous node's output using configurable conditions.

Config: Define conditions for each output port (e.g., 'has-errors', 'always', 'never').

Call another saved flow as a sub-routine. The sub-flow receives the current node's input and returns its final output. Includes recursion protection (max depth 5).

Config: Enter the Flow ID to call and set max recursion depth.

Pause the flow and wait for human approval or input. The flow resumes when the user responds.

Config: Set the prompt text and optional choices.

Run an existing AI agent (built-in or community). The agent performs its full analysis with MCP tool calls and returns the result.

Config: Select the agent by name from the dropdown.

Route messages based on property values. Supports equality, comparison, range, regex, and more. Each rule maps to an output port.

Config: Set the property to evaluate and define rules for each output.

Set, change, delete, or move properties on the message object. Useful for transforming data between nodes.

Config: Add rules: set a value, change (find/replace), delete, or move a property.

Mustache-style template rendering. Use {{payload.field}} syntax to build strings from message data.

Config: Write a Mustache template. Access message properties with double braces.

Run custom JavaScript code. Receives a msg object and can modify or create new messages. Supports multiple outputs.

Config: Write JavaScript. Return msg to pass it on, or return an array for multiple outputs.

Make HTTP requests to external services. Supports all methods, custom headers, authentication, and response parsing.

Config: Set URL, method, headers, and payload. Response is available in msg.payload.

Split arrays or objects into individual messages, or join multiple messages back together. Useful for parallel processing.

Config: Split: choose array, string, or object mode. Join: set count or timeout.

Delay message delivery by a configurable amount of time (max 60 seconds in the OSF engine).

Config: Set delay duration in seconds.

Log message data to the Node-RED debug sidebar and the OSF run output. Passes the message through unchanged.

Config: Choose what to display: full message or specific property.