AdaptlyPost

Mark Inbox Reviews

update_inbox_reviews_status

Idempotent

Mark a batch of reviews as unread, read or done in the AdaptlyPost inbox. Only AdaptlyPost changes; nothing is sent to Google. 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_reviews_status"
  }
}

Input Schema

Name	Required	Description
`ids`	Yes	Ids of the reviews to mark, from list_inbox_reviews
`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 reviews (the updated reviews) and unreadCount. An InboxReview: id, accountId, platform (GOOGLE_BUSINESS), accountName, platformReviewId, reviewer { name, avatarUrl, isAnonymous }, rating (1 to 5), text, reply ({ text, updatedAt } or null), createdAt, updatedAt, status, repliedAt, maxReplyLength and capabilities { canReply }.

Schema Changelog

Changes observed during successful MCP inspections.

Changed6 schema fields changedNov 9, 2026

changedInput schema / properties / ids / description

Previous value: -"1 to 100 review ids from list_inbox_reviews"New value: +"Ids of the reviews to mark, from list_inbox_reviews"

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: +{
+  "reviews": {
+    "anyOf": [
+      {
+        "items": {
+          "additionalProperties": true,
+          "properties": {
+            "accountId": {
+              "description": "The account `id` from GET /social-accounts",
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "accountName": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "capabilities": {
+              "anyOf": [
+                {
+                  "additionalProperties": true,
+                  "properties": {
+                    "canReply": {
+                      "type": [
+                        "boolean",
+                        "null"
+                      ]
+                    }
+                  },
+                  "type": "object"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "createdAt": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "id": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "maxReplyLength": {
+              "description": "In UTF-8 bytes",
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "platform": {
+              "description": "One of: FACEBOOK, INSTAGRAM, THREADS, TIKTOK, TWITTER, BLUESKY, LINKEDIN, PINTEREST, YOUTUBE, MASTODON, TELEGRAM, GOOGLE_BUSINESS, TUMBLR, WORDPRESS",
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "platformReviewId": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "rating": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "repliedAt": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "reply": {
+              "anyOf": [
+                {
+                  "additionalProperties": true,
+                  "properties": {
+                    "text": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "updatedAt": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    }
+                  },
+                  "type": "object"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "reviewer": {
+              "anyOf": [
+                {
+                  "additionalProperties": true,
+                  "properties": {
+                    "avatarUrl": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "isAnonymous": {
+                      "type": [
+                        "boolean",
+                        "null"
+                      ]
+                    },
+                    "name": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    }
+                  },
+                  "type": "object"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "status": {
+              "description": "One of: UNREAD, READ, DONE",
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "text": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "updatedAt": {
+              "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

A4.1/5.0

Behavior4/5

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

Goes well beyond the annotations: it names the required permission (inbox.reply), who holds it (Admin, Editor), the failure mode (403 permission_denied), the plan prerequisite, and the crucial fact that the change is local-only and not propagated to Google. It stops short of describing partial-failure behavior when some ids in the batch are invalid or belong to another workspace.

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

Conciseness5/5

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

Three short sentences, action first, then effect scope, then prerequisites. No filler and no repetition of schema or annotation content.

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

Completeness5/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; the schema covers batch limits and workspace scoping; annotations cover safety and idempotency. The description fills the remaining gaps an agent would need (permission, plan, local-only effect) to invoke it correctly.

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 the schema already explains ids, the status enum, and workspaceId resolution. The description adds only the framing that ids are processed as a batch and that all items get the same status; it introduces no syntax or format detail beyond the schema, so the baseline 3 applies.

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?

States a specific verb (mark), a specific resource (a batch of reviews in the AdaptlyPost inbox), and the exact target states (unread, read, done). The resource noun 'reviews' cleanly separates it from the comment/conversation/mention status siblings, and 'Only AdaptlyPost changes; nothing is sent to Google' pins the blast radius.

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?

Usage is implied by the described action and the states offered, and the 'nothing is sent to Google' note implicitly tells the agent this is not a reply/publish operation. But there is no explicit when-to-use versus the sibling status tools or list_inbox_reviews, and no stated when-not.

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?