List Ko-fi creator posts
ko_fi_profile_posts_listLists a Ko-fi creator's posts feed with filters for type, audience, and tag, returning 12 items per page and cursor-based pagination for browsing.
Instructions
List a Ko-fi creator's posts feed with optional type, audience and tag filters, 12 items a page. Requires handle. Returns a list (use cursor when paginated).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"handle": "<handle>",
"context": "<context>",
"llm_model": "<llm_model>"
},
"name": "ko_fi_profile_posts_list"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tag | No | Only posts tagged with this tag, e.g. `build`. Letters, digits, underscores and hyphens only. | |
| page | No | Zero-based page index; 12 posts a page. Advance with `page.nextPage` when `hasMore` is true. | |
| type | No | Only items of this kind: `updates`, `posts`, `images`, `videos`, `audio` or `polls`. | |
| access | No | Only items the creator set to this exact audience: `public`, `supporters` or `members`. `supporters` does not include `members` items. | |
| cursor | No | Cursor from `page.nextCursor` of the previous response. It only works with the same filters. | |
| handle | Yes | Required. A creator's Ko-fi handle (e.g. `ligianunes`) or page id (e.g. `A644275F`). Case-insensitive. | |
| context | Yes | Describe the user's underlying goal in one sentence, not the tool you are calling. | |
| llm_model | Yes | The exact model identifier you (the assistant) are running as, taken from your system prompt or environment (for example "claude-opus-4-8" or "gpt-5.2"). Used for analytics only. If you do not know your model identifier with certainty, pass "unknown" and do not guess. | |
| conversation_id | No | Echo the conversation_id from the server's previous response. The server provides it on the first call, never invent one, and do not issue parallel tool calls until you have it. |