MCPFerramentas MCP/Publicações/list_posts
list_posts
Readposts:read
Scope location means one location, brand means locationless client posts, all means every client post; default location when locationId is given, otherwise all. List real Posts, including unpublished Series drafts and client-level posts without a location. Provide clientId or locationId; both must agree. Follow nextPage until hasMore is false and reconcile changed totals/IDs; pages are live, not a snapshot. createdFrom/createdTo (legacy from/to) filter creation dates; scheduledFrom/scheduledTo filter actual schedules, never suggestions. UI Series titles belong to list_distribution_campaigns, not ContentSeries ideas.
Parâmetros
locationIdstringopcional
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.
clientIdstringopcional
Client id; includes client/account-level posts with no location. Accepts the database ID or public cli- ID. IDs must belong to the authenticated agency and permitted client.
connectionIdstringopcional
Connected account id; intersects selected scope.
distributionCampaignIdstringopcional
UI Series / DistributionCampaign id.
postIdsstring[]opcional
Exact real Post ids; [] returns no posts.
createdFromstringopcional
Creation time from (ISO).
createdTostringopcional
Creation time to (ISO).
scheduledFromstringopcional
Actual scheduled time from (ISO); excludes unscheduled drafts.
scheduledTostringopcional
Actual scheduled time to (ISO).
scope"location" | "brand" | "all"opcional
Post scope.
pagenumberopcional
Positive page number; default 1.
platform"google" | "facebook" | "instagram" | "x" | "linkedin" | "pinterest" | "mastodon" | "bluesky" | "threads" | "tiktok" | "youtube"opcional
Filter by platform.
type"announcement" | "event" | "offer"opcional
Filter by post type.
status"draft" | "scheduled" | "paused" | "publishing" | "active" | "partial" | "error" | "expired" | "incomplete"opcional
Filter by status. `incomplete` = drafts that can't publish yet because a required field is missing (each comes back with its missingFields).
fromstringopcional
Created from (ISO).
tostringopcional
Created to (ISO).
searchstringopcional
Name contains (case-insensitive).
limitnumberopcional
Page size 1–50; default 50.
Exemplo de solicitação
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "list_posts",
"arguments": {}
}
}Exemplo de resposta
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"content": [
{
"type": "text",
"text": "..."
}
]
}
}O formato da resposta é ilustrativo — o conteúdo real depende da ferramenta e dos seus dados.