List Mastodon server profile directory
mastodon_directory_listLists accounts a Mastodon server displays in its directory. Specify the server host to retrieve the list, with cursor support for pagination.
Instructions
List the accounts a Mastodon server shows in its directory. Requires host. 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": {
"host": "<host>",
"context": "<context>",
"llm_model": "<llm_model>"
},
"name": "mastodon_directory_list"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| host | Yes | Required. The Mastodon server to ask, e.g. `mastodon.social`. A server URL is also accepted. The server you name is the one that answers. | |
| limit | No | Items per page, 1 to 80. Default: 40. | |
| order | No | `active` (default) most recently active first, `new` newest first. | |
| scope | No | `all` (default) or `local` for the server's own accounts only. | |
| cursor | No | Pass `page.nextCursor` from the previous response (a plain number is taken as an offset). The list is ordered live, so a row can appear on two pages; remove repeats by `id`, `name` or `url`. | |
| offset | No | Items to skip, as an offset. Prefer `cursor` for the next page. Default: 0. | |
| 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. |