Tools Reference

The Blotato MCP Server exposes 9 tools. Your AI tool calls these automatically based on your prompts.

Accounts

blotato_get_user

Get your account info and verify the connection is working.

• Input: none

• Output: user ID, email, subscription status

blotato_list_accounts

List all connected social media accounts with subaccounts (for Facebook Pages and LinkedIn Company Pages).

• Input: platform (optional) - filter by platform name

• Output: array of accounts with ID, platform, name, username, and subaccounts

---

Publishing

blotato_create_post

Create and publish (or schedule) a post to a social media platform.

• Input:

  • accountId (required) - from blotato_list_accounts

  • platform (required) - twitter, instagram, facebook, tiktok, linkedin, pinterest, bluesky, threads, or youtube

  • text (required) - post content

  • mediaUrls (optional) - array of public media URLs

  • scheduledTime (optional) - ISO 8601 datetime

  • useNextFreeSlot (optional) - use next available schedule slot

  • pageId (optional) - for Facebook/LinkedIn pages

  • mediaType (optional) - for Instagram: image, video, reel, or carousel

  • privacyLevel (optional) - for TikTok

  • boardId (optional) - for Pinterest

  • title (optional) - for Pinterest or YouTube

  • privacyStatus (optional) - for YouTube: public, private, or unlisted

• Output: postSubmissionId (poll with blotato_get_post_status)

blotato_get_post_status

Check the status of a submitted post.

• Input: postSubmissionId (required)

• Output: status, publicUrl (when published), errorMessage (when failed)

• Status values: in-progress -> published | scheduled | failed

---

Content Extraction

blotato_extract_content

Extract content from a URL or text. Polls internally and returns the result directly.

• Input:

  • sourceType (required) - youtube, article, twitter, tiktok, text, audio, pdf, or perplexity-query

  • url (optional) - required for URL-based source types

  • text (optional) - required for text and perplexity-query source types

  • customInstructions (optional)

• Output: title and content (extracted text)

---

Videos and Images

blotato_list_templates

List all available visual templates (videos, carousels, quote cards, infographics).

• Input: none

• Output: array of templates with ID, name, and description

blotato_create_visual

Generate an image, carousel, or video from a template.

• Input:

  • templateId (required) - from blotato_list_templates

  • prompt (optional) - describe what you want in natural language

  • render (optional, default: true)

• Output: visual ID and status (poll with blotato_get_visual_status)

blotato_get_visual_status

Check the status of a visual generation request.

• Input: id (required)

• Output: status, mediaUrl (for videos), imageUrls (for images/carousels)

• Status values: queueing -> generating-script -> script-ready -> generating-media -> media-ready -> exporting -> done | failed

---

Media

blotato_upload_media

Upload media from a public URL to Blotato's servers. Returns a Blotato-hosted URL for use in blotato_create_post.

• Input: url (required) - public URL of the media file

• Output: hosted URL and media ID