Actions

VoxelSite Actions turn your website into a two-way channel. Define an interaction once — a reservation, a newsletter signup, a callback request — and it immediately appears as a polished form on your site and as a tool that AI assistants can discover and use. No publishing step needed.

Visitors fill out forms. AI agents call tools. Both submit to the same system with the same validation rules. Every change you make in the Studio is live instantly.

No publish needed. Unlike pages and content, actions are live the moment you save them. Create an action, edit a field, toggle one off — visitors and AI agents see the change immediately. No publish step required.

Creating an action

Open the Studio, navigate to the Actions tab, and click Create Action. You can start from scratch or choose one of the built-in templates:

• Contact form
• Newsletter signup
• Table reservation
• Appointment booking
• Event registration
• Callback request
• Quote request
• Feedback form
• Waitlist

Give your action a name, pick an icon from the icon picker, and add an optional description. Then build your form fields.

Field builder

Each action has a list of fields. Use the field builder to add, reorder, and configure them.

Supported field types

Field settings

Click the gear icon on any field to configure:

• Placeholder — hint text shown inside the empty field
• Default value — pre-filled value
• Help text — short description shown below the field
• Min / Max — for number fields
• Max length — character limit for text fields
• Options — for select, radio, and multi-select fields

Defining options

For select dropdowns, radio buttons, and multi-select checkboxes, enter options one per line in the settings panel. Option names can contain commas and special characters — no escaping needed.

For multi-select fields, prefix an option with [x] to make it selected by default:

Vegetarian
[x] Vegan
[x] Gluten-free
Dairy-free
Nut-free

In this example, Vegan and Gluten-free are checked by default when the form loads.

Validation

Mark any field as required using the toggle in the field builder. Additional validation is applied automatically based on field type:

• Email — must be a valid email address
• Phone — must be a valid phone number
• URL — must be a valid web address
• Number — must be within min/max range
• Date — can require a date in the future
• Multi-select — when required, at least one option must be checked
• Text / Textarea — optional maximum character length

Validation runs in the visitor's browser for instant feedback, on the server for security, and is described in the AI agent schema so agents know the constraints before submitting.

The Actions Bar

Active actions appear in a sleek bar at the bottom of every page on your site. Visitors tap an action to open a form overlay with smooth animations and real-time validation.

When you create, edit, or toggle an action in the Studio, the change is reflected on your site immediately — visitors always see the latest version.

The Actions Bar:

• Supports dark mode (light, dark, or auto based on system preference)
• Offers three layout variants: bottom bar, floating action button, or minimal pill
• Adapts to mobile screens and touch targets
• Shows messages in 31 languages — detected from the visitor's browser language
• Meets WCAG AA accessibility standards with keyboard navigation and focus indicators

AI agent integration

Every active action is automatically exposed as a tool via two public endpoints on your site:

AI assistants can:

1. Discover your actions by calling tools/list on /mcp.php
2. Understand field requirements, validation rules, and options from the tool schema
3. Submit data by calling tools/call with the action name and arguments

What agents see

Each action becomes an MCP tool named make_[action_id]. For example, a "Table Reservation" action with id reservation becomes the tool make_reservation. An agent calling tools/list receives a schema like this:

{
  "name": "make_reservation",
  "description": "Reserve a table at the restaurant",
  "inputSchema": {
    "type": "object",
    "properties": {
      "name":   { "type": "string", "description": "Name" },
      "date":   { "type": "string", "description": "Date (must be in the future)" },
      "time":   { "type": "string", "description": "Time" },
      "guests": { "type": "number", "description": "Guests", "minimum": 1, "maximum": 12 }
    },
    "required": ["name", "date", "time", "guests"]
  }
}

The Studio shows this exact schema on each action's detail page under Agent Preview, so you can verify what agents see.

Verifying your actions

Open yoursite.com/actions/manifest.json in a browser to see every active action with its fields, options, and validation rules. This manifest updates the moment you change an action in the Studio — no publish needed.

This works with ChatGPT, Claude, and any MCP-compatible AI assistant. Your llms.txt file also lists available actions so AI crawlers know what your site can do.

Managing submissions

Every submission is stored in the Studio. Open any action to see its record list:

• Filter by status (new, confirmed, completed, cancelled)
• View full submission details, metadata (IP, browser, timestamp), and timeline
• Update the status of individual records
• Export all records to CSV
• Delete individual records
• Purge old records in bulk — choose from 3 days to 1 year

Capacity and constraints

Optionally set limits on your actions:

• Max per day — cap the number of daily submissions (useful for reservations)
• Unique fields — prevent duplicate submissions by email or phone

Publishing

The first time you publish your site, VoxelSite deploys the Actions Bar files and injects them into every page. After that initial publish, all action changes are live in real time — you do not need to re-publish when you create, edit, activate, or deactivate actions.

When you unpublish your site, the Actions Bar is cleanly removed from all pages.

Related

• Forms — traditional schema-driven forms (contact, booking)
• SEO & AI Discovery — how llms.txt and MCP make your site AI-readable
• Publishing — what happens when you publish