AdaptlyPost

Mark Inbox Comments

update_inbox_comments_status

Idempotent

Mark a batch of comments as unread, read or done in the AdaptlyPost inbox. Only AdaptlyPost changes; nothing is sent to the platform. Needs the inbox.reply permission, which Admin and Editor hold (403 permission_denied otherwise), and an active plan.

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": {
      "ids": "<ids>",
      "status": "<status>"
    },
    "name": "update_inbox_comments_status"
  }
}

Input Schema

Name	Required	Description
`ids`	Yes	Ids of the comments to mark, from list_inbox_comments
`status`	Yes	Inbox status to give every listed item
`workspaceId`	No	Workspace to act in: an id from list_workspaces. Omit to act in the workspace list_workspaces marks current. Use the same workspaceId for every call about the same workspace, since ids from one workspace (accounts, posts, uploads) do not exist in another

Output Schema

Name	Required	Description	Default
`result`	Yes	An object with comments (the updated comments) and unreadCount. An InboxComment: id, accountId, platform, accountName, postId (the AdaptlyPost post id, null when the post was not published through AdaptlyPost), platformPostId, postText, postPermalink, platformCommentId, parentPlatformCommentId (null for a top-level comment), isReply, author { id, name, username, avatarUrl }, text, permalink, likeCount, createdAt, status (UNREAD, READ or DONE), isHidden, isOwn, replied (the account has a reply under it, sent from AdaptlyPost or the platform app), repliedAt, likedByAccount and capabilities { canReply, canHide, canDelete, canLike }.

Schema Changelog

Changes observed during successful MCP inspections.

Changed6 schema fields changedNov 9, 2026

changedInput schema / properties / ids / description

Previous value: -"1 to 100 comment ids from list_inbox_comments"New value: +"Ids of the comments to mark, from list_inbox_comments"

changedInput schema / properties / status / description

Previous value: -"UNREAD, READ or DONE"New value: +"Inbox status to give every listed item"

addedOutput schema / properties / result / additionalProperties
```
Added value: +true
```

addedOutput schema / properties / result / properties

Added value: +{
+  "comments": {
+    "anyOf": [
+      {
+        "items": {
+          "additionalProperties": true,
+          "properties": {
+            "accountId": {
+              "description": "The account `id` from GET /social-accounts",
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "accountName": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "author": {
+              "anyOf": [
+                {
+                  "additionalProperties": true,
+                  "properties": {
+                    "avatarUrl": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "id": {
+                      "description": "The platform user id",
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "name": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "username": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    }
+                  },
+                  "type": "object"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "capabilities": {
+              "anyOf": [
+                {
+                  "additionalProperties": true,
+                  "properties": {
+                    "canDelete": {
+                      "type": [
+                        "boolean",
+                        "null"
+                      ]
+                    },
+                    "canHide": {
+                      "type": [
+                        "boolean",
+                        "null"
+                      ]
+                    },
+                    "canLike": {
+                      "type": [
+                        "boolean",
+                        "null"
+                      ]
+                    },
+                    "canReply": {
+                      "type": [
+                        "boolean",
+                        "null"
+                      ]
+                    }
+                  },
+                  "type": "object"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "createdAt": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "id": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "isHidden": {
+              "type": [
+                "boolean",
+                "null"
+              ]
+            },
+            "isOwn": {
+              "type": [
+                "boolean",
+                "null"
+              ]
+            },
+            "isReply": {
+              "type": [
+                "boolean",
+                "null"
+              ]
+            },
+            "likeCount": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "likedByAccount": {
+              "type": [
+                "boolean",
+                "null"
+              ]
+            },
+            "parentPlatformCommentId": {
+              "description": "Null for a top-level comment",
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "permalink": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "platform": {
+              "description": "One of: FACEBOOK, INSTAGRAM, THREADS, TIKTOK, TWITTER, BLUESKY, LINKEDIN, PINTEREST, YOUTUBE, MASTODON, TELEGRAM, GOOGLE_BUSINESS, TUMBLR, WORDPRESS",
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "platformCommentId": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "platformPostId": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "postId": {
+              "description": "The AdaptlyPost post id, null when the post was not published through AdaptlyPost",
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "postPermalink": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "postText": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "replied": {
+              "description": "True when your account has a reply under it, sent from AdaptlyPost or from the platform's own app",
+              "type": [
+                "boolean",
+                "null"
+              ]
+            },
+            "repliedAt": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "status": {
+              "description": "One of: UNREAD, READ, DONE",
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "text": {
+              "type": [
+                "string",
+                "null"
+              ]
+            }
+          },
+          "type": "object"
+        },
+        "type": "array"
+      },
+      {
+        "type": "null"
+      }
+    ]
+  },
+  "unreadCount": {
+    "description": "Unread items of this channel left in the workspace",
+    "type": [
+      "number",
+      "null"
+    ]
+  }
+}

addedOutput schema / properties / result / type
```
Added value: +"object"
```
addedOutput schema / required
```
Added value: +[
+  "result"
+]
```

AddedNov 8, 2026

TDQS

A3.7/5.0

Behavior4/5

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

Annotations already declare readOnlyHint=false, idempotentHint=true, and destructiveHint=false; the description adds value beyond them by scoping the blast radius ('only AdaptlyPost changes; nothing is sent to the platform') and disclosing the auth/plan requirements and the exact failure signal. Idempotency itself is left to the annotation rather than restated, which is fine.

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?

Three tight sentences: action front-loaded, then side-effect scope, then prerequisites. No filler or repetition of the title, though the permission clause is dense and could be split for faster scanning.

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?

An output schema exists, so return values need no explanation, and annotations cover the mutation profile; the description fills in the remaining gaps an agent needs (permission model, plan requirement, external side effects). Only the choice among the three sibling status tools remains uncovered.

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 description coverage is 100%, so ids, status enum, and workspaceId are already fully documented in the schema, including the cross-workspace id warning. The description only echoes the status values and the batch nature, adding no syntax or format detail beyond the schema.

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?

States a specific verb and resource: mark a batch of comments as UNREAD/READ/DONE in the AdaptlyPost inbox. The resource noun ('comments') distinguishes it from the conversation, mention, and review status siblings, though it never names an alternative explicitly.

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?

Gives real prerequisites (inbox.reply permission held by Admin/Editor, active plan, 403 permission_denied otherwise) but says nothing about when to pick this over update_inbox_mentions_status or update_inbox_reviews_status, or when a comment should not be marked. Prerequisites are covered; alternative selection is left to inference.

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

All AdaptlyPost tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?