Governed ability

Insert an Avada library item

aafm/avada-insert-library-itemGuarded write

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

Places an item from Avada's library, named by its id from avada-list-library, on an Avada page, layout section or library item, before or after an element from the outline of avada-get-page-content or as its first or last child. A saved section goes at the top level, a saved column inside a row, or directly in a flex container as Avada Studio sections hold it, and a saved element inside a column, by Avada's own nesting rules. An ordinary item is copied byte for byte; a global item is placed as a reference to the item, as Avada's builder does, so every page that shows it keeps showing the item itself, and placing one needs a user who can edit private posts. An item may hold at most 50 elements, nested at most 6 deep. An item holding a code block, a raw setting or a setting named like an event handler needs a user who may post unfiltered HTML, and for any other user its text may hold no square bracket, percent-encoded bracket, data-* attribute, unfinished tag or HTML that WordPress would remove, for a copy and for a reference alike. A global item it shows by reference, at any depth, gets the same access check and content checks; a reference loop is refused. Requires page_fingerprint from the last read or write and returns the new one; a changed page is refused and nothing is saved. Other indexes may move, so read the outline again before the next structural change. 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 page and to the item; Avada's Role Manager is 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 library item 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 library item 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 library item 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 library item on this site.
RunRunning aafm/avada-insert-library-item
GateAllowedcapability re-checked before running
Auditaafm/avada-insert-library-item · 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 our saved Testimonials section from the Avada Library under the pricing table on page 41.
  2. Place the global newsletter element at the end of the blog sidebar layout section.

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 library item.

Copy or reference?

An ordinary item is copied byte for byte. A global item is placed as a reference, as Avada's builder does, so every page that shows it keeps showing the item itself; placing one needs a user who can edit private posts.

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 library item 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.