PagibleAI MCP Tools Reference

PagibleAI exposes tools according to the installed packages and the authenticated user's permissions. Use this page to check available operations, draft behavior and the normal page-editing order.

The full PagibleAI installation exposes 41 tools: 30 core tools and 11 from pagible-ai. A client shows only the tools allowed by the authenticated user's permissions.

• get-locales: Lists the configured content languages.
• get-schemas: Returns the available content, metadata and configuration fields as JSON schema. Field hints from the element definitions are included as descriptions to guide the client.
• get-access: Lists the named frontend access values. Requires access:view.
• set-page-access: Replaces the access state of up to 50 pages, or of exactly one root page and its complete subtree when descendants is true. The change is immediate and requires page:access.

• search-pages: Finds pages by keyword and filters.
• get-page: Returns one page, its content and its latest_id.
• get-page-tree: Returns the nested page structure.
• get-page-history: Lists a page's saved versions.
• get-page-metrics: Returns analytics for a page URL.
• add-page: Creates a page draft.
• save-page: Updates a page draft using latest_id.
• publish-page: Publishes now or at a scheduled time.
• move-page: Repositions a page in the tree.
• drop-page: Soft-deletes a page.
• restore-page: Restores a soft-deleted page.

• search-elements: Finds shared elements by keyword and filters.
• get-element: Returns one shared element and its latest_id.
• add-element: Creates a shared-element draft.
• save-element: Updates a draft using latest_id.
• publish-element: Publishes now or at a scheduled time. Referencing pages then use the published change.
• drop-element: Soft-deletes a shared element.
• restore-element: Restores a soft-deleted shared element.

• search-files: Finds images, video, audio and documents.
• get-file: Returns one file, its metadata, previews and latest_id.
• add-file: Creates a file draft from either a url (http or https) or base64 content. The content can be a data URI and is limited to 8 MB, so it only suits small files; pass name with a file extension, e.g. icon.svg. Prefer url for larger files. Set disk to private to store the file protected by page access; the default is public.
• save-file: Updates file metadata using latest_id. It can also replace the file itself with base64 content (up to 8 MB); image previews are regenerated.
• publish-file: Publishes now or at a scheduled time.
• relocate-file: Moves a managed file, its previews and versions between public and private storage. Requires file:relocate. It cannot move a remote hot-linked file.
• drop-file: Soft-deletes a file.
• restore-file: Restores a soft-deleted file.

• refine-content: Rewrites or restructures page content and returns the refined content elements. It doesn't save anything; pass the result to save-page if you want to keep it.
• translate-content: Translates one or more text values.
• describe-file: Describes an image, audio file or video.
• transcribe-audio: Converts speech in an audio file to timed text.
• generate-image: Creates a new image draft from a prompt.
• repaint-image: Changes an existing image from a prompt.
• inpaint-image: Replaces a masked area from a prompt.
• erase-image: Removes the area selected by a mask.
• isolate-image: Removes an image background.
• uncrop-image: Extends an image beyond its current edges.
• upscale-image: Increases image resolution.

Each AI tool checks its feature permission and any page or file permission needed to read or save the target.

Use this order when creating or updating a page:

1. Call get-locales and get-schemas.
2. Find the target with search-pages, then read it with get-page.
3. Create a draft with add-page, or pass latest_id to save-page.
4. Read the draft again. Check its title, path, content, metadata, files and access state.
5. Publish only after approval. Use at with publish-page to schedule it.

Example prompt: “Find the pricing page and improve its introduction for small agencies. Preserve every element ID, save a draft and show me the result. Do not publish it.”

set-page-access is separate from this workflow because its changes take effect immediately.

• Set Up the PagibleAI MCP Server
• Connect MCP Clients to PagibleAI
• Authorization and Permissions