Skip to content

JSON Schema

The form format is published as JSON Schema (draft 2020-12), drawn from the validator every save and publish is checked with:

File What it describes
/schema/form.json A form: what’s in a .seaforms.json file.
/schema/live.json A form’s live config: what happens after Send.

To read a form’s file with hints and checks in VS Code or Cursor, point *.seaforms.json at the schema. That leaves the files themselves as they are:

.vscode/settings.json
{
"json.schemas": [
{
"fileMatch": ["*.seaforms.json"],
"url": "https://developer.seaforms.io/schema/form.json"
}
]
}
check-form.ts
import Ajv2020 from "ajv/dist/2020.js";
const schema = await fetch("https://developer.seaforms.io/schema/form.json").then((r) => r.json());
const validate = new Ajv2020({ strict: false }).compile(schema);
if (!validate(form)) console.error(validate.errors);

The MCP connector’s form_schema tool hands the same document to a connected tool, so it can write a form with exact keys and allowed values.

Was this helpful?

Your answer goes straight to the person who wrote it.

Thanks. We read every note and update the article.

Thanks, that helps us keep these useful.

ChatGPT is a trademark of OpenAI, and Claude and Claude Code are trademarks of Anthropic. Other product names and logos belong to their owners. None of them makes or endorses Seaforms. Trademarks