About this plugin
Soflyy Primitives for AI is a modular plugin. Each module is a building block that an AI agent can operate end to end: create it, configure it, read its data, and manage it.
Agent-first. 9). An agent connected to your site over MCP does the work; the admin screens are there for you to see what it built.
Bring your own connection. Primitives does not connect your agent to WordPress. Use any plugin that serves WordPress abilities over MCP — for example the official MCP Adapter, Novamira, or WPVibe.
Its abilities show up there automatically. Abilities require an administrator account.
Module #1: Forms
Agents author a form as a JSON definition; Primitives renders it, validates and stores submissions, and sends notifications.
- Typed fields: text, textarea, email, URL, phone, number, date, select, radio, checkbox, checkboxes, hidden, file upload, and static HTML.
- Server-side validation of every rule, with structured errors.
- Conditional logic and multi-step forms.
- File uploads into a protected directory, downloadable only by administrators.
- Email notifications (through wp_mail() ) and outgoing webhooks.
- Spam protection with a honeypot and a time trap. No third-party captcha.
- Semantic markup with stable primitives- class hooks and no visual styling, so the agent styles forms with your site’s CSS.
- An admin screen to browse forms and submissions, export CSV, and enable, disable, or delete forms.
Embed a form anywhere with its shortcode, for example [primitives_form id="contact"].
Abilities:
- primitives/forms-v1-upsert-form — create a form, or replace one, from its definition.
- primitives/forms-v1-get-form — a form’s definition, shortcode, and rendered markup.
- primitives/forms-v1-list-forms — all forms with their shortcodes and submission counts.
- primitives/forms-v1-delete-form — delete a form, optionally with its submissions.
- primitives/forms-v1-list-submissions — submissions, filtered by form and date, paginated.
- primitives/forms-v1-get-submission — one submission’s values and file download links.
- primitives/forms-v1-delete-submission — delete one submission and its files.
Module #2: TBD
Source code and building
The plugin ships its complete source code.
The admin screens are React apps written in TypeScript. Each module keeps its source in modules/<module>/ui/src and the compiled JavaScript and CSS that WordPress loads in modules/<module>/ui/dist.
js 22 or newer):
- cd modules/forms-v1/ui
- npm ci
- npm run build
ts. json pin every dependency, including the bundled React.