n8n-nodes-jsonfirst
v1.1.3
Published
JSONFIRST community node for n8n — Convert natural language to structured JDON intents with AI governance
Maintainers
Readme
n8n-nodes-jsonfirst
Stop writing fragile prompts for AI agents.
JSONFIRST converts natural language into structured JSON intent your agents can execute safely.
Intent → JSON → Execution.
JSONFIRST helps build reliable AI agents by converting natural language into structured JSON intent.
User input
↓
JSONFIRST parsing
↓
JDON (structured intent)
↓
Agent executionQuick Example
[Webhook] → [JSONFIRST: Process Intent] → [Switch on action.normalized] → [HTTP Request / Email / DB]Input:
"Create an order for John, 2 units of product A"Output:
{
"action": { "normalized": "create" },
"object": { "type": "order" },
"confidence": 0.94
}Route your workflow on {{ $json.jdons[0].action.normalized }}.
Who is this for
- n8n automation builders — parse natural language into routable workflow actions
- AI agent developers — add a structured intent layer to your LLM pipeline
- Developers done with fragile prompts — replace brittle regex with governed JSON intents
Installation
In your self-hosted n8n instance:
- Go to Settings → Community Nodes
- Click Install
- Enter:
n8n-nodes-jsonfirst - Click Install
Configuration
Add a JSONFIRST API credential:
- API Key — get yours at jsonfirst.com → Dashboard → API Console
- API Base URL — defaults to
https://jsonfirst.com
Operations
| Operation | Description | |---|---| | Process Intent | Convert text → JDON (structured intent object) | | Execute Intent | Process + execute the intent end-to-end | | Validate JDON | Check a JDON object against the JSONFIRST spec | | Get Governance Modes | List all available modes for your plan |
Governance Modes
| Mode | Description |
|---|---|
| ANTI_CREDIT_WASTE_V2 | Default — optimizes token usage, instant response |
| MAX_PERFORMANCE | Full LLM processing for maximum accuracy |
| STRICT_PROTOCOL | Enforces strict JSONFIRST compliance |
| EXPRESS_ROUTE | Fastest possible processing |
| GUARDIAN_MODE | Enhanced safety and content filtering |
Early Testers
Looking for the first 20 developers testing n8n-nodes-jsonfirst. Open an issue using the Early Tester template and your project will be listed here.
| # | Project | Use case | |---|---|---| | — | Be the first | Open an issue |
Plans & Pricing
| Plan | Intents/month | Price | |---|---|---| | Free Trial | 50 | €0 | | No-Code Builder | 1,000 | €29/mo | | Pro | 2,000 | €49/mo | | Business | 10,000 | €149/mo |
Links
License
MIT © JSONFIRST
