Skip to main content
Glama

Manage Scheduled & Published Social Posts

posts_manage
Idempotent

List, inspect, update, mutate, delete, or retry scheduled, queued, and published social media posts stored in Nuntior Cloud — including live real-time YouTube video/Short title and hashtag/tag updates via YouTube Data API v3 (PUT /youtube/v3/videos?part=snippet) while keeping the existing description 100% intact unless content is explicitly changed, and custom YouTube thumbnail updates via POST /upload/youtube/v3/thumbnails/set (thumbnailMediaAssetId / thumbnailUrl) that do not rewrite title, description, or tags. Also tracks 72h hook iteration metadata (rewriteCount, hookHistory, lastViewCount, iterationStatus, lessonsLearned).

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>"
    },
    "name": "posts_manage"
  }
}

Input Schema

NameRequiredDescriptionDefault
tagsNoUpdated hashtags/tags for the post or video.
titleNoUpdated video/post title (e.g., for YouTube Shorts title & hook iteration while keeping the description intact).
actionYesPost management operation: 'list' posts (optionally filtered by status), 'get' a single post by `postId` or `externalPostId` (with live YouTube view/like/comment counts and age in hours), 'update' / 'mutate' post content, YouTube title/tags, YouTube custom thumbnail, or schedule time, 'delete' a post, or 'retry_failed' to re-dispatch failed deliveries.
lessonNoOptional performance lesson note saved on the post when closing an iteration loop.
postIdNoUnique post identifier (`post_...`). Required when `action` is 'get', 'update', 'mutate', or 'delete' unless `externalPostId` is provided.
contentNoUpdated post text content or video description when executing `action: 'update'` or `'mutate'` (omit to keep the existing YouTube description 100% intact).
hookStyleNoOptional hook rotation label ('opinion', 'data', 'question') tracked in `hookHistory` (with `rewriteCount` incremented automatically).
profileIdNoBrand profile identifier (`prof_...`) used to scope the post query or mutation.prof_allometrik
scheduledForNoUpdated ISO-8601 publication timestamp when rescheduling a post via `action: 'update'`.
statusFilterNoOptional status filter when listing posts (e.g. 'published', 'scheduled', 'queued', 'failed', 'draft').
thumbnailUrlNoPublic image URL (JPEG/PNG/GIF/BMP/WebP) to set as the custom thumbnail on a published YouTube video via `thumbnails.set`. Prefer `thumbnailMediaAssetId` when the file is already in Nuntior `/media`. Same no-snippet-rewrite contract as `thumbnailMediaAssetId`.
externalPostIdNoOptional native platform video/post ID (e.g. YouTube `videoId`) to inspect or update directly on the platform even if originally uploaded outside Nuntior.
iterationStatusNoOptional iteration loop status ('active', 'thriving', 'closed').
preserveDescriptionNoKeep the original description untouched when updating a published video's title/tags (default `true` when `title` is provided without `content`).
thumbnailMediaAssetIdNoNuntior image media asset (`med_...`) to set as the custom thumbnail on a published YouTube video via `POST /upload/youtube/v3/thumbnails/set`. Preferred over `thumbnailUrl`. Does not call `videos.update` and does not alter title, description, or tags unless those fields are also passed. Requires a connected YouTube channel with upload scope. Channel must be verified for custom thumbnails.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed3 schema fields changed
    • changedInput schema / properties / action / description
      Previous value: -"Post management operation: 'list' posts (optionally filtered by status), 'get' a single post by `postId` or `externalPostId` (with live YouTube view/like/comment counts and age in hours), 'update' / 'mutate' post content, YouTube title/tags, or schedule time, 'delete' a post, or 'retry_failed' to re-dispatch failed deliveries."New value: +"Post management operation: 'list' posts (optionally filtered by status), 'get' a single post by `postId` or `externalPostId` (with live YouTube view/like/comment counts and age in hours), 'update' / 'mutate' post content, YouTube title/tags, YouTube custom thumbnail, or schedule time, 'delete' a post, or 'retry_failed' to re-dispatch failed deliveries."
    • addedInput schema / properties / thumbnailMediaAssetId
      Added value: +{
      +  "description": "Nuntior image media asset (`med_...`) to set as the custom thumbnail on a published YouTube video via `POST /upload/youtube/v3/thumbnails/set`. Preferred over `thumbnailUrl`. Does not call `videos.update` and does not alter title, description, or tags unless those fields are also passed. Requires a connected YouTube channel with upload scope. Channel must be verified for custom thumbnails.",
      +  "type": "string"
      +}
    • addedInput schema / properties / thumbnailUrl
      Added value: +{
      +  "description": "Public image URL (JPEG/PNG/GIF/BMP/WebP) to set as the custom thumbnail on a published YouTube video via `thumbnails.set`. Prefer `thumbnailMediaAssetId` when the file is already in Nuntior `/media`. Same no-snippet-rewrite contract as `thumbnailMediaAssetId`.",
      +  "type": "string"
      +}
  2. Changed10 schema fields changed
    • changedInput schema / properties / action / description
      Previous value: -"Post management operation: 'list' posts (optionally filtered by status), 'get' a single post by `postId`, 'update' post content or schedule time, 'delete' a post, or 'retry_failed' to re-dispatch failed deliveries."New value: +"Post management operation: 'list' posts (optionally filtered by status), 'get' a single post by `postId` or `externalPostId` (with live YouTube view/like/comment counts and age in hours), 'update' / 'mutate' post content, YouTube title/tags, or schedule time, 'delete' a post, or 'retry_failed' to re-dispatch failed deliveries."
    • changedInput schema / properties / content / description
      Previous value: -"Updated post text content when executing `action: 'update'`."New value: +"Updated post text content or video description when executing `action: 'update'` or `'mutate'` (omit to keep the existing YouTube description 100% intact)."
    • addedInput schema / properties / externalPostId
      Added value: +{
      +  "description": "Optional native platform video/post ID (e.g. YouTube `videoId`) to inspect or update directly on the platform even if originally uploaded outside Nuntior.",
      +  "type": "string"
      +}
    • addedInput schema / properties / hookStyle
      Added value: +{
      +  "description": "Optional hook rotation label ('opinion', 'data', 'question') tracked in `hookHistory` (with `rewriteCount` incremented automatically).",
      +  "type": "string"
      +}
    • addedInput schema / properties / iterationStatus
      Added value: +{
      +  "description": "Optional iteration loop status ('active', 'thriving', 'closed').",
      +  "enum": [
      +    "active",
      +    "thriving",
      +    "closed"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / lesson
      Added value: +{
      +  "description": "Optional performance lesson note saved on the post when closing an iteration loop.",
      +  "type": "string"
      +}
    • changedInput schema / properties / postId / description
      Previous value: -"Unique post identifier (`post_...`). Required when `action` is 'get', 'update', or 'delete'."New value: +"Unique post identifier (`post_...`). Required when `action` is 'get', 'update', 'mutate', or 'delete' unless `externalPostId` is provided."
    • addedInput schema / properties / preserveDescription
      Added value: +{
      +  "default": true,
      +  "description": "Keep the original description untouched when updating a published video's title/tags (default `true` when `title` is provided without `content`).",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / tags
      Added value: +{
      +  "description": "Updated hashtags/tags for the post or video.",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / title
      Added value: +{
      +  "description": "Updated video/post title (e.g., for YouTube Shorts title & hook iteration while keeping the description intact).",
      +  "type": "string"
      +}
  3. Changed1 schema field changed
    • changedInput schema / properties / action / enum
      Previous value: -[
      -  "list",
      -  "get",
      -  "update",
      -  "delete",
      -  "retry_failed"
      -]New value: +[
      +  "list",
      +  "get",
      +  "update",
      +  "mutate",
      +  "reschedule",
      +  "delete",
      +  "cancel",
      +  "retry_failed",
      +  "process_due"
      +]
  4. Changed8 schema fields changed
    • addedInput schema / additionalProperties
      Added value: +false
    • addedInput schema / properties / action / description
      Added value: +"Post management operation: 'list' posts (optionally filtered by status), 'get' a single post by `postId`, 'update' post content or schedule time, 'delete' a post, or 'retry_failed' to re-dispatch failed deliveries."
    • addedInput schema / properties / content / description
      Added value: +"Updated post text content when executing `action: 'update'`."
    • addedInput schema / properties / postId / description
      Added value: +"Unique post identifier (`post_...`). Required when `action` is 'get', 'update', or 'delete'."
    • addedInput schema / properties / profileId / default
      Added value: +"prof_allometrik"
    • addedInput schema / properties / profileId / description
      Added value: +"Brand profile identifier (`prof_...`) used to scope the post query or mutation."
    • addedInput schema / properties / scheduledFor / description
      Added value: +"Updated ISO-8601 publication timestamp when rescheduling a post via `action: 'update'`."
    • addedInput schema / properties / statusFilter / description
      Added value: +"Optional status filter when listing posts (e.g. 'published', 'scheduled', 'queued', 'failed', 'draft')."
  5. First observed

TDQS

B3.1/5.0
Behavior2/5

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

The description does add substantial behavior beyond the annotations: the `videos.update` no-snippet-rewrite contract, thumbnail-set semantics that leave title/description/tags untouched, and the verified-channel/upload-scope prerequisite. However, it advertises a `delete` action while the annotations declare `destructiveHint: false`, which is the annotation an agent would use to gate irreversible operations — that mismatch undercuts the safety signal.

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

Conciseness2/5

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

The verb list is correctly front-loaded, but the body is a single ~110-word run-on sentence cluttered with raw endpoint paths (`PUT /youtube/v3/videos?part=snippet`, `POST /upload/youtube/v3/thumbnails/set`) that belong in parameter documentation. It would be far more usable split into a short purpose line plus per-action notes.

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

Completeness3/5

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

For a 15-parameter, 9-action mutation tool with no output schema, the description covers the YouTube title/tag/thumbnail path well but never mentions `reschedule`, `cancel`, `process_due`, or what `get` returns (live view/like/comment counts appear only in the schema). It is adequate, not complete, for a tool of this surface area.

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

Parameters4/5

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

Schema coverage is 100%, so 3 is the floor, and the description genuinely adds meaning on top: it explains that omitting `content` keeps the YouTube description 100% intact, that `thumbnailMediaAssetId` is preferred over `thumbnailUrl`, and how `title`/`tags`/`preserveDescription` interact with the snippet-preservation contract. It does not explain the 72h iteration parameters (`rewriteCount`, `hookHistory`, `iterationStatus`) beyond naming them as tracked metadata.

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

Purpose4/5

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

The opening clause names concrete verbs and a concrete resource ("List, inspect, update, mutate, delete, or retry scheduled, queued, and published social media posts stored in Nuntior Cloud"), so an agent knows exactly what domain it touches. It is less clear on the boundary with the sibling `posts_publish` — nothing states that creation/publication belongs there and lifecycle management belongs here.

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

Usage Guidelines3/5

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

Per-action guidance (list vs get vs update vs delete) lives almost entirely in the `action` enum's schema description rather than the tool description. There is no explicit when-to-use/when-not-to-use routing to siblings such as `posts_publish`, `media_pipeline`, or `analytics_query`, so the agent must infer the split.

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