Skip to main content
Glama
mcp-n8n-voice-orchestrator

mcp-n8n-voice-orchestrator

npm version License: MIT

mcp-n8n-voice-orchestrator

A lightweight, deterministic Model Context Protocol (MCP) bridge and reference architecture designed to connect Claude (Sonnet/Haiku/Opus) and Claude Code directly to self-hosted n8n instances, Vapi.ai voice pipelines, Twilio, and WhatsApp Cloud API.

Why This Exists (The Ecosystem Gap)

While n8n provides general workflow nodes and Anthropic's MCP standardizes tool-calling, production voice and messaging pipelines suffer from three critical bottlenecks:

  1. Race Conditions & Webhook Concurrency: Out-of-order webhook arrivals between Vapi end-of-call reports and WhatsApp follow-up triggers.

  2. Sub-Second Latency Requirements: Voice agents require deterministic state lookup (<300ms) before triggering LLM tool calls.

  3. Lack of Standardized MCP Schemas for Self-Hosted Automation: Developers repeatedly rebuild boilerplate JSON-RPC wrappers to expose n8n webhook endpoints as verified Claude MCP tools.

Related MCP server: n8n MCP Server

Core Architecture

  • /mcp-server: TypeScript MCP server exposing n8n webhook workflows as strict, Zod-validated tools for Claude Desktop and Claude API.

  • /workflows: Production-grade n8n JSON blueprints for missed-call recovery, deterministic lead qualification, and multi-channel session handoff.

  • /state-machine: Supabase / PostgreSQL idempotency tables and row-level locking schemas to prevent duplicate outbound dispatches.

Quick Start

git clone [https://github.com/Code-With-Vishal/mcp-n8n-voice-orchestrator.git](https://github.com/Code-With-Vishal/mcp-n8n-voice-orchestrator.git)
cd mcp-n8n-voice-orchestrator
npm install
cp .env.example .env
npm run build
 

Available Tools

1 tool
dispatch_idempotent_n8n_workflowC

Dispatches a deterministic, lock-verified webhook payload to a self-hosted n8n workflow from Vapi, Twilio, or WhatsApp Cloud API.

Inputs: channel (required), payload (required), workflowId (required), idempotencyKey (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3/5.0

    Scored across 1 tool

    Disambiguation5/5

    With only a single tool, there is no possibility of confusing it with another; its purpose as a workflow dispatcher is unmistakable.

    Naming Consistency4/5

    The lone name follows a clear snake_case verb_noun pattern (dispatch_idempotent_n8n_workflow), though with one tool there is no pattern to actually be consistent across.

    Tool Count2/5

    A single tool is too thin for an orchestration server; dispatch is the only operation, leaving no room for status, verification, or management operations.

    Completeness2/5

    The surface offers fire-and-forget dispatch with no way to check workflow status, list available workflows, or handle failures, which are significant gaps for an orchestration role.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Enables users to manage workflows, monitor executions, and perform administrative tasks in n8n through natural language conversations with Claude. It provides over 40 tools to control self-hosted or cloud n8n instances via the Model Context Protocol.
      42
      128 npm
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Production-ready MCP server that brings N8N workflow automation to both Claude.ai and ChatGPT. Supports multi-tenant OAuth/SSE integration with dynamic N8N instance configuration.
      128 npm
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Wraps the n8n self-hosted REST API to let Claude and MCP-compatible LLMs manage workflows, executions, credentials, and more via natural language.
      39
      128 npm
      MIT