MCPMCP-Tools/Social Inbox/list_inbox_items

list_inbox_items

Readinbox:read

List Social Inbox items — comments on the agency's posts, direct messages and @mentions — newest first, 20 per page (the result carries pageSize). Filter by kind, platform (facebook, instagram, x, linkedin, youtube, bluesky, mastodon), status (open | resolved), client or keyword. Filters apply before paging: `total` counts only the items matching them, so page 0, 1, 2… until you have `total` items is a complete walk. Every item carries `actions` — what you can do through this API (reply, privateReply, like/unlike, hide/unhide, delete, resolve/reopen, tag, assign) as { ok: true } or { ok: false, reason: network | window | done | deleted, reasonText } — so you know before trying whether a reply is possible and why not, and `appActions`: other things allowed on the item but done only in the app.

Parameter
kind"comment" | "message" | "mention"optional
comment | message (DM) | mention
platformstringoptional
Network key, e.g. instagram
status"open" | "resolved"optional
open | resolved
clientIdstringoptional
Only this client's items (database id or public cli- id)
keywordstringoptional
Text or @handle to search for
pagenumberoptional
Page number, from 0
Beispielanfrage
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_inbox_items",
    "arguments": {}
  }
}
Beispielantwort
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "..."
      }
    ]
  }
}

Die Antwortform dient nur zur Veranschaulichung — der tatsächliche Inhalt hängt vom Tool und Ihren Daten ab.