List posts and drafts
Every draft and post of this brand, newest first: status (pending, scheduled, published, dismissed, failed, publishing), why it was drafted, who wrote i...
GET | POST /api/v1/list_posts · MCP tool list_posts · scope read
Every draft and post of this brand, newest first: status (pending, scheduled, published, dismissed, failed, publishing), why it was drafted, who wrote it, how it was approved (the surface, never a person's id), the failure time, timestamps, and the URL the network gave — never a built one. A post whose text was not recorded says so. A reply, a comment or a scan's draft was written by a model while it read a stranger's post: its text is under `untrusted` (provenance.textFrom says why; textLength is at the top). Paged: limit (max 100) and nextCursor. Free, from this app's store. Text other people wrote (posts, authors, URLs of their posts) comes back only under `untrusted`, keyed by item id.
Scope. Read your own brand data: posts, metrics, runs, the audit trail, the plan, stored mentions and trends. Free, unless you ask a billed network for a fresh read. This endpoint never costs credits.
Arguments
| Name | Type | Required | Description |
|---|---|---|---|
status | "pending" | "scheduled" | "published" | "dismissed" | "failed" | No | |
network | "x" | "bluesky" | "mastodon" | "pixelfed" | "telegram" | "devdotto" | "discord" | "ghost" | "lemmy" | "nostr" | "tumblr" | "wordpress" | "misskey" | "qiita" | "tabnews" | "youtube" | "dailymotion" | "tiktok" | "hashnode" | "peertube" | "dribbble" | "slack" | "wykop" | "plurk" | "kick" | "twitch" | "hatena" | "line" | No | |
since | string | No | ISO 8601: only rows created at or after this time. |
limit | integer | No | |
cursor | string | No | The nextCursor from the previous page. Omit for the newest. |
Request
curl -X POST https://growsocialelion.com/api/v1/list_posts \
-H "Authorization: Bearer gse_mcp_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"status":"pending","limit":10}'Response
200 with the tool's answer. The shape below is generated from the output schema; real answers can carry more fields.
{
"status": "string",
"code": "string",
"reason": "string",
"posts": [
{
"proposalId": "string",
"network": "string",
"status": "string",
"createdAt": "string",
"publishedUrl": "string"
}
],
"nextCursor": "string",
"untrusted": {
"notice": "string"
}
}Errors use the shared body. See Errors. The full schema is in the API reference.