# list_posts

> Page: https://docs.flung.dev/mcp/tools/list-posts. Index of every page: https://docs.flung.dev/llms.txt

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`](https://docs.flung.dev/reference/api/get-v1-posts.md) |
| 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](https://docs.flung.dev/mcp/tools.md) | Every tool |
| [Connect an AI agent](https://docs.flung.dev/mcp.md) | Install the server in your client |
| [`GET /v1/posts`](https://docs.flung.dev/reference/api/get-v1-posts.md) | The same operation over HTTP |