Magic Dev 5.0 – Official Documentation

Welcome to the official documentation of Magic Dev 5.0!

📖 Magic Dev 5.0 - Complete Presentation with Introduction There are moments in life when everything shifts in a split second. For me, it was a March 2025 morning on a public works construction site. An accident. The kind that pins you to bed and forces you to rethink your entire existence.

My name is Charles, I'm 34 years old, and until that fateful March day, I was a mason's assistant. My hands knew concrete, my muscles the fatigue of labor, and my daily routine followed the unchanging rhythm of construction sites.

Then life offered me a forced break. Six months off work, six months pacing around my apartment in Les Salles-sur-Verdon. It's funny how boredom can sometimes be the best teacher.

One evening, while wandering the internet, I stumbled upon something strange: n8n. Little boxes connected to each other, data dancing from one service to another, pure automation. I had the same revelation as a kid discovering LEGO for the first time.

The nights began to fly by. 12 hours, 14 hours in front of the screen, as if I was playing the most addictive video game in the world. My fingers learned a new language, my neurons reconnected at breakneck speed. System architecture, biomimetics, automation... Everything mixed in my head into a creative symphony I had never felt on a construction site.

And then Magic Dev was born.

Not from a marketing plan, not from a commercial strategy. Just from the pure desire of a guy who had just discovered his true passion and wanted to share it with the whole world. A node that wouldn't just be a tool, but a playground, a meeting place, a collective adventure.

1300 downloads in 4 days. Apparently, I wasn't the only one dreaming of a more alive, more human, more... magical n8n ecosystem.

This documentation isn't a cold technical manual. It's the story of a renaissance, of a growing community, and of a node that carries within it six months of sleepless nights and consuming passion.

Welcome to the Magic Dev universe.

📚 Table of Contents Presentation and Prerequisites - Quick Without Blabla

Technical Presentation Mode 🤖 AI Magic Generator

Technical Presentation Mode 🎁 Creator Magic Hub

Technical Presentation Mode 🔑 Quest Magic Unlock

Market

📋 1. Presentation and Prerequisites - Quick Without Blabla

Essential: manual trigger + n8n-nodes-magic-dev

Presentation Mode 🗃️ Magic Market 🤖 Magic Mapping → A prompt, instance URL, N8N API key, OpenRouter API to teleport your workflow to your instance.

🎁 Creator Mapping → Instance URL, N8N API key and a random creator workflow teleports to your instance.

🔑 Quest Mapping → Instance URL, N8N API key, secret code found in Creator Mapping to win a premium workflow.

🗃️ Magic Market → PUBLISH: Share your workflows with description and public Google Sheets URL | SEARCH: Find workflows by keywords in our community-driven public link database. Help us build one of the largest open source workflow databases in the world!

⭐ FEEDBACK: Optional rating system (1-20 stars) + comments available in all modes

🤝 Creators: Want to collaborate? Contact me via Telegram @magicdev_bot! 💝 Donation: 0xfb1f5190Dd2498Cd25Db95d6b23C7145bc14E667 (multichain)`,

🤖 2. Technical Presentation Mode AI Magic Generator (Beta) The first blade of my digital Swiss knife. The one that made me understand that the boundary between dream and reality was thinner than I thought.

What does it actually do? This mode helps builders who use AI to create their JSON code live easier lives. It transforms raw prompts into functional n8n workflows through intelligent automation.

The concrete mechanism: Insert your instance URL, your n8n API key in create mode, your OpenRouter API key, execute the workflow, and behind the scenes a workflow acting as a backend receives a whole bunch of exploitable fields.

🗂️ Complete Field List (AI Magic Generator)

Below is every field currently used by the AI Magic Generator mode, followed by a short description of its purpose.

mode  Defines the active node mode. For this feature the value is always "ai_generation".

timestamp  ISO-8601 date-time added when the request is built. Lets the backend sort and track requests chronologically.

version  Magic Dev package version that generated the request. Guarantees backward compatibility when the schema evolves.

type  Specifies what is being generated. In the example it is "ai_workflow".

fieldSet  Name of the logical field group being sent. For AI generation this is simply "ai".

aiInstanceUrl  Public URL of the n8n instance that will host / receive the finished workflow.

aiApiKey  Personal n8n API key (created in Owner → API). Authorises workflow creation inside your instance.

aiOpenrouterKey  Your OpenRouter key that unlocks access to GPT-4, Claude, Gemini, etc. The key is forwarded unchanged to OpenRouter.

aiPrompt  Natural-language instruction given to the AI (e.g. “LangChain agent with Google tools”). It is the heart of the request.

aiComplexity  Desired sophistication level. Accepts "basic", "intermediate" or "advanced" and steers the size / depth of the workflow returned.

feedback.rating  Integer between 0-20 allowing the user to grade the result quality.

feedback.comments  Free-text field for any comment you want to send back to improve the generator.

feedback.mode  Echoes the mode the user was in when leaving feedback (e.g. "ai_generation"). Useful when the same backend serves many modes.

feedback.timestamp  Date-time attached to the feedback object so ratings can be analysed over time.

webhookUrl  Public callback URL where asynchronous status updates will be pushed (long AI jobs, laarge file uploads, etc.).

executionMode  Tells the backend how to execute the workflow: "production", "test" or "dev". Enables throttling or sandboxing when needed.

🧠 AI Magic Generator Mode

Goal: Transform a natural-language prompt into a fully functional n8n workflow using OpenRouter + intelligent formatting.

🔹 Step-by-Step

Webhook Input

Receives: aiPrompt, aiInstanceUrl, aiApiKey, aiOpenrouterKey, aiComplexity

Timestamp Injection

A DateTime node adds timestamp in Europe/Paris timezone.

Golden Router

Switch node checks mode === "ai_generation"

Field Processor (processor_ai_generation)

Cleans and structures fields into processedFields

AI Agent (Golden_Dev)

Uses LangChain/LLM with prompt constraints to return valid n8n workflow JSON

Output Parser (parse_ai_generation)

Cleans output and isolates the workflow_data object

Workflow Teleportation (mapping_ai_generation)

Sends workflow to user’s n8n instance using aiInstanceUrl + aiApiKey

Google Sheets Logging (optional)

Archives prompt, output, timestamps, feedback, and result data

🔐 Notes

ExecutionMode, feedback.rating, webhookUrl, and complexity level can also be passed optionally

Ideal for pro builders and automation architects

🎁 Creator Mode

Goal: Instantly deliver pre-made workflows from the Magic Vault into any user’s n8n instance.

🔹 Step-by-Step

Webhook Input

Receives: creatorInstanceUrl, creatorApiKey

Golden Router

Checks mode === "creator_mapping" to activate this mode

Vault Picker

Selects a random or curated workflow from the Magic Vault (local, Google Sheet, or hosted list)

Workflow Fetcher

Downloads and validates the JSON

Teleportation (creator_mapping)

Sends the workflow to the user's n8n instance via API POST

Feedback (optional)

User can rate (0-20), comment, or interact with Creator Notes

Logging

Tracks deployed workflow, timestamp, user ID (anon or hash), feedback

🕵️ Hidden Clues for Quest Mode

Some Creator Notes contain hidden clues – encrypted messages, keywords, or ciphers. If you find them and piece them together, you can unlock Quest Mode, where premium workflows are stored.

🔑 Quest Mode (Teaser)

A secret mode, only unlocked with the correct password or sequence of clues hidden in the Creator Mode workflows. When unlocked, it grants access to:

Exclusive workflows

Special automations

Rare utilities created by top community builders

To unlock it, collect fragments from Creator workflows, observe the notes, and decode the logic behind them. Once you find the correct code — you’ll know.

🗃️ Magic Market Mode (Community Database)

Goal: Create a community-driven open database of workflows, fully searchable and shareable.

Features:

Publish: Share your own workflows with title, description, and a public Google Sheets URL

Search: Find workflows by keyword, category, creator, or theme

Rate: Provide 1–20 star ratings and community comments

This mode is designed to:

Grow the world’s largest free n8n workflow database

Encourage collaboration and discovery

Archive and curate thousands of community solutions

This mode is ideal for:

Power users who want to contribute

Beginners looking for examples

Hackathons, open data competitions, and public service innovation

Use the mode: "magic_market" to route into this logic. Submissions and searches both go through the same node family.

🤝 Community

Share your own workflows via Magic Market

Rate and comment on workflows

Collaborate via @magicdev_bot on Telegram

💝 Donations

Wallet (multi-chain): 0xfb1f5190Dd2498Cd25Db95d6b23C7145bc14E667

Magic Dev is more than a node. It’s a playground, a discovery engine, and a tribute to creative resilience.

Let the magic begin.