Account

account_get

No parameters. Returns scheduling context — call this before scheduling posts to avoid plan limit errors:

Profiles

profiles_list

List all connected social media profiles. No parameters. Returns profile id, name, platform, username, and status for each account.

profiles_get

profiles_platforms_list

List supported platforms (instagram, facebook, twitter, tiktok, youtube, linkedin, telegram, max, bluesky, threads, pinterest, googleGmb, wordpress, vkontakte). No parameters.

profiles_get_pinterest_boards

List Pinterest boards for a profile. Returns id and name for each board — use id in platform_options.pinterest.board_id when creating a post.

profiles_get_youtube_categories

List YouTube video categories for a profile. Returns id and name — use id in platform_options.youtube.category when creating a post.

Posts

When you have multiple profiles on the same platform, pass explicit profile_ids to target the right account. Call profiles_list first to discover IDs.

posts_create

Create a social media post. Can be saved as draft, scheduled, or published immediately.

Choose the correct mode based on user intent:

• DRAFT MODE (is_draft=true): user says "draft", "save for later", "don't publish". Post is saved but not scheduled or published.
• IMMEDIATE MODE (publish_now=true): user says "publish now", "post now", "immediately". Post goes live right away.
• SCHEDULED MODE (default): user says "schedule", "tomorrow at 9am". Provide publish_at as "Y-m-d H:i" in account timezone — call account_get first for timezone and plan_end_at.

posts_create_story

Same parameters as posts_create. Automatically sets is_story=true for Instagram, Facebook, and VK. Requires image or video media.

posts_create_reels

Same parameters as posts_create. Automatically sets is_reels=true for Instagram and Facebook. Requires vertical video media. Optional: platform_options.instagram.graduation_strategy (MANUAL or SS_PERFORMANCE) for an Instagram trial Reel.

posts_create_shorts

Same parameters as posts_create. Automatically sets youtube.is_shorts=true. Requires short vertical video.

posts_publish_now

Convenience wrapper — sets publish_now=true.

posts_cross_post

Post the same content to multiple profiles at once.

posts_list

posts_list_failed

posts_get / posts_delete / posts_retry

posts_update

Update a draft or scheduled post. Cannot update published posts.

posts_retry_all_failed

posts_limits

Per-platform text/hashtag/mention/media limits, plus the account's global max upload size. Call before posts_create to validate content length/media count instead of only discovering limits via a 422.

platform_options

Per-platform settings object passed to post create/update tools. Keys match platform: instagram, facebook, youtube, tiktok, telegram, max, linkedin, pinterest, twitter, threads, bluesky, wordpress, google_my_business, vkontakte.

{
  "instagram": { "is_reels": true, "graduation_strategy": "SS_PERFORMANCE" },
  "youtube": { "is_shorts": true, "privacy": "public", "category": "22" }
}Copy

Hashtags

Saved hashtag sets ("groups") for a profile — reuse a set in content instead of retyping the same hashtags every time.

hashtags_list

hashtags_create

hashtags_delete

hashtag_groups_create

hashtag_groups_update

hashtag_groups_delete

Media

media_get_upload_url

When to use: hosted MCP or when the user must upload manually in a browser. Call profiles_list first — pass profile_id for the target post (drives platform-specific media processing).

When NOT to use: local stdio with a readable file_path (use media_upload_file) or public URL (use media_urls).

The flow is:

1. Call profiles_list → pick profile_id
2. Call this tool with profile_id → get upload_url and token
3. Ask the user to open the URL in their browser
4. User uploads files through the drag & drop web page
5. Call media_check_status with the token to get uploaded file IDs
6. Use those IDs in media_ids when calling posts_create, posts_update, or story/reels tools

If posting a Story or Reels, set matching flags here and in platform_options when creating the post (e.g. is_story=true + posts_create_story).

media_upload_file

When to use: local stdio via @onlypult/mcp (npx -y @onlypult/mcp@latest) — Cursor, Claude Desktop, Windsurf, Codex, Antigravity, and other clients that run MCP on your machine. Pass a path the server can read (workspace-relative or absolute).

When NOT to use: hosted mcp.onlypult.com (server cannot read your disk), Claude.ai, ChatGPT — use browser flow. Chat-only attachments without a disk path.

Reliable flow: profiles_list → media_get_upload_url(profile_id) → media_upload_file with file_path + token → posts_create with same profile_ids.

Returns file id immediately for media_ids. Files > 5MB use multipart upload internally.

media_check_status

When to use: after browser upload when the user says "done". Not needed after media_upload_file.

Returns file IDs to use in media_ids when calling posts_create. Supported: JPG, PNG, WebP, GIF, MP4, MOV, WebM. Max file size depends on your Onlypult plan.

Post ./marketing/video.mp4 to Instagram as a ReelCopy

https://app.onlypult.com/mcp-upload?token=abc123...Copy