MCPMCP Tools/Posts/list_posts

list_posts

Readposts:read

List posts for a location with per-platform state and aggregate stats (agency-scoped).

Parameters
locationIdstringrequired
The location's id (from list_locations).
platform"google" | "facebook" | "instagram" | "x" | "linkedin" | "pinterest" | "mastodon" | "bluesky" | "threads" | "tiktok"optional
Filter by platform.
type"announcement" | "event" | "offer"optional
Filter by post type.
status"draft" | "scheduled" | "error" | "active" | "incomplete"optional
Filter by status.
fromstringoptional
Created from (ISO).
tostringoptional
Created to (ISO).
searchstringoptional
Name contains (case-insensitive).
limitnumberoptional
Max rows to return (1–200, default 50).
Example request
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_posts",
    "arguments": {
      "locationId": "string"
    }
  }
}
Example response
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "..."
      }
    ]
  }
}

Response shape shown for illustration — the actual content depends on the tool and your data.