JSONFIRST — Universal Intent Protocol for AI

JSONFIRST is a structured JSON protocol that makes AI agents 100% reliable, auditable, and governable.

Instead of sending ambiguous natural language to your AI, JSONFIRST wraps every intent in a formal contract — with execution mode, constraints, and output spec. The AI cannot hallucinate outside the contract.

→ jsonfirst.com · Templates · Docs · npm

---

What is JSONFIRST?

JSONFIRST is a protocol and SDK that adds a governance layer to every AI interaction. It defines:

• Execution mode — STRICT_PROTOCOL, EXPRESS_ROUTE, GUARDIAN_MODE, FINANCE_ALGO, etc.
• Intent contract — structured jdons array that the AI must follow
• Output constraints — what the AI can and cannot return
• Audit trail — every intent is traceable and immutable

Why JSONFIRST?

Without JSONFIRST	With JSONFIRST
AI hallucinates	AI follows a strict contract
No audit trail	Every intent is logged
Unpredictable outputs	Validated, typed outputs
Hard to automate	Works with any LLM via API

Quick Start

npm install @jsonfirst/sdk

const JsonFirst = require('@jsonfirst/sdk');

const client = new JsonFirst({ apiKey: 'YOUR_API_KEY' });

// Wrap your intent in a governance contract
const result = await client.parse(
  'Transfer 5000€ to supplier account FR76...',
  { mode: 'FINANCE_ALGO' }
);

console.log(result.execution.executable);        // false — requires human confirmation
console.log(result.execution.audit_trail);       // "full"

Governance Modes

Mode	Use case
STRICT_PROTOCOL	Compliance, regulated industries
EXPRESS_ROUTE	Fast automation, low-risk tasks
GUARDIAN_MODE	Human confirmation required
FINANCE_ALGO	Financial transactions, full audit
ETHICAL_LOCK	GDPR, medical, legal
PERFORMANCE_MAX	Speed-optimized, max throughput

View all 12 modes →

Works With

ChatGPT · Claude · Gemini · Mistral · n8n · Make · Zapier · Bubble · FlutterFlow · Airtable · WeWeb · Base44 · Lovable

SDK

npm install @jsonfirst/sdk

• npm: @jsonfirst/sdk
• SDK repo: github.com/JSONFIRST/SDK

50+ Ready-to-Use Templates

Contact forms · E-commerce checkout · Invoice automation · GDPR requests · CI/CD pipelines · Support triage · Medical intake · Legal contracts · HR onboarding · and more.

Browse all templates →

FAQ

What is JSONFIRST? A JSON-based protocol that adds governance, auditability and reliability to AI agent interactions.

Which LLMs does JSONFIRST support? All of them — ChatGPT, Claude, Gemini, Mistral, Llama, and any API-accessible model.

Is it open source? The SDK is open source (MIT). The governance engine is available via API.

How is it different from OpenAI function calling? JSONFIRST is model-agnostic and adds a behavioral contract layer — not just structured output, but execution rules, audit trails, and compliance constraints.

---

Get started → · Documentation → · Pricing →