Skip to main content
Glama

Publish & Cross-Post Across 18 Social Networks

posts_publish

Publish immediately (publish_now), schedule for a future ISO-8601 timestamp (schedule), enqueue into the profile slot queue (queue), or simultaneously cross-post (cross_post) content and media across 18+ social networks. Includes the built-in X Smart Link Optimizer (xLinkStrategy: 'first_reply'), which automatically strips external links from the main X post and publishes them in an immediate 1st reply—cutting X API link costs by 85% ($0.03 vs $0.20) while avoiding main-feed link reach penalties. Returns the persisted postId, per-platform delivery receipts (platformResults), total API cost (totalCostUsd), and exact dollar savings (totalSavedViaSmartLinkUsd).

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "action": "<action>",
      "platforms": "<platforms>"
    },
    "name": "posts_publish"
  }
}

Input Schema

NameRequiredDescriptionDefault
tagsNoOptional tags or keywords for YouTube, TikTok, or CMS posts.
titleNoOptional headline, YouTube/TikTok video title, LinkedIn PDF carousel title, or Reddit/Pinterest post title.
actionYesPublishing mode: 'publish_now' dispatches immediately, 'cross_post' syndicates tailored variants across multiple networks at once, 'schedule' holds until `scheduledFor`, and 'queue' places the post in the next best engagement slot.
formatNoPublication format. 'post' (default) is a regular feed post. 'story' publishes an Instagram Story: requires platforms=['instagram'], action='publish_now', exactly ONE media item (one entry in `mediaUrls` or `mediaAssetIds`; image .jpg/.png or video .mp4/.mov, ideally 9:16, video 3-60s) and NO caption (omit `content` or pass an empty string). Videos are processed by Instagram before going live.post
contentNoPrimary post body text, caption, or thread hook. May include hashtags, mentions, and URLs (external URLs on X are automatically handled according to `xLinkStrategy`).
accountIdNoOptional connected account id (`acc_...`) to publish with. When set, that exact account (and its token) is used for its platform instead of auto-selecting one.
mediaUrlsNoOptional direct URLs to images (.png, .jpg, .webp), videos (.mp4, .mov), or documents (.pdf, .pptx, .docx for LinkedIn Document Carousels).
platformsYesNon-empty array of destination social network slugs to publish or cross-post to (e.g. `['x', 'linkedin', 'bluesky', 'threads']`).
profileIdNoBrand profile identifier (`prof_...`) whose connected social accounts will publish the post.prof_allometrik
visibilityNoOptional visibility setting (e.g. 'public' or 'connections' on LinkedIn; 'public', 'unlisted', or 'private' on YouTube/TikTok).
webhookUrlNoOptional https URL that receives a JSON post.published / post.failed / post.partial event when an Instagram/Threads post that returned status 'processing' (media container still being processed by Meta) is finished by the background job.
firstCommentNoOptional first comment or reply to publish immediately under the main post.
scheduledForNoOptional ISO-8601 UTC or offset timestamp (e.g. '2026-10-27T08:30:00+01:00') specifying when a scheduled post should go live.
thumbnailUrlNoOptional public image URL for a YouTube custom thumbnail at publish time (prefer `thumbnailMediaAssetId`). Same `thumbnails.set` path as `thumbnailMediaAssetId`.
mediaAssetIdsNoOptional list of Nuntior media asset IDs (`med_...`) from `media_pipeline` or `/v1/media/upload` to attach as images, PDF document carousels, or videos.
xLinkStrategyNoX (Twitter) link optimization mode: 'first_reply' moves any URL to an automated 1st reply to save $0.17/post (85% X API cost reduction) and maximize organic impressions; 'inline' leaves the URL in the main tweet; 'bio' replaces the URL with a bio pointer.first_reply
autoAdjustMediaNoWhen true, automatically selects the matching aspect-ratio variant (9:16 for Reels/TikTok/Shorts, 16:9 or 1:1 for X/LinkedIn) for each target platform.
authModeOverrideNoOptional authentication override forcing delivery through 'managed' Nuntior OAuth credentials or 'byok' customer-supplied keys.
thumbnailMediaAssetIdNoOptional Nuntior image media asset (`med_...`) used as the YouTube custom thumbnail at publish time via `POST /upload/youtube/v3/thumbnails/set`. Does not replace the video file. Thumbnail failures are returned in `thumbnailErrorDetail` and do not roll back a successful video upload.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • addedInput schema / properties / thumbnailMediaAssetId
      Added value: +{
      +  "description": "Optional Nuntior image media asset (`med_...`) used as the YouTube custom thumbnail at publish time via `POST /upload/youtube/v3/thumbnails/set`. Does not replace the video file. Thumbnail failures are returned in `thumbnailErrorDetail` and do not roll back a successful video upload.",
      +  "type": "string"
      +}
    • addedInput schema / properties / thumbnailUrl
      Added value: +{
      +  "description": "Optional public image URL for a YouTube custom thumbnail at publish time (prefer `thumbnailMediaAssetId`). Same `thumbnails.set` path as `thumbnailMediaAssetId`.",
      +  "type": "string"
      +}
  2. Changed2 schema fields changed
    • addedInput schema / properties / accountId
      Added value: +{
      +  "description": "Optional connected account id (`acc_...`) to publish with. When set, that exact account (and its token) is used for its platform instead of auto-selecting one.",
      +  "type": "string"
      +}
    • addedInput schema / properties / webhookUrl
      Added value: +{
      +  "description": "Optional https URL that receives a JSON post.published / post.failed / post.partial event when an Instagram/Threads post that returned status 'processing' (media container still being processed by Meta) is finished by the background job.",
      +  "type": "string"
      +}
  3. Changed2 schema fields changed
    • addedInput schema / properties / format
      Added value: +{
      +  "default": "post",
      +  "description": "Publication format. 'post' (default) is a regular feed post. 'story' publishes an Instagram Story: requires platforms=['instagram'], action='publish_now', exactly ONE media item (one entry in `mediaUrls` or `mediaAssetIds`; image .jpg/.png or video .mp4/.mov, ideally 9:16, video 3-60s) and NO caption (omit `content` or pass an empty string). Videos are processed by Instagram before going live.",
      +  "enum": [
      +    "post",
      +    "story"
      +  ],
      +  "type": "string"
      +}
    • changedInput schema / required
      Previous value: -[
      -  "action",
      -  "content",
      -  "platforms"
      -]New value: +[
      +  "action",
      +  "platforms"
      +]
  4. Changed6 schema fields changed
    • addedInput schema / properties / firstComment
      Added value: +{
      +  "description": "Optional first comment or reply to publish immediately under the main post.",
      +  "type": "string"
      +}
    • changedInput schema / properties / mediaAssetIds / description
      Previous value: -"Optional list of Nuntior media asset IDs (`med_...`) from `media_pipeline` to attach as images, carousels, or videos."New value: +"Optional list of Nuntior media asset IDs (`med_...`) from `media_pipeline` or `/v1/media/upload` to attach as images, PDF document carousels, or videos."
    • addedInput schema / properties / mediaUrls
      Added value: +{
      +  "description": "Optional direct URLs to images (.png, .jpg, .webp), videos (.mp4, .mov), or documents (.pdf, .pptx, .docx for LinkedIn Document Carousels).",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / tags
      Added value: +{
      +  "description": "Optional tags or keywords for YouTube, TikTok, or CMS posts.",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / title
      Added value: +{
      +  "description": "Optional headline, YouTube/TikTok video title, LinkedIn PDF carousel title, or Reddit/Pinterest post title.",
      +  "type": "string"
      +}
    • addedInput schema / properties / visibility
      Added value: +{
      +  "description": "Optional visibility setting (e.g. 'public' or 'connections' on LinkedIn; 'public', 'unlisted', or 'private' on YouTube/TikTok).",
      +  "enum": [
      +    "public",
      +    "unlisted",
      +    "private",
      +    "connections"
      +  ],
      +  "type": "string"
      +}
  5. Changed12 schema fields changed
    • addedInput schema / additionalProperties
      Added value: +false
    • addedInput schema / properties / action / description
      Added value: +"Publishing mode: 'publish_now' dispatches immediately, 'cross_post' syndicates tailored variants across multiple networks at once, 'schedule' holds until `scheduledFor`, and 'queue' places the post in the next best engagement slot."
    • addedInput schema / properties / authModeOverride / description
      Added value: +"Optional authentication override forcing delivery through 'managed' Nuntior OAuth credentials or 'byok' customer-supplied keys."
    • addedInput schema / properties / autoAdjustMedia / description
      Added value: +"When true, automatically selects the matching aspect-ratio variant (9:16 for Reels/TikTok/Shorts, 16:9 or 1:1 for X/LinkedIn) for each target platform."
    • changedInput schema / properties / content / description
      Previous value: -"Post text (may include URLs to optimize on X)"New value: +"Primary post body text, caption, or thread hook. May include hashtags, mentions, and URLs (external URLs on X are automatically handled according to `xLinkStrategy`)."
    • addedInput schema / properties / mediaAssetIds / description
      Added value: +"Optional list of Nuntior media asset IDs (`med_...`) from `media_pipeline` to attach as images, carousels, or videos."
    • addedInput schema / properties / platforms / description
      Added value: +"Non-empty array of destination social network slugs to publish or cross-post to (e.g. `['x', 'linkedin', 'bluesky', 'threads']`)."
    • changedInput schema / properties / platforms / items / enum
      Previous value: -[
      -  "x",
      -  "linkedin",
      -  "instagram",
      -  "facebook",
      -  "threads",
      -  "tiktok",
      -  "youtube",
      -  "bluesky",
      -  "mastodon",
      -  "farcaster",
      -  "reddit",
      -  "pinterest",
      -  "google_business",
      -  "telegram",
      -  "discord",
      -  "ghost",
      -  "wordpress",
      -  "webflow"
      -]New value: +[
      +  "x",
      +  "linkedin",
      +  "bluesky",
      +  "instagram",
      +  "facebook",
      +  "threads",
      +  "tiktok",
      +  "youtube",
      +  "reddit",
      +  "pinterest",
      +  "mastodon",
      +  "telegram",
      +  "discord",
      +  "google_business",
      +  "ghost",
      +  "wordpress",
      +  "webflow",
      +  "whatsapp"
      +]
    • addedInput schema / properties / profileId / default
      Added value: +"prof_allometrik"
    • addedInput schema / properties / profileId / description
      Added value: +"Brand profile identifier (`prof_...`) whose connected social accounts will publish the post."
    • changedInput schema / properties / scheduledFor / description
      Previous value: -"ISO-8601 timestamp when scheduling"New value: +"Optional ISO-8601 UTC or offset timestamp (e.g. '2026-10-27T08:30:00+01:00') specifying when a scheduled post should go live."
    • changedInput schema / properties / xLinkStrategy / description
      Previous value: -"Moves links on X to 1st reply to save $0.17/post ($0.20 -> $0.03 or $0 BYOK) and boost reach."New value: +"X (Twitter) link optimization mode: 'first_reply' moves any URL to an automated 1st reply to save $0.17/post (85% X API cost reduction) and maximize organic impressions; 'inline' leaves the URL in the main tweet; 'bio' replaces the URL with a bio pointer."
  6. First observed

TDQS

A4.1/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations declare non-read-only, non-idempotent, open-world, non-destructive, and the description adds genuinely new behavior: the first_reply link stripping, the 85% X cost saving, background processing for Instagram/Threads containers with webhook callbacks, and that thumbnail failures do not roll back the video upload. It does not state auth or rate-limit constraints, but the cost and async-delivery details go well beyond the annotation baseline.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two sentences, front-loaded with the action modes and followed by the differentiator and return shape. The parenthetical cost arithmetic ($0.03 vs $0.20) and the em-dash clause are slightly dense but each carries decision-relevant information, so little is wasted.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 19-parameter, non-idempotent publishing tool with no output schema, the description covers the action modes, the cross-posting scope, the link-optimizer behavior and the return fields (postId, platformResults, totalCostUsd, totalSavedViaSmartLinkUsd). It omits partial-failure semantics across platforms and the required-profileId default, which are the remaining gaps.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the schema already documents all 19 parameters, and the description largely restates the action enum and the xLinkStrategy default. It adds marginal value by tying xLinkStrategy's default to the cost-saving rationale, but no new syntax or constraint detail beyond what the schema supplies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description names a specific verb (publish/cross-post) and resource (content and media) and enumerates the four action modes with their parameter values, so the agent can distinguish publish_now, schedule, queue and cross_post without opening the schema. It also distinguishes this tool from posts_manage by scoping it to delivery across 18+ networks.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description gives clear conditions for each of the four modes (immediate, future timestamp, slot queue, simultaneous cross-post) and explains when the Smart Link Optimizer applies. It does not explicitly say when to use posts_manage or media_pipeline instead, so it stops short of full alternative routing.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources