原始内容
name: makepost-com-app-growth version: 2.3.0 title: Social Media Toolkit (via makepost.com) description: Manage your social media across 9 platforms — draft captions, hashtags & post ideas, generate AI images, schedule, publish, set recurring autopilot schedules, and trigger webhooks — all through conversation. license: MIT author: William Engbjerg homepage: https://makepost.com/openclaw keywords: social-media, scheduling, publishing, content, drafts, automation, ai-captions, image-generation, hashtags, webhooks, recurring-scheduling, autopilot, n8n, zapier metadata: openclaw: requires: env: - MAKEPOST_API_KEY bins: - npx primaryEnv: MAKEPOST_API_KEY
Social Media Toolkit (via makepost.com)
MakePost is a social media scheduling platform built to be driven by AI agents. Draft captions, hashtags, and post ideas, generate AI images, schedule, and publish videos, image carousels, and posts to 9 platforms — TikTok, Instagram, YouTube, Facebook, X, LinkedIn, Threads, Pinterest, and Bluesky — from one place or straight from your AI agent. Set recurring autopilot schedules that auto-publish a queue, and fire signed webhooks into n8n, Zapier, Make, or your own service.
Setup
- Create a MakePost account at makepost.com
- Connect your social accounts (TikTok, Instagram, YouTube, etc.)
- Generate an API key from Settings
- Store your API key:
MAKEPOST_API_KEY=sk_live_your_key_here
Auth
All requests use Bearer token:
Authorization: Bearer <MAKEPOST_API_KEY>
MCP endpoint: https://makepost.com/api/mcp/
API docs: https://api.makepost.com
Available Tools
Publishing
list_videos — List uploaded videos ready for posting.
limit(int, default 50) — Max videos to return.- Returns: video ID, title, duration (seconds), source ("upload" or "creatify"), linked app name.
- Only completed videos included (processing/errored excluded). Sorted newest first.
upload_video — Upload a video from a public URL into MakePost.
video_url(string, required) — Public URL to .mp4, .mov, .webm, or .m4v. Max 500MB, max 10 minutes.title(string, required) — Video title.caption(string) — Default caption for publishing. Falls back to title if empty.app_id(string) — Project to link to. Accepts project ID or name. Auto-selects if you have one project.cover_timestamp(float) — Seconds into the video to extract as cover frame (e.g. 5.5).cover_image_url(string) — Public URL to a custom cover image (JPEG/PNG/WebP/GIF, max 10MB). Alternative to cover_timestamp. Accepts any public URL directly — no need to upload the cover image separately first.- Returns: video_id, url, title, duration, file_size, is_short_eligible, cover_url.
- Runs content moderation automatically. Rejected content is deleted.
- For direct file uploads (not URL), use the REST API endpoint
POST /v1/media/upload-filewith multipart form data.
list_accounts — List connected social media accounts.
- Returns: account ID, platform, username, provider, avatar_url.
- Only active (connected) accounts returned. Disconnected accounts excluded.
- Platforms: tiktok, instagram, youtube, facebook, x, linkedin, threads, pinterest, bluesky.
list_account_groups — List account groups with their member accounts.
- Returns: group ID, name, account_ids, accounts (with platform and name).
- Groups are collections of accounts that can be published to together.
- Use group IDs with the group_ids parameter in publish_content.
schedule_post — Schedule a video to one or more social media accounts at a specific time.
video_id(string, required) — Video ID from list_videos.account_ids(list of strings, required) — Account IDs from list_accounts.scheduled_at(string, required) — ISO 8601 datetime (e.g. "2026-03-22T15:00:00").timezone(string) — IANA timezone (e.g. "America/New_York"). Defaults to your account timezone.caption(string) — Post caption. Falls back to video script, then title.- Inactive accounts in the list are silently skipped. Response times are always UTC.
list_posts — List your posts, optionally filtered by status.
status(string) — Filter: "scheduled", "published", "failed", "pending", or "processing".limit(int, default 50) — Max posts to return (1-100).- Status lifecycle: scheduled → pending → processing → published or failed.
- All timestamps in UTC. Sorted by scheduled_at (newest first).
cancel_scheduled_post — Cancel a scheduled post before it publishes.
post_id(string, required) — Post ID to cancel.- Only works on posts with status "scheduled". The post is permanently deleted.
reschedule_scheduled_post — Change when a scheduled post will be published.
post_id(string, required) — Post ID to reschedule.scheduled_at(string, required) — New publish time in ISO 8601.timezone(string) — IANA timezone. Defaults to your account timezone.- Only works on "scheduled" posts. New time must be at least 5 minutes in the future.
edit_scheduled_post_caption — Edit the caption of a scheduled post.
post_id(string, required) — Post ID to edit.caption(string, required) — The new caption text.- Only works on posts with status "scheduled".
get_publishing_results — Check publishing results for a post.
post_id(string, required) — Post ID to check.- Returns: status, platform_url (null while pending), stats (views, likes, comments, shares — null until synced), error_message (only for failed posts).
Content Publishing
publish_content — Create and publish content (text, image, video, or carousel) to one or more accounts.
content_type(string, required) — "text", "image", "video", or "carousel".caption(string, required) — Main post caption. Used for all platforms unless overridden by captions.account_ids(list of strings) — Account IDs to post to. Required unless is_draft=True.media_id(string) — Pre-uploaded media ID (from upload_image or upload_video). Required for image/video/carousel.scheduled_at(string) — ISO 8601 datetime. Omit to publish immediately.timezone(string) — IANA timezone for scheduled_at.is_draft(bool, default false) — Save as draft without publishing. Account IDs and captions are stored for later use.title(string) — Optional title (used by YouTube).app_id(string) — Project ID to associate content with (from list_apps).captions(dict) — Per-platform caption overrides, e.g. {"linkedin": "Professional version", "x": "Short version"}.group_ids(list of strings) — Account group IDs to resolve to individual accounts (from list_account_groups).tiktok_is_draft(bool, default false) — Send to TikTok as a draft instead of publishing live. The video appears in the user's TikTok drafts for editing before posting.- Text-only posts work on X, LinkedIn, Threads, Bluesky, Facebook. TikTok, Instagram, YouTube, Pinterest require media.
upload_image — Upload an image from a public URL into MakePost.
image_url(string, required) — Public URL to .jpg, .png, .webp, or .gif. Max 20MB.title(string) — Image title.app_id(string) — Project to link to. Auto-selects if you have one project.- Returns: media_id, url, title. Use media_id with publish_content.
- For direct file uploads (not URL), use the REST API endpoint
POST /v1/media/upload-filewith multipart form data.
list_drafts — List your draft posts.
limit(int, default 50) — Max drafts to return (1-100).- Sorted newest first.
- Returns draft_account_ids (stored target accounts) and draft_captions (stored per-platform captions) if set.
publish_draft_tool — Publish a draft post (immediately or scheduled).
post_id(string, required) — Draft post ID from list_drafts.account_ids(list of strings) — Account IDs. If omitted, uses accounts stored when the draft was created.scheduled_at(string) — ISO 8601 datetime. Omit for immediate.timezone(string) — IANA timezone.
update_draft_tool — Update a draft post's content, accounts, or captions.
post_id(string, required) — Draft post ID.caption(string) — New main caption text.content_type(string) — New content type.media_id(string) — New media ID.account_ids(list of strings) — Updated list of account IDs for this draft.captions(dict) — Updated per-platform caption overrides, e.g. {"x": "Short", "linkedin": "Long"}.
delete_draft_tool — Delete a draft post permanently.
post_id(string, required) — Draft post ID to delete.
Bulk Operations
bulk_publish_content — Publish, schedule, or draft up to 20 content items in a single request.
items(list, required) — Array of content items (max 20). Each item has the same fields as publish_content: content_type, caption, account_ids, media_id, scheduled_at, timezone, is_draft, title, app_id, captions, group_ids, tiktok_is_draft.- Each item is processed independently — failures on individual items do not stop the batch.
- Returns a list of per-item results with success/failure status and error details for failed items.
- Rate limit: 5 requests per minute.
bulk_upload_media — Upload up to 20 images or videos from public URLs in a single request.
items(list, required) — Array of media items (max 20). Each item has:url(string, required),type("image" or "video", default "image"),title(string),app_id(string).- Image URLs: .jpg, .png, .webp, or .gif. Max 20MB per image.
- Video URLs: .mp4, .mov, .webm, or .m4v. Max 500MB, max 10 minutes per video.
- Each item is processed independently — failures on individual items do not stop the batch.
- Returns a list of per-item results with media_id on success or error details on failure.
- Rate limit: 3 requests per minute.
bulk_cancel_posts — Cancel up to 50 scheduled posts in a single request.
post_ids(list of strings, required) — Post IDs to cancel (max 50).- Only works on posts with status "scheduled". Non-scheduled posts are skipped with an error.
- Each post is processed independently — failures on individual posts do not stop the batch.
- Returns a list of per-item results with success/failure status and error details.
- Rate limit: 10 requests per minute.
bulk_reschedule_posts — Reschedule up to 50 scheduled posts in a single request.
items(list, required) — Array of reschedule items (max 50). Each item has:post_id(string, required),scheduled_at(string, required — ISO 8601 datetime),timezone(string).- Only works on "scheduled" posts. New time must be at least 5 minutes in the future.
- Each post is processed independently — failures on individual posts do not stop the batch.
- Returns a list of per-item results with success/failure status and error details.
- Rate limit: 10 requests per minute.
Projects
list_apps — List your projects.
- Returns: project ID, name, type, rating, rating_count.
- Projects are optional containers to organize content by client, brand, or campaign.
- Pass a project ID as the optional
app_idwhen uploading or publishing to associate content with that project. - Sorted newest first.
AI Generation
generate_caption — Draft a post caption from a short brief.
brief(string, required) — What the post is about (topic, angle, key points).platform(string) — Target platform (e.g. "tiktok", "linkedin"). Tailors length and style to the platform's norms.tone(string) — Desired tone (e.g. "casual", "professional", "playful").- Returns: a ready-to-use caption. Counts toward your monthly AI usage.
generate_hashtags — Generate relevant hashtags for a topic.
topic(string, required) — The subject to find hashtags for.count(int) — How many hashtags to return.platform(string) — Target platform for platform-appropriate tags.- Returns: a list of hashtags. Counts toward your monthly AI usage.
generate_post_ideas — Brainstorm distinct post ideas for a theme.
topic(string, required) — The theme or product to generate ideas for.count(int) — How many ideas to return.- Returns: a list of distinct ideas, each with a hook, an angle, and a suggested caption. Counts toward your monthly AI usage.
generate_title — Write a short, viral hook or title.
topic(string, required) — What the content is about.platform(string) — Target platform (e.g. "youtube" for a video title).- Returns: a short hook/title. Counts toward your monthly AI usage.
generate_image — Generate an AI image (Google Imagen) ready to post.
prompt(string, required) — Description of the image to create.aspect_ratio(string) — Image shape: "1:1" (default), "3:4", "4:3", "9:16", or "16:9".app_id(string) — Project to link the resulting media to.- Returns: a
media_idplus the image URL — use the media_id directly with publish_content or schedule_post. Counts toward your monthly AI usage.
get_usage — Check your AI usage and plan limits.
- Returns: this month's AI generation usage (captions, hashtags, ideas, titles, images) and your plan's limits.
Platform Info
get_platform_rules — Get per-platform posting rules so you post correctly.
platform(string) — Optional. A single platform to look up; omit to return rules for all 9.- Returns: caption character limits, supported media types (video/image/carousel/text), and carousel min/max sizes for each platform.
- Use this before drafting captions or building carousels so content fits each platform's constraints.
Webhooks
list_webhooks_tool — List your registered webhook endpoints.
- Returns: each endpoint's ID, URL, subscribed events, and the full list of available events.
create_webhook_tool — Register a webhook endpoint to receive signed events.
url(string, required) — HTTPS endpoint MakePost will POST to.events(list of strings) — Events to subscribe to (e.g. "post.published", "post.failed"). Omit to receive all events.- Returns: the endpoint ID and a signing
secret— shown only once. Each delivery includes anX-MakePost-Signatureheader (HMAC-SHA256 of the body using your secret); verify it to confirm authenticity. - Wire MakePost into n8n, Zapier, Make, or your own service.
delete_webhook_tool — Remove a webhook endpoint.
webhook_id(string, required) — Endpoint ID to delete.
Recurring Scheduling
Set-and-forget autopilot: create a posting plan with recurring weekday + time slots, add media to its queue, and each slot automatically publishes the next queued item.
create_posting_plan_tool — Create a recurring posting plan.
name(string, required) — Plan name.account_ids(list of strings, required) — Accounts the plan publishes to.slots(list, required) — Recurring slots, each with a weekday and a time (e.g. Monday 09:00, Thursday 17:30).timezone(string) — IANA timezone the slots are interpreted in (e.g. "America/New_York").- Returns: the plan ID. Each slot auto-publishes the next item from the plan's queue.
list_posting_plans_tool — List your recurring posting plans.
- Returns: each plan's ID, name, accounts, slots, timezone, and active/paused state.
add_to_posting_queue — Add uploaded media to a plan's queue.
plan_id(string, required) — The posting plan.media_id(string, required) — Pre-uploaded media (from upload_image, upload_video, generate_image, or bulk_upload_media).caption(string) — Caption to use when this item publishes.- Items publish in queue order, one per upcoming slot.
list_posting_queue — View the queued items for a plan.
plan_id(string, required) — The posting plan.- Returns: queued items in publish order.
pause_posting_plan — Pause a plan so its slots stop auto-publishing.
plan_id(string, required) — The plan to pause.
resume_posting_plan — Resume a paused plan.
plan_id(string, required) — The plan to resume.
delete_posting_plan_tool — Delete a posting plan.
plan_id(string, required) — The plan to delete.
Example Workflows
- "Post 'Just launched v2.0!' to all my accounts" — Creates a text post and publishes to all text-compatible platforms.
- "Upload this image and post it to Instagram and Facebook with the caption 'New feature'" — Uploads the image, then publishes to selected accounts.
- "Save a draft post about our upcoming feature for later" — Creates a draft that can be edited and published when ready. Accounts and per-platform captions are preserved.
- "Draft a post for X and LinkedIn with different captions for each" — Creates a draft with per-platform captions stored for later publishing.
- "Post to all accounts in my MakePost group" — Uses list_account_groups to find the group, then publishes with group_ids.
- "Upload https://example.com/my-video.mp4 and schedule it to all my accounts tomorrow at noon" — Downloads the video, runs moderation, and schedules across all connected platforms.
- "Post my latest video to TikTok and Instagram tomorrow at 3pm" — Finds your most recent video, picks the right accounts, and schedules it.
- "How did my last post do?" — Uses get_publishing_results to report status and engagement stats (views, likes, comments, shares).
- "Show me my drafts and publish the one about the launch to LinkedIn" — Lists drafts, then publishes the right one to the selected account.
- "List my projects and schedule this video under the Acme client" — Lists projects, then publishes with the project ID passed as app_id.
Bulk Operations
- "Schedule a week of posts — Monday text, Tuesday image, Wednesday video, Thursday text, Friday carousel, Saturday image, Sunday video" — Uses bulk_publish_content with 7 items, each with a different scheduled_at and content_type, all in one call.
- "Upload these 10 product screenshots and then post them all to Instagram and LinkedIn" — First calls bulk_upload_media with 10 image URLs, then uses the returned media_ids in bulk_publish_content to publish all 10.
- "Cancel all my scheduled posts for next week" — Lists posts filtered by status "scheduled", identifies the ones in the target date range, then calls bulk_cancel_posts with their IDs.
- "Move all my Friday posts to Saturday at the same times" — Lists scheduled posts, filters for Friday, then calls bulk_reschedule_posts with each post shifted by one day.
AI Generation
- "Write me a punchy TikTok caption for our new feature launch" — Uses generate_caption with the brief and platform "tiktok", then you can publish it directly.
- "Give me 10 hashtags for a fitness reel" — Uses generate_hashtags with the topic and count.
- "Brainstorm 5 post ideas about productivity, each with a hook and caption" — Uses generate_post_ideas and returns distinct angles ready to schedule.
- "Make an image of a sunset over mountains and post it to Instagram" — Uses generate_image to create the image (returns a media_id), then publish_content with that media_id.
- "How much of my AI quota have I used this month?" — Uses get_usage to report generation counts against your plan limits.
Platform Rules
- "What's the caption limit on X vs LinkedIn?" — Uses get_platform_rules to report per-platform caption limits.
- "Build a carousel — how many images can I post on Instagram?" — Uses get_platform_rules to check carousel min/max sizes before assembling the carousel.
Webhooks
- "Notify my n8n workflow whenever a post publishes" — Uses create_webhook_tool with the n8n URL and the "post.published" event, then returns the signing secret to configure signature verification.
- "Show me my webhook endpoints" — Uses list_webhooks_tool to list registered endpoints and the available events.
Recurring Scheduling (Autopilot)
- "Set up a plan that posts to TikTok every Mon/Wed/Fri at 9am, then queue these 6 videos" — Uses create_posting_plan_tool with three slots, then add_to_posting_queue for each video. Each slot auto-publishes the next queued item.
- "Pause my autopilot plan while I'm on vacation" — Uses pause_posting_plan, then resume_posting_plan when you're back.
- "What's left in my posting queue?" — Uses list_posting_queue to show upcoming items in publish order.
Tips
- Project auto-selection: If you have only one project, you can omit app_id from any tool — it auto-selects.
- Flexible project lookup: Pass a project name (case-insensitive) instead of the internal ID.
- Timezone handling: schedule_post and reschedule default to your account timezone if you don't specify one.
- Caption fallbacks: If no caption is provided, publishing uses the video's script, then its title.
- Per-platform captions: Use the captions dict in publish_content to write a different caption per platform.
- Drafts: Save content with is_draft=True, then publish or schedule it later with publish_draft_tool.
- Post to multiple platforms simultaneously by including multiple account IDs in schedule_post.
REST API
The MCP tools above also have equivalent REST API endpoints at https://api.makepost.com/v1/. Full interactive docs at https://api.makepost.com.
New endpoint groups:
- AI generation:
POST /v1/ai/caption,POST /v1/ai/hashtags,POST /v1/ai/ideas,POST /v1/ai/title,POST /v1/ai/image, andGET /v1/ai/usage. - Platform rules:
GET /v1/platforms— per-platform caption limits, supported media, and carousel sizes. - Webhooks:
GET /v1/webhooks,POST /v1/webhooks,DELETE /v1/webhooks/{id}, andPOST /v1/webhooks/{id}/test. Deliveries are signed with anX-MakePost-Signature(HMAC-SHA256) header. - Recurring schedules:
GET /v1/schedules,POST /v1/schedules,DELETE /v1/schedules/{id},POST /v1/schedules/{id}/pause,POST /v1/schedules/{id}/resume, andPOST /v1/schedules/{id}/queue.
Direct file upload (REST API only — not available via MCP):
POST https://api.makepost.com/v1/media/upload-file
Content-Type: multipart/form-data
Authorization: Bearer <MAKEPOST_API_KEY>
file: <binary> (required) Image or video file
type: "image"|"video"|"cover" (default "image")
title: string (optional)
app_id: string (optional)
- Images: max 20MB, JPEG/PNG/WebP/GIF
- Videos: max 500MB, MP4/MOV/WebM, max 10 minutes
- Returns same response as upload_image or upload_video
REST API: Cover Image Upload — Upload a cover image without creating a media record.
POST /v1/media/upload-filewithtype: "cover"— returns{"url": "...", "type": "cover"}with no media_id.POST /v1/media/uploadwithtype: "cover"— same, from a public URL.- Use the returned URL as
cover_image_urlwhen uploading a video.
Supported Platforms
TikTok, Instagram, YouTube, Facebook, X, LinkedIn, Threads, Pinterest, Bluesky