Governed ability

Insert an Avada element

aafm/avada-insert-elementGuarded write

Insert an Avada element is a governed ability in Agent Abilities for MCP, a free WordPress plugin that runs an MCP server on your site.

Adds one element, with its children, to an Avada page, layout section, library item, form or off canvas panel: before or after an element named by its index and fingerprint from avada-get-page-content with include_structure, or as that element's first or last child. element takes tag, atts (setting names and input forms from avada-list-elements), text and children. Every setting the element has is written with its default, as Avada's builder writes a new element; empty ones are left out when Avada's remove empty attributes setting is on. A container takes rows, a row takes columns, a column takes elements or nested columns, a nested row takes nested columns, and a parent element such as tabs takes only its own child element; a column needs type, its width, such as 1_2. Refused: an element type Avada's element map does not list, a place inside an element that shows a global library item, and a setting or value avada-update-element would refuse. A double quote, a square bracket, two spaces in a row or a non-breaking space in a text setting is refused. Code blocks and settings that can carry script need a user who may post unfiltered HTML, and so do square brackets, percent-encoded brackets and data-* attributes in body text. page_fingerprint must be the one from the last read or write; the response returns the new one with the new element's index and fingerprint. An empty post takes an insert with no anchor and is then marked as an Avada page. At most 50 elements, nested at most 6 deep. A save that would change other content for this user is refused, and nothing is saved. When a revision is kept, restore_revision_id brings the page back through restore-revision. Not undoable from this plugin's change history. Requires edit access to the post, and for a layout section a user who can manage site options; Avada's Role Manager settings are not applied. Only while Avada is active.

How it is governed

The same model as every ability in the plugin, stated for this one.

  • Off until you enable it

    Like every ability, Insert an Avada element ships switched off. You turn it on one at a time, and an update never switches on a tool it serves.

  • Guarded write

    Writes stay conservative, and the plugin re-checks the capability before the call runs.

  • Capability gated

    A connection only sees Insert an Avada element if the user you connected can run it, and the plugin checks that capability again before it executes.

  • Every call audited

    The call is written to the log in your own database, denials included, with the argument keys and the identifiers it touched, never free-text content.

Insert an Avada element is one of the 18 governed Avada abilities. See the full Avada MCP integration.

See it in action

An illustrative run. Your real calls and data stay on your own site.

agent-abilities · auditGoverned
YouInsert an Avada element on this site.
RunRunning aafm/avada-insert-element
GateAllowedcapability re-checked before running
Auditaafm/avada-insert-element · principal: editor · args: post_id
ResultApplies the change, then writes the call to the audit log.

Try it with a prompt

Example requests you could paste to your agent.

  1. Add a text block under the heading in the first column of page 41.
  2. Insert a new container with a two-column row at the end of page 41.

These are illustrative example prompts. The agent runs them as the user you connected, checked against that user's capabilities and written to your audit log.

Frequently asked

Short answers for Insert an Avada element.

Does it follow Avada's nesting?

Yes. A container takes rows, a row takes columns, a column takes elements or nested columns, and a parent element such as tabs takes only its own child element. At most 50 elements, nested at most 6 deep.

What if the page changed since I read it?

page_fingerprint must match the last read or write, or the call is refused and nothing is saved. The response returns the new fingerprint with the new element's index.

Can I undo it?

Not from the Changes tab, which does not record this tool. When a revision is kept, restore_revision_id brings the page back through Restore revision.

Back to all abilities

Governed by default, from the first call.

Insert an Avada element is off until you enable it, scoped to the user you connect, and logged like everything else. Turn on only what you need.

Every ability off until you enable it, capability-gated on every call.