MCPMCP Tools/Posts/list_posts
list_posts
Readposts:read
List published and scheduled posts for a location: content, images, platform status, engagement stats. Use for checking post cadence, social media activity.
Parameters
locationIdstringrequired
The location's id (from list_locations). Accepts the database ID or public loc- ID. IDs must belong to the authenticated agency and permitted client.
platform"google" | "facebook" | "instagram" | "x" | "linkedin" | "pinterest" | "mastodon" | "bluesky" | "threads" | "tiktok" | "youtube"optional
Filter by platform.
type"announcement" | "event" | "offer"optional
Filter by post type.
status"draft" | "scheduled" | "paused" | "publishing" | "active" | "partial" | "error" | "expired" | "incomplete"optional
Filter by status. `incomplete` = drafts that can't publish yet because a required field is missing (each comes back with its missingFields).
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.