A bidirectional translation driver: n8n REST API ↔ MCP In-Memory Objects. Drop this package in and your entire n8n automation infrastructure becomes AI-native tools.

Quick Start

const n8n = await createN8nConnector({
  url: process.env.N8N_URL!,
  apiKey: process.env.N8N_API_KEY!,
  includeTags: ['ai-enabled'],
  pollInterval: 60_000,
  onChange: () => server.notification({ method: 'notifications/tools/list_changed' }),
});

for (const tool of n8n.tools()) {
  registry.register(defineTool(tool.name, tool.config));
}

Features

| Feature | Description | |---------|-------------| | Dynamic Ingestion | Connects at boot, scans n8n, fetches active webhook flows with release tags, compiles to ToolBuilder instances | | Semantic Inference | Extracts the Notes field from the workflow canvas and injects it as the tool description — zero-shot precision | | MVA Interception | Produces ToolBuilder instances (not a server). Attach Presenters and auth Middleware in RAM | | Surgical Construction | defineN8nTool() points to an exact workflow ID with hand-written Zod schemas and auth middleware | | Live State Sync | Background polling recompiles tools on change and fires notifications/tools/list_changed — zero-downtime hot-reload |

How It Works

The package resolves HTTP I/O, route discovery, state synchronization, and LLM semantics. But it returns 100% of the control over Routing, Protocol, and Security (MVA) to the developer in server.ts.

The perfect balance between the agility of low-code integrations and hardcore software engineering.

Installation

npm install @vurb/n8n vurb zod

Peer Dependencies

| Package | Version | |---------|---------| | vurb | ^2.0.0 | | zod | ^3.25.1 \|\| ^4.0.0 |

Requirements

• Node.js ≥ 18.0.0
• Vurb.ts ≥ 2.0.0 (peer dependency)
• n8n instance with API access enabled

License

Apache-2.0