List Mastodon profile posts
mastodon_profile_posts_listList public posts from a Mastodon profile by handle, with filters for originals, media, or pinned posts and cursor-based pagination.
Instructions
List the public posts of a Mastodon profile. 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": "mastodon_profile_posts_list"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tag | No | Hashtag name without the `#`, e.g. `photography`. Letters of any script are allowed; the server folds case and accents. | |
| limit | No | Items per page, 1 to 40. Default: 20. | |
| cursor | No | Pass `page.nextCursor` from the previous response to get the next page. | |
| filter | No | `all` (default) includes replies and boosts, `original` leaves them out, `media` keeps posts with media, `pinned` returns the pinned posts. | |
| handle | Yes | Required. Account handle with its home server, e.g. `Gargron@mastodon.social`. A leading `acct:` or `@`, or a profile URL (`https://mastodon.social/@Gargron`, `https://mastodon.social/web/@Gargron`) is also accepted. | |
| 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. |