Skip to main content

​
Enabled Tools (v1)

Mallary MCP currently exposes these tool names:
  • mallary_create_upload_url
  • mallary_create_post
  • mallary_get_job
  • mallary_attach_tiktok_post_url
  • mallary_list_posts
  • mallary_list_comments
  • mallary_reply_to_comment
  • mallary_delete_post
  • mallary_get_analytics
  • mallary_get_audience
  • mallary_list_profiles
  • mallary_create_profile
  • mallary_rename_profile
  • mallary_list_platforms
  • mallary_disconnect_platform
  • mallary_get_settings
  • mallary_update_settings
  • mallary_list_webhooks
  • mallary_create_webhook
  • mallary_delete_webhook

​
Tool Surface

These tools cover:
  • uploads
  • post creation
  • job lookup
  • TikTok final URL attachment
  • post listing
  • comment listing and supplied comment replies
  • post deletion
  • post analytics and account audience retrieval
  • profile listing
  • profile creation and rename
  • profile settings retrieval and update
  • connected platform listing
  • platform disconnects
  • webhook listing
  • webhook creation
  • webhook deletion

​
Connected Platforms

mallary_list_platforms returns Mallary’s supported public platform set and marks which of those platforms are currently connected for the authenticated account. The response includes:
  • platforms: every supported public platform with a connected boolean
  • connected: the connected subset
  • disconnected: the remaining supported platforms
  • counts: connected and supported totals
  • profiles, profile_id, default_profile_id, and limits for connection profile context

​
Connection profiles

MCP tools use the default Mallary profile unless you send profile_id. Use mallary_list_profiles to list each profile’s random public ID, then pass that string as profile_id when targeting a non-default profile. Use mallary_create_profile to create a new profile and mallary_rename_profile to rename an existing profile. mallary_get_audience returns the latest follower or subscriber count for every connected account in the selected profile. Mallary updates supported counts once every 24 hours. TikTok and LinkedIn report permission_required until Mallary adds the needed permissions. The following tools accept profile_id:
  • mallary_create_post
  • mallary_list_posts
  • mallary_list_comments
  • mallary_get_analytics
  • mallary_get_audience
  • mallary_list_platforms
  • mallary_get_settings
  • mallary_update_settings
  • mallary_disconnect_platform

​
Settings

mallary_get_settings reads profile settings, business profile fields, auto-reply status, warnings, and plan capabilities. mallary_update_settings updates only the fields you send. Supported fields include auto_reply_enabled, brand_profile, business_name, business_description, website_url, services, features, contact_info, pricing, and faq.

​
Comment Engagement

mallary_list_comments and mallary_reply_to_comment are available on all Mallary plans. Use mallary_list_comments with a Mallary post_id/job ID to read comments on a published post. Then you or your AI agent can write a reply and pass that exact text to mallary_reply_to_comment. Supported platforms are Facebook, Instagram, Threads, LinkedIn, X, and YouTube. The MCP tool does not generate the reply. If you want auto-generated replies, use the Mallary AI auto reply feature.

​
Scheduling

mallary_create_post uses the same scheduling contract as the Mallary API:
  • send an absolute scheduled_at like 2026-04-06T18:30:00Z
  • or send a local scheduled_at like 2026-04-06T14:30 together with scheduled_timezone: "America/New_York"
  • scheduled_timezone must be a valid IANA timezone

​
Publish Results

mallary_create_post returns Mallary job IDs immediately. After each platform finishes publishing, mallary_get_job and mallary_list_posts include platform_post_id and platform_post_url when the platform returns or exposes them.

​
Platform-specific options

mallary_create_post uses the same underlying post payload as the Mallary API, including platform_options for platform-specific behavior. For the exact supported platform_options fields and examples, use the API reference here: Platform options reference

​
Platform-specific media rules

mallary_create_post also uses the same platform media validation rules as the Mallary API. Examples:
  • Threads supports platform_options.threads.post_type with text, image, video, or carousel. Its media shapes are text-only, one image, one video, or a 2 to 20 item carousel.
  • YouTube requires exactly one video.
  • TikTok video posts require one video, and TikTok photo posts support up to 35 JPEG/WebP images.
  • Pinterest requires exactly one image or GIF, or exactly one video, plus boardId.
  • Reddit image posts require one image or GIF. The current public API path does not support Reddit video upload.
  • X allows up to 4 images, or 1 video, or 1 GIF.
For the full per-platform matrix and current runtime caveats, see: Platform-specific media rules

​
Video thumbnails

mallary_create_post accepts thumbnail_url on media items, using the same contract as the REST API:
The thumbnail URL must already point to https://files.mallary.ai/.... YouTube regular videos, Facebook videos, and Instagram videos/Reels can use custom thumbnails or covers. TikTok video posts do not accept arbitrary image thumbnails through Mallary. TikTok photo posts can use thumbnail_url only when it matches one of the supplied photo URLs, and that image becomes the photo cover.
Last modified on August 14, 2026