MCPOutils MCP/Publications/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.
Paramètres
locationIdstringfacultatif
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.
clientIdstringfacultatif
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.
connectionIdstringfacultatif
Connected account id; intersects selected scope.
distributionCampaignIdstringfacultatif
UI Series / DistributionCampaign id.
postIdsstring[]facultatif
Exact real Post ids; [] returns no posts.
createdFromstringfacultatif
Creation time from (ISO).
createdTostringfacultatif
Creation time to (ISO).
scheduledFromstringfacultatif
Actual scheduled time from (ISO); excludes unscheduled drafts.
scheduledTostringfacultatif
Actual scheduled time to (ISO).
scope"location" | "brand" | "all"facultatif
Post scope.
pagenumberfacultatif
Positive page number; default 1.
platform"google" | "facebook" | "instagram" | "x" | "linkedin" | "pinterest" | "mastodon" | "bluesky" | "threads" | "tiktok" | "youtube"facultatif
Filter by platform.
type"announcement" | "event" | "offer"facultatif
Filter by post type.
status"draft" | "scheduled" | "paused" | "publishing" | "active" | "partial" | "error" | "expired" | "incomplete"facultatif
Filter by status. `incomplete` = drafts that can't publish yet because a required field is missing (each comes back with its missingFields).
fromstringfacultatif
Created from (ISO).
tostringfacultatif
Created to (ISO).
searchstringfacultatif
Name contains (case-insensitive).
limitnumberfacultatif
Page size 1–50; default 50.
Exemple de requête
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "list_posts",
"arguments": {}
}
}Exemple de réponse
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"content": [
{
"type": "text",
"text": "..."
}
]
}
}La forme de la réponse est indicative — le contenu réel dépend de l'outil et de vos données.