Your assistant picks the right tool for you. You do not need to call them by name. This list helps when you want to know what is possible or why the assistant did something.
Channels and posts
| Tool |
What it does |
Main inputs |
integrationList |
Lists your connected channels with their id, name and platform. |
None |
integrationSchema |
Gets the rules, the maximum length and the settings a platform needs before a post is scheduled. |
platform, isPremium |
triggerTool |
Looks up extra details a channel needs for a post, such as an id, using a helper that integrationSchema names. |
integrationId, methodName, dataSchema |
integrationSchedulePostTool |
Creates posts: scheduled, saved as drafts or published now, with comments or thread parts and attachments. |
socialPost: integrationId, date (UTC), type (schedule, draft or now), postsAndComments (text and attachments), settings |
listScheduledPosts |
Lists your posts between two dates: scheduled, queued, drafts, published and failed, with the reason a post failed. |
startDate, endDate (default: now to 30 days ahead) |
reschedulePost |
Asks to move a post to a new date and time. It does not move the post. |
id, date, summary |
deletePost |
Asks to delete a post. It does not delete the post. |
group, summary |
getAnalytics |
Gets analytics for one channel, such as followers, engagement and reach, depending on the platform. |
integrationId, days (default 7) |
| Tool |
What it does |
Main inputs |
uploadFromUrlTool |
Copies an image or video from a public link into your media library. |
url |
mediaListTool |
Lists the files in your media library, newest first, 18 per page, with an optional search by file name. |
search, page |
generateImageTool |
Makes an AI image from a description and saves it to your media library. |
prompt |
createBrandedDraft |
Writes a caption in your brand voice and designs a matching graphic, saved to your media library. It does not schedule anything. |
topic, platform, language |
generateVideoOptions |
Lists the kinds of AI video Postra can make and the options each one takes. |
None |
videoFunctionTool |
Gets extra details a video type needs, such as a voice. |
identifier, functionName |
generateVideoTool |
Makes an AI video and saves it to your media library. |
identifier, output (vertical or horizontal), customParams |
Postra’s assistant
| Tool |
What it does |
Main inputs |
ask_postra |
Sends a request in plain words to Postra’s own assistant, which uses the tools above and replies with what it did. |
message |
Good to know
- Attachments. A post can only attach files that are in your Postra media library. Use
uploadFromUrlTool or mediaListTool first. The upload takes JPEG, PNG, GIF, WebP, AVIF, BMP, TIFF and MP4 files up to 100 MB, from public http or https links only. For a file on your computer, use the Public API.
- Times. Dates passed to the tools are in UTC. If you write “9:00 UK time”, your assistant converts it.
- Plan allowances. Scheduled posts count towards your plan’s monthly posts. Drafts do not. AI images and videos use your plan’s monthly AI allowance.
- Moving and deleting.
reschedulePost and deletePost only ask. Nothing moves or disappears through MCP. Do it in Postra, in the calendar or with the assistant inside Postra. See What MCP is.
ask_postra. It schedules a request that names the channel, the date and time, and the text. If something is missing, it says what. Each question stands on its own, and it counts towards the 2,200 assistant questions a month. See Limits.
Example requests
Type these into your assistant as they are, with your own details:
- “Which channels do I have connected in Postra?”
- “Schedule a post on my LinkedIn for Tuesday at 9:00 UK time: We are hiring a part-time barista. Apply in the shop or by email.”
- “What is planned in Postra for the next 7 days? Did anything fail?”
- “Upload this image to my Postra media library: https://example.com/spring-menu.jpg”
- “Write a post about our spring sale for Instagram and make a matching graphic. Save it as a draft.”
- “How did my Facebook page do over the last 30 days?”
