Browse the docs

DocsAI assistants (MCP)

MCP tools

Every tool the PostDelegate MCP server offers, what it does and whether it changes anything.

On this page

Your assistant discovers these tools by itself when it connects. You do not call them directly. This page explains what each one does so you know what an assistant can and cannot do. Tool names are shown exactly as the server reports them.

Channels and settings

ToolWhat it doesChanges data?
integrationListLists your connected channels. Pass a group id to list only one customer’s channels.No
groupListLists your customers (groups).No
integrationSchemaReturns a channel’s post rules, its length limit, the settings fields it needs, and the helper lookups available. Assistants call it before scheduling.No
triggerToolRuns a helper lookup named by integrationSchema, for example fetching WordPress categories or Listmonk lists. May refresh the channel’s saved login.Can refresh credentials

Posts

ToolWhat it doesChanges data?
integrationSchedulePostToolCreates a draft, a scheduled post or an immediate post on one or more channels. It runs the same validation as the app and the API, and returns a post id and a preview link for each post, or a list of errors to fix.Yes
postsListToolLists your posts between two dates, with their state, errors, content, channel and settings.No
postSettingsToolUpdates the network settings of a scheduled post or draft that has not published. Content and date stay as they are.Yes
deletePostToolDeletes a post and its comments on that channel. A deleted scheduled post does not publish. Deleting a published post only removes it from PostDelegate. It cannot be undone.Yes

Media

ToolWhat it doesChanges data?
uploadFromUrlToolAdds an image or video from a public URL to your media library. An optional adjust setting resizes and re-encodes it for the networks.Yes
mediaListToolLists your media library, newest first, 18 per page, with an optional file-name search. Used to reuse a file instead of uploading it again.No
mediaStatusToolChecks whether an adjusted upload is ready or still processing.No
uploadWidgetToolShows an upload widget so you can add a file from your own device. Only shown by assistants that support interactive MCP apps.Yes
uploadWidgetStatusToolLists the files uploaded through the widget.No
uploadWidgetTicketToolUsed by the upload widget itself to get a short-lived upload ticket. Assistants do not need to call it.No

Local files cannot be fetched by an assistant. Upload them through the app, the widget, or the upload API.

AI media tools, not available today

The server also defines tools for generating images and video and for turning long YouTube videos into short clips: generateImageTool, generateVideoOptions, videoFunctionTool, generateVideoTool, videoStatusTool, clippingTool, clippingStatusTool and clippingWidgetTicketTool.

PostDelegate does not provide AI generation: these tools depend on AI features that are currently off, and the clipping tools only exist when the service is set up for them. If one appears in your assistant’s tool list it will answer with an error such as no credits available. Use your own assistant’s image and video features instead, then bring the result into PostDelegate with uploadFromUrlTool.

What an assistant sees

  • Tools only act on the workspace you approved. A different workspace needs a separate sign-in.
  • Tools that change data are marked as such to clients, so assistants that support confirmation prompts will ask you first.
  • Connections through the API key addresses may also list a general ask_postiz tool that relies on AI features. It does nothing useful while AI is off, and you can ignore it.
  • Content from your posts and videos is just data for the assistant to show you. Be wary of any assistant that treats text in a post as instructions.

Something unclear, wrong or missing? Email [email protected] and tell us which page you were on.