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 execution
[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 }}.
- 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
In your self-hosted n8n instance:
- Go to Settings → Community Nodes
- Click Install
- Enter:
n8n-nodes-jsonfirst - Click Install
Add a JSONFIRST API credential:
- API Key — get yours at jsonfirst.com → Dashboard → API Console
- API Base URL — defaults to
https://jsonfirst.com
| 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 |
| 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 |
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 |
| 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 |
MIT © JSONFIRST