MCP: Posts and media
list_posts
List posts. Posts newest first with their status. For the next page pass the last id as startingAfter while hasMore is true.
TL;DR
| Question | Answer |
|---|---|
| What does it do? | Posts newest first with their status. For the next page pass the last id as startingAfter while hasMore is true. |
| Does it change anything? | Reads only. |
| Which endpoint does it call? | GET /v1/posts |
| Which server? | https://mcp.flung.dev/mcp-oauth (sign in) or https://mcp.flung.dev/mcp (API key). |
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
limit | integer | no | Posts per page. minimum 1; maximum 50; default 20. |
startingAfter | string | no | The last post id of the previous page. at least 1 character; at most 64 characters. |
status | "scheduled" | "publishing" | "published" | "partially_published" | "failed" | "cancelled" | no | |
platform | "x" | "instagram" | "facebook" | "threads" | "linkedin" | "tiktok" | "youtube" | "pinterest" | "bluesky" | "mastodon" | "discord" | "farcaster" | no | The social platform. |
Example call
json
{ "name": "list_posts", "arguments": { "limit": 10 }}Things a person might say
- "What have we posted this week?"
- "Show scheduled posts."
Annotations
| Hint | Value |
|---|---|
readOnlyHint | true |
destructiveHint | false |
idempotentHint | true |
openWorldHint | false |
See also
| Doc | Why |
|---|---|
| MCP tools | Every tool |
| Connect an AI agent | Install the server in your client |
GET /v1/posts | The same operation over HTTP |