<!-- https://cutedyno.com/docs/mcp/tools/list_posts -->

# List posts

MCP tool `list_posts`, calling `GET /v1/posts`.

Returns posts for a profile, newest first, with filters for status, content type, and platform.

Read only: yes.

## Parameters

- `profileId` (string) — Profile to act on. Omit to use the profile this API key belongs to. Call list_profiles first when managing several customers.
- `page` (integer) — Defaults to 1.
- `limit` (integer) — Defaults to 20, max 100.
- `status` (enum) — Filter by lifecycle state. One of: draft, pending_approval, approved, rejected, scheduled, queued, processing, published, partially_published, failed, cancelled.
- `contentType` (enum) One of: text, image, video.
- `platform` (enum) One of: facebook, instagram, tiktok, linkedin, youtube.