Focus · Mastodon
Typed Focus mode operations for Mastodon accounts, generated from the Mastodon focus module (same behaviour as the generic /accounts/{accountId}/focus routes).
focus_mastodon- Statuses27
- Scheduled statuses5
- Polls3
- Media4
- Pinned statuses3
- Notifications6
- Grouped notifications5
- Notification policy2
- Notification requests7
- Conversations6
- Comments7
- Followers4
- Following5
- Follow requests3
- Relationships9
- Familiar followers1
- Accounts3
- Lists10
- Featured tags5
- Endorsements4
- Follow1
- Unfollow1
- Remove from followers1
- Block1
- Unblock1
- Mute1
- Unmute1
- Endorse1
- Unendorse1
- Note1
- List members3
- Collections9
- Suggestions3
- Directory2
- Bookmarks6
- Favourites6
- Followed tags4
- Filters7
- Filter keywords5
- Filter statuses4
- Markers2
- Home timeline8
- Local timeline8
- Federated timeline8
- Hashtag timeline8
- Link timeline8
- List timeline8
- Trends tags2
- Trends statuses8
- Trends links1
- Search1
- Tags5
- Blocks3
- Mutes3
- Domain blocks3
- Reports1
- Profile4
- Preferences1
- Annual reports5
- Push subscription4
- Instance1
- Instance rules1
- Terms of service1
- Privacy policy1
- Extended description1
- Instance peers1
- Instance activity1
- Instance domain blocks1
- Translation languages1
- Custom emojis1
- Announcements4
- Account overview1
- Post performance1
- Admin accounts10
- Admin reports7
- Admin domain blocks5
- Admin domain allows4
- Admin ip blocks5
- Admin email domain blocks4
- Admin canonical email blocks5
- Admin measures1
- Admin dimensions1
- Admin retention1
- Admin trends links3
- Admin trends statuses3
- Admin trends tags3
Statuses
Mastodon: List Posts
/accounts/{accountId}/mastodon/statusesOwn statuses (GET /api/v1/accounts/:id/statuses). Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Cursor pagination: pass next_cursor back as cursor. Requires scopes: read:statuses. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: /v1/accounts/{accountId}/focus/statuses.
Try it with MCPAsk your agent to call mastodon-statuses-list (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringOpaque cursor from a previous next_cursor
limitintegerdefault: 201–80
account_idstringDefaults to the connected account
only_mediabooleanexclude_repliesbooleanexclude_reblogsbooleanpinnedbooleantaggedstringexclude_directbooleanMastodon 4.6+
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 29 item attributes
idstringrequiredread-onlyuristring (uri)urlstring (uri) | nullcreated_atstring (date-time)edited_atstring (date-time) | nulltextstringread-onlycontentstringspoiler_textstringsensitivebooleanvisibilitystringpublicunlistedprivatedirect
languagestring | nullin_reply_to_idstring | nullin_reply_to_account_idstring | nullreplies_countintegerreblogs_countintegerfavourites_countintegerquotes_countinteger | nullauthorstringauthor_namestring | nullmedia_attachmentsarray of objectShow 8 item attributes
idstringread-onlytypestringimagegifvvideoaudiounknown
urlstring (uri) | nullpreview_urlstring (uri) | nullremote_urlstring (uri) | nulldescriptionstring | nullblurhashstring | nullmetaobjectpollobject | nullShow 9 child attributes
idstringread-onlyexpires_atstring (date-time) | nullexpiredbooleanmultiplebooleanvotes_countintegervoters_countinteger | nullvotedbooleanown_votesarray of integeroptionsarray of objectShow 2 item attributes
titlestringvotes_countinteger | nullfavouritedbooleanrebloggedbooleanbookmarkedbooleanmutedbooleanpinnedbooleanis_reblogbooleanquoteobject | nullShow 2 child attributes
statestringquoted_statusobject | nullquote_approvalobject | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Mastodon: Create a Posts item
/accounts/{accountId}/mastodon/statusesPublish (media, poll, CW, quote, schedule, thread). Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Requires scopes: read:statuses, write:statuses. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: /v1/accounts/{accountId}/focus/statuses.
Try it with MCPAsk your agent to call mastodon-statuses-create (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
statusstringPlain text; URLs count as 23 characters
visibilitystringpublicunlistedprivatedirect
spoiler_textstringsensitivebooleanlanguagestringISO 639-1
mediaarray of stringSocialit media ids (uploaded to the instance on publish)
media_idsarray of stringAlready-uploaded Mastodon media ids
alt_textsarray of stringAlt text per media item, by index
pollobjectShow 4 child attributes
optionsarray of string≥ 2 items
expires_inintegerdefault: 86400multiplebooleanhide_totalsbooleanin_reply_to_idstringquoted_status_idstringMastodon 4.5+
quote_approval_policystringpublicfollowersnobody
scheduled_atstring (date-time)≥ 5 minutes ahead → ScheduledStatus
threadarray of stringFollow-up replies posted as a self-thread
Returns object
idstringrequiredread-onlyuristring (uri)urlstring (uri) | nullcreated_atstring (date-time)edited_atstring (date-time) | nulltextstringread-onlycontentstringspoiler_textstringsensitivebooleanvisibilitystringpublicunlistedprivatedirect
languagestring | nullin_reply_to_idstring | nullin_reply_to_account_idstring | nullreplies_countintegerreblogs_countintegerfavourites_countintegerquotes_countinteger | nullauthorstringauthor_namestring | nullmedia_attachmentsarray of objectShow 8 item attributes
idstringread-onlytypestringimagegifvvideoaudiounknown
urlstring (uri) | nullpreview_urlstring (uri) | nullremote_urlstring (uri) | nulldescriptionstring | nullblurhashstring | nullmetaobjectpollobject | nullShow 9 child attributes
idstringread-onlyexpires_atstring (date-time) | nullexpiredbooleanmultiplebooleanvotes_countintegervoters_countinteger | nullvotedbooleanown_votesarray of integeroptionsarray of objectShow 2 item attributes
titlestringvotes_countinteger | nullfavouritedbooleanrebloggedbooleanbookmarkedbooleanmutedbooleanpinnedbooleanis_reblogbooleanquoteobject | nullShow 2 child attributes
statestringquoted_statusobject | nullquote_approvalobject | nullResponses
Mastodon: Get a Posts item
/accounts/{accountId}/mastodon/statuses/{itemId}Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Requires scopes: read:statuses. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: /v1/accounts/{accountId}/focus/statuses.
Try it with MCPAsk your agent to call mastodon-statuses-get (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringrequiredread-onlyuristring (uri)urlstring (uri) | nullcreated_atstring (date-time)edited_atstring (date-time) | nulltextstringread-onlycontentstringspoiler_textstringsensitivebooleanvisibilitystringpublicunlistedprivatedirect
languagestring | nullin_reply_to_idstring | nullin_reply_to_account_idstring | nullreplies_countintegerreblogs_countintegerfavourites_countintegerquotes_countinteger | nullauthorstringauthor_namestring | nullmedia_attachmentsarray of objectShow 8 item attributes
idstringread-onlytypestringimagegifvvideoaudiounknown
urlstring (uri) | nullpreview_urlstring (uri) | nullremote_urlstring (uri) | nulldescriptionstring | nullblurhashstring | nullmetaobjectpollobject | nullShow 9 child attributes
idstringread-onlyexpires_atstring (date-time) | nullexpiredbooleanmultiplebooleanvotes_countintegervoters_countinteger | nullvotedbooleanown_votesarray of integeroptionsarray of objectShow 2 item attributes
titlestringvotes_countinteger | nullfavouritedbooleanrebloggedbooleanbookmarkedbooleanmutedbooleanpinnedbooleanis_reblogbooleanquoteobject | nullShow 2 child attributes
statestringquoted_statusobject | nullquote_approvalobject | nullResponses
Mastodon: Update a Posts item
/accounts/{accountId}/mastodon/statuses/{itemId}Edit (PUT /api/v1/statuses/:id); visibility cannot change. Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Requires scopes: read:statuses, write:statuses. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: /v1/accounts/{accountId}/focus/statuses.
Try it with MCPAsk your agent to call mastodon-statuses-update (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
statusstringspoiler_textstringsensitivebooleanlanguagestringmedia_idsarray of stringFinal list of attachment ids (omit to keep)
mediaarray of stringNew Socialit media to upload and append
media_attributesarray of objectShow 3 item attributes
idstringdescriptionstringfocusstring"x,y"
pollobject | nullShow 4 child attributes
optionsarray of stringexpires_inintegermultiplebooleanhide_totalsbooleanquote_approval_policystringpublicfollowersnobody
Returns object
idstringrequiredread-onlyuristring (uri)urlstring (uri) | nullcreated_atstring (date-time)edited_atstring (date-time) | nulltextstringread-onlycontentstringspoiler_textstringsensitivebooleanvisibilitystringpublicunlistedprivatedirect
languagestring | nullin_reply_to_idstring | nullin_reply_to_account_idstring | nullreplies_countintegerreblogs_countintegerfavourites_countintegerquotes_countinteger | nullauthorstringauthor_namestring | nullmedia_attachmentsarray of objectShow 8 item attributes
idstringread-onlytypestringimagegifvvideoaudiounknown
urlstring (uri) | nullpreview_urlstring (uri) | nullremote_urlstring (uri) | nulldescriptionstring | nullblurhashstring | nullmetaobjectpollobject | nullShow 9 child attributes
idstringread-onlyexpires_atstring (date-time) | nullexpiredbooleanmultiplebooleanvotes_countintegervoters_countinteger | nullvotedbooleanown_votesarray of integeroptionsarray of objectShow 2 item attributes
titlestringvotes_countinteger | nullfavouritedbooleanrebloggedbooleanbookmarkedbooleanmutedbooleanpinnedbooleanis_reblogbooleanquoteobject | nullShow 2 child attributes
statestringquoted_statusobject | nullquote_approvalobject | nullResponses
Mastodon: Delete a Posts item
/accounts/{accountId}/mastodon/statuses/{itemId}Delete (and its media). Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Requires scopes: read:statuses, write:statuses. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: /v1/accounts/{accountId}/focus/statuses.
Try it with MCPAsk your agent to call mastodon-statuses-delete (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Mastodon: Pin to profile (Posts)
/accounts/{accountId}/mastodon/statuses/{itemId}/pinPin to profile. Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Requires scopes: read:statuses, write:accounts. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: /v1/accounts/{accountId}/focus/statuses.
Try it with MCPAsk your agent to call mastodon-statuses-pin (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Unpin (Posts)
/accounts/{accountId}/mastodon/statuses/{itemId}/unpinUnpin. Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Requires scopes: read:statuses, write:accounts. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: /v1/accounts/{accountId}/focus/statuses.
Try it with MCPAsk your agent to call mastodon-statuses-unpin (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Boost (Posts)
/accounts/{accountId}/mastodon/statuses/{itemId}/boostBoost. Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Requires scopes: read:statuses, write:statuses. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: /v1/accounts/{accountId}/focus/statuses.
Try it with MCPAsk your agent to call mastodon-statuses-boost (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
visibilitystringpublicunlistedprivate
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Undo boost (Posts)
/accounts/{accountId}/mastodon/statuses/{itemId}/unboostUndo boost. Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Requires scopes: read:statuses, write:statuses. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: /v1/accounts/{accountId}/focus/statuses.
Try it with MCPAsk your agent to call mastodon-statuses-unboost (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Favourite (Posts)
/accounts/{accountId}/mastodon/statuses/{itemId}/favouriteFavourite. Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Requires scopes: read:statuses, write:favourites. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: /v1/accounts/{accountId}/focus/statuses.
Try it with MCPAsk your agent to call mastodon-statuses-favourite (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Unfavourite (Posts)
/accounts/{accountId}/mastodon/statuses/{itemId}/unfavouriteUnfavourite. Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Requires scopes: read:statuses, write:favourites. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: /v1/accounts/{accountId}/focus/statuses.
Try it with MCPAsk your agent to call mastodon-statuses-unfavourite (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Bookmark (Posts)
/accounts/{accountId}/mastodon/statuses/{itemId}/bookmarkBookmark. Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Requires scopes: read:statuses, write:bookmarks. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: /v1/accounts/{accountId}/focus/statuses.
Try it with MCPAsk your agent to call mastodon-statuses-bookmark (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Remove bookmark (Posts)
/accounts/{accountId}/mastodon/statuses/{itemId}/unbookmarkRemove bookmark. Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Requires scopes: read:statuses, write:bookmarks. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: /v1/accounts/{accountId}/focus/statuses.
Try it with MCPAsk your agent to call mastodon-statuses-unbookmark (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Mute conversation (Posts)
/accounts/{accountId}/mastodon/statuses/{itemId}/muteMute conversation. Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Requires scopes: read:statuses, write:mutes. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: /v1/accounts/{accountId}/focus/statuses.
Try it with MCPAsk your agent to call mastodon-statuses-mute (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Unmute conversation (Posts)
/accounts/{accountId}/mastodon/statuses/{itemId}/unmuteUnmute conversation. Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Requires scopes: read:statuses, write:mutes. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: /v1/accounts/{accountId}/focus/statuses.
Try it with MCPAsk your agent to call mastodon-statuses-unmute (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Reply / continue thread (Posts)
/accounts/{accountId}/mastodon/statuses/{itemId}/replyReply / continue thread. Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Requires scopes: read:statuses, write:statuses. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: /v1/accounts/{accountId}/focus/statuses.
Try it with MCPAsk your agent to call mastodon-statuses-reply (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
statusstringPlain text; URLs count as 23 characters
visibilitystringpublicunlistedprivatedirect
spoiler_textstringsensitivebooleanlanguagestringISO 639-1
mediaarray of stringSocialit media ids (uploaded to the instance on publish)
media_idsarray of stringAlready-uploaded Mastodon media ids
alt_textsarray of stringAlt text per media item, by index
pollobjectShow 4 child attributes
optionsarray of string≥ 2 items
expires_inintegerdefault: 86400multiplebooleanhide_totalsbooleanin_reply_to_idstringquoted_status_idstringMastodon 4.5+
quote_approval_policystringpublicfollowersnobody
scheduled_atstring (date-time)≥ 5 minutes ahead → ScheduledStatus
threadarray of stringFollow-up replies posted as a self-thread
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Translate (Posts)
/accounts/{accountId}/mastodon/statuses/{itemId}/translateTranslate. Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Requires scopes: read:statuses. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: /v1/accounts/{accountId}/focus/statuses.
Try it with MCPAsk your agent to call mastodon-statuses-translate (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
langstringTarget ISO 639-1 (default: user locale)
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Edit history (Posts)
/accounts/{accountId}/mastodon/statuses/{itemId}/historyEdit history. Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Requires scopes: read:statuses. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: /v1/accounts/{accountId}/focus/statuses.
Try it with MCPAsk your agent to call mastodon-statuses-history (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Source text (Posts)
/accounts/{accountId}/mastodon/statuses/{itemId}/sourceSource text. Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Requires scopes: read:statuses. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: /v1/accounts/{accountId}/focus/statuses.
Try it with MCPAsk your agent to call mastodon-statuses-source (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Thread (Posts)
/accounts/{accountId}/mastodon/statuses/{itemId}/contextThread. Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Requires scopes: read:statuses. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: /v1/accounts/{accountId}/focus/statuses.
Try it with MCPAsk your agent to call mastodon-statuses-context (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Delete & redraft (Posts)
/accounts/{accountId}/mastodon/statuses/{itemId}/redraftDeletes the status (keeping media) and re-posts it with optional changes. Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Destructive. Requires scopes: read:statuses, write:statuses. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: /v1/accounts/{accountId}/focus/statuses.
Try it with MCPAsk your agent to call mastodon-statuses-redraft (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
statusstringspoiler_textstringvisibilitystringpublicunlistedprivatedirect
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Favourited by (Posts)
/accounts/{accountId}/mastodon/statuses/{itemId}/favourited-byFavourited by. Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Requires scopes: read:statuses. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: /v1/accounts/{accountId}/focus/statuses.
Try it with MCPAsk your agent to call mastodon-statuses-favourited-by (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
cursorstringOpaque cursor from a previous next_cursor
limitintegerdefault: 201–80
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Boosted by (Posts)
/accounts/{accountId}/mastodon/statuses/{itemId}/reblogged-byBoosted by. Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Requires scopes: read:statuses. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: /v1/accounts/{accountId}/focus/statuses.
Try it with MCPAsk your agent to call mastodon-statuses-reblogged-by (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
cursorstringOpaque cursor from a previous next_cursor
limitintegerdefault: 201–80
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Quotes of this post (Posts)
/accounts/{accountId}/mastodon/statuses/{itemId}/quotesQuotes of this post. Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Requires scopes: read:statuses. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: /v1/accounts/{accountId}/focus/statuses.
Try it with MCPAsk your agent to call mastodon-statuses-quotes (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
cursorstringOpaque cursor from a previous next_cursor
limitintegerdefault: 201–80
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Revoke a quote (Posts)
/accounts/{accountId}/mastodon/statuses/{itemId}/revoke-quoteRevoke a quote. Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Destructive. Requires scopes: read:statuses, write:statuses. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: /v1/accounts/{accountId}/focus/statuses.
Try it with MCPAsk your agent to call mastodon-statuses-revoke-quote (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
quoting_status_idstringrequiredReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Who can quote (Posts)
/accounts/{accountId}/mastodon/statuses/{itemId}/interaction-policyWho can quote. Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Requires scopes: read:statuses, write:statuses. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: /v1/accounts/{accountId}/focus/statuses.
Try it with MCPAsk your agent to call mastodon-statuses-interaction-policy (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
quote_approval_policystringrequiredpublicfollowersnobody
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Posts (People)
/accounts/{accountId}/mastodon/accounts/{itemId}/statusesPosts. Search and look up accounts (local or remote), see their posts, follow, block, mute, endorse, add notes. Requires scopes: read:accounts. Network docs: https://docs.joinmastodon.org/methods/accounts/ Generic route: /v1/accounts/{accountId}/focus/accounts.
Try it with MCPAsk your agent to call mastodon-accounts-statuses (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
cursorstringOpaque cursor from a previous next_cursor
limitintegerdefault: 201–80
only_mediabooleanexclude_repliesbooleanexclude_reblogsbooleanpinnedbooleantaggedstringReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Scheduled statuses
Mastodon: List Scheduled posts
/accounts/{accountId}/mastodon/scheduled-statusesStatuses scheduled natively on the instance (from any client). Content is fixed; only the date can change. Cursor pagination: pass next_cursor back as cursor. Requires scopes: read:statuses. Network docs: https://docs.joinmastodon.org/methods/scheduled_statuses/ Generic route: /v1/accounts/{accountId}/focus/scheduled-statuses.
Try it with MCPAsk your agent to call mastodon-scheduled-statuses-list (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringOpaque cursor from a previous next_cursor
limitintegerdefault: 201–80
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 9 item attributes
idstringrequiredread-onlyscheduled_atstring (date-time)requiredtextstringread-onlyvisibilitystring | nullpublicunlistedprivatedirect
spoiler_textstring | nullmedia_countintegerpoll_optionsarray of string | nullparamsobjectmedia_attachmentsarray of objectShow 8 item attributes
idstringread-onlytypestringimagegifvvideoaudiounknown
urlstring (uri) | nullpreview_urlstring (uri) | nullremote_urlstring (uri) | nulldescriptionstring | nullblurhashstring | nullmetaobjectlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Mastodon: Create a Scheduled posts item
/accounts/{accountId}/mastodon/scheduled-statusesSchedule natively (≥ 5 min ahead, max 300 pending / 25 per day). Statuses scheduled natively on the instance (from any client). Content is fixed; only the date can change. Requires scopes: read:statuses, write:statuses. Network docs: https://docs.joinmastodon.org/methods/scheduled_statuses/ Generic route: /v1/accounts/{accountId}/focus/scheduled-statuses.
Try it with MCPAsk your agent to call mastodon-scheduled-statuses-create (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
statusstringPlain text; URLs count as 23 characters
visibilitystringpublicunlistedprivatedirect
spoiler_textstringsensitivebooleanlanguagestringISO 639-1
mediaarray of stringSocialit media ids (uploaded to the instance on publish)
media_idsarray of stringAlready-uploaded Mastodon media ids
alt_textsarray of stringAlt text per media item, by index
pollobjectShow 4 child attributes
optionsarray of string≥ 2 items
expires_inintegerdefault: 86400multiplebooleanhide_totalsbooleanin_reply_to_idstringquoted_status_idstringMastodon 4.5+
quote_approval_policystringpublicfollowersnobody
scheduled_atstring (date-time)required≥ 5 minutes ahead → ScheduledStatus
threadarray of stringFollow-up replies posted as a self-thread
Returns object
idstringrequiredread-onlyscheduled_atstring (date-time)requiredtextstringread-onlyvisibilitystring | nullpublicunlistedprivatedirect
spoiler_textstring | nullmedia_countintegerpoll_optionsarray of string | nullparamsobjectmedia_attachmentsarray of objectShow 8 item attributes
idstringread-onlytypestringimagegifvvideoaudiounknown
urlstring (uri) | nullpreview_urlstring (uri) | nullremote_urlstring (uri) | nulldescriptionstring | nullblurhashstring | nullmetaobjectResponses
Mastodon: Get a Scheduled posts item
/accounts/{accountId}/mastodon/scheduled-statuses/{itemId}Statuses scheduled natively on the instance (from any client). Content is fixed; only the date can change. Requires scopes: read:statuses. Network docs: https://docs.joinmastodon.org/methods/scheduled_statuses/ Generic route: /v1/accounts/{accountId}/focus/scheduled-statuses.
Try it with MCPAsk your agent to call mastodon-scheduled-statuses-get (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringrequiredread-onlyscheduled_atstring (date-time)requiredtextstringread-onlyvisibilitystring | nullpublicunlistedprivatedirect
spoiler_textstring | nullmedia_countintegerpoll_optionsarray of string | nullparamsobjectmedia_attachmentsarray of objectShow 8 item attributes
idstringread-onlytypestringimagegifvvideoaudiounknown
urlstring (uri) | nullpreview_urlstring (uri) | nullremote_urlstring (uri) | nulldescriptionstring | nullblurhashstring | nullmetaobjectResponses
Mastodon: Update a Scheduled posts item
/accounts/{accountId}/mastodon/scheduled-statuses/{itemId}Reschedule. Statuses scheduled natively on the instance (from any client). Content is fixed; only the date can change. Requires scopes: read:statuses, write:statuses. Network docs: https://docs.joinmastodon.org/methods/scheduled_statuses/ Generic route: /v1/accounts/{accountId}/focus/scheduled-statuses.
Try it with MCPAsk your agent to call mastodon-scheduled-statuses-update (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
scheduled_atstring (date-time)requiredReturns object
idstringrequiredread-onlyscheduled_atstring (date-time)requiredtextstringread-onlyvisibilitystring | nullpublicunlistedprivatedirect
spoiler_textstring | nullmedia_countintegerpoll_optionsarray of string | nullparamsobjectmedia_attachmentsarray of objectShow 8 item attributes
idstringread-onlytypestringimagegifvvideoaudiounknown
urlstring (uri) | nullpreview_urlstring (uri) | nullremote_urlstring (uri) | nulldescriptionstring | nullblurhashstring | nullmetaobjectResponses
Mastodon: Delete a Scheduled posts item
/accounts/{accountId}/mastodon/scheduled-statuses/{itemId}Statuses scheduled natively on the instance (from any client). Content is fixed; only the date can change. Requires scopes: read:statuses, write:statuses. Network docs: https://docs.joinmastodon.org/methods/scheduled_statuses/ Generic route: /v1/accounts/{accountId}/focus/scheduled-statuses.
Try it with MCPAsk your agent to call mastodon-scheduled-statuses-delete (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Polls
Mastodon: List Polls
/accounts/{accountId}/mastodon/pollsOwn statuses that carry a poll. Your polls and their results; vote in any poll. Cursor pagination: pass next_cursor back as cursor. Requires scopes: read:statuses. Network docs: https://docs.joinmastodon.org/methods/polls/ Generic route: /v1/accounts/{accountId}/focus/polls.
Try it with MCPAsk your agent to call mastodon-polls-list (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringOpaque cursor from a previous next_cursor
limitintegerdefault: 201–80
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 12 item attributes
idstringread-onlyexpires_atstring (date-time) | nullexpiredbooleanmultiplebooleanvotes_countintegervoters_countinteger | nullvotedbooleanown_votesarray of integeroptionsarray of objectShow 2 item attributes
titlestringvotes_countinteger | nullstatus_idstringquestionstringcreated_atstring (date-time)limitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Mastodon: Get a Polls item
/accounts/{accountId}/mastodon/polls/{itemId}Your polls and their results; vote in any poll. Requires scopes: read:statuses. Network docs: https://docs.joinmastodon.org/methods/polls/ Generic route: /v1/accounts/{accountId}/focus/polls.
Try it with MCPAsk your agent to call mastodon-polls-get (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringread-onlyexpires_atstring (date-time) | nullexpiredbooleanmultiplebooleanvotes_countintegervoters_countinteger | nullvotedbooleanown_votesarray of integeroptionsarray of objectShow 2 item attributes
titlestringvotes_countinteger | nullstatus_idstringquestionstringcreated_atstring (date-time)Responses
Mastodon: Vote (Polls)
/accounts/{accountId}/mastodon/polls/{itemId}/voteVote. Your polls and their results; vote in any poll. Requires scopes: read:statuses, write:statuses. Network docs: https://docs.joinmastodon.org/methods/polls/ Generic route: /v1/accounts/{accountId}/focus/polls.
Try it with MCPAsk your agent to call mastodon-polls-vote (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
choicesarray of integerrequired≥ 1 items
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Media
Mastodon: Get a Media item
/accounts/{accountId}/mastodon/media/{itemId}Upload media, edit alt text / focal point before attaching, delete unattached uploads (unattached media is purged after 1 day). Requires scopes: write:media. Network docs: https://docs.joinmastodon.org/methods/media/ Generic route: /v1/accounts/{accountId}/focus/media.
Try it with MCPAsk your agent to call mastodon-media-get (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringread-onlytypestringimagegifvvideoaudiounknown
urlstring (uri) | nullpreview_urlstring (uri) | nullremote_urlstring (uri) | nulldescriptionstring | nullblurhashstring | nullmetaobjectResponses
Mastodon: Update a Media item
/accounts/{accountId}/mastodon/media/{itemId}Alt text / focal point (only before attaching; afterwards edit the status media_attributes). Upload media, edit alt text / focal point before attaching, delete unattached uploads (unattached media is purged after 1 day). Requires scopes: write:media. Network docs: https://docs.joinmastodon.org/methods/media/ Generic route: /v1/accounts/{accountId}/focus/media.
Try it with MCPAsk your agent to call mastodon-media-update (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
descriptionstringfocusstringReturns object
idstringread-onlytypestringimagegifvvideoaudiounknown
urlstring (uri) | nullpreview_urlstring (uri) | nullremote_urlstring (uri) | nulldescriptionstring | nullblurhashstring | nullmetaobjectResponses
Mastodon: Delete a Media item
/accounts/{accountId}/mastodon/media/{itemId}Delete unattached media (4.4+). Upload media, edit alt text / focal point before attaching, delete unattached uploads (unattached media is purged after 1 day). Requires scopes: write:media. Network docs: https://docs.joinmastodon.org/methods/media/ Generic route: /v1/accounts/{accountId}/focus/media.
Try it with MCPAsk your agent to call mastodon-media-delete (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Mastodon: Create a Media item
/accounts/{accountId}/mastodon/mediaPOST /api/v2/media (waits for processing). Upload media, edit alt text / focal point before attaching, delete unattached uploads (unattached media is purged after 1 day). Requires scopes: write:media. Network docs: https://docs.joinmastodon.org/methods/media/ Generic route: /v1/accounts/{accountId}/focus/media.
Try it with MCPAsk your agent to call mastodon-media-create (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
mediastringSocialit media id
urlstring (uri)Or a public URL
descriptionstringfocusstring"x,y" in -1.0..1.0
thumbnailstringCustom thumbnail (video/audio)
Returns object
idstringread-onlytypestringimagegifvvideoaudiounknown
urlstring (uri) | nullpreview_urlstring (uri) | nullremote_urlstring (uri) | nulldescriptionstring | nullblurhashstring | nullmetaobjectResponses
Pinned statuses
Mastodon: List Pinned posts
/accounts/{accountId}/mastodon/pinned-statusesStatuses pinned to your profile (max configuration.accounts.max_pinned_statuses, default 5). Cursor pagination: pass next_cursor back as cursor. Requires scopes: read:statuses. Network docs: https://docs.joinmastodon.org/methods/statuses/#pin Generic route: /v1/accounts/{accountId}/focus/pinned-statuses.
Try it with MCPAsk your agent to call mastodon-pinned-statuses-list (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringOpaque cursor from a previous next_cursor
limitintegerdefault: 201–80
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 29 item attributes
idstringrequiredread-onlyuristring (uri)urlstring (uri) | nullcreated_atstring (date-time)edited_atstring (date-time) | nulltextstringread-onlycontentstringspoiler_textstringsensitivebooleanvisibilitystringpublicunlistedprivatedirect
languagestring | nullin_reply_to_idstring | nullin_reply_to_account_idstring | nullreplies_countintegerreblogs_countintegerfavourites_countintegerquotes_countinteger | nullauthorstringauthor_namestring | nullmedia_attachmentsarray of objectShow 8 item attributes
idstringread-onlytypestringimagegifvvideoaudiounknown
urlstring (uri) | nullpreview_urlstring (uri) | nullremote_urlstring (uri) | nulldescriptionstring | nullblurhashstring | nullmetaobjectpollobject | nullShow 9 child attributes
idstringread-onlyexpires_atstring (date-time) | nullexpiredbooleanmultiplebooleanvotes_countintegervoters_countinteger | nullvotedbooleanown_votesarray of integeroptionsarray of objectShow 2 item attributes
titlestringvotes_countinteger | nullfavouritedbooleanrebloggedbooleanbookmarkedbooleanmutedbooleanpinnedbooleanis_reblogbooleanquoteobject | nullShow 2 child attributes
statestringquoted_statusobject | nullquote_approvalobject | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Mastodon: Create a Pinned posts item
/accounts/{accountId}/mastodon/pinned-statusesStatuses pinned to your profile (max configuration.accounts.max_pinned_statuses, default 5). Requires scopes: read:statuses, write:accounts. Network docs: https://docs.joinmastodon.org/methods/statuses/#pin Generic route: /v1/accounts/{accountId}/focus/pinned-statuses.
Try it with MCPAsk your agent to call mastodon-pinned-statuses-create (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
status_idstringrequiredReturns object
idstringrequiredread-onlyuristring (uri)urlstring (uri) | nullcreated_atstring (date-time)edited_atstring (date-time) | nulltextstringread-onlycontentstringspoiler_textstringsensitivebooleanvisibilitystringpublicunlistedprivatedirect
languagestring | nullin_reply_to_idstring | nullin_reply_to_account_idstring | nullreplies_countintegerreblogs_countintegerfavourites_countintegerquotes_countinteger | nullauthorstringauthor_namestring | nullmedia_attachmentsarray of objectShow 8 item attributes
idstringread-onlytypestringimagegifvvideoaudiounknown
urlstring (uri) | nullpreview_urlstring (uri) | nullremote_urlstring (uri) | nulldescriptionstring | nullblurhashstring | nullmetaobjectpollobject | nullShow 9 child attributes
idstringread-onlyexpires_atstring (date-time) | nullexpiredbooleanmultiplebooleanvotes_countintegervoters_countinteger | nullvotedbooleanown_votesarray of integeroptionsarray of objectShow 2 item attributes
titlestringvotes_countinteger | nullfavouritedbooleanrebloggedbooleanbookmarkedbooleanmutedbooleanpinnedbooleanis_reblogbooleanquoteobject | nullShow 2 child attributes
statestringquoted_statusobject | nullquote_approvalobject | nullResponses
Mastodon: Delete a Pinned posts item
/accounts/{accountId}/mastodon/pinned-statuses/{itemId}Statuses pinned to your profile (max configuration.accounts.max_pinned_statuses, default 5). Requires scopes: read:statuses, write:accounts. Network docs: https://docs.joinmastodon.org/methods/statuses/#pin Generic route: /v1/accounts/{accountId}/focus/pinned-statuses.
Try it with MCPAsk your agent to call mastodon-pinned-statuses-delete (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Notifications
Mastodon: List Notifications
/accounts/{accountId}/mastodon/notificationsAll notifications (mentions, boosts, favourites, follows, quotes, polls, moderation…). Cursor pagination: pass next_cursor back as cursor. Requires scopes: read:notifications. Network docs: https://docs.joinmastodon.org/methods/notifications/ Generic route: /v1/accounts/{accountId}/focus/notifications.
Try it with MCPAsk your agent to call mastodon-notifications-list (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringOpaque cursor from a previous next_cursor
limitintegerdefault: 201–80
typesarray of stringexclude_typesarray of stringaccount_idstringinclude_filteredbooleanInclude notifications filtered by the notification policy (4.3+)
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 15 item attributes
idstringrequiredread-onlytypestringrequiredmentionstatusreblogfollowfollow_requestfavouritepollupdateadmin.sign_upadmin.reportsevered_relationshipsmoderation_warningquotequoted_updateadded_to_collectioncollection_update
created_atstring (date-time)group_keystring | nullauthorstring | nullauthor_namestring | nulltextstring | nullstatus_idstring | nullvisibilitystring | nullfilteredboolean | nullaccountobject | nullShow 23 child attributes
idstringrequiredread-onlyacctstringrequiredusernamestringdisplay_namestringurlstring (uri)avatarstringheaderstringnotestringnote_textstringlockedbooleanbotbooleangroupbooleandiscoverableboolean | nullindexableboolean | nullfollowers_countintegerfollowing_countintegerstatuses_countintegercreated_atstring (date-time)last_status_atstring (date) | nullfieldsarray of objectShow 3 item attributes
namestringvaluestringverified_atstring (date-time) | nullmovedobject | nullsuspendedbooleanlimitedbooleanstatusobject | nullShow 29 child attributes
idstringrequiredread-onlyuristring (uri)urlstring (uri) | nullcreated_atstring (date-time)edited_atstring (date-time) | nulltextstringread-onlycontentstringspoiler_textstringsensitivebooleanvisibilitystringpublicunlistedprivatedirect
languagestring | nullin_reply_to_idstring | nullin_reply_to_account_idstring | nullreplies_countintegerreblogs_countintegerfavourites_countintegerquotes_countinteger | nullauthorstringauthor_namestring | nullmedia_attachmentsarray of objectShow 8 item attributes
idstringread-onlytypestringimagegifvvideoaudiounknown
urlstring (uri) | nullpreview_urlstring (uri) | nullremote_urlstring (uri) | nulldescriptionstring | nullblurhashstring | nullmetaobjectpollobject | nullShow 9 child attributes
idstringread-onlyexpires_atstring (date-time) | nullexpiredbooleanmultiplebooleanvotes_countintegervoters_countinteger | nullvotedbooleanown_votesarray of integeroptionsarray of objectShow 2 item attributes
titlestringvotes_countinteger | nullfavouritedbooleanrebloggedbooleanbookmarkedbooleanmutedbooleanpinnedbooleanis_reblogbooleanquoteobject | nullShow 2 child attributes
statestringquoted_statusobject | nullquote_approvalobject | nullreportobject | nullmoderation_warningobject | nulleventobject | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Mastodon: Get a Notifications item
/accounts/{accountId}/mastodon/notifications/{itemId}All notifications (mentions, boosts, favourites, follows, quotes, polls, moderation…). Requires scopes: read:notifications. Network docs: https://docs.joinmastodon.org/methods/notifications/ Generic route: /v1/accounts/{accountId}/focus/notifications.
Try it with MCPAsk your agent to call mastodon-notifications-get (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringrequiredread-onlytypestringrequiredmentionstatusreblogfollowfollow_requestfavouritepollupdateadmin.sign_upadmin.reportsevered_relationshipsmoderation_warningquotequoted_updateadded_to_collectioncollection_update
created_atstring (date-time)group_keystring | nullauthorstring | nullauthor_namestring | nulltextstring | nullstatus_idstring | nullvisibilitystring | nullfilteredboolean | nullaccountobject | nullShow 23 child attributes
idstringrequiredread-onlyacctstringrequiredusernamestringdisplay_namestringurlstring (uri)avatarstringheaderstringnotestringnote_textstringlockedbooleanbotbooleangroupbooleandiscoverableboolean | nullindexableboolean | nullfollowers_countintegerfollowing_countintegerstatuses_countintegercreated_atstring (date-time)last_status_atstring (date) | nullfieldsarray of objectShow 3 item attributes
namestringvaluestringverified_atstring (date-time) | nullmovedobject | nullsuspendedbooleanlimitedbooleanstatusobject | nullShow 29 child attributes
idstringrequiredread-onlyuristring (uri)urlstring (uri) | nullcreated_atstring (date-time)edited_atstring (date-time) | nulltextstringread-onlycontentstringspoiler_textstringsensitivebooleanvisibilitystringpublicunlistedprivatedirect
languagestring | nullin_reply_to_idstring | nullin_reply_to_account_idstring | nullreplies_countintegerreblogs_countintegerfavourites_countintegerquotes_countinteger | nullauthorstringauthor_namestring | nullmedia_attachmentsarray of objectShow 8 item attributes
idstringread-onlytypestringimagegifvvideoaudiounknown
urlstring (uri) | nullpreview_urlstring (uri) | nullremote_urlstring (uri) | nulldescriptionstring | nullblurhashstring | nullmetaobjectpollobject | nullShow 9 child attributes
idstringread-onlyexpires_atstring (date-time) | nullexpiredbooleanmultiplebooleanvotes_countintegervoters_countinteger | nullvotedbooleanown_votesarray of integeroptionsarray of objectShow 2 item attributes
titlestringvotes_countinteger | nullfavouritedbooleanrebloggedbooleanbookmarkedbooleanmutedbooleanpinnedbooleanis_reblogbooleanquoteobject | nullShow 2 child attributes
statestringquoted_statusobject | nullquote_approvalobject | nullreportobject | nullmoderation_warningobject | nulleventobject | nullResponses
Mastodon: Dismiss (Notifications)
/accounts/{accountId}/mastodon/notifications/{itemId}/dismissDismiss. All notifications (mentions, boosts, favourites, follows, quotes, polls, moderation…). Requires scopes: read:notifications, write:notifications. Network docs: https://docs.joinmastodon.org/methods/notifications/ Generic route: /v1/accounts/{accountId}/focus/notifications.
Try it with MCPAsk your agent to call mastodon-notifications-dismiss (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Clear all (Notifications)
/accounts/{accountId}/mastodon/notifications/clearClear all. All notifications (mentions, boosts, favourites, follows, quotes, polls, moderation…). Destructive. Requires scopes: read:notifications, write:notifications. Network docs: https://docs.joinmastodon.org/methods/notifications/ Generic route: /v1/accounts/{accountId}/focus/notifications.
Try it with MCPAsk your agent to call mastodon-notifications-clear (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Unread count (Notifications)
/accounts/{accountId}/mastodon/notifications/unread-countUnread count. All notifications (mentions, boosts, favourites, follows, quotes, polls, moderation…). Requires scopes: read:notifications. Network docs: https://docs.joinmastodon.org/methods/notifications/ Generic route: /v1/accounts/{accountId}/focus/notifications.
Try it with MCPAsk your agent to call mastodon-notifications-unread-count (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Reply (Notifications)
/accounts/{accountId}/mastodon/notifications/{itemId}/replyReply. All notifications (mentions, boosts, favourites, follows, quotes, polls, moderation…). Requires scopes: read:notifications, write:statuses. Network docs: https://docs.joinmastodon.org/methods/notifications/ Generic route: /v1/accounts/{accountId}/focus/notifications.
Try it with MCPAsk your agent to call mastodon-notifications-reply (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
statusstringPlain text; URLs count as 23 characters
visibilitystringpublicunlistedprivatedirect
spoiler_textstringsensitivebooleanlanguagestringISO 639-1
mediaarray of stringSocialit media ids (uploaded to the instance on publish)
media_idsarray of stringAlready-uploaded Mastodon media ids
alt_textsarray of stringAlt text per media item, by index
pollobjectShow 4 child attributes
optionsarray of string≥ 2 items
expires_inintegerdefault: 86400multiplebooleanhide_totalsbooleanin_reply_to_idstringquoted_status_idstringMastodon 4.5+
quote_approval_policystringpublicfollowersnobody
scheduled_atstring (date-time)≥ 5 minutes ahead → ScheduledStatus
threadarray of stringFollow-up replies posted as a self-thread
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Grouped notifications
Mastodon: List Grouped notifications
/accounts/{accountId}/mastodon/grouped-notificationsNotifications grouped like the Mastodon web UI ("Alice and 12 others favourited…"). Mastodon 4.3+. Cursor pagination: pass next_cursor back as cursor. Requires scopes: read:notifications. Network docs: https://docs.joinmastodon.org/methods/grouped_notifications/ Generic route: /v1/accounts/{accountId}/focus/grouped-notifications.
Try it with MCPAsk your agent to call mastodon-grouped-notifications-list (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringOpaque cursor from a previous next_cursor
limitintegerdefault: 201–80
typesarray of stringexclude_typesarray of stringgrouped_typesarray of stringaccount_idstringinclude_filteredbooleanexpand_accountsstringfullpartial_avatars
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 10 item attributes
group_keystringrequiredread-onlytypestringmentionstatusreblogfollowfollow_requestfavouritepollupdateadmin.sign_upadmin.reportsevered_relationshipsmoderation_warningquotequoted_updateadded_to_collectioncollection_update
notifications_countintegermost_recent_notification_idstringcreated_atstring (date-time) | nullauthorstring | nulltextstring | nullaccountsarray of objectShow 23 item attributes
idstringrequiredread-onlyacctstringrequiredusernamestringdisplay_namestringurlstring (uri)avatarstringheaderstringnotestringnote_textstringlockedbooleanbotbooleangroupbooleandiscoverableboolean | nullindexableboolean | nullfollowers_countintegerfollowing_countintegerstatuses_countintegercreated_atstring (date-time)last_status_atstring (date) | nullfieldsarray of objectShow 3 item attributes
namestringvaluestringverified_atstring (date-time) | nullmovedobject | nullsuspendedbooleanlimitedbooleanstatusobject | nullShow 29 child attributes
idstringrequiredread-onlyuristring (uri)urlstring (uri) | nullcreated_atstring (date-time)edited_atstring (date-time) | nulltextstringread-onlycontentstringspoiler_textstringsensitivebooleanvisibilitystringpublicunlistedprivatedirect
languagestring | nullin_reply_to_idstring | nullin_reply_to_account_idstring | nullreplies_countintegerreblogs_countintegerfavourites_countintegerquotes_countinteger | nullauthorstringauthor_namestring | nullmedia_attachmentsarray of objectShow 8 item attributes
idstringread-onlytypestringimagegifvvideoaudiounknown
urlstring (uri) | nullpreview_urlstring (uri) | nullremote_urlstring (uri) | nulldescriptionstring | nullblurhashstring | nullmetaobjectpollobject | nullShow 9 child attributes
idstringread-onlyexpires_atstring (date-time) | nullexpiredbooleanmultiplebooleanvotes_countintegervoters_countinteger | nullvotedbooleanown_votesarray of integeroptionsarray of objectShow 2 item attributes
titlestringvotes_countinteger | nullfavouritedbooleanrebloggedbooleanbookmarkedbooleanmutedbooleanpinnedbooleanis_reblogbooleanquoteobject | nullShow 2 child attributes
statestringquoted_statusobject | nullquote_approvalobject | nullsample_account_idsarray of stringlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Mastodon: Get a Grouped notifications item
/accounts/{accountId}/mastodon/grouped-notifications/{itemId}Notifications grouped like the Mastodon web UI ("Alice and 12 others favourited…"). Mastodon 4.3+. Requires scopes: read:notifications. Network docs: https://docs.joinmastodon.org/methods/grouped_notifications/ Generic route: /v1/accounts/{accountId}/focus/grouped-notifications.
Try it with MCPAsk your agent to call mastodon-grouped-notifications-get (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
group_keystringrequiredread-onlytypestringmentionstatusreblogfollowfollow_requestfavouritepollupdateadmin.sign_upadmin.reportsevered_relationshipsmoderation_warningquotequoted_updateadded_to_collectioncollection_update
notifications_countintegermost_recent_notification_idstringcreated_atstring (date-time) | nullauthorstring | nulltextstring | nullaccountsarray of objectShow 23 item attributes
idstringrequiredread-onlyacctstringrequiredusernamestringdisplay_namestringurlstring (uri)avatarstringheaderstringnotestringnote_textstringlockedbooleanbotbooleangroupbooleandiscoverableboolean | nullindexableboolean | nullfollowers_countintegerfollowing_countintegerstatuses_countintegercreated_atstring (date-time)last_status_atstring (date) | nullfieldsarray of objectShow 3 item attributes
namestringvaluestringverified_atstring (date-time) | nullmovedobject | nullsuspendedbooleanlimitedbooleanstatusobject | nullShow 29 child attributes
idstringrequiredread-onlyuristring (uri)urlstring (uri) | nullcreated_atstring (date-time)edited_atstring (date-time) | nulltextstringread-onlycontentstringspoiler_textstringsensitivebooleanvisibilitystringpublicunlistedprivatedirect
languagestring | nullin_reply_to_idstring | nullin_reply_to_account_idstring | nullreplies_countintegerreblogs_countintegerfavourites_countintegerquotes_countinteger | nullauthorstringauthor_namestring | nullmedia_attachmentsarray of objectShow 8 item attributes
idstringread-onlytypestringimagegifvvideoaudiounknown
urlstring (uri) | nullpreview_urlstring (uri) | nullremote_urlstring (uri) | nulldescriptionstring | nullblurhashstring | nullmetaobjectpollobject | nullShow 9 child attributes
idstringread-onlyexpires_atstring (date-time) | nullexpiredbooleanmultiplebooleanvotes_countintegervoters_countinteger | nullvotedbooleanown_votesarray of integeroptionsarray of objectShow 2 item attributes
titlestringvotes_countinteger | nullfavouritedbooleanrebloggedbooleanbookmarkedbooleanmutedbooleanpinnedbooleanis_reblogbooleanquoteobject | nullShow 2 child attributes
statestringquoted_statusobject | nullquote_approvalobject | nullsample_account_idsarray of stringResponses
Mastodon: Dismiss group (Grouped notifications)
/accounts/{accountId}/mastodon/grouped-notifications/{itemId}/dismissDismiss group. Notifications grouped like the Mastodon web UI ("Alice and 12 others favourited…"). Mastodon 4.3+. Requires scopes: read:notifications, write:notifications. Network docs: https://docs.joinmastodon.org/methods/grouped_notifications/ Generic route: /v1/accounts/{accountId}/focus/grouped-notifications.
Try it with MCPAsk your agent to call mastodon-grouped-notifications-dismiss (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Accounts in group (Grouped notifications)
/accounts/{accountId}/mastodon/grouped-notifications/{itemId}/accountsAccounts in group. Notifications grouped like the Mastodon web UI ("Alice and 12 others favourited…"). Mastodon 4.3+. Requires scopes: read:notifications. Network docs: https://docs.joinmastodon.org/methods/grouped_notifications/ Generic route: /v1/accounts/{accountId}/focus/grouped-notifications.
Try it with MCPAsk your agent to call mastodon-grouped-notifications-accounts (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Unread count (Grouped notifications)
/accounts/{accountId}/mastodon/grouped-notifications/unread-countUnread count. Notifications grouped like the Mastodon web UI ("Alice and 12 others favourited…"). Mastodon 4.3+. Requires scopes: read:notifications. Network docs: https://docs.joinmastodon.org/methods/grouped_notifications/ Generic route: /v1/accounts/{accountId}/focus/grouped-notifications.
Try it with MCPAsk your agent to call mastodon-grouped-notifications-unread-count (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Notification policy
Mastodon: Get Notification filtering
/accounts/{accountId}/mastodon/notification-policyFilter or drop notifications from people you don’t follow, new accounts, private mentions, moderated accounts (4.3+). Requires scopes: read:notifications. Network docs: https://docs.joinmastodon.org/methods/notifications/#get-policy Generic route: /v1/accounts/{accountId}/focus/notification-policy.
Try it with MCPAsk your agent to call mastodon-notification-policy-get (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
for_not_followingstringacceptfilterdrop
for_not_followersstringacceptfilterdrop
for_new_accountsstringacceptfilterdrop
for_private_mentionsstringacceptfilterdrop
for_limited_accountsstringacceptfilterdrop
summaryobjectread-onlyShow 2 child attributes
pending_requests_countintegerpending_notifications_countintegerResponses
Mastodon: Update Notification filtering
/accounts/{accountId}/mastodon/notification-policyFilter or drop notifications from people you don’t follow, new accounts, private mentions, moderated accounts (4.3+). Requires scopes: read:notifications, write:notifications. Network docs: https://docs.joinmastodon.org/methods/notifications/#get-policy Generic route: /v1/accounts/{accountId}/focus/notification-policy.
Try it with MCPAsk your agent to call mastodon-notification-policy-update (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Body object
for_not_followingstringacceptfilterdrop
for_not_followersstringacceptfilterdrop
for_new_accountsstringacceptfilterdrop
for_private_mentionsstringacceptfilterdrop
for_limited_accountsstringacceptfilterdrop
Returns object
for_not_followingstringacceptfilterdrop
for_not_followersstringacceptfilterdrop
for_new_accountsstringacceptfilterdrop
for_private_mentionsstringacceptfilterdrop
for_limited_accountsstringacceptfilterdrop
summaryobjectread-onlyShow 2 child attributes
pending_requests_countintegerpending_notifications_countintegerResponses
Notification requests
Mastodon: List Message requests
/accounts/{accountId}/mastodon/notification-requestsNotifications held back by your filtering policy (mentions and DMs from strangers). Accept to move them into the inbox. Cursor pagination: pass next_cursor back as cursor. Requires scopes: read:notifications. Network docs: https://docs.joinmastodon.org/methods/notifications/#get-requests Generic route: /v1/accounts/{accountId}/focus/notification-requests.
Try it with MCPAsk your agent to call mastodon-notification-requests-list (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringOpaque cursor from a previous next_cursor
limitintegerdefault: 201–80
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 8 item attributes
idstringrequiredread-onlycreated_atstring (date-time)updated_atstring (date-time)notifications_countstringauthorstringtextstring | nullaccountobjectShow 23 child attributes
idstringrequiredread-onlyacctstringrequiredusernamestringdisplay_namestringurlstring (uri)avatarstringheaderstringnotestringnote_textstringlockedbooleanbotbooleangroupbooleandiscoverableboolean | nullindexableboolean | nullfollowers_countintegerfollowing_countintegerstatuses_countintegercreated_atstring (date-time)last_status_atstring (date) | nullfieldsarray of objectShow 3 item attributes
namestringvaluestringverified_atstring (date-time) | nullmovedobject | nullsuspendedbooleanlimitedbooleanlast_statusobject | nullShow 29 child attributes
idstringrequiredread-onlyuristring (uri)urlstring (uri) | nullcreated_atstring (date-time)edited_atstring (date-time) | nulltextstringread-onlycontentstringspoiler_textstringsensitivebooleanvisibilitystringpublicunlistedprivatedirect
languagestring | nullin_reply_to_idstring | nullin_reply_to_account_idstring | nullreplies_countintegerreblogs_countintegerfavourites_countintegerquotes_countinteger | nullauthorstringauthor_namestring | nullmedia_attachmentsarray of objectShow 8 item attributes
idstringread-onlytypestringimagegifvvideoaudiounknown
urlstring (uri) | nullpreview_urlstring (uri) | nullremote_urlstring (uri) | nulldescriptionstring | nullblurhashstring | nullmetaobjectpollobject | nullShow 9 child attributes
idstringread-onlyexpires_atstring (date-time) | nullexpiredbooleanmultiplebooleanvotes_countintegervoters_countinteger | nullvotedbooleanown_votesarray of integeroptionsarray of objectShow 2 item attributes
titlestringvotes_countinteger | nullfavouritedbooleanrebloggedbooleanbookmarkedbooleanmutedbooleanpinnedbooleanis_reblogbooleanquoteobject | nullShow 2 child attributes
statestringquoted_statusobject | nullquote_approvalobject | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Mastodon: Get a Message requests item
/accounts/{accountId}/mastodon/notification-requests/{itemId}Notifications held back by your filtering policy (mentions and DMs from strangers). Accept to move them into the inbox. Requires scopes: read:notifications. Network docs: https://docs.joinmastodon.org/methods/notifications/#get-requests Generic route: /v1/accounts/{accountId}/focus/notification-requests.
Try it with MCPAsk your agent to call mastodon-notification-requests-get (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringrequiredread-onlycreated_atstring (date-time)updated_atstring (date-time)notifications_countstringauthorstringtextstring | nullaccountobjectShow 23 child attributes
idstringrequiredread-onlyacctstringrequiredusernamestringdisplay_namestringurlstring (uri)avatarstringheaderstringnotestringnote_textstringlockedbooleanbotbooleangroupbooleandiscoverableboolean | nullindexableboolean | nullfollowers_countintegerfollowing_countintegerstatuses_countintegercreated_atstring (date-time)last_status_atstring (date) | nullfieldsarray of objectShow 3 item attributes
namestringvaluestringverified_atstring (date-time) | nullmovedobject | nullsuspendedbooleanlimitedbooleanlast_statusobject | nullShow 29 child attributes
idstringrequiredread-onlyuristring (uri)urlstring (uri) | nullcreated_atstring (date-time)edited_atstring (date-time) | nulltextstringread-onlycontentstringspoiler_textstringsensitivebooleanvisibilitystringpublicunlistedprivatedirect
languagestring | nullin_reply_to_idstring | nullin_reply_to_account_idstring | nullreplies_countintegerreblogs_countintegerfavourites_countintegerquotes_countinteger | nullauthorstringauthor_namestring | nullmedia_attachmentsarray of objectShow 8 item attributes
idstringread-onlytypestringimagegifvvideoaudiounknown
urlstring (uri) | nullpreview_urlstring (uri) | nullremote_urlstring (uri) | nulldescriptionstring | nullblurhashstring | nullmetaobjectpollobject | nullShow 9 child attributes
idstringread-onlyexpires_atstring (date-time) | nullexpiredbooleanmultiplebooleanvotes_countintegervoters_countinteger | nullvotedbooleanown_votesarray of integeroptionsarray of objectShow 2 item attributes
titlestringvotes_countinteger | nullfavouritedbooleanrebloggedbooleanbookmarkedbooleanmutedbooleanpinnedbooleanis_reblogbooleanquoteobject | nullShow 2 child attributes
statestringquoted_statusobject | nullquote_approvalobject | nullResponses
Mastodon: Accept (Message requests)
/accounts/{accountId}/mastodon/notification-requests/{itemId}/acceptAccept. Notifications held back by your filtering policy (mentions and DMs from strangers). Accept to move them into the inbox. Requires scopes: read:notifications, write:notifications. Network docs: https://docs.joinmastodon.org/methods/notifications/#get-requests Generic route: /v1/accounts/{accountId}/focus/notification-requests.
Try it with MCPAsk your agent to call mastodon-notification-requests-accept (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Dismiss (Message requests)
/accounts/{accountId}/mastodon/notification-requests/{itemId}/dismissDismiss. Notifications held back by your filtering policy (mentions and DMs from strangers). Accept to move them into the inbox. Destructive. Requires scopes: read:notifications, write:notifications. Network docs: https://docs.joinmastodon.org/methods/notifications/#get-requests Generic route: /v1/accounts/{accountId}/focus/notification-requests.
Try it with MCPAsk your agent to call mastodon-notification-requests-dismiss (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Accept selected (Message requests)
/accounts/{accountId}/mastodon/notification-requests/accept-manyAccept selected. Notifications held back by your filtering policy (mentions and DMs from strangers). Accept to move them into the inbox. Requires scopes: read:notifications, write:notifications. Network docs: https://docs.joinmastodon.org/methods/notifications/#get-requests Generic route: /v1/accounts/{accountId}/focus/notification-requests.
Try it with MCPAsk your agent to call mastodon-notification-requests-accept-many (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
idsarray of stringrequired≥ 1 items
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Dismiss selected (Message requests)
/accounts/{accountId}/mastodon/notification-requests/dismiss-manyDismiss selected. Notifications held back by your filtering policy (mentions and DMs from strangers). Accept to move them into the inbox. Destructive. Requires scopes: read:notifications, write:notifications. Network docs: https://docs.joinmastodon.org/methods/notifications/#get-requests Generic route: /v1/accounts/{accountId}/focus/notification-requests.
Try it with MCPAsk your agent to call mastodon-notification-requests-dismiss-many (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Body object
idsarray of stringrequired≥ 1 items
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Merge status (Message requests)
/accounts/{accountId}/mastodon/notification-requests/mergedMerge status. Notifications held back by your filtering policy (mentions and DMs from strangers). Accept to move them into the inbox. Requires scopes: read:notifications. Network docs: https://docs.joinmastodon.org/methods/notifications/#get-requests Generic route: /v1/accounts/{accountId}/focus/notification-requests.
Try it with MCPAsk your agent to call mastodon-notification-requests-merged (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Conversations
Mastodon: List Direct messages
/accounts/{accountId}/mastodon/conversationsPrivate mentions grouped into conversations. Replies @mention every participant. Cursor pagination: pass next_cursor back as cursor. Requires scopes: read:statuses. Network docs: https://docs.joinmastodon.org/methods/conversations/ Generic route: /v1/accounts/{accountId}/focus/conversations.
Try it with MCPAsk your agent to call mastodon-conversations-list (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringOpaque cursor from a previous next_cursor
limitintegerdefault: 201–80
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 8 item attributes
idstringrequiredread-onlyupdated_atstring (date-time) | nullunreadbooleanunread_countintegerlast_messagestring | nulllast_status_idstring | nullparticipantsarray of objectShow 5 item attributes
idstringnamestringusernamestringavatar_urlstring (uri) | nullurlstring (uri) | nullmessagesarray of objectShow 7 item attributes
idstringtextstringdirectionstringinout
sent_atstring (date-time)from_idstringfrom_usernamestringattachmentsarray of objectlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Mastodon: Create a Direct messages item
/accounts/{accountId}/mastodon/conversationsStart a DM (visibility=direct). Private mentions grouped into conversations. Replies @mention every participant. Requires scopes: read:statuses, write:statuses. Network docs: https://docs.joinmastodon.org/methods/conversations/ Generic route: /v1/accounts/{accountId}/focus/conversations.
Try it with MCPAsk your agent to call mastodon-conversations-create (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
toarray of stringrequired≥ 1 items
textstringmediaarray of stringspoiler_textstringsensitivebooleanReturns object
idstringrequiredread-onlyupdated_atstring (date-time) | nullunreadbooleanunread_countintegerlast_messagestring | nulllast_status_idstring | nullparticipantsarray of objectShow 5 item attributes
idstringnamestringusernamestringavatar_urlstring (uri) | nullurlstring (uri) | nullmessagesarray of objectShow 7 item attributes
idstringtextstringdirectionstringinout
sent_atstring (date-time)from_idstringfrom_usernamestringattachmentsarray of objectResponses
Mastodon: Get a Direct messages item
/accounts/{accountId}/mastodon/conversations/{itemId}Conversation + its direct messages. Private mentions grouped into conversations. Replies @mention every participant. Requires scopes: read:statuses. Network docs: https://docs.joinmastodon.org/methods/conversations/ Generic route: /v1/accounts/{accountId}/focus/conversations.
Try it with MCPAsk your agent to call mastodon-conversations-get (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringrequiredread-onlyupdated_atstring (date-time) | nullunreadbooleanunread_countintegerlast_messagestring | nulllast_status_idstring | nullparticipantsarray of objectShow 5 item attributes
idstringnamestringusernamestringavatar_urlstring (uri) | nullurlstring (uri) | nullmessagesarray of objectShow 7 item attributes
idstringtextstringdirectionstringinout
sent_atstring (date-time)from_idstringfrom_usernamestringattachmentsarray of objectResponses
Mastodon: Delete a Direct messages item
/accounts/{accountId}/mastodon/conversations/{itemId}Private mentions grouped into conversations. Replies @mention every participant. Requires scopes: read:statuses, write:conversations. Network docs: https://docs.joinmastodon.org/methods/conversations/ Generic route: /v1/accounts/{accountId}/focus/conversations.
Try it with MCPAsk your agent to call mastodon-conversations-delete (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Mastodon: Mark as read (Direct messages)
/accounts/{accountId}/mastodon/conversations/{itemId}/readMark as read. Private mentions grouped into conversations. Replies @mention every participant. Requires scopes: read:statuses, write:conversations. Network docs: https://docs.joinmastodon.org/methods/conversations/ Generic route: /v1/accounts/{accountId}/focus/conversations.
Try it with MCPAsk your agent to call mastodon-conversations-read (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Reply (Direct messages)
/accounts/{accountId}/mastodon/conversations/{itemId}/replyReply. Private mentions grouped into conversations. Replies @mention every participant. Requires scopes: read:statuses, write:statuses. Network docs: https://docs.joinmastodon.org/methods/conversations/ Generic route: /v1/accounts/{accountId}/focus/conversations.
Try it with MCPAsk your agent to call mastodon-conversations-reply (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
textstringmediaarray of stringspoiler_textstringsensitivebooleanReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Comments
Mastodon: List Comments
/accounts/{accountId}/mastodon/commentsReplies to your posts (thread context + reply mentions, including filtered ones). Cursor pagination: pass next_cursor back as cursor. Requires scopes: read:statuses, read:notifications. Network docs: https://docs.joinmastodon.org/methods/statuses/#context Generic route: /v1/accounts/{accountId}/focus/comments.
Try it with MCPAsk your agent to call mastodon-comments-list (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
post_idstringReplies to one post; omit for recent replies across your posts
recent_postsintegerdefault: 5How many recent own posts to scan when post_id is omitted
≤ 40
limitintegerdefault: 40≤ 200
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 17 item attributes
idstringrequiredread-onlytextstringauthorstringauthor_namestring | nullauthor_avatarstring (uri) | nullcreated_atstring (date-time)like_countintegerreply_countintegershare_countintegerparent_idstring | nullpost_idstring | nullvisibilitystringlikedbooleanis_ownbooleanspoiler_textstring | nullurlstring (uri) | nullattachmentsarray of objectlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Mastodon: Get a Comments item
/accounts/{accountId}/mastodon/comments/{itemId}Replies to your posts (thread context + reply mentions, including filtered ones). Requires scopes: read:statuses, read:notifications. Network docs: https://docs.joinmastodon.org/methods/statuses/#context Generic route: /v1/accounts/{accountId}/focus/comments.
Try it with MCPAsk your agent to call mastodon-comments-get (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringrequiredread-onlytextstringauthorstringauthor_namestring | nullauthor_avatarstring (uri) | nullcreated_atstring (date-time)like_countintegerreply_countintegershare_countintegerparent_idstring | nullpost_idstring | nullvisibilitystringlikedbooleanis_ownbooleanspoiler_textstring | nullurlstring (uri) | nullattachmentsarray of objectResponses
Mastodon: Delete a Comments item
/accounts/{accountId}/mastodon/comments/{itemId}Delete your own reply (others’ replies cannot be deleted). Replies to your posts (thread context + reply mentions, including filtered ones). Requires scopes: read:statuses, read:notifications, write:statuses. Network docs: https://docs.joinmastodon.org/methods/statuses/#context Generic route: /v1/accounts/{accountId}/focus/comments.
Try it with MCPAsk your agent to call mastodon-comments-delete (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Mastodon: Reply (Comments)
/accounts/{accountId}/mastodon/comments/{itemId}/replyReply. Replies to your posts (thread context + reply mentions, including filtered ones). Requires scopes: read:statuses, read:notifications, write:statuses. Network docs: https://docs.joinmastodon.org/methods/statuses/#context Generic route: /v1/accounts/{accountId}/focus/comments.
Try it with MCPAsk your agent to call mastodon-comments-reply (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
textstringrequiredvisibilitystringpublicunlistedprivatedirect
mention_allbooleanmediaarray of stringReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Favourite (Comments)
/accounts/{accountId}/mastodon/comments/{itemId}/likeFavourite. Replies to your posts (thread context + reply mentions, including filtered ones). Requires scopes: read:statuses, read:notifications, write:favourites. Network docs: https://docs.joinmastodon.org/methods/statuses/#context Generic route: /v1/accounts/{accountId}/focus/comments.
Try it with MCPAsk your agent to call mastodon-comments-like (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Unfavourite (Comments)
/accounts/{accountId}/mastodon/comments/{itemId}/unlikeUnfavourite. Replies to your posts (thread context + reply mentions, including filtered ones). Requires scopes: read:statuses, read:notifications, write:favourites. Network docs: https://docs.joinmastodon.org/methods/statuses/#context Generic route: /v1/accounts/{accountId}/focus/comments.
Try it with MCPAsk your agent to call mastodon-comments-unlike (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Mute thread (Comments)
/accounts/{accountId}/mastodon/comments/{itemId}/mute-threadMute thread. Replies to your posts (thread context + reply mentions, including filtered ones). Requires scopes: read:statuses, read:notifications, write:mutes. Network docs: https://docs.joinmastodon.org/methods/statuses/#context Generic route: /v1/accounts/{accountId}/focus/comments.
Try it with MCPAsk your agent to call mastodon-comments-mute-thread (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Followers
Mastodon: List Followers
/accounts/{accountId}/mastodon/followersCursor pagination: pass next_cursor back as cursor. Network docs: https://docs.joinmastodon.org/methods/accounts/#followers Generic route: /v1/accounts/{accountId}/focus/followers.
Try it with MCPAsk your agent to call mastodon-followers-list (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringOpaque cursor from a previous next_cursor
limitintegerdefault: 201–80
account_idstringDefaults to the connected account
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 23 item attributes
idstringrequiredread-onlyacctstringrequiredusernamestringdisplay_namestringurlstring (uri)avatarstringheaderstringnotestringnote_textstringlockedbooleanbotbooleangroupbooleandiscoverableboolean | nullindexableboolean | nullfollowers_countintegerfollowing_countintegerstatuses_countintegercreated_atstring (date-time)last_status_atstring (date) | nullfieldsarray of objectShow 3 item attributes
namestringvaluestringverified_atstring (date-time) | nullmovedobject | nullsuspendedbooleanlimitedbooleanlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Mastodon: Remove from followers (Followers)
/accounts/{accountId}/mastodon/followers/{itemId}/remove-from-followersRemove from followers. Destructive. Requires scopes: write:follows. Network docs: https://docs.joinmastodon.org/methods/accounts/#followers Generic route: /v1/accounts/{accountId}/focus/followers.
Try it with MCPAsk your agent to call mastodon-followers-remove-from-followers (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Follow (Followers)
/accounts/{accountId}/mastodon/followers/{itemId}/followFollow. Requires scopes: write:follows. Network docs: https://docs.joinmastodon.org/methods/accounts/#followers Generic route: /v1/accounts/{accountId}/focus/followers.
Try it with MCPAsk your agent to call mastodon-followers-follow (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
reblogsbooleandefault: truenotifybooleanlanguagesarray of stringReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Block (Followers)
/accounts/{accountId}/mastodon/followers/{itemId}/blockBlock. Destructive. Requires scopes: write:blocks. Network docs: https://docs.joinmastodon.org/methods/accounts/#followers Generic route: /v1/accounts/{accountId}/focus/followers.
Try it with MCPAsk your agent to call mastodon-followers-block (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Following
Mastodon: List Following
/accounts/{accountId}/mastodon/followingCursor pagination: pass next_cursor back as cursor. Network docs: https://docs.joinmastodon.org/methods/accounts/#following Generic route: /v1/accounts/{accountId}/focus/following.
Try it with MCPAsk your agent to call mastodon-following-list (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringOpaque cursor from a previous next_cursor
limitintegerdefault: 201–80
account_idstringReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 23 item attributes
idstringrequiredread-onlyacctstringrequiredusernamestringdisplay_namestringurlstring (uri)avatarstringheaderstringnotestringnote_textstringlockedbooleanbotbooleangroupbooleandiscoverableboolean | nullindexableboolean | nullfollowers_countintegerfollowing_countintegerstatuses_countintegercreated_atstring (date-time)last_status_atstring (date) | nullfieldsarray of objectShow 3 item attributes
namestringvaluestringverified_atstring (date-time) | nullmovedobject | nullsuspendedbooleanlimitedbooleanlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Mastodon: Create a Following item
/accounts/{accountId}/mastodon/followingFollow an account by id or @user@domain (400 follows / 24 h). Requires scopes: write:follows. Network docs: https://docs.joinmastodon.org/methods/accounts/#following Generic route: /v1/accounts/{accountId}/focus/following.
Try it with MCPAsk your agent to call mastodon-following-create (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
account_idstringacctstring@user@domain
reblogsbooleandefault: truenotifybooleanlanguagesarray of stringReturns object
idstringrequiredread-onlyacctstringrequiredusernamestringdisplay_namestringurlstring (uri)avatarstringheaderstringnotestringnote_textstringlockedbooleanbotbooleangroupbooleandiscoverableboolean | nullindexableboolean | nullfollowers_countintegerfollowing_countintegerstatuses_countintegercreated_atstring (date-time)last_status_atstring (date) | nullfieldsarray of objectShow 3 item attributes
namestringvaluestringverified_atstring (date-time) | nullmovedobject | nullsuspendedbooleanlimitedbooleanResponses
Mastodon: Delete a Following item
/accounts/{accountId}/mastodon/following/{itemId}Unfollow. Requires scopes: write:follows. Network docs: https://docs.joinmastodon.org/methods/accounts/#following Generic route: /v1/accounts/{accountId}/focus/following.
Try it with MCPAsk your agent to call mastodon-following-delete (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Mastodon: Notify on new posts (Following)
/accounts/{accountId}/mastodon/following/{itemId}/notifyNotify on new posts. Requires scopes: write:follows. Network docs: https://docs.joinmastodon.org/methods/accounts/#following Generic route: /v1/accounts/{accountId}/focus/following.
Try it with MCPAsk your agent to call mastodon-following-notify (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
notifybooleandefault: trueReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Mute (Following)
/accounts/{accountId}/mastodon/following/{itemId}/muteMute. Requires scopes: write:mutes. Network docs: https://docs.joinmastodon.org/methods/accounts/#following Generic route: /v1/accounts/{accountId}/focus/following.
Try it with MCPAsk your agent to call mastodon-following-mute (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
notificationsbooleandefault: truedurationintegerSeconds; 0 = indefinite
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Follow requests
Mastodon: List Follow requests
/accounts/{accountId}/mastodon/follow-requestsPending requests to follow your locked account. Cursor pagination: pass next_cursor back as cursor. Requires scopes: read:follows. Network docs: https://docs.joinmastodon.org/methods/follow_requests/ Generic route: /v1/accounts/{accountId}/focus/follow-requests.
Try it with MCPAsk your agent to call mastodon-follow-requests-list (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringOpaque cursor from a previous next_cursor
limitintegerdefault: 201–80
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 23 item attributes
idstringrequiredread-onlyacctstringrequiredusernamestringdisplay_namestringurlstring (uri)avatarstringheaderstringnotestringnote_textstringlockedbooleanbotbooleangroupbooleandiscoverableboolean | nullindexableboolean | nullfollowers_countintegerfollowing_countintegerstatuses_countintegercreated_atstring (date-time)last_status_atstring (date) | nullfieldsarray of objectShow 3 item attributes
namestringvaluestringverified_atstring (date-time) | nullmovedobject | nullsuspendedbooleanlimitedbooleanlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Mastodon: Accept (Follow requests)
/accounts/{accountId}/mastodon/follow-requests/{itemId}/authorizeAccept. Pending requests to follow your locked account. Requires scopes: read:follows, write:follows. Network docs: https://docs.joinmastodon.org/methods/follow_requests/ Generic route: /v1/accounts/{accountId}/focus/follow-requests.
Try it with MCPAsk your agent to call mastodon-follow-requests-authorize (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Reject (Follow requests)
/accounts/{accountId}/mastodon/follow-requests/{itemId}/rejectReject. Pending requests to follow your locked account. Destructive. Requires scopes: read:follows, write:follows. Network docs: https://docs.joinmastodon.org/methods/follow_requests/ Generic route: /v1/accounts/{accountId}/focus/follow-requests.
Try it with MCPAsk your agent to call mastodon-follow-requests-reject (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Relationships
Mastodon: List Relationships
/accounts/{accountId}/mastodon/relationshipsFollow / block / mute state with given accounts. Cursor pagination: pass next_cursor back as cursor. Requires scopes: read:follows. Network docs: https://docs.joinmastodon.org/methods/accounts/#relationships Generic route: /v1/accounts/{accountId}/focus/relationships.
Try it with MCPAsk your agent to call mastodon-relationships-list (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
idsarray of stringrequired≥ 1 items
with_suspendedbooleanReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 16 item attributes
idstringrequiredread-onlyfollowingbooleanshowing_reblogsbooleannotifyingbooleanlanguagesarray of string | nullfollowed_bybooleanblockingbooleanblocked_bybooleanmutingbooleanmuting_notificationsbooleanmuting_expires_atstring (date-time) | nullrequestedbooleanrequested_bybooleandomain_blockingbooleanendorsedbooleannotestringlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Mastodon: Follow (Relationships)
/accounts/{accountId}/mastodon/relationships/{itemId}/followFollow. Follow / block / mute state with given accounts. Requires scopes: read:follows, write:follows. Network docs: https://docs.joinmastodon.org/methods/accounts/#relationships Generic route: /v1/accounts/{accountId}/focus/relationships.
Try it with MCPAsk your agent to call mastodon-relationships-follow (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
reblogsbooleandefault: truenotifybooleanlanguagesarray of stringReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Unfollow (Relationships)
/accounts/{accountId}/mastodon/relationships/{itemId}/unfollowUnfollow. Follow / block / mute state with given accounts. Requires scopes: read:follows, write:follows. Network docs: https://docs.joinmastodon.org/methods/accounts/#relationships Generic route: /v1/accounts/{accountId}/focus/relationships.
Try it with MCPAsk your agent to call mastodon-relationships-unfollow (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Remove from followers (Relationships)
/accounts/{accountId}/mastodon/relationships/{itemId}/remove-from-followersRemove from followers. Follow / block / mute state with given accounts. Destructive. Requires scopes: read:follows, write:follows. Network docs: https://docs.joinmastodon.org/methods/accounts/#relationships Generic route: /v1/accounts/{accountId}/focus/relationships.
Try it with MCPAsk your agent to call mastodon-relationships-remove-from-followers (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Block (Relationships)
/accounts/{accountId}/mastodon/relationships/{itemId}/blockBlock. Follow / block / mute state with given accounts. Destructive. Requires scopes: read:follows, write:blocks. Network docs: https://docs.joinmastodon.org/methods/accounts/#relationships Generic route: /v1/accounts/{accountId}/focus/relationships.
Try it with MCPAsk your agent to call mastodon-relationships-block (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Unblock (Relationships)
/accounts/{accountId}/mastodon/relationships/{itemId}/unblockUnblock. Follow / block / mute state with given accounts. Requires scopes: read:follows, write:blocks. Network docs: https://docs.joinmastodon.org/methods/accounts/#relationships Generic route: /v1/accounts/{accountId}/focus/relationships.
Try it with MCPAsk your agent to call mastodon-relationships-unblock (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Mute (Relationships)
/accounts/{accountId}/mastodon/relationships/{itemId}/muteMute. Follow / block / mute state with given accounts. Requires scopes: read:follows, write:mutes. Network docs: https://docs.joinmastodon.org/methods/accounts/#relationships Generic route: /v1/accounts/{accountId}/focus/relationships.
Try it with MCPAsk your agent to call mastodon-relationships-mute (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
notificationsbooleandefault: truedurationintegerSeconds; 0 = indefinite
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Unmute (Relationships)
/accounts/{accountId}/mastodon/relationships/{itemId}/unmuteUnmute. Follow / block / mute state with given accounts. Requires scopes: read:follows, write:mutes. Network docs: https://docs.joinmastodon.org/methods/accounts/#relationships Generic route: /v1/accounts/{accountId}/focus/relationships.
Try it with MCPAsk your agent to call mastodon-relationships-unmute (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Private note (Relationships)
/accounts/{accountId}/mastodon/relationships/{itemId}/notePrivate note. Follow / block / mute state with given accounts. Requires scopes: read:follows, write:accounts. Network docs: https://docs.joinmastodon.org/methods/accounts/#relationships Generic route: /v1/accounts/{accountId}/focus/relationships.
Try it with MCPAsk your agent to call mastodon-relationships-note (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
commentstringReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Familiar followers
Mastodon: List Familiar followers
/accounts/{accountId}/mastodon/familiar-followersAccounts you follow that also follow the given accounts. Cursor pagination: pass next_cursor back as cursor. Requires scopes: read:follows. Network docs: https://docs.joinmastodon.org/methods/accounts/#familiar_followers Generic route: /v1/accounts/{accountId}/focus/familiar-followers.
Try it with MCPAsk your agent to call mastodon-familiar-followers-list (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
idsarray of stringrequired≥ 1 items
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 3 item attributes
idstringrequiredcountintegeraccountsarray of objectShow 23 item attributes
idstringrequiredread-onlyacctstringrequiredusernamestringdisplay_namestringurlstring (uri)avatarstringheaderstringnotestringnote_textstringlockedbooleanbotbooleangroupbooleandiscoverableboolean | nullindexableboolean | nullfollowers_countintegerfollowing_countintegerstatuses_countintegercreated_atstring (date-time)last_status_atstring (date) | nullfieldsarray of objectShow 3 item attributes
namestringvaluestringverified_atstring (date-time) | nullmovedobject | nullsuspendedbooleanlimitedbooleanlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Accounts
Mastodon: List People
/accounts/{accountId}/mastodon/accountsAccount search (GET /api/v1/accounts/search). Search and look up accounts (local or remote), see their posts, follow, block, mute, endorse, add notes. Cursor pagination: pass next_cursor back as cursor. Requires scopes: read:accounts. Network docs: https://docs.joinmastodon.org/methods/accounts/ Generic route: /v1/accounts/{accountId}/focus/accounts.
Try it with MCPAsk your agent to call mastodon-accounts-list (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
qstringrequiredresolvebooleanWebFinger-resolve remote handles
followingbooleanlimitinteger≤ 80
cursorstringReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 23 item attributes
idstringrequiredread-onlyacctstringrequiredusernamestringdisplay_namestringurlstring (uri)avatarstringheaderstringnotestringnote_textstringlockedbooleanbotbooleangroupbooleandiscoverableboolean | nullindexableboolean | nullfollowers_countintegerfollowing_countintegerstatuses_countintegercreated_atstring (date-time)last_status_atstring (date) | nullfieldsarray of objectShow 3 item attributes
namestringvaluestringverified_atstring (date-time) | nullmovedobject | nullsuspendedbooleanlimitedbooleanlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Mastodon: Get a People item
/accounts/{accountId}/mastodon/accounts/{itemId}Search and look up accounts (local or remote), see their posts, follow, block, mute, endorse, add notes. Requires scopes: read:accounts. Network docs: https://docs.joinmastodon.org/methods/accounts/ Generic route: /v1/accounts/{accountId}/focus/accounts.
Try it with MCPAsk your agent to call mastodon-accounts-get (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringrequiredread-onlyacctstringrequiredusernamestringdisplay_namestringurlstring (uri)avatarstringheaderstringnotestringnote_textstringlockedbooleanbotbooleangroupbooleandiscoverableboolean | nullindexableboolean | nullfollowers_countintegerfollowing_countintegerstatuses_countintegercreated_atstring (date-time)last_status_atstring (date) | nullfieldsarray of objectShow 3 item attributes
namestringvaluestringverified_atstring (date-time) | nullmovedobject | nullsuspendedbooleanlimitedbooleanResponses
Mastodon: Look up handle (People)
/accounts/{accountId}/mastodon/accounts/lookupLook up handle. Search and look up accounts (local or remote), see their posts, follow, block, mute, endorse, add notes. Requires scopes: read:accounts. Network docs: https://docs.joinmastodon.org/methods/accounts/ Generic route: /v1/accounts/{accountId}/focus/accounts.
Try it with MCPAsk your agent to call mastodon-accounts-lookup (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
acctstringrequireduser or user@domain
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Lists
Mastodon: Lists containing (People)
/accounts/{accountId}/mastodon/accounts/{itemId}/listsLists containing. Search and look up accounts (local or remote), see their posts, follow, block, mute, endorse, add notes. Requires scopes: read:accounts, read:lists. Network docs: https://docs.joinmastodon.org/methods/accounts/ Generic route: /v1/accounts/{accountId}/focus/accounts.
Try it with MCPAsk your agent to call mastodon-accounts-lists (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: List Lists
/accounts/{accountId}/mastodon/listsCursor pagination: pass next_cursor back as cursor. Requires scopes: read:lists. Network docs: https://docs.joinmastodon.org/methods/lists/ Generic route: /v1/accounts/{accountId}/focus/lists.
Try it with MCPAsk your agent to call mastodon-lists-list (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 4 item attributes
idstringrequiredread-onlytitlestringrequiredreplies_policystringfollowedlistnone
exclusivebooleanHide members from the home timeline (4.2+)
limitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Mastodon: Create a Lists item
/accounts/{accountId}/mastodon/listsRequires scopes: read:lists, write:lists. Network docs: https://docs.joinmastodon.org/methods/lists/ Generic route: /v1/accounts/{accountId}/focus/lists.
Try it with MCPAsk your agent to call mastodon-lists-create (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
titlestringrequiredreplies_policystringfollowedlistnone
exclusivebooleanReturns object
idstringrequiredread-onlytitlestringrequiredreplies_policystringfollowedlistnone
exclusivebooleanHide members from the home timeline (4.2+)
Responses
Mastodon: Get a Lists item
/accounts/{accountId}/mastodon/lists/{itemId}Requires scopes: read:lists. Network docs: https://docs.joinmastodon.org/methods/lists/ Generic route: /v1/accounts/{accountId}/focus/lists.
Try it with MCPAsk your agent to call mastodon-lists-get (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringrequiredread-onlytitlestringrequiredreplies_policystringfollowedlistnone
exclusivebooleanHide members from the home timeline (4.2+)
Responses
Mastodon: Update a Lists item
/accounts/{accountId}/mastodon/lists/{itemId}Requires scopes: read:lists, write:lists. Network docs: https://docs.joinmastodon.org/methods/lists/ Generic route: /v1/accounts/{accountId}/focus/lists.
Try it with MCPAsk your agent to call mastodon-lists-update (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
titlestringreplies_policystringfollowedlistnone
exclusivebooleanReturns object
idstringrequiredread-onlytitlestringrequiredreplies_policystringfollowedlistnone
exclusivebooleanHide members from the home timeline (4.2+)
Responses
Mastodon: Delete a Lists item
/accounts/{accountId}/mastodon/lists/{itemId}Requires scopes: read:lists, write:lists. Network docs: https://docs.joinmastodon.org/methods/lists/ Generic route: /v1/accounts/{accountId}/focus/lists.
Try it with MCPAsk your agent to call mastodon-lists-delete (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Mastodon: List timeline (Lists)
/accounts/{accountId}/mastodon/lists/{itemId}/timelineList timeline. Requires scopes: read:lists. Network docs: https://docs.joinmastodon.org/methods/lists/ Generic route: /v1/accounts/{accountId}/focus/lists.
Try it with MCPAsk your agent to call mastodon-lists-timeline (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
cursorstringOpaque cursor from a previous next_cursor
limitintegerdefault: 201–80
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Members (Lists)
/accounts/{accountId}/mastodon/lists/{itemId}/membersMembers. Requires scopes: read:lists. Network docs: https://docs.joinmastodon.org/methods/lists/ Generic route: /v1/accounts/{accountId}/focus/lists.
Try it with MCPAsk your agent to call mastodon-lists-members (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
cursorstringOpaque cursor from a previous next_cursor
limitintegerdefault: 201–80
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Add accounts (Lists)
/accounts/{accountId}/mastodon/lists/{itemId}/add-accountsAdd accounts. Requires scopes: read:lists, write:lists. Network docs: https://docs.joinmastodon.org/methods/lists/ Generic route: /v1/accounts/{accountId}/focus/lists.
Try it with MCPAsk your agent to call mastodon-lists-add-accounts (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
account_idsarray of stringrequired≥ 1 items
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Remove accounts (Lists)
/accounts/{accountId}/mastodon/lists/{itemId}/remove-accountsRemove accounts. Requires scopes: read:lists, write:lists. Network docs: https://docs.joinmastodon.org/methods/lists/ Generic route: /v1/accounts/{accountId}/focus/lists.
Try it with MCPAsk your agent to call mastodon-lists-remove-accounts (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
account_idsarray of stringrequired≥ 1 items
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Featured tags
Mastodon: Featured hashtags (People)
/accounts/{accountId}/mastodon/accounts/{itemId}/featured-tagsFeatured hashtags. Search and look up accounts (local or remote), see their posts, follow, block, mute, endorse, add notes. Requires scopes: read:accounts. Network docs: https://docs.joinmastodon.org/methods/accounts/ Generic route: /v1/accounts/{accountId}/focus/accounts.
Try it with MCPAsk your agent to call mastodon-accounts-featured-tags (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: List Featured hashtags
/accounts/{accountId}/mastodon/featured-tagsHashtags featured on your profile (max configuration.accounts.max_featured_tags, default 10). Cursor pagination: pass next_cursor back as cursor. Requires scopes: read:accounts. Network docs: https://docs.joinmastodon.org/methods/featured_tags/ Generic route: /v1/accounts/{accountId}/focus/featured-tags.
Try it with MCPAsk your agent to call mastodon-featured-tags-list (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 5 item attributes
idstringrequiredread-onlynamestringurlstring (uri)statuses_countintegerlast_status_atstring (date) | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Mastodon: Create a Featured hashtags item
/accounts/{accountId}/mastodon/featured-tagsHashtags featured on your profile (max configuration.accounts.max_featured_tags, default 10). Requires scopes: read:accounts, write:accounts. Network docs: https://docs.joinmastodon.org/methods/featured_tags/ Generic route: /v1/accounts/{accountId}/focus/featured-tags.
Try it with MCPAsk your agent to call mastodon-featured-tags-create (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
namestringrequiredWithout #
Returns object
idstringrequiredread-onlynamestringurlstring (uri)statuses_countintegerlast_status_atstring (date) | nullResponses
Mastodon: Delete a Featured hashtags item
/accounts/{accountId}/mastodon/featured-tags/{itemId}Hashtags featured on your profile (max configuration.accounts.max_featured_tags, default 10). Requires scopes: read:accounts, write:accounts. Network docs: https://docs.joinmastodon.org/methods/featured_tags/ Generic route: /v1/accounts/{accountId}/focus/featured-tags.
Try it with MCPAsk your agent to call mastodon-featured-tags-delete (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Mastodon: Suggestions (Featured hashtags)
/accounts/{accountId}/mastodon/featured-tags/suggestionsSuggestions. Hashtags featured on your profile (max configuration.accounts.max_featured_tags, default 10). Requires scopes: read:accounts. Network docs: https://docs.joinmastodon.org/methods/featured_tags/ Generic route: /v1/accounts/{accountId}/focus/featured-tags.
Try it with MCPAsk your agent to call mastodon-featured-tags-suggestions (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Endorsements
Mastodon: Featured accounts (People)
/accounts/{accountId}/mastodon/accounts/{itemId}/endorsementsFeatured accounts. Search and look up accounts (local or remote), see their posts, follow, block, mute, endorse, add notes. Requires scopes: read:accounts. Network docs: https://docs.joinmastodon.org/methods/accounts/ Generic route: /v1/accounts/{accountId}/focus/accounts.
Try it with MCPAsk your agent to call mastodon-accounts-endorsements (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
cursorstringOpaque cursor from a previous next_cursor
limitintegerdefault: 201–80
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: List Featured accounts
/accounts/{accountId}/mastodon/endorsementsAccounts you feature (endorse) on your profile. Cursor pagination: pass next_cursor back as cursor. Requires scopes: read:accounts. Network docs: https://docs.joinmastodon.org/methods/endorsements/ Generic route: /v1/accounts/{accountId}/focus/endorsements.
Try it with MCPAsk your agent to call mastodon-endorsements-list (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringOpaque cursor from a previous next_cursor
limitintegerdefault: 201–80
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 23 item attributes
idstringrequiredread-onlyacctstringrequiredusernamestringdisplay_namestringurlstring (uri)avatarstringheaderstringnotestringnote_textstringlockedbooleanbotbooleangroupbooleandiscoverableboolean | nullindexableboolean | nullfollowers_countintegerfollowing_countintegerstatuses_countintegercreated_atstring (date-time)last_status_atstring (date) | nullfieldsarray of objectShow 3 item attributes
namestringvaluestringverified_atstring (date-time) | nullmovedobject | nullsuspendedbooleanlimitedbooleanlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Mastodon: Create a Featured accounts item
/accounts/{accountId}/mastodon/endorsementsAccounts you feature (endorse) on your profile. Requires scopes: read:accounts, write:accounts. Network docs: https://docs.joinmastodon.org/methods/endorsements/ Generic route: /v1/accounts/{accountId}/focus/endorsements.
Try it with MCPAsk your agent to call mastodon-endorsements-create (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
account_idstringrequiredReturns object
idstringrequiredread-onlyacctstringrequiredusernamestringdisplay_namestringurlstring (uri)avatarstringheaderstringnotestringnote_textstringlockedbooleanbotbooleangroupbooleandiscoverableboolean | nullindexableboolean | nullfollowers_countintegerfollowing_countintegerstatuses_countintegercreated_atstring (date-time)last_status_atstring (date) | nullfieldsarray of objectShow 3 item attributes
namestringvaluestringverified_atstring (date-time) | nullmovedobject | nullsuspendedbooleanlimitedbooleanResponses
Mastodon: Delete a Featured accounts item
/accounts/{accountId}/mastodon/endorsements/{itemId}Accounts you feature (endorse) on your profile. Requires scopes: read:accounts, write:accounts. Network docs: https://docs.joinmastodon.org/methods/endorsements/ Generic route: /v1/accounts/{accountId}/focus/endorsements.
Try it with MCPAsk your agent to call mastodon-endorsements-delete (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Follow
Mastodon: Follow (People)
/accounts/{accountId}/mastodon/accounts/{itemId}/followFollow. Search and look up accounts (local or remote), see their posts, follow, block, mute, endorse, add notes. Requires scopes: read:accounts, write:follows. Network docs: https://docs.joinmastodon.org/methods/accounts/ Generic route: /v1/accounts/{accountId}/focus/accounts.
Try it with MCPAsk your agent to call mastodon-accounts-follow (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
reblogsbooleandefault: truenotifybooleanlanguagesarray of stringReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Unfollow
Mastodon: Unfollow (People)
/accounts/{accountId}/mastodon/accounts/{itemId}/unfollowUnfollow. Search and look up accounts (local or remote), see their posts, follow, block, mute, endorse, add notes. Requires scopes: read:accounts, write:follows. Network docs: https://docs.joinmastodon.org/methods/accounts/ Generic route: /v1/accounts/{accountId}/focus/accounts.
Try it with MCPAsk your agent to call mastodon-accounts-unfollow (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Remove from followers
Mastodon: Remove from followers (People)
/accounts/{accountId}/mastodon/accounts/{itemId}/remove-from-followersRemove from followers. Search and look up accounts (local or remote), see their posts, follow, block, mute, endorse, add notes. Destructive. Requires scopes: read:accounts, write:follows. Network docs: https://docs.joinmastodon.org/methods/accounts/ Generic route: /v1/accounts/{accountId}/focus/accounts.
Try it with MCPAsk your agent to call mastodon-accounts-remove-from-followers (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Block
Mastodon: Block (People)
/accounts/{accountId}/mastodon/accounts/{itemId}/blockBlock. Search and look up accounts (local or remote), see their posts, follow, block, mute, endorse, add notes. Destructive. Requires scopes: read:accounts, write:blocks. Network docs: https://docs.joinmastodon.org/methods/accounts/ Generic route: /v1/accounts/{accountId}/focus/accounts.
Try it with MCPAsk your agent to call mastodon-accounts-block (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Unblock
Mastodon: Unblock (People)
/accounts/{accountId}/mastodon/accounts/{itemId}/unblockUnblock. Search and look up accounts (local or remote), see their posts, follow, block, mute, endorse, add notes. Requires scopes: read:accounts, write:blocks. Network docs: https://docs.joinmastodon.org/methods/accounts/ Generic route: /v1/accounts/{accountId}/focus/accounts.
Try it with MCPAsk your agent to call mastodon-accounts-unblock (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mute
Mastodon: Mute (People)
/accounts/{accountId}/mastodon/accounts/{itemId}/muteMute. Search and look up accounts (local or remote), see their posts, follow, block, mute, endorse, add notes. Requires scopes: read:accounts, write:mutes. Network docs: https://docs.joinmastodon.org/methods/accounts/ Generic route: /v1/accounts/{accountId}/focus/accounts.
Try it with MCPAsk your agent to call mastodon-accounts-mute (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
notificationsbooleandefault: truedurationintegerSeconds; 0 = indefinite
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Unmute
Mastodon: Unmute (People)
/accounts/{accountId}/mastodon/accounts/{itemId}/unmuteUnmute. Search and look up accounts (local or remote), see their posts, follow, block, mute, endorse, add notes. Requires scopes: read:accounts, write:mutes. Network docs: https://docs.joinmastodon.org/methods/accounts/ Generic route: /v1/accounts/{accountId}/focus/accounts.
Try it with MCPAsk your agent to call mastodon-accounts-unmute (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Endorse
Mastodon: Feature on profile (People)
/accounts/{accountId}/mastodon/accounts/{itemId}/endorseFeature on profile. Search and look up accounts (local or remote), see their posts, follow, block, mute, endorse, add notes. Requires scopes: read:accounts, write:accounts. Network docs: https://docs.joinmastodon.org/methods/accounts/ Generic route: /v1/accounts/{accountId}/focus/accounts.
Try it with MCPAsk your agent to call mastodon-accounts-endorse (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Unendorse
Mastodon: Unfeature (People)
/accounts/{accountId}/mastodon/accounts/{itemId}/unendorseUnfeature. Search and look up accounts (local or remote), see their posts, follow, block, mute, endorse, add notes. Requires scopes: read:accounts, write:accounts. Network docs: https://docs.joinmastodon.org/methods/accounts/ Generic route: /v1/accounts/{accountId}/focus/accounts.
Try it with MCPAsk your agent to call mastodon-accounts-unendorse (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Note
Mastodon: Private note (People)
/accounts/{accountId}/mastodon/accounts/{itemId}/notePrivate note. Search and look up accounts (local or remote), see their posts, follow, block, mute, endorse, add notes. Requires scopes: read:accounts, write:accounts. Network docs: https://docs.joinmastodon.org/methods/accounts/ Generic route: /v1/accounts/{accountId}/focus/accounts.
Try it with MCPAsk your agent to call mastodon-accounts-note (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
commentstringReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
List members
Mastodon: List List members
/accounts/{accountId}/mastodon/list-membersAccounts in a list (you must follow an account before adding it). Cursor pagination: pass next_cursor back as cursor. Requires scopes: read:lists. Network docs: https://docs.joinmastodon.org/methods/lists/#accounts Generic route: /v1/accounts/{accountId}/focus/list-members.
Try it with MCPAsk your agent to call mastodon-list-members-list (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringOpaque cursor from a previous next_cursor
limitintegerdefault: 201–80
list_idstringrequiredReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 25 item attributes
idstringrequired<list_id>:<account_id>
acctstringusernamestringdisplay_namestringurlstring (uri)avatarstringheaderstringnotestringnote_textstringlockedbooleanbotbooleangroupbooleandiscoverableboolean | nullindexableboolean | nullfollowers_countintegerfollowing_countintegerstatuses_countintegercreated_atstring (date-time)last_status_atstring (date) | nullfieldsarray of objectShow 3 item attributes
namestringvaluestringverified_atstring (date-time) | nullmovedobject | nullsuspendedbooleanlimitedbooleanaccount_idstringlist_idstringlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Mastodon: Create a List members item
/accounts/{accountId}/mastodon/list-membersAccounts in a list (you must follow an account before adding it). Requires scopes: read:lists, write:lists. Network docs: https://docs.joinmastodon.org/methods/lists/#accounts Generic route: /v1/accounts/{accountId}/focus/list-members.
Try it with MCPAsk your agent to call mastodon-list-members-create (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
list_idstringrequiredaccount_idsarray of stringrequired≥ 1 items
Returns object
idstringrequired<list_id>:<account_id>
acctstringusernamestringdisplay_namestringurlstring (uri)avatarstringheaderstringnotestringnote_textstringlockedbooleanbotbooleangroupbooleandiscoverableboolean | nullindexableboolean | nullfollowers_countintegerfollowing_countintegerstatuses_countintegercreated_atstring (date-time)last_status_atstring (date) | nullfieldsarray of objectShow 3 item attributes
namestringvaluestringverified_atstring (date-time) | nullmovedobject | nullsuspendedbooleanlimitedbooleanaccount_idstringlist_idstringResponses
Mastodon: Delete a List members item
/accounts/{accountId}/mastodon/list-members/{itemId}Accounts in a list (you must follow an account before adding it). Requires scopes: read:lists, write:lists. Network docs: https://docs.joinmastodon.org/methods/lists/#accounts Generic route: /v1/accounts/{accountId}/focus/list-members.
Try it with MCPAsk your agent to call mastodon-list-members-delete (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Collections
Mastodon: List Collections
/accounts/{accountId}/mastodon/collectionsCurated sets of up to 25 accounts (Mastodon 4.6+, FEP-7aa9). Body fields beyond name/description are passed through (unverified). Cursor pagination: pass next_cursor back as cursor. Requires scopes: read:collections. Network docs: https://docs.joinmastodon.org/methods/collections/ Generic route: /v1/accounts/{accountId}/focus/collections.
Try it with MCPAsk your agent to call mastodon-collections-list (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringOpaque cursor from a previous next_cursor
limitintegerdefault: 201–80
account_idstringReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 11 item attributes
idstringrequiredread-onlynamestringdescriptionstring | nullsensitiveboolean | nulldiscoverableboolean | nulllanguagestring | nulltagobject | nullitems_countinteger | nullitemsarray of objectShow 3 item attributes
idstringstatestringaccountobject | nullShow 23 child attributes
idstringrequiredread-onlyacctstringrequiredusernamestringdisplay_namestringurlstring (uri)avatarstringheaderstringnotestringnote_textstringlockedbooleanbotbooleangroupbooleandiscoverableboolean | nullindexableboolean | nullfollowers_countintegerfollowing_countintegerstatuses_countintegercreated_atstring (date-time)last_status_atstring (date) | nullfieldsarray of objectShow 3 item attributes
namestringvaluestringverified_atstring (date-time) | nullmovedobject | nullsuspendedbooleanlimitedbooleancreated_atstring (date-time) | nullupdated_atstring (date-time) | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Mastodon: Create a Collections item
/accounts/{accountId}/mastodon/collectionsCurated sets of up to 25 accounts (Mastodon 4.6+, FEP-7aa9). Body fields beyond name/description are passed through (unverified). Requires scopes: read:collections, write:collections. Network docs: https://docs.joinmastodon.org/methods/collections/ Generic route: /v1/accounts/{accountId}/focus/collections.
Try it with MCPAsk your agent to call mastodon-collections-create (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
namestringrequireddescriptionstringsensitivebooleandiscoverablebooleanlanguagestringtag_namestringaccount_idsarray of string≤ 25 items
Returns object
idstringrequiredread-onlynamestringdescriptionstring | nullsensitiveboolean | nulldiscoverableboolean | nulllanguagestring | nulltagobject | nullitems_countinteger | nullitemsarray of objectShow 3 item attributes
idstringstatestringaccountobject | nullShow 23 child attributes
idstringrequiredread-onlyacctstringrequiredusernamestringdisplay_namestringurlstring (uri)avatarstringheaderstringnotestringnote_textstringlockedbooleanbotbooleangroupbooleandiscoverableboolean | nullindexableboolean | nullfollowers_countintegerfollowing_countintegerstatuses_countintegercreated_atstring (date-time)last_status_atstring (date) | nullfieldsarray of objectShow 3 item attributes
namestringvaluestringverified_atstring (date-time) | nullmovedobject | nullsuspendedbooleanlimitedbooleancreated_atstring (date-time) | nullupdated_atstring (date-time) | nullResponses
Mastodon: Get a Collections item
/accounts/{accountId}/mastodon/collections/{itemId}Curated sets of up to 25 accounts (Mastodon 4.6+, FEP-7aa9). Body fields beyond name/description are passed through (unverified). Requires scopes: read:collections. Network docs: https://docs.joinmastodon.org/methods/collections/ Generic route: /v1/accounts/{accountId}/focus/collections.
Try it with MCPAsk your agent to call mastodon-collections-get (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringrequiredread-onlynamestringdescriptionstring | nullsensitiveboolean | nulldiscoverableboolean | nulllanguagestring | nulltagobject | nullitems_countinteger | nullitemsarray of objectShow 3 item attributes
idstringstatestringaccountobject | nullShow 23 child attributes
idstringrequiredread-onlyacctstringrequiredusernamestringdisplay_namestringurlstring (uri)avatarstringheaderstringnotestringnote_textstringlockedbooleanbotbooleangroupbooleandiscoverableboolean | nullindexableboolean | nullfollowers_countintegerfollowing_countintegerstatuses_countintegercreated_atstring (date-time)last_status_atstring (date) | nullfieldsarray of objectShow 3 item attributes
namestringvaluestringverified_atstring (date-time) | nullmovedobject | nullsuspendedbooleanlimitedbooleancreated_atstring (date-time) | nullupdated_atstring (date-time) | nullResponses
Mastodon: Update a Collections item
/accounts/{accountId}/mastodon/collections/{itemId}Curated sets of up to 25 accounts (Mastodon 4.6+, FEP-7aa9). Body fields beyond name/description are passed through (unverified). Requires scopes: read:collections, write:collections. Network docs: https://docs.joinmastodon.org/methods/collections/ Generic route: /v1/accounts/{accountId}/focus/collections.
Try it with MCPAsk your agent to call mastodon-collections-update (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
namestringdescriptionstringsensitivebooleandiscoverablebooleanlanguagestringtag_namestringaccount_idsarray of string≤ 25 items
Returns object
idstringrequiredread-onlynamestringdescriptionstring | nullsensitiveboolean | nulldiscoverableboolean | nulllanguagestring | nulltagobject | nullitems_countinteger | nullitemsarray of objectShow 3 item attributes
idstringstatestringaccountobject | nullShow 23 child attributes
idstringrequiredread-onlyacctstringrequiredusernamestringdisplay_namestringurlstring (uri)avatarstringheaderstringnotestringnote_textstringlockedbooleanbotbooleangroupbooleandiscoverableboolean | nullindexableboolean | nullfollowers_countintegerfollowing_countintegerstatuses_countintegercreated_atstring (date-time)last_status_atstring (date) | nullfieldsarray of objectShow 3 item attributes
namestringvaluestringverified_atstring (date-time) | nullmovedobject | nullsuspendedbooleanlimitedbooleancreated_atstring (date-time) | nullupdated_atstring (date-time) | nullResponses
Mastodon: Delete a Collections item
/accounts/{accountId}/mastodon/collections/{itemId}Curated sets of up to 25 accounts (Mastodon 4.6+, FEP-7aa9). Body fields beyond name/description are passed through (unverified). Requires scopes: read:collections, write:collections. Network docs: https://docs.joinmastodon.org/methods/collections/ Generic route: /v1/accounts/{accountId}/focus/collections.
Try it with MCPAsk your agent to call mastodon-collections-delete (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Mastodon: Add account (Collections)
/accounts/{accountId}/mastodon/collections/{itemId}/add-itemAdd account. Curated sets of up to 25 accounts (Mastodon 4.6+, FEP-7aa9). Body fields beyond name/description are passed through (unverified). Requires scopes: read:collections, write:collections. Network docs: https://docs.joinmastodon.org/methods/collections/ Generic route: /v1/accounts/{accountId}/focus/collections.
Try it with MCPAsk your agent to call mastodon-collections-add-item (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
account_idstringrequiredReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Remove account (Collections)
/accounts/{accountId}/mastodon/collections/{itemId}/remove-itemRemove account. Curated sets of up to 25 accounts (Mastodon 4.6+, FEP-7aa9). Body fields beyond name/description are passed through (unverified). Requires scopes: read:collections, write:collections. Network docs: https://docs.joinmastodon.org/methods/collections/ Generic route: /v1/accounts/{accountId}/focus/collections.
Try it with MCPAsk your agent to call mastodon-collections-remove-item (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
item_idstringrequiredReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Remove me from this collection (Collections)
/accounts/{accountId}/mastodon/collections/{itemId}/revokeRemove me from this collection. Curated sets of up to 25 accounts (Mastodon 4.6+, FEP-7aa9). Body fields beyond name/description are passed through (unverified). Destructive. Requires scopes: read:collections, write:collections. Network docs: https://docs.joinmastodon.org/methods/collections/ Generic route: /v1/accounts/{accountId}/focus/collections.
Try it with MCPAsk your agent to call mastodon-collections-revoke (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
item_idstringrequiredReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Collections featuring an account (Collections)
/accounts/{accountId}/mastodon/collections/in-collectionsCollections featuring an account. Curated sets of up to 25 accounts (Mastodon 4.6+, FEP-7aa9). Body fields beyond name/description are passed through (unverified). Requires scopes: read:collections. Network docs: https://docs.joinmastodon.org/methods/collections/ Generic route: /v1/accounts/{accountId}/focus/collections.
Try it with MCPAsk your agent to call mastodon-collections-in-collections (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
cursorstringOpaque cursor from a previous next_cursor
limitintegerdefault: 201–80
account_idstringReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Suggestions
Mastodon: List Who to follow
/accounts/{accountId}/mastodon/suggestionsCursor pagination: pass next_cursor back as cursor. Requires scopes: read:accounts. Network docs: https://docs.joinmastodon.org/methods/suggestions/ Generic route: /v1/accounts/{accountId}/focus/suggestions.
Try it with MCPAsk your agent to call mastodon-suggestions-list (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 40≤ 80
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 24 item attributes
idstringrequiredread-onlyacctstringusernamestringdisplay_namestringurlstring (uri)avatarstringheaderstringnotestringnote_textstringlockedbooleanbotbooleangroupbooleandiscoverableboolean | nullindexableboolean | nullfollowers_countintegerfollowing_countintegerstatuses_countintegercreated_atstring (date-time)last_status_atstring (date) | nullfieldsarray of objectShow 3 item attributes
namestringvaluestringverified_atstring (date-time) | nullmovedobject | nullsuspendedbooleanlimitedbooleansourcesarray of stringlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Mastodon: Delete a Who to follow item
/accounts/{accountId}/mastodon/suggestions/{itemId}Never suggest this account again. Requires scopes: read:accounts, write:accounts. Network docs: https://docs.joinmastodon.org/methods/suggestions/ Generic route: /v1/accounts/{accountId}/focus/suggestions.
Try it with MCPAsk your agent to call mastodon-suggestions-delete (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Mastodon: Follow (Who to follow)
/accounts/{accountId}/mastodon/suggestions/{itemId}/followFollow. Requires scopes: read:accounts, write:follows. Network docs: https://docs.joinmastodon.org/methods/suggestions/ Generic route: /v1/accounts/{accountId}/focus/suggestions.
Try it with MCPAsk your agent to call mastodon-suggestions-follow (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
reblogsbooleandefault: truenotifybooleanlanguagesarray of stringReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Directory
Mastodon: List Profile directory
/accounts/{accountId}/mastodon/directoryDiscoverable accounts known to the instance. Cursor pagination: pass next_cursor back as cursor. Network docs: https://docs.joinmastodon.org/methods/directory/ Generic route: /v1/accounts/{accountId}/focus/directory.
Try it with MCPAsk your agent to call mastodon-directory-list (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
orderstringactivenew
localbooleanlimitintegerdefault: 40≤ 80
cursorstringReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 23 item attributes
idstringrequiredread-onlyacctstringrequiredusernamestringdisplay_namestringurlstring (uri)avatarstringheaderstringnotestringnote_textstringlockedbooleanbotbooleangroupbooleandiscoverableboolean | nullindexableboolean | nullfollowers_countintegerfollowing_countintegerstatuses_countintegercreated_atstring (date-time)last_status_atstring (date) | nullfieldsarray of objectShow 3 item attributes
namestringvaluestringverified_atstring (date-time) | nullmovedobject | nullsuspendedbooleanlimitedbooleanlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Mastodon: Follow (Profile directory)
/accounts/{accountId}/mastodon/directory/{itemId}/followFollow. Discoverable accounts known to the instance. Requires scopes: write:follows. Network docs: https://docs.joinmastodon.org/methods/directory/ Generic route: /v1/accounts/{accountId}/focus/directory.
Try it with MCPAsk your agent to call mastodon-directory-follow (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
reblogsbooleandefault: truenotifybooleanlanguagesarray of stringReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Bookmarks
Mastodon: List Bookmarks
/accounts/{accountId}/mastodon/bookmarksCursor pagination: pass next_cursor back as cursor. Requires scopes: read:bookmarks. Network docs: https://docs.joinmastodon.org/methods/bookmarks/ Generic route: /v1/accounts/{accountId}/focus/bookmarks.
Try it with MCPAsk your agent to call mastodon-bookmarks-list (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringOpaque cursor from a previous next_cursor
limitintegerdefault: 201–80
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 29 item attributes
idstringrequiredread-onlyuristring (uri)urlstring (uri) | nullcreated_atstring (date-time)edited_atstring (date-time) | nulltextstringread-onlycontentstringspoiler_textstringsensitivebooleanvisibilitystringpublicunlistedprivatedirect
languagestring | nullin_reply_to_idstring | nullin_reply_to_account_idstring | nullreplies_countintegerreblogs_countintegerfavourites_countintegerquotes_countinteger | nullauthorstringauthor_namestring | nullmedia_attachmentsarray of objectShow 8 item attributes
idstringread-onlytypestringimagegifvvideoaudiounknown
urlstring (uri) | nullpreview_urlstring (uri) | nullremote_urlstring (uri) | nulldescriptionstring | nullblurhashstring | nullmetaobjectpollobject | nullShow 9 child attributes
idstringread-onlyexpires_atstring (date-time) | nullexpiredbooleanmultiplebooleanvotes_countintegervoters_countinteger | nullvotedbooleanown_votesarray of integeroptionsarray of objectShow 2 item attributes
titlestringvotes_countinteger | nullfavouritedbooleanrebloggedbooleanbookmarkedbooleanmutedbooleanpinnedbooleanis_reblogbooleanquoteobject | nullShow 2 child attributes
statestringquoted_statusobject | nullquote_approvalobject | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Mastodon: Create a Bookmarks item
/accounts/{accountId}/mastodon/bookmarksRequires scopes: read:bookmarks, write:bookmarks. Network docs: https://docs.joinmastodon.org/methods/bookmarks/ Generic route: /v1/accounts/{accountId}/focus/bookmarks.
Try it with MCPAsk your agent to call mastodon-bookmarks-create (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
status_idstringrequiredReturns object
idstringrequiredread-onlyuristring (uri)urlstring (uri) | nullcreated_atstring (date-time)edited_atstring (date-time) | nulltextstringread-onlycontentstringspoiler_textstringsensitivebooleanvisibilitystringpublicunlistedprivatedirect
languagestring | nullin_reply_to_idstring | nullin_reply_to_account_idstring | nullreplies_countintegerreblogs_countintegerfavourites_countintegerquotes_countinteger | nullauthorstringauthor_namestring | nullmedia_attachmentsarray of objectShow 8 item attributes
idstringread-onlytypestringimagegifvvideoaudiounknown
urlstring (uri) | nullpreview_urlstring (uri) | nullremote_urlstring (uri) | nulldescriptionstring | nullblurhashstring | nullmetaobjectpollobject | nullShow 9 child attributes
idstringread-onlyexpires_atstring (date-time) | nullexpiredbooleanmultiplebooleanvotes_countintegervoters_countinteger | nullvotedbooleanown_votesarray of integeroptionsarray of objectShow 2 item attributes
titlestringvotes_countinteger | nullfavouritedbooleanrebloggedbooleanbookmarkedbooleanmutedbooleanpinnedbooleanis_reblogbooleanquoteobject | nullShow 2 child attributes
statestringquoted_statusobject | nullquote_approvalobject | nullResponses
Mastodon: Delete a Bookmarks item
/accounts/{accountId}/mastodon/bookmarks/{itemId}Requires scopes: read:bookmarks, write:bookmarks. Network docs: https://docs.joinmastodon.org/methods/bookmarks/ Generic route: /v1/accounts/{accountId}/focus/bookmarks.
Try it with MCPAsk your agent to call mastodon-bookmarks-delete (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Mastodon: Favourite (Bookmarks)
/accounts/{accountId}/mastodon/bookmarks/{itemId}/favouriteFavourite. Requires scopes: read:bookmarks, write:favourites. Network docs: https://docs.joinmastodon.org/methods/bookmarks/ Generic route: /v1/accounts/{accountId}/focus/bookmarks.
Try it with MCPAsk your agent to call mastodon-bookmarks-favourite (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Boost (Bookmarks)
/accounts/{accountId}/mastodon/bookmarks/{itemId}/boostBoost. Requires scopes: read:bookmarks, write:statuses. Network docs: https://docs.joinmastodon.org/methods/bookmarks/ Generic route: /v1/accounts/{accountId}/focus/bookmarks.
Try it with MCPAsk your agent to call mastodon-bookmarks-boost (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
visibilitystringpublicunlistedprivate
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Reply (Bookmarks)
/accounts/{accountId}/mastodon/bookmarks/{itemId}/replyReply. Requires scopes: read:bookmarks, write:statuses. Network docs: https://docs.joinmastodon.org/methods/bookmarks/ Generic route: /v1/accounts/{accountId}/focus/bookmarks.
Try it with MCPAsk your agent to call mastodon-bookmarks-reply (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
statusstringPlain text; URLs count as 23 characters
visibilitystringpublicunlistedprivatedirect
spoiler_textstringsensitivebooleanlanguagestringISO 639-1
mediaarray of stringSocialit media ids (uploaded to the instance on publish)
media_idsarray of stringAlready-uploaded Mastodon media ids
alt_textsarray of stringAlt text per media item, by index
pollobjectShow 4 child attributes
optionsarray of string≥ 2 items
expires_inintegerdefault: 86400multiplebooleanhide_totalsbooleanin_reply_to_idstringquoted_status_idstringMastodon 4.5+
quote_approval_policystringpublicfollowersnobody
scheduled_atstring (date-time)≥ 5 minutes ahead → ScheduledStatus
threadarray of stringFollow-up replies posted as a self-thread
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Favourites
Mastodon: List Favourites
/accounts/{accountId}/mastodon/favouritesCursor pagination: pass next_cursor back as cursor. Requires scopes: read:favourites. Network docs: https://docs.joinmastodon.org/methods/favourites/ Generic route: /v1/accounts/{accountId}/focus/favourites.
Try it with MCPAsk your agent to call mastodon-favourites-list (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringOpaque cursor from a previous next_cursor
limitintegerdefault: 201–80
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 29 item attributes
idstringrequiredread-onlyuristring (uri)urlstring (uri) | nullcreated_atstring (date-time)edited_atstring (date-time) | nulltextstringread-onlycontentstringspoiler_textstringsensitivebooleanvisibilitystringpublicunlistedprivatedirect
languagestring | nullin_reply_to_idstring | nullin_reply_to_account_idstring | nullreplies_countintegerreblogs_countintegerfavourites_countintegerquotes_countinteger | nullauthorstringauthor_namestring | nullmedia_attachmentsarray of objectShow 8 item attributes
idstringread-onlytypestringimagegifvvideoaudiounknown
urlstring (uri) | nullpreview_urlstring (uri) | nullremote_urlstring (uri) | nulldescriptionstring | nullblurhashstring | nullmetaobjectpollobject | nullShow 9 child attributes
idstringread-onlyexpires_atstring (date-time) | nullexpiredbooleanmultiplebooleanvotes_countintegervoters_countinteger | nullvotedbooleanown_votesarray of integeroptionsarray of objectShow 2 item attributes
titlestringvotes_countinteger | nullfavouritedbooleanrebloggedbooleanbookmarkedbooleanmutedbooleanpinnedbooleanis_reblogbooleanquoteobject | nullShow 2 child attributes
statestringquoted_statusobject | nullquote_approvalobject | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Mastodon: Create a Favourites item
/accounts/{accountId}/mastodon/favouritesRequires scopes: read:favourites, write:favourites. Network docs: https://docs.joinmastodon.org/methods/favourites/ Generic route: /v1/accounts/{accountId}/focus/favourites.
Try it with MCPAsk your agent to call mastodon-favourites-create (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
status_idstringrequiredReturns object
idstringrequiredread-onlyuristring (uri)urlstring (uri) | nullcreated_atstring (date-time)edited_atstring (date-time) | nulltextstringread-onlycontentstringspoiler_textstringsensitivebooleanvisibilitystringpublicunlistedprivatedirect
languagestring | nullin_reply_to_idstring | nullin_reply_to_account_idstring | nullreplies_countintegerreblogs_countintegerfavourites_countintegerquotes_countinteger | nullauthorstringauthor_namestring | nullmedia_attachmentsarray of objectShow 8 item attributes
idstringread-onlytypestringimagegifvvideoaudiounknown
urlstring (uri) | nullpreview_urlstring (uri) | nullremote_urlstring (uri) | nulldescriptionstring | nullblurhashstring | nullmetaobjectpollobject | nullShow 9 child attributes
idstringread-onlyexpires_atstring (date-time) | nullexpiredbooleanmultiplebooleanvotes_countintegervoters_countinteger | nullvotedbooleanown_votesarray of integeroptionsarray of objectShow 2 item attributes
titlestringvotes_countinteger | nullfavouritedbooleanrebloggedbooleanbookmarkedbooleanmutedbooleanpinnedbooleanis_reblogbooleanquoteobject | nullShow 2 child attributes
statestringquoted_statusobject | nullquote_approvalobject | nullResponses
Mastodon: Delete a Favourites item
/accounts/{accountId}/mastodon/favourites/{itemId}Requires scopes: read:favourites, write:favourites. Network docs: https://docs.joinmastodon.org/methods/favourites/ Generic route: /v1/accounts/{accountId}/focus/favourites.
Try it with MCPAsk your agent to call mastodon-favourites-delete (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Mastodon: Bookmark (Favourites)
/accounts/{accountId}/mastodon/favourites/{itemId}/bookmarkBookmark. Requires scopes: read:favourites, write:bookmarks. Network docs: https://docs.joinmastodon.org/methods/favourites/ Generic route: /v1/accounts/{accountId}/focus/favourites.
Try it with MCPAsk your agent to call mastodon-favourites-bookmark (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Boost (Favourites)
/accounts/{accountId}/mastodon/favourites/{itemId}/boostBoost. Requires scopes: read:favourites, write:statuses. Network docs: https://docs.joinmastodon.org/methods/favourites/ Generic route: /v1/accounts/{accountId}/focus/favourites.
Try it with MCPAsk your agent to call mastodon-favourites-boost (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
visibilitystringpublicunlistedprivate
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Reply (Favourites)
/accounts/{accountId}/mastodon/favourites/{itemId}/replyReply. Requires scopes: read:favourites, write:statuses. Network docs: https://docs.joinmastodon.org/methods/favourites/ Generic route: /v1/accounts/{accountId}/focus/favourites.
Try it with MCPAsk your agent to call mastodon-favourites-reply (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
statusstringPlain text; URLs count as 23 characters
visibilitystringpublicunlistedprivatedirect
spoiler_textstringsensitivebooleanlanguagestringISO 639-1
mediaarray of stringSocialit media ids (uploaded to the instance on publish)
media_idsarray of stringAlready-uploaded Mastodon media ids
alt_textsarray of stringAlt text per media item, by index
pollobjectShow 4 child attributes
optionsarray of string≥ 2 items
expires_inintegerdefault: 86400multiplebooleanhide_totalsbooleanin_reply_to_idstringquoted_status_idstringMastodon 4.5+
quote_approval_policystringpublicfollowersnobody
scheduled_atstring (date-time)≥ 5 minutes ahead → ScheduledStatus
threadarray of stringFollow-up replies posted as a self-thread
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Followed tags
Mastodon: List Followed hashtags
/accounts/{accountId}/mastodon/followed-tagsHashtags whose posts appear in your home timeline. Cursor pagination: pass next_cursor back as cursor. Requires scopes: read:follows. Network docs: https://docs.joinmastodon.org/methods/followed_tags/ Generic route: /v1/accounts/{accountId}/focus/followed-tags.
Try it with MCPAsk your agent to call mastodon-followed-tags-list (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringOpaque cursor from a previous next_cursor
limitintegerdefault: 201–80
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 6 item attributes
idstring | nullnamestringurlstring (uri)followingboolean | nullfeaturingboolean | nullhistoryarray of objectShow 3 item attributes
daystringusesstringaccountsstringlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Mastodon: Create a Followed hashtags item
/accounts/{accountId}/mastodon/followed-tagsHashtags whose posts appear in your home timeline. Requires scopes: read:follows, write:follows. Network docs: https://docs.joinmastodon.org/methods/followed_tags/ Generic route: /v1/accounts/{accountId}/focus/followed-tags.
Try it with MCPAsk your agent to call mastodon-followed-tags-create (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
namestringrequiredWithout #
Returns object
idstring | nullnamestringurlstring (uri)followingboolean | nullfeaturingboolean | nullhistoryarray of objectShow 3 item attributes
daystringusesstringaccountsstringResponses
Mastodon: Get a Followed hashtags item
/accounts/{accountId}/mastodon/followed-tags/{itemId}Hashtags whose posts appear in your home timeline. Requires scopes: read:follows. Network docs: https://docs.joinmastodon.org/methods/followed_tags/ Generic route: /v1/accounts/{accountId}/focus/followed-tags.
Try it with MCPAsk your agent to call mastodon-followed-tags-get (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstring | nullnamestringurlstring (uri)followingboolean | nullfeaturingboolean | nullhistoryarray of objectShow 3 item attributes
daystringusesstringaccountsstringResponses
Mastodon: Delete a Followed hashtags item
/accounts/{accountId}/mastodon/followed-tags/{itemId}Hashtags whose posts appear in your home timeline. Requires scopes: read:follows, write:follows. Network docs: https://docs.joinmastodon.org/methods/followed_tags/ Generic route: /v1/accounts/{accountId}/focus/followed-tags.
Try it with MCPAsk your agent to call mastodon-followed-tags-delete (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Filters
Mastodon: List Filters
/accounts/{accountId}/mastodon/filtersKeyword / status filters (v2) with warn, hide or blur actions. Cursor pagination: pass next_cursor back as cursor. Requires scopes: read:filters. Network docs: https://docs.joinmastodon.org/methods/filters/ Generic route: /v1/accounts/{accountId}/focus/filters.
Try it with MCPAsk your agent to call mastodon-filters-list (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 7 item attributes
idstringrequiredread-onlytitlestringrequiredcontextarray of string≥ 1 items
filter_actionstringwarnhideblur
expires_atstring (date-time) | nullkeywordsarray of objectShow 3 item attributes
idstringkeywordstringwhole_wordbooleanstatusesarray of objectShow 2 item attributes
idstringstatus_idstringlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Mastodon: Create a Filters item
/accounts/{accountId}/mastodon/filtersKeyword / status filters (v2) with warn, hide or blur actions. Requires scopes: read:filters, write:filters. Network docs: https://docs.joinmastodon.org/methods/filters/ Generic route: /v1/accounts/{accountId}/focus/filters.
Try it with MCPAsk your agent to call mastodon-filters-create (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
titlestringrequiredcontextarray of stringrequiredfilter_actionstringwarnhideblur
expires_inintegerSeconds; omit for never
keywords_attributesarray of objectShow 4 item attributes
idstringkeywordstringwhole_wordboolean_destroybooleanReturns object
idstringrequiredread-onlytitlestringrequiredcontextarray of string≥ 1 items
filter_actionstringwarnhideblur
expires_atstring (date-time) | nullkeywordsarray of objectShow 3 item attributes
idstringkeywordstringwhole_wordbooleanstatusesarray of objectShow 2 item attributes
idstringstatus_idstringResponses
Mastodon: Get a Filters item
/accounts/{accountId}/mastodon/filters/{itemId}Keyword / status filters (v2) with warn, hide or blur actions. Requires scopes: read:filters. Network docs: https://docs.joinmastodon.org/methods/filters/ Generic route: /v1/accounts/{accountId}/focus/filters.
Try it with MCPAsk your agent to call mastodon-filters-get (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringrequiredread-onlytitlestringrequiredcontextarray of string≥ 1 items
filter_actionstringwarnhideblur
expires_atstring (date-time) | nullkeywordsarray of objectShow 3 item attributes
idstringkeywordstringwhole_wordbooleanstatusesarray of objectShow 2 item attributes
idstringstatus_idstringResponses
Mastodon: Update a Filters item
/accounts/{accountId}/mastodon/filters/{itemId}Keyword / status filters (v2) with warn, hide or blur actions. Requires scopes: read:filters, write:filters. Network docs: https://docs.joinmastodon.org/methods/filters/ Generic route: /v1/accounts/{accountId}/focus/filters.
Try it with MCPAsk your agent to call mastodon-filters-update (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
titlestringcontextarray of stringfilter_actionstringwarnhideblur
expires_inintegerSeconds; omit for never
keywords_attributesarray of objectShow 4 item attributes
idstringkeywordstringwhole_wordboolean_destroybooleanReturns object
idstringrequiredread-onlytitlestringrequiredcontextarray of string≥ 1 items
filter_actionstringwarnhideblur
expires_atstring (date-time) | nullkeywordsarray of objectShow 3 item attributes
idstringkeywordstringwhole_wordbooleanstatusesarray of objectShow 2 item attributes
idstringstatus_idstringResponses
Mastodon: Delete a Filters item
/accounts/{accountId}/mastodon/filters/{itemId}Keyword / status filters (v2) with warn, hide or blur actions. Requires scopes: read:filters, write:filters. Network docs: https://docs.joinmastodon.org/methods/filters/ Generic route: /v1/accounts/{accountId}/focus/filters.
Try it with MCPAsk your agent to call mastodon-filters-delete (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Mastodon: Add keyword (Filters)
/accounts/{accountId}/mastodon/filters/{itemId}/add-keywordAdd keyword. Keyword / status filters (v2) with warn, hide or blur actions. Requires scopes: read:filters, write:filters. Network docs: https://docs.joinmastodon.org/methods/filters/ Generic route: /v1/accounts/{accountId}/focus/filters.
Try it with MCPAsk your agent to call mastodon-filters-add-keyword (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
keywordstringrequiredwhole_wordbooleanReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Filter a status (Filters)
/accounts/{accountId}/mastodon/filters/{itemId}/add-statusFilter a status. Keyword / status filters (v2) with warn, hide or blur actions. Requires scopes: read:filters, write:filters. Network docs: https://docs.joinmastodon.org/methods/filters/ Generic route: /v1/accounts/{accountId}/focus/filters.
Try it with MCPAsk your agent to call mastodon-filters-add-status (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
status_idstringrequiredReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Filter keywords
Mastodon: List Filter keywords
/accounts/{accountId}/mastodon/filter-keywordsCursor pagination: pass next_cursor back as cursor. Requires scopes: read:filters. Network docs: https://docs.joinmastodon.org/methods/filters/#keywords-get Generic route: /v1/accounts/{accountId}/focus/filter-keywords.
Try it with MCPAsk your agent to call mastodon-filter-keywords-list (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
filter_idstringrequiredReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 4 item attributes
idstringrequiredread-onlykeywordstringrequiredwhole_wordbooleanfilter_idstringlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Mastodon: Create a Filter keywords item
/accounts/{accountId}/mastodon/filter-keywordsRequires scopes: read:filters, write:filters. Network docs: https://docs.joinmastodon.org/methods/filters/#keywords-get Generic route: /v1/accounts/{accountId}/focus/filter-keywords.
Try it with MCPAsk your agent to call mastodon-filter-keywords-create (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
filter_idstringrequiredkeywordstringrequiredwhole_wordbooleanReturns object
idstringrequiredread-onlykeywordstringrequiredwhole_wordbooleanfilter_idstringResponses
Mastodon: Get a Filter keywords item
/accounts/{accountId}/mastodon/filter-keywords/{itemId}Requires scopes: read:filters. Network docs: https://docs.joinmastodon.org/methods/filters/#keywords-get Generic route: /v1/accounts/{accountId}/focus/filter-keywords.
Try it with MCPAsk your agent to call mastodon-filter-keywords-get (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringrequiredread-onlykeywordstringrequiredwhole_wordbooleanfilter_idstringResponses
Mastodon: Update a Filter keywords item
/accounts/{accountId}/mastodon/filter-keywords/{itemId}Requires scopes: read:filters, write:filters. Network docs: https://docs.joinmastodon.org/methods/filters/#keywords-get Generic route: /v1/accounts/{accountId}/focus/filter-keywords.
Try it with MCPAsk your agent to call mastodon-filter-keywords-update (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
keywordstringwhole_wordbooleanReturns object
idstringrequiredread-onlykeywordstringrequiredwhole_wordbooleanfilter_idstringResponses
Mastodon: Delete a Filter keywords item
/accounts/{accountId}/mastodon/filter-keywords/{itemId}Requires scopes: read:filters, write:filters. Network docs: https://docs.joinmastodon.org/methods/filters/#keywords-get Generic route: /v1/accounts/{accountId}/focus/filter-keywords.
Try it with MCPAsk your agent to call mastodon-filter-keywords-delete (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Filter statuses
Mastodon: List Filtered posts
/accounts/{accountId}/mastodon/filter-statusesCursor pagination: pass next_cursor back as cursor. Requires scopes: read:filters. Network docs: https://docs.joinmastodon.org/methods/filters/#statuses-get Generic route: /v1/accounts/{accountId}/focus/filter-statuses.
Try it with MCPAsk your agent to call mastodon-filter-statuses-list (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
filter_idstringrequiredReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 3 item attributes
idstringrequiredread-onlystatus_idstringrequiredfilter_idstringlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Mastodon: Create a Filtered posts item
/accounts/{accountId}/mastodon/filter-statusesRequires scopes: read:filters, write:filters. Network docs: https://docs.joinmastodon.org/methods/filters/#statuses-get Generic route: /v1/accounts/{accountId}/focus/filter-statuses.
Try it with MCPAsk your agent to call mastodon-filter-statuses-create (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
filter_idstringrequiredstatus_idstringrequiredReturns object
idstringrequiredread-onlystatus_idstringrequiredfilter_idstringResponses
Mastodon: Get a Filtered posts item
/accounts/{accountId}/mastodon/filter-statuses/{itemId}Requires scopes: read:filters. Network docs: https://docs.joinmastodon.org/methods/filters/#statuses-get Generic route: /v1/accounts/{accountId}/focus/filter-statuses.
Try it with MCPAsk your agent to call mastodon-filter-statuses-get (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringrequiredread-onlystatus_idstringrequiredfilter_idstringResponses
Mastodon: Delete a Filtered posts item
/accounts/{accountId}/mastodon/filter-statuses/{itemId}Requires scopes: read:filters, write:filters. Network docs: https://docs.joinmastodon.org/methods/filters/#statuses-get Generic route: /v1/accounts/{accountId}/focus/filter-statuses.
Try it with MCPAsk your agent to call mastodon-filter-statuses-delete (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Markers
Mastodon: List Read markers
/accounts/{accountId}/mastodon/markersLast-read position in home and notifications, synced across clients. Cursor pagination: pass next_cursor back as cursor. Requires scopes: read:statuses. Network docs: https://docs.joinmastodon.org/methods/markers/ Generic route: /v1/accounts/{accountId}/focus/markers.
Try it with MCPAsk your agent to call mastodon-markers-list (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 4 item attributes
idstringrequiredhomenotifications
last_read_idstringversionintegerupdated_atstring (date-time)limitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Mastodon: Update a Read markers item
/accounts/{accountId}/mastodon/markers/{itemId}Last-read position in home and notifications, synced across clients. Requires scopes: read:statuses, write:statuses. Network docs: https://docs.joinmastodon.org/methods/markers/ Generic route: /v1/accounts/{accountId}/focus/markers.
Try it with MCPAsk your agent to call mastodon-markers-update (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
last_read_idstringrequiredReturns object
idstringrequiredhomenotifications
last_read_idstringversionintegerupdated_atstring (date-time)Responses
Home timeline
Mastodon: List Home
/accounts/{accountId}/mastodon/home-timelinePosts from people and hashtags you follow. Cursor pagination: pass next_cursor back as cursor. Requires scopes: read:statuses. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/home-timeline.
Try it with MCPAsk your agent to call mastodon-home-timeline-list (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringOpaque cursor from a previous next_cursor
limitintegerdefault: 201–80
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 29 item attributes
idstringrequiredread-onlyuristring (uri)urlstring (uri) | nullcreated_atstring (date-time)edited_atstring (date-time) | nulltextstringread-onlycontentstringspoiler_textstringsensitivebooleanvisibilitystringpublicunlistedprivatedirect
languagestring | nullin_reply_to_idstring | nullin_reply_to_account_idstring | nullreplies_countintegerreblogs_countintegerfavourites_countintegerquotes_countinteger | nullauthorstringauthor_namestring | nullmedia_attachmentsarray of objectShow 8 item attributes
idstringread-onlytypestringimagegifvvideoaudiounknown
urlstring (uri) | nullpreview_urlstring (uri) | nullremote_urlstring (uri) | nulldescriptionstring | nullblurhashstring | nullmetaobjectpollobject | nullShow 9 child attributes
idstringread-onlyexpires_atstring (date-time) | nullexpiredbooleanmultiplebooleanvotes_countintegervoters_countinteger | nullvotedbooleanown_votesarray of integeroptionsarray of objectShow 2 item attributes
titlestringvotes_countinteger | nullfavouritedbooleanrebloggedbooleanbookmarkedbooleanmutedbooleanpinnedbooleanis_reblogbooleanquoteobject | nullShow 2 child attributes
statestringquoted_statusobject | nullquote_approvalobject | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Mastodon: Favourite (Home)
/accounts/{accountId}/mastodon/home-timeline/{itemId}/favouriteFavourite. Posts from people and hashtags you follow. Requires scopes: read:statuses, write:favourites. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/home-timeline.
Try it with MCPAsk your agent to call mastodon-home-timeline-favourite (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Unfavourite (Home)
/accounts/{accountId}/mastodon/home-timeline/{itemId}/unfavouriteUnfavourite. Posts from people and hashtags you follow. Requires scopes: read:statuses, write:favourites. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/home-timeline.
Try it with MCPAsk your agent to call mastodon-home-timeline-unfavourite (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Boost (Home)
/accounts/{accountId}/mastodon/home-timeline/{itemId}/boostBoost. Posts from people and hashtags you follow. Requires scopes: read:statuses, write:statuses. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/home-timeline.
Try it with MCPAsk your agent to call mastodon-home-timeline-boost (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
visibilitystringpublicunlistedprivate
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Undo boost (Home)
/accounts/{accountId}/mastodon/home-timeline/{itemId}/unboostUndo boost. Posts from people and hashtags you follow. Requires scopes: read:statuses, write:statuses. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/home-timeline.
Try it with MCPAsk your agent to call mastodon-home-timeline-unboost (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Bookmark (Home)
/accounts/{accountId}/mastodon/home-timeline/{itemId}/bookmarkBookmark. Posts from people and hashtags you follow. Requires scopes: read:statuses, write:bookmarks. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/home-timeline.
Try it with MCPAsk your agent to call mastodon-home-timeline-bookmark (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Remove bookmark (Home)
/accounts/{accountId}/mastodon/home-timeline/{itemId}/unbookmarkRemove bookmark. Posts from people and hashtags you follow. Requires scopes: read:statuses, write:bookmarks. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/home-timeline.
Try it with MCPAsk your agent to call mastodon-home-timeline-unbookmark (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Reply (Home)
/accounts/{accountId}/mastodon/home-timeline/{itemId}/replyReply. Posts from people and hashtags you follow. Requires scopes: read:statuses, write:statuses. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/home-timeline.
Try it with MCPAsk your agent to call mastodon-home-timeline-reply (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
statusstringPlain text; URLs count as 23 characters
visibilitystringpublicunlistedprivatedirect
spoiler_textstringsensitivebooleanlanguagestringISO 639-1
mediaarray of stringSocialit media ids (uploaded to the instance on publish)
media_idsarray of stringAlready-uploaded Mastodon media ids
alt_textsarray of stringAlt text per media item, by index
pollobjectShow 4 child attributes
optionsarray of string≥ 2 items
expires_inintegerdefault: 86400multiplebooleanhide_totalsbooleanin_reply_to_idstringquoted_status_idstringMastodon 4.5+
quote_approval_policystringpublicfollowersnobody
scheduled_atstring (date-time)≥ 5 minutes ahead → ScheduledStatus
threadarray of stringFollow-up replies posted as a self-thread
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Local timeline
Mastodon: List Local
/accounts/{accountId}/mastodon/local-timelinePublic posts from this server (may be restricted by configuration.timelines_access). Cursor pagination: pass next_cursor back as cursor. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/local-timeline.
Try it with MCPAsk your agent to call mastodon-local-timeline-list (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringOpaque cursor from a previous next_cursor
limitintegerdefault: 201–80
only_mediabooleanReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 29 item attributes
idstringrequiredread-onlyuristring (uri)urlstring (uri) | nullcreated_atstring (date-time)edited_atstring (date-time) | nulltextstringread-onlycontentstringspoiler_textstringsensitivebooleanvisibilitystringpublicunlistedprivatedirect
languagestring | nullin_reply_to_idstring | nullin_reply_to_account_idstring | nullreplies_countintegerreblogs_countintegerfavourites_countintegerquotes_countinteger | nullauthorstringauthor_namestring | nullmedia_attachmentsarray of objectShow 8 item attributes
idstringread-onlytypestringimagegifvvideoaudiounknown
urlstring (uri) | nullpreview_urlstring (uri) | nullremote_urlstring (uri) | nulldescriptionstring | nullblurhashstring | nullmetaobjectpollobject | nullShow 9 child attributes
idstringread-onlyexpires_atstring (date-time) | nullexpiredbooleanmultiplebooleanvotes_countintegervoters_countinteger | nullvotedbooleanown_votesarray of integeroptionsarray of objectShow 2 item attributes
titlestringvotes_countinteger | nullfavouritedbooleanrebloggedbooleanbookmarkedbooleanmutedbooleanpinnedbooleanis_reblogbooleanquoteobject | nullShow 2 child attributes
statestringquoted_statusobject | nullquote_approvalobject | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Mastodon: Favourite (Local)
/accounts/{accountId}/mastodon/local-timeline/{itemId}/favouriteFavourite. Public posts from this server (may be restricted by configuration.timelines_access). Requires scopes: write:favourites. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/local-timeline.
Try it with MCPAsk your agent to call mastodon-local-timeline-favourite (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Unfavourite (Local)
/accounts/{accountId}/mastodon/local-timeline/{itemId}/unfavouriteUnfavourite. Public posts from this server (may be restricted by configuration.timelines_access). Requires scopes: write:favourites. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/local-timeline.
Try it with MCPAsk your agent to call mastodon-local-timeline-unfavourite (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Boost (Local)
/accounts/{accountId}/mastodon/local-timeline/{itemId}/boostBoost. Public posts from this server (may be restricted by configuration.timelines_access). Requires scopes: write:statuses. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/local-timeline.
Try it with MCPAsk your agent to call mastodon-local-timeline-boost (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
visibilitystringpublicunlistedprivate
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Undo boost (Local)
/accounts/{accountId}/mastodon/local-timeline/{itemId}/unboostUndo boost. Public posts from this server (may be restricted by configuration.timelines_access). Requires scopes: write:statuses. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/local-timeline.
Try it with MCPAsk your agent to call mastodon-local-timeline-unboost (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Bookmark (Local)
/accounts/{accountId}/mastodon/local-timeline/{itemId}/bookmarkBookmark. Public posts from this server (may be restricted by configuration.timelines_access). Requires scopes: write:bookmarks. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/local-timeline.
Try it with MCPAsk your agent to call mastodon-local-timeline-bookmark (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Remove bookmark (Local)
/accounts/{accountId}/mastodon/local-timeline/{itemId}/unbookmarkRemove bookmark. Public posts from this server (may be restricted by configuration.timelines_access). Requires scopes: write:bookmarks. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/local-timeline.
Try it with MCPAsk your agent to call mastodon-local-timeline-unbookmark (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Reply (Local)
/accounts/{accountId}/mastodon/local-timeline/{itemId}/replyReply. Public posts from this server (may be restricted by configuration.timelines_access). Requires scopes: write:statuses. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/local-timeline.
Try it with MCPAsk your agent to call mastodon-local-timeline-reply (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
statusstringPlain text; URLs count as 23 characters
visibilitystringpublicunlistedprivatedirect
spoiler_textstringsensitivebooleanlanguagestringISO 639-1
mediaarray of stringSocialit media ids (uploaded to the instance on publish)
media_idsarray of stringAlready-uploaded Mastodon media ids
alt_textsarray of stringAlt text per media item, by index
pollobjectShow 4 child attributes
optionsarray of string≥ 2 items
expires_inintegerdefault: 86400multiplebooleanhide_totalsbooleanin_reply_to_idstringquoted_status_idstringMastodon 4.5+
quote_approval_policystringpublicfollowersnobody
scheduled_atstring (date-time)≥ 5 minutes ahead → ScheduledStatus
threadarray of stringFollow-up replies posted as a self-thread
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Federated timeline
Mastodon: List Federated
/accounts/{accountId}/mastodon/federated-timelinePublic posts from across the fediverse known to this server. Cursor pagination: pass next_cursor back as cursor. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/federated-timeline.
Try it with MCPAsk your agent to call mastodon-federated-timeline-list (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringOpaque cursor from a previous next_cursor
limitintegerdefault: 201–80
only_mediabooleanremotebooleanOnly remote posts
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 29 item attributes
idstringrequiredread-onlyuristring (uri)urlstring (uri) | nullcreated_atstring (date-time)edited_atstring (date-time) | nulltextstringread-onlycontentstringspoiler_textstringsensitivebooleanvisibilitystringpublicunlistedprivatedirect
languagestring | nullin_reply_to_idstring | nullin_reply_to_account_idstring | nullreplies_countintegerreblogs_countintegerfavourites_countintegerquotes_countinteger | nullauthorstringauthor_namestring | nullmedia_attachmentsarray of objectShow 8 item attributes
idstringread-onlytypestringimagegifvvideoaudiounknown
urlstring (uri) | nullpreview_urlstring (uri) | nullremote_urlstring (uri) | nulldescriptionstring | nullblurhashstring | nullmetaobjectpollobject | nullShow 9 child attributes
idstringread-onlyexpires_atstring (date-time) | nullexpiredbooleanmultiplebooleanvotes_countintegervoters_countinteger | nullvotedbooleanown_votesarray of integeroptionsarray of objectShow 2 item attributes
titlestringvotes_countinteger | nullfavouritedbooleanrebloggedbooleanbookmarkedbooleanmutedbooleanpinnedbooleanis_reblogbooleanquoteobject | nullShow 2 child attributes
statestringquoted_statusobject | nullquote_approvalobject | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Mastodon: Favourite (Federated)
/accounts/{accountId}/mastodon/federated-timeline/{itemId}/favouriteFavourite. Public posts from across the fediverse known to this server. Requires scopes: write:favourites. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/federated-timeline.
Try it with MCPAsk your agent to call mastodon-federated-timeline-favourite (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Unfavourite (Federated)
/accounts/{accountId}/mastodon/federated-timeline/{itemId}/unfavouriteUnfavourite. Public posts from across the fediverse known to this server. Requires scopes: write:favourites. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/federated-timeline.
Try it with MCPAsk your agent to call mastodon-federated-timeline-unfavourite (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Boost (Federated)
/accounts/{accountId}/mastodon/federated-timeline/{itemId}/boostBoost. Public posts from across the fediverse known to this server. Requires scopes: write:statuses. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/federated-timeline.
Try it with MCPAsk your agent to call mastodon-federated-timeline-boost (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
visibilitystringpublicunlistedprivate
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Undo boost (Federated)
/accounts/{accountId}/mastodon/federated-timeline/{itemId}/unboostUndo boost. Public posts from across the fediverse known to this server. Requires scopes: write:statuses. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/federated-timeline.
Try it with MCPAsk your agent to call mastodon-federated-timeline-unboost (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Bookmark (Federated)
/accounts/{accountId}/mastodon/federated-timeline/{itemId}/bookmarkBookmark. Public posts from across the fediverse known to this server. Requires scopes: write:bookmarks. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/federated-timeline.
Try it with MCPAsk your agent to call mastodon-federated-timeline-bookmark (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Remove bookmark (Federated)
/accounts/{accountId}/mastodon/federated-timeline/{itemId}/unbookmarkRemove bookmark. Public posts from across the fediverse known to this server. Requires scopes: write:bookmarks. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/federated-timeline.
Try it with MCPAsk your agent to call mastodon-federated-timeline-unbookmark (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Reply (Federated)
/accounts/{accountId}/mastodon/federated-timeline/{itemId}/replyReply. Public posts from across the fediverse known to this server. Requires scopes: write:statuses. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/federated-timeline.
Try it with MCPAsk your agent to call mastodon-federated-timeline-reply (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
statusstringPlain text; URLs count as 23 characters
visibilitystringpublicunlistedprivatedirect
spoiler_textstringsensitivebooleanlanguagestringISO 639-1
mediaarray of stringSocialit media ids (uploaded to the instance on publish)
media_idsarray of stringAlready-uploaded Mastodon media ids
alt_textsarray of stringAlt text per media item, by index
pollobjectShow 4 child attributes
optionsarray of string≥ 2 items
expires_inintegerdefault: 86400multiplebooleanhide_totalsbooleanin_reply_to_idstringquoted_status_idstringMastodon 4.5+
quote_approval_policystringpublicfollowersnobody
scheduled_atstring (date-time)≥ 5 minutes ahead → ScheduledStatus
threadarray of stringFollow-up replies posted as a self-thread
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Hashtag timeline
Mastodon: List Hashtag
/accounts/{accountId}/mastodon/hashtag-timelinePublic posts with a hashtag (any/all/none combinations). Cursor pagination: pass next_cursor back as cursor. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/hashtag-timeline.
Try it with MCPAsk your agent to call mastodon-hashtag-timeline-list (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringOpaque cursor from a previous next_cursor
limitintegerdefault: 201–80
tagstringrequiredanyarray of stringallarray of stringnonearray of stringlocalbooleanremotebooleanonly_mediabooleanReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 29 item attributes
idstringrequiredread-onlyuristring (uri)urlstring (uri) | nullcreated_atstring (date-time)edited_atstring (date-time) | nulltextstringread-onlycontentstringspoiler_textstringsensitivebooleanvisibilitystringpublicunlistedprivatedirect
languagestring | nullin_reply_to_idstring | nullin_reply_to_account_idstring | nullreplies_countintegerreblogs_countintegerfavourites_countintegerquotes_countinteger | nullauthorstringauthor_namestring | nullmedia_attachmentsarray of objectShow 8 item attributes
idstringread-onlytypestringimagegifvvideoaudiounknown
urlstring (uri) | nullpreview_urlstring (uri) | nullremote_urlstring (uri) | nulldescriptionstring | nullblurhashstring | nullmetaobjectpollobject | nullShow 9 child attributes
idstringread-onlyexpires_atstring (date-time) | nullexpiredbooleanmultiplebooleanvotes_countintegervoters_countinteger | nullvotedbooleanown_votesarray of integeroptionsarray of objectShow 2 item attributes
titlestringvotes_countinteger | nullfavouritedbooleanrebloggedbooleanbookmarkedbooleanmutedbooleanpinnedbooleanis_reblogbooleanquoteobject | nullShow 2 child attributes
statestringquoted_statusobject | nullquote_approvalobject | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Mastodon: Favourite (Hashtag)
/accounts/{accountId}/mastodon/hashtag-timeline/{itemId}/favouriteFavourite. Public posts with a hashtag (any/all/none combinations). Requires scopes: write:favourites. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/hashtag-timeline.
Try it with MCPAsk your agent to call mastodon-hashtag-timeline-favourite (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Unfavourite (Hashtag)
/accounts/{accountId}/mastodon/hashtag-timeline/{itemId}/unfavouriteUnfavourite. Public posts with a hashtag (any/all/none combinations). Requires scopes: write:favourites. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/hashtag-timeline.
Try it with MCPAsk your agent to call mastodon-hashtag-timeline-unfavourite (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Boost (Hashtag)
/accounts/{accountId}/mastodon/hashtag-timeline/{itemId}/boostBoost. Public posts with a hashtag (any/all/none combinations). Requires scopes: write:statuses. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/hashtag-timeline.
Try it with MCPAsk your agent to call mastodon-hashtag-timeline-boost (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
visibilitystringpublicunlistedprivate
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Undo boost (Hashtag)
/accounts/{accountId}/mastodon/hashtag-timeline/{itemId}/unboostUndo boost. Public posts with a hashtag (any/all/none combinations). Requires scopes: write:statuses. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/hashtag-timeline.
Try it with MCPAsk your agent to call mastodon-hashtag-timeline-unboost (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Bookmark (Hashtag)
/accounts/{accountId}/mastodon/hashtag-timeline/{itemId}/bookmarkBookmark. Public posts with a hashtag (any/all/none combinations). Requires scopes: write:bookmarks. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/hashtag-timeline.
Try it with MCPAsk your agent to call mastodon-hashtag-timeline-bookmark (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Remove bookmark (Hashtag)
/accounts/{accountId}/mastodon/hashtag-timeline/{itemId}/unbookmarkRemove bookmark. Public posts with a hashtag (any/all/none combinations). Requires scopes: write:bookmarks. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/hashtag-timeline.
Try it with MCPAsk your agent to call mastodon-hashtag-timeline-unbookmark (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Reply (Hashtag)
/accounts/{accountId}/mastodon/hashtag-timeline/{itemId}/replyReply. Public posts with a hashtag (any/all/none combinations). Requires scopes: write:statuses. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/hashtag-timeline.
Try it with MCPAsk your agent to call mastodon-hashtag-timeline-reply (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
statusstringPlain text; URLs count as 23 characters
visibilitystringpublicunlistedprivatedirect
spoiler_textstringsensitivebooleanlanguagestringISO 639-1
mediaarray of stringSocialit media ids (uploaded to the instance on publish)
media_idsarray of stringAlready-uploaded Mastodon media ids
alt_textsarray of stringAlt text per media item, by index
pollobjectShow 4 child attributes
optionsarray of string≥ 2 items
expires_inintegerdefault: 86400multiplebooleanhide_totalsbooleanin_reply_to_idstringquoted_status_idstringMastodon 4.5+
quote_approval_policystringpublicfollowersnobody
scheduled_atstring (date-time)≥ 5 minutes ahead → ScheduledStatus
threadarray of stringFollow-up replies posted as a self-thread
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Link timeline
Mastodon: List Link
/accounts/{accountId}/mastodon/link-timelinePosts sharing a trending link (4.3+). Cursor pagination: pass next_cursor back as cursor. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/link-timeline.
Try it with MCPAsk your agent to call mastodon-link-timeline-list (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringOpaque cursor from a previous next_cursor
limitintegerdefault: 201–80
urlstring (uri)requiredReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 29 item attributes
idstringrequiredread-onlyuristring (uri)urlstring (uri) | nullcreated_atstring (date-time)edited_atstring (date-time) | nulltextstringread-onlycontentstringspoiler_textstringsensitivebooleanvisibilitystringpublicunlistedprivatedirect
languagestring | nullin_reply_to_idstring | nullin_reply_to_account_idstring | nullreplies_countintegerreblogs_countintegerfavourites_countintegerquotes_countinteger | nullauthorstringauthor_namestring | nullmedia_attachmentsarray of objectShow 8 item attributes
idstringread-onlytypestringimagegifvvideoaudiounknown
urlstring (uri) | nullpreview_urlstring (uri) | nullremote_urlstring (uri) | nulldescriptionstring | nullblurhashstring | nullmetaobjectpollobject | nullShow 9 child attributes
idstringread-onlyexpires_atstring (date-time) | nullexpiredbooleanmultiplebooleanvotes_countintegervoters_countinteger | nullvotedbooleanown_votesarray of integeroptionsarray of objectShow 2 item attributes
titlestringvotes_countinteger | nullfavouritedbooleanrebloggedbooleanbookmarkedbooleanmutedbooleanpinnedbooleanis_reblogbooleanquoteobject | nullShow 2 child attributes
statestringquoted_statusobject | nullquote_approvalobject | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Mastodon: Favourite (Link)
/accounts/{accountId}/mastodon/link-timeline/{itemId}/favouriteFavourite. Posts sharing a trending link (4.3+). Requires scopes: write:favourites. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/link-timeline.
Try it with MCPAsk your agent to call mastodon-link-timeline-favourite (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Unfavourite (Link)
/accounts/{accountId}/mastodon/link-timeline/{itemId}/unfavouriteUnfavourite. Posts sharing a trending link (4.3+). Requires scopes: write:favourites. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/link-timeline.
Try it with MCPAsk your agent to call mastodon-link-timeline-unfavourite (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Boost (Link)
/accounts/{accountId}/mastodon/link-timeline/{itemId}/boostBoost. Posts sharing a trending link (4.3+). Requires scopes: write:statuses. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/link-timeline.
Try it with MCPAsk your agent to call mastodon-link-timeline-boost (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
visibilitystringpublicunlistedprivate
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Undo boost (Link)
/accounts/{accountId}/mastodon/link-timeline/{itemId}/unboostUndo boost. Posts sharing a trending link (4.3+). Requires scopes: write:statuses. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/link-timeline.
Try it with MCPAsk your agent to call mastodon-link-timeline-unboost (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Bookmark (Link)
/accounts/{accountId}/mastodon/link-timeline/{itemId}/bookmarkBookmark. Posts sharing a trending link (4.3+). Requires scopes: write:bookmarks. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/link-timeline.
Try it with MCPAsk your agent to call mastodon-link-timeline-bookmark (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Remove bookmark (Link)
/accounts/{accountId}/mastodon/link-timeline/{itemId}/unbookmarkRemove bookmark. Posts sharing a trending link (4.3+). Requires scopes: write:bookmarks. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/link-timeline.
Try it with MCPAsk your agent to call mastodon-link-timeline-unbookmark (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Reply (Link)
/accounts/{accountId}/mastodon/link-timeline/{itemId}/replyReply. Posts sharing a trending link (4.3+). Requires scopes: write:statuses. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/link-timeline.
Try it with MCPAsk your agent to call mastodon-link-timeline-reply (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
statusstringPlain text; URLs count as 23 characters
visibilitystringpublicunlistedprivatedirect
spoiler_textstringsensitivebooleanlanguagestringISO 639-1
mediaarray of stringSocialit media ids (uploaded to the instance on publish)
media_idsarray of stringAlready-uploaded Mastodon media ids
alt_textsarray of stringAlt text per media item, by index
pollobjectShow 4 child attributes
optionsarray of string≥ 2 items
expires_inintegerdefault: 86400multiplebooleanhide_totalsbooleanin_reply_to_idstringquoted_status_idstringMastodon 4.5+
quote_approval_policystringpublicfollowersnobody
scheduled_atstring (date-time)≥ 5 minutes ahead → ScheduledStatus
threadarray of stringFollow-up replies posted as a self-thread
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
List timeline
Mastodon: List List
/accounts/{accountId}/mastodon/list-timelinePosts from the members of one of your lists. Cursor pagination: pass next_cursor back as cursor. Requires scopes: read:lists. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/list-timeline.
Try it with MCPAsk your agent to call mastodon-list-timeline-list (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringOpaque cursor from a previous next_cursor
limitintegerdefault: 201–80
list_idstringrequiredReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 29 item attributes
idstringrequiredread-onlyuristring (uri)urlstring (uri) | nullcreated_atstring (date-time)edited_atstring (date-time) | nulltextstringread-onlycontentstringspoiler_textstringsensitivebooleanvisibilitystringpublicunlistedprivatedirect
languagestring | nullin_reply_to_idstring | nullin_reply_to_account_idstring | nullreplies_countintegerreblogs_countintegerfavourites_countintegerquotes_countinteger | nullauthorstringauthor_namestring | nullmedia_attachmentsarray of objectShow 8 item attributes
idstringread-onlytypestringimagegifvvideoaudiounknown
urlstring (uri) | nullpreview_urlstring (uri) | nullremote_urlstring (uri) | nulldescriptionstring | nullblurhashstring | nullmetaobjectpollobject | nullShow 9 child attributes
idstringread-onlyexpires_atstring (date-time) | nullexpiredbooleanmultiplebooleanvotes_countintegervoters_countinteger | nullvotedbooleanown_votesarray of integeroptionsarray of objectShow 2 item attributes
titlestringvotes_countinteger | nullfavouritedbooleanrebloggedbooleanbookmarkedbooleanmutedbooleanpinnedbooleanis_reblogbooleanquoteobject | nullShow 2 child attributes
statestringquoted_statusobject | nullquote_approvalobject | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Mastodon: Favourite (List)
/accounts/{accountId}/mastodon/list-timeline/{itemId}/favouriteFavourite. Posts from the members of one of your lists. Requires scopes: read:lists, write:favourites. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/list-timeline.
Try it with MCPAsk your agent to call mastodon-list-timeline-favourite (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Unfavourite (List)
/accounts/{accountId}/mastodon/list-timeline/{itemId}/unfavouriteUnfavourite. Posts from the members of one of your lists. Requires scopes: read:lists, write:favourites. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/list-timeline.
Try it with MCPAsk your agent to call mastodon-list-timeline-unfavourite (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Boost (List)
/accounts/{accountId}/mastodon/list-timeline/{itemId}/boostBoost. Posts from the members of one of your lists. Requires scopes: read:lists, write:statuses. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/list-timeline.
Try it with MCPAsk your agent to call mastodon-list-timeline-boost (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
visibilitystringpublicunlistedprivate
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Undo boost (List)
/accounts/{accountId}/mastodon/list-timeline/{itemId}/unboostUndo boost. Posts from the members of one of your lists. Requires scopes: read:lists, write:statuses. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/list-timeline.
Try it with MCPAsk your agent to call mastodon-list-timeline-unboost (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Bookmark (List)
/accounts/{accountId}/mastodon/list-timeline/{itemId}/bookmarkBookmark. Posts from the members of one of your lists. Requires scopes: read:lists, write:bookmarks. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/list-timeline.
Try it with MCPAsk your agent to call mastodon-list-timeline-bookmark (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Remove bookmark (List)
/accounts/{accountId}/mastodon/list-timeline/{itemId}/unbookmarkRemove bookmark. Posts from the members of one of your lists. Requires scopes: read:lists, write:bookmarks. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/list-timeline.
Try it with MCPAsk your agent to call mastodon-list-timeline-unbookmark (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Reply (List)
/accounts/{accountId}/mastodon/list-timeline/{itemId}/replyReply. Posts from the members of one of your lists. Requires scopes: read:lists, write:statuses. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: /v1/accounts/{accountId}/focus/list-timeline.
Try it with MCPAsk your agent to call mastodon-list-timeline-reply (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
statusstringPlain text; URLs count as 23 characters
visibilitystringpublicunlistedprivatedirect
spoiler_textstringsensitivebooleanlanguagestringISO 639-1
mediaarray of stringSocialit media ids (uploaded to the instance on publish)
media_idsarray of stringAlready-uploaded Mastodon media ids
alt_textsarray of stringAlt text per media item, by index
pollobjectShow 4 child attributes
optionsarray of string≥ 2 items
expires_inintegerdefault: 86400multiplebooleanhide_totalsbooleanin_reply_to_idstringquoted_status_idstringMastodon 4.5+
quote_approval_policystringpublicfollowersnobody
scheduled_atstring (date-time)≥ 5 minutes ahead → ScheduledStatus
threadarray of stringFollow-up replies posted as a self-thread
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Trends tags
Mastodon: List Trending hashtags
/accounts/{accountId}/mastodon/trends-tagsCursor pagination: pass next_cursor back as cursor. Network docs: https://docs.joinmastodon.org/methods/trends/#tags Generic route: /v1/accounts/{accountId}/focus/trends-tags.
Try it with MCPAsk your agent to call mastodon-trends-tags-list (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 10≤ 20
cursorstringReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 6 item attributes
idstring | nullnamestringurlstring (uri)followingboolean | nullfeaturingboolean | nullhistoryarray of objectShow 3 item attributes
daystringusesstringaccountsstringlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Mastodon: Follow hashtag (Trending hashtags)
/accounts/{accountId}/mastodon/trends-tags/{itemId}/followFollow hashtag. Requires scopes: write:follows. Network docs: https://docs.joinmastodon.org/methods/trends/#tags Generic route: /v1/accounts/{accountId}/focus/trends-tags.
Try it with MCPAsk your agent to call mastodon-trends-tags-follow (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Trends statuses
Mastodon: List Trending posts
/accounts/{accountId}/mastodon/trends-statusesCursor pagination: pass next_cursor back as cursor. Network docs: https://docs.joinmastodon.org/methods/trends/#statuses Generic route: /v1/accounts/{accountId}/focus/trends-statuses.
Try it with MCPAsk your agent to call mastodon-trends-statuses-list (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 20≤ 40
cursorstringReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 29 item attributes
idstringrequiredread-onlyuristring (uri)urlstring (uri) | nullcreated_atstring (date-time)edited_atstring (date-time) | nulltextstringread-onlycontentstringspoiler_textstringsensitivebooleanvisibilitystringpublicunlistedprivatedirect
languagestring | nullin_reply_to_idstring | nullin_reply_to_account_idstring | nullreplies_countintegerreblogs_countintegerfavourites_countintegerquotes_countinteger | nullauthorstringauthor_namestring | nullmedia_attachmentsarray of objectShow 8 item attributes
idstringread-onlytypestringimagegifvvideoaudiounknown
urlstring (uri) | nullpreview_urlstring (uri) | nullremote_urlstring (uri) | nulldescriptionstring | nullblurhashstring | nullmetaobjectpollobject | nullShow 9 child attributes
idstringread-onlyexpires_atstring (date-time) | nullexpiredbooleanmultiplebooleanvotes_countintegervoters_countinteger | nullvotedbooleanown_votesarray of integeroptionsarray of objectShow 2 item attributes
titlestringvotes_countinteger | nullfavouritedbooleanrebloggedbooleanbookmarkedbooleanmutedbooleanpinnedbooleanis_reblogbooleanquoteobject | nullShow 2 child attributes
statestringquoted_statusobject | nullquote_approvalobject | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Mastodon: Favourite (Trending posts)
/accounts/{accountId}/mastodon/trends-statuses/{itemId}/favouriteFavourite. Requires scopes: write:favourites. Network docs: https://docs.joinmastodon.org/methods/trends/#statuses Generic route: /v1/accounts/{accountId}/focus/trends-statuses.
Try it with MCPAsk your agent to call mastodon-trends-statuses-favourite (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Unfavourite (Trending posts)
/accounts/{accountId}/mastodon/trends-statuses/{itemId}/unfavouriteUnfavourite. Requires scopes: write:favourites. Network docs: https://docs.joinmastodon.org/methods/trends/#statuses Generic route: /v1/accounts/{accountId}/focus/trends-statuses.
Try it with MCPAsk your agent to call mastodon-trends-statuses-unfavourite (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Boost (Trending posts)
/accounts/{accountId}/mastodon/trends-statuses/{itemId}/boostBoost. Requires scopes: write:statuses. Network docs: https://docs.joinmastodon.org/methods/trends/#statuses Generic route: /v1/accounts/{accountId}/focus/trends-statuses.
Try it with MCPAsk your agent to call mastodon-trends-statuses-boost (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
visibilitystringpublicunlistedprivate
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Undo boost (Trending posts)
/accounts/{accountId}/mastodon/trends-statuses/{itemId}/unboostUndo boost. Requires scopes: write:statuses. Network docs: https://docs.joinmastodon.org/methods/trends/#statuses Generic route: /v1/accounts/{accountId}/focus/trends-statuses.
Try it with MCPAsk your agent to call mastodon-trends-statuses-unboost (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Bookmark (Trending posts)
/accounts/{accountId}/mastodon/trends-statuses/{itemId}/bookmarkBookmark. Requires scopes: write:bookmarks. Network docs: https://docs.joinmastodon.org/methods/trends/#statuses Generic route: /v1/accounts/{accountId}/focus/trends-statuses.
Try it with MCPAsk your agent to call mastodon-trends-statuses-bookmark (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Remove bookmark (Trending posts)
/accounts/{accountId}/mastodon/trends-statuses/{itemId}/unbookmarkRemove bookmark. Requires scopes: write:bookmarks. Network docs: https://docs.joinmastodon.org/methods/trends/#statuses Generic route: /v1/accounts/{accountId}/focus/trends-statuses.
Try it with MCPAsk your agent to call mastodon-trends-statuses-unbookmark (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Reply (Trending posts)
/accounts/{accountId}/mastodon/trends-statuses/{itemId}/replyReply. Requires scopes: write:statuses. Network docs: https://docs.joinmastodon.org/methods/trends/#statuses Generic route: /v1/accounts/{accountId}/focus/trends-statuses.
Try it with MCPAsk your agent to call mastodon-trends-statuses-reply (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
statusstringPlain text; URLs count as 23 characters
visibilitystringpublicunlistedprivatedirect
spoiler_textstringsensitivebooleanlanguagestringISO 639-1
mediaarray of stringSocialit media ids (uploaded to the instance on publish)
media_idsarray of stringAlready-uploaded Mastodon media ids
alt_textsarray of stringAlt text per media item, by index
pollobjectShow 4 child attributes
optionsarray of string≥ 2 items
expires_inintegerdefault: 86400multiplebooleanhide_totalsbooleanin_reply_to_idstringquoted_status_idstringMastodon 4.5+
quote_approval_policystringpublicfollowersnobody
scheduled_atstring (date-time)≥ 5 minutes ahead → ScheduledStatus
threadarray of stringFollow-up replies posted as a self-thread
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Trends links
Mastodon: List Trending links
/accounts/{accountId}/mastodon/trends-linksCursor pagination: pass next_cursor back as cursor. Network docs: https://docs.joinmastodon.org/methods/trends/#links Generic route: /v1/accounts/{accountId}/focus/trends-links.
Try it with MCPAsk your agent to call mastodon-trends-links-list (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 10≤ 20
cursorstringReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 9 item attributes
urlstring (uri)requiredtitlestringdescriptionstringtypestringlinkphotovideorich
provider_namestringauthor_namestringimagestring (uri) | nullpublished_atstring (date-time) | nullhistoryarray of objectShow 3 item attributes
daystringusesstringaccountsstringlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Search
Mastodon: List Search
/accounts/{accountId}/mastodon/searchSearch accounts, posts and hashtags. resolve=true imports a remote post or account by URL / handle. Cursor pagination: pass next_cursor back as cursor. Requires scopes: read:search. Network docs: https://docs.joinmastodon.org/methods/search/ Generic route: /v1/accounts/{accountId}/focus/search.
Try it with MCPAsk your agent to call mastodon-search-list (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
qstringrequiredtypestringaccountsstatuseshashtags
resolvebooleanfollowingbooleanaccount_idstringexclude_unreviewedbooleanlimitintegerdefault: 20≤ 40
cursorstringoffset=
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 7 item attributes
idstringrequiredkindstringrequiredaccountstatushashtag
titlestringurlstring (uri) | nullaccountobject | nullShow 23 child attributes
idstringrequiredread-onlyacctstringrequiredusernamestringdisplay_namestringurlstring (uri)avatarstringheaderstringnotestringnote_textstringlockedbooleanbotbooleangroupbooleandiscoverableboolean | nullindexableboolean | nullfollowers_countintegerfollowing_countintegerstatuses_countintegercreated_atstring (date-time)last_status_atstring (date) | nullfieldsarray of objectShow 3 item attributes
namestringvaluestringverified_atstring (date-time) | nullmovedobject | nullsuspendedbooleanlimitedbooleanstatusobject | nullShow 29 child attributes
idstringrequiredread-onlyuristring (uri)urlstring (uri) | nullcreated_atstring (date-time)edited_atstring (date-time) | nulltextstringread-onlycontentstringspoiler_textstringsensitivebooleanvisibilitystringpublicunlistedprivatedirect
languagestring | nullin_reply_to_idstring | nullin_reply_to_account_idstring | nullreplies_countintegerreblogs_countintegerfavourites_countintegerquotes_countinteger | nullauthorstringauthor_namestring | nullmedia_attachmentsarray of objectShow 8 item attributes
idstringread-onlytypestringimagegifvvideoaudiounknown
urlstring (uri) | nullpreview_urlstring (uri) | nullremote_urlstring (uri) | nulldescriptionstring | nullblurhashstring | nullmetaobjectpollobject | nullShow 9 child attributes
idstringread-onlyexpires_atstring (date-time) | nullexpiredbooleanmultiplebooleanvotes_countintegervoters_countinteger | nullvotedbooleanown_votesarray of integeroptionsarray of objectShow 2 item attributes
titlestringvotes_countinteger | nullfavouritedbooleanrebloggedbooleanbookmarkedbooleanmutedbooleanpinnedbooleanis_reblogbooleanquoteobject | nullShow 2 child attributes
statestringquoted_statusobject | nullquote_approvalobject | nullhashtagobject | nullShow 6 child attributes
idstring | nullnamestringurlstring (uri)followingboolean | nullfeaturingboolean | nullhistoryarray of objectShow 3 item attributes
daystringusesstringaccountsstringlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Tags
Mastodon: Get a Hashtags item
/accounts/{accountId}/mastodon/tags/{itemId}Hashtag details; follow or feature it on your profile. Network docs: https://docs.joinmastodon.org/methods/tags/ Generic route: /v1/accounts/{accountId}/focus/tags.
Try it with MCPAsk your agent to call mastodon-tags-get (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstring | nullnamestringurlstring (uri)followingboolean | nullfeaturingboolean | nullhistoryarray of objectShow 3 item attributes
daystringusesstringaccountsstringResponses
Mastodon: Follow (Hashtags)
/accounts/{accountId}/mastodon/tags/{itemId}/followFollow. Hashtag details; follow or feature it on your profile. Requires scopes: write:follows. Network docs: https://docs.joinmastodon.org/methods/tags/ Generic route: /v1/accounts/{accountId}/focus/tags.
Try it with MCPAsk your agent to call mastodon-tags-follow (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Unfollow (Hashtags)
/accounts/{accountId}/mastodon/tags/{itemId}/unfollowUnfollow. Hashtag details; follow or feature it on your profile. Requires scopes: write:follows. Network docs: https://docs.joinmastodon.org/methods/tags/ Generic route: /v1/accounts/{accountId}/focus/tags.
Try it with MCPAsk your agent to call mastodon-tags-unfollow (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Feature on profile (Hashtags)
/accounts/{accountId}/mastodon/tags/{itemId}/featureFeature on profile. Hashtag details; follow or feature it on your profile. Requires scopes: write:accounts. Network docs: https://docs.joinmastodon.org/methods/tags/ Generic route: /v1/accounts/{accountId}/focus/tags.
Try it with MCPAsk your agent to call mastodon-tags-feature (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Unfeature (Hashtags)
/accounts/{accountId}/mastodon/tags/{itemId}/unfeatureUnfeature. Hashtag details; follow or feature it on your profile. Requires scopes: write:accounts. Network docs: https://docs.joinmastodon.org/methods/tags/ Generic route: /v1/accounts/{accountId}/focus/tags.
Try it with MCPAsk your agent to call mastodon-tags-unfeature (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Blocks
Mastodon: List Blocked accounts
/accounts/{accountId}/mastodon/blocksCursor pagination: pass next_cursor back as cursor. Requires scopes: read:blocks. Network docs: https://docs.joinmastodon.org/methods/blocks/ Generic route: /v1/accounts/{accountId}/focus/blocks.
Try it with MCPAsk your agent to call mastodon-blocks-list (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringOpaque cursor from a previous next_cursor
limitintegerdefault: 201–80
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 23 item attributes
idstringrequiredread-onlyacctstringrequiredusernamestringdisplay_namestringurlstring (uri)avatarstringheaderstringnotestringnote_textstringlockedbooleanbotbooleangroupbooleandiscoverableboolean | nullindexableboolean | nullfollowers_countintegerfollowing_countintegerstatuses_countintegercreated_atstring (date-time)last_status_atstring (date) | nullfieldsarray of objectShow 3 item attributes
namestringvaluestringverified_atstring (date-time) | nullmovedobject | nullsuspendedbooleanlimitedbooleanlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Mastodon: Create a Blocked accounts item
/accounts/{accountId}/mastodon/blocksRequires scopes: read:blocks, write:blocks. Network docs: https://docs.joinmastodon.org/methods/blocks/ Generic route: /v1/accounts/{accountId}/focus/blocks.
Try it with MCPAsk your agent to call mastodon-blocks-create (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
account_idstringrequiredReturns object
idstringrequiredread-onlyacctstringrequiredusernamestringdisplay_namestringurlstring (uri)avatarstringheaderstringnotestringnote_textstringlockedbooleanbotbooleangroupbooleandiscoverableboolean | nullindexableboolean | nullfollowers_countintegerfollowing_countintegerstatuses_countintegercreated_atstring (date-time)last_status_atstring (date) | nullfieldsarray of objectShow 3 item attributes
namestringvaluestringverified_atstring (date-time) | nullmovedobject | nullsuspendedbooleanlimitedbooleanResponses
Mastodon: Delete a Blocked accounts item
/accounts/{accountId}/mastodon/blocks/{itemId}Unblock. Requires scopes: read:blocks, write:blocks. Network docs: https://docs.joinmastodon.org/methods/blocks/ Generic route: /v1/accounts/{accountId}/focus/blocks.
Try it with MCPAsk your agent to call mastodon-blocks-delete (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Mutes
Mastodon: List Muted accounts
/accounts/{accountId}/mastodon/mutesCursor pagination: pass next_cursor back as cursor. Requires scopes: read:mutes. Network docs: https://docs.joinmastodon.org/methods/mutes/ Generic route: /v1/accounts/{accountId}/focus/mutes.
Try it with MCPAsk your agent to call mastodon-mutes-list (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringOpaque cursor from a previous next_cursor
limitintegerdefault: 201–80
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 24 item attributes
idstringrequiredread-onlyacctstringusernamestringdisplay_namestringurlstring (uri)avatarstringheaderstringnotestringnote_textstringlockedbooleanbotbooleangroupbooleandiscoverableboolean | nullindexableboolean | nullfollowers_countintegerfollowing_countintegerstatuses_countintegercreated_atstring (date-time)last_status_atstring (date) | nullfieldsarray of objectShow 3 item attributes
namestringvaluestringverified_atstring (date-time) | nullmovedobject | nullsuspendedbooleanlimitedbooleanmute_expires_atstring (date-time) | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Mastodon: Create a Muted accounts item
/accounts/{accountId}/mastodon/mutesRequires scopes: read:mutes, write:mutes. Network docs: https://docs.joinmastodon.org/methods/mutes/ Generic route: /v1/accounts/{accountId}/focus/mutes.
Try it with MCPAsk your agent to call mastodon-mutes-create (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
account_idstringrequirednotificationsbooleandefault: truedurationintegerSeconds; 0 = indefinite
Returns object
idstringrequiredread-onlyacctstringusernamestringdisplay_namestringurlstring (uri)avatarstringheaderstringnotestringnote_textstringlockedbooleanbotbooleangroupbooleandiscoverableboolean | nullindexableboolean | nullfollowers_countintegerfollowing_countintegerstatuses_countintegercreated_atstring (date-time)last_status_atstring (date) | nullfieldsarray of objectShow 3 item attributes
namestringvaluestringverified_atstring (date-time) | nullmovedobject | nullsuspendedbooleanlimitedbooleanmute_expires_atstring (date-time) | nullResponses
Mastodon: Delete a Muted accounts item
/accounts/{accountId}/mastodon/mutes/{itemId}Unmute. Requires scopes: read:mutes, write:mutes. Network docs: https://docs.joinmastodon.org/methods/mutes/ Generic route: /v1/accounts/{accountId}/focus/mutes.
Try it with MCPAsk your agent to call mastodon-mutes-delete (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Domain blocks
Mastodon: List Blocked servers
/accounts/{accountId}/mastodon/domain-blocksHide everything from a domain and remove its followers. Cursor pagination: pass next_cursor back as cursor. Requires scopes: read:blocks. Network docs: https://docs.joinmastodon.org/methods/domain_blocks/ Generic route: /v1/accounts/{accountId}/focus/domain-blocks.
Try it with MCPAsk your agent to call mastodon-domain-blocks-list (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringOpaque cursor from a previous next_cursor
limitintegerdefault: 201–80
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 2 item attributes
idstringdomainstringrequiredlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Mastodon: Create a Blocked servers item
/accounts/{accountId}/mastodon/domain-blocksHide everything from a domain and remove its followers. Requires scopes: read:blocks, write:blocks. Network docs: https://docs.joinmastodon.org/methods/domain_blocks/ Generic route: /v1/accounts/{accountId}/focus/domain-blocks.
Try it with MCPAsk your agent to call mastodon-domain-blocks-create (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
domainstringrequiredReturns object
idstringdomainstringrequiredResponses
Mastodon: Delete a Blocked servers item
/accounts/{accountId}/mastodon/domain-blocks/{itemId}Hide everything from a domain and remove its followers. Requires scopes: read:blocks, write:blocks. Network docs: https://docs.joinmastodon.org/methods/domain_blocks/ Generic route: /v1/accounts/{accountId}/focus/domain-blocks.
Try it with MCPAsk your agent to call mastodon-domain-blocks-delete (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Reports
Mastodon: Create a Report item
/accounts/{accountId}/mastodon/reportsReport an account, posts or collections to moderators (400 / 24 h). Rule ids come from Server › Rules. Requires scopes: write:reports. Network docs: https://docs.joinmastodon.org/methods/reports/ Generic route: /v1/accounts/{accountId}/focus/reports.
Try it with MCPAsk your agent to call mastodon-reports-create (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
account_idstringrequiredstatus_idsarray of stringcollection_idsarray of stringcommentstringforwardbooleanforward_to_domainsarray of stringcategorystringspamlegalviolationother
rule_idsarray of stringReturns object
idstringread-onlyaccount_idstringrequiredstatus_idsarray of stringcollection_idsarray of stringcommentstring≤ 1000 characters
forwardbooleanAlso send to the remote server
forward_to_domainsarray of stringcategorystringspamlegalviolationother
rule_idsarray of stringaction_takenbooleanread-onlycreated_atstring (date-time)read-onlyResponses
Profile
Mastodon: Get Profile
/accounts/{accountId}/mastodon/profileYour public profile, posting defaults and the bot flag (many servers require it for automated accounts). Requires one of: profile | read:accounts. Network docs: https://docs.joinmastodon.org/methods/profile/ Generic route: /v1/accounts/{accountId}/focus/profile.
Try it with MCPAsk your agent to call mastodon-profile-get (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
idstringrequiredread-onlyacctstringusernamestringdisplay_namestringurlstring (uri)avatarstringheaderstringnotestringnote_textstringlockedbooleanbotbooleangroupbooleandiscoverableboolean | nullindexableboolean | nullfollowers_countintegerfollowing_countintegerstatuses_countintegercreated_atstring (date-time)last_status_atstring (date) | nullfieldsarray of objectShow 3 item attributes
namestringvaluestringverified_atstring (date-time) | nullmovedobject | nullsuspendedbooleanlimitedbooleanavatar_descriptionstring | null4.6+
header_descriptionstring | null4.6+
hide_collectionsboolean | nullshow_mediaboolean | nullshow_media_repliesboolean | nullshow_featuredboolean | nullattribution_domainsarray of string | null≤ 10 items
sourceobjectShow 6 child attributes
privacystringpublicunlistedprivatedirect
sensitivebooleanlanguagestring | nullnotestringfieldsarray of objectShow 2 item attributes
namestringvaluestringquote_policystring | nullpublicfollowersnobody
Responses
Mastodon: Update Profile
/accounts/{accountId}/mastodon/profilePATCH /api/v1/profile (4.6+) or /api/v1/accounts/update_credentials. Your public profile, posting defaults and the bot flag (many servers require it for automated accounts). Requires scopes: write:accounts. Requires one of: profile | read:accounts. Network docs: https://docs.joinmastodon.org/methods/profile/ Generic route: /v1/accounts/{accountId}/focus/profile.
Try it with MCPAsk your agent to call mastodon-profile-update (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Body object
display_namestringconfiguration.accounts.max_display_name_length (40 on 4.6+)
notestringmax_note_length (500)
avatarstringImage (Socialit media id)
avatar_descriptionstringheaderstringheader_descriptionstringlockedbooleanbotbooleandiscoverablebooleanindexablebooleanhide_collectionsbooleanshow_mediabooleanshow_media_repliesbooleanshow_featuredbooleanattribution_domainsarray of string≤ 10 items
fields_attributesarray of object≤ 4 items
Show 2 item attributes
namestringvaluestringsourceobjectShow 4 child attributes
privacystringpublicunlistedprivate
sensitivebooleanlanguagestringquote_policystringpublicfollowersnobody
Returns object
idstringrequiredread-onlyacctstringusernamestringdisplay_namestringurlstring (uri)avatarstringheaderstringnotestringnote_textstringlockedbooleanbotbooleangroupbooleandiscoverableboolean | nullindexableboolean | nullfollowers_countintegerfollowing_countintegerstatuses_countintegercreated_atstring (date-time)last_status_atstring (date) | nullfieldsarray of objectShow 3 item attributes
namestringvaluestringverified_atstring (date-time) | nullmovedobject | nullsuspendedbooleanlimitedbooleanavatar_descriptionstring | null4.6+
header_descriptionstring | null4.6+
hide_collectionsboolean | nullshow_mediaboolean | nullshow_media_repliesboolean | nullshow_featuredboolean | nullattribution_domainsarray of string | null≤ 10 items
sourceobjectShow 6 child attributes
privacystringpublicunlistedprivatedirect
sensitivebooleanlanguagestring | nullnotestringfieldsarray of objectShow 2 item attributes
namestringvaluestringquote_policystring | nullpublicfollowersnobody
Responses
Mastodon: Remove avatar (Profile)
/accounts/{accountId}/mastodon/profile/delete-avatarRemove avatar. Your public profile, posting defaults and the bot flag (many servers require it for automated accounts). Destructive. Requires scopes: write:accounts. Requires one of: profile | read:accounts. Network docs: https://docs.joinmastodon.org/methods/profile/ Generic route: /v1/accounts/{accountId}/focus/profile.
Try it with MCPAsk your agent to call mastodon-profile-delete-avatar (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Remove header (Profile)
/accounts/{accountId}/mastodon/profile/delete-headerRemove header. Your public profile, posting defaults and the bot flag (many servers require it for automated accounts). Destructive. Requires scopes: write:accounts. Requires one of: profile | read:accounts. Network docs: https://docs.joinmastodon.org/methods/profile/ Generic route: /v1/accounts/{accountId}/focus/profile.
Try it with MCPAsk your agent to call mastodon-profile-delete-header (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Preferences
Mastodon: Get Preferences
/accounts/{accountId}/mastodon/preferencesPosting defaults (visibility, sensitivity, language, quote policy) and reading preferences. Requires scopes: read:accounts. Network docs: https://docs.joinmastodon.org/methods/preferences/ Generic route: /v1/accounts/{accountId}/focus/preferences.
Try it with MCPAsk your agent to call mastodon-preferences-get (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
posting:default:visibilitystringpublicunlistedprivatedirect
posting:default:sensitivebooleanposting:default:languagestring | nullposting:default:quote_policystring | nullpublicfollowersnobody
reading:expand:mediastringdefaultshow_allhide_all
reading:expand:spoilersbooleanResponses
Annual reports
Mastodon: List Year in review
/accounts/{accountId}/mastodon/annual-reportsWrapstodon annual reports (available Dec 10–31 when the server enables them). Cursor pagination: pass next_cursor back as cursor. Requires scopes: read:accounts. Network docs: https://docs.joinmastodon.org/methods/annual_reports/ Generic route: /v1/accounts/{accountId}/focus/annual-reports.
Try it with MCPAsk your agent to call mastodon-annual-reports-list (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 4 item attributes
idstringyearintegerrequiredschema_versionintegerdataobjectlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Mastodon: Get a Year in review item
/accounts/{accountId}/mastodon/annual-reports/{itemId}Wrapstodon annual reports (available Dec 10–31 when the server enables them). Requires scopes: read:accounts. Network docs: https://docs.joinmastodon.org/methods/annual_reports/ Generic route: /v1/accounts/{accountId}/focus/annual-reports.
Try it with MCPAsk your agent to call mastodon-annual-reports-get (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringyearintegerrequiredschema_versionintegerdataobjectResponses
Mastodon: Mark as read (Year in review)
/accounts/{accountId}/mastodon/annual-reports/{itemId}/mark-readMark as read. Wrapstodon annual reports (available Dec 10–31 when the server enables them). Requires scopes: read:accounts, write:accounts. Network docs: https://docs.joinmastodon.org/methods/annual_reports/ Generic route: /v1/accounts/{accountId}/focus/annual-reports.
Try it with MCPAsk your agent to call mastodon-annual-reports-mark-read (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Generate (Year in review)
/accounts/{accountId}/mastodon/annual-reports/{itemId}/generateGenerate. Wrapstodon annual reports (available Dec 10–31 when the server enables them). Requires scopes: read:accounts, write:accounts. Network docs: https://docs.joinmastodon.org/methods/annual_reports/ Generic route: /v1/accounts/{accountId}/focus/annual-reports.
Try it with MCPAsk your agent to call mastodon-annual-reports-generate (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Generation state (Year in review)
/accounts/{accountId}/mastodon/annual-reports/{itemId}/stateGeneration state. Wrapstodon annual reports (available Dec 10–31 when the server enables them). Requires scopes: read:accounts. Network docs: https://docs.joinmastodon.org/methods/annual_reports/ Generic route: /v1/accounts/{accountId}/focus/annual-reports.
Try it with MCPAsk your agent to call mastodon-annual-reports-state (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Push subscription
Mastodon: Get Push subscription
/accounts/{accountId}/mastodon/push-subscriptionWeb Push subscription of this token (one per token; creating replaces it). Socialit uses it as a webhook. Requires scopes: push. Network docs: https://docs.joinmastodon.org/methods/push/ Generic route: /v1/accounts/{accountId}/focus/push-subscription.
Try it with MCPAsk your agent to call mastodon-push-subscription-get (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
idstringread-onlyendpointstring (uri)standardbooleanRFC 8291 aes128gcm (4.4+)
policystringallfollowedfollowernone
server_keystringread-onlyalertsobjectShow 12 child attributes
mentionbooleanstatusbooleanreblogbooleanfollowbooleanfollow_requestbooleanfavouritebooleanpollbooleanupdatebooleanquotebooleanquoted_updatebooleanadmin.sign_upbooleanadmin.reportbooleanResponses
Mastodon: Create a Push subscription item
/accounts/{accountId}/mastodon/push-subscriptionWeb Push subscription of this token (one per token; creating replaces it). Socialit uses it as a webhook. Requires scopes: push. Network docs: https://docs.joinmastodon.org/methods/push/ Generic route: /v1/accounts/{accountId}/focus/push-subscription.
Try it with MCPAsk your agent to call mastodon-push-subscription-create (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
endpointstring (uri)requiredkeysobjectrequiredShow 2 child attributes
p256dhstringrequiredauthstringrequiredalertsobjectShow 12 child attributes
mentionbooleanstatusbooleanreblogbooleanfollowbooleanfollow_requestbooleanfavouritebooleanpollbooleanupdatebooleanquotebooleanquoted_updatebooleanadmin.sign_upbooleanadmin.reportbooleanpolicystringallfollowedfollowernone
standardbooleandefault: trueReturns object
idstringread-onlyendpointstring (uri)standardbooleanRFC 8291 aes128gcm (4.4+)
policystringallfollowedfollowernone
server_keystringread-onlyalertsobjectShow 12 child attributes
mentionbooleanstatusbooleanreblogbooleanfollowbooleanfollow_requestbooleanfavouritebooleanpollbooleanupdatebooleanquotebooleanquoted_updatebooleanadmin.sign_upbooleanadmin.reportbooleanResponses
Mastodon: Update Push subscription
/accounts/{accountId}/mastodon/push-subscriptionWeb Push subscription of this token (one per token; creating replaces it). Socialit uses it as a webhook. Requires scopes: push. Network docs: https://docs.joinmastodon.org/methods/push/ Generic route: /v1/accounts/{accountId}/focus/push-subscription.
Try it with MCPAsk your agent to call mastodon-push-subscription-update (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Body object
alertsobjectShow 12 child attributes
mentionbooleanstatusbooleanreblogbooleanfollowbooleanfollow_requestbooleanfavouritebooleanpollbooleanupdatebooleanquotebooleanquoted_updatebooleanadmin.sign_upbooleanadmin.reportbooleanpolicystringallfollowedfollowernone
Returns object
idstringread-onlyendpointstring (uri)standardbooleanRFC 8291 aes128gcm (4.4+)
policystringallfollowedfollowernone
server_keystringread-onlyalertsobjectShow 12 child attributes
mentionbooleanstatusbooleanreblogbooleanfollowbooleanfollow_requestbooleanfavouritebooleanpollbooleanupdatebooleanquotebooleanquoted_updatebooleanadmin.sign_upbooleanadmin.reportbooleanResponses
Mastodon: Delete Push subscription
/accounts/{accountId}/mastodon/push-subscriptionWeb Push subscription of this token (one per token; creating replaces it). Socialit uses it as a webhook. Requires scopes: push. Network docs: https://docs.joinmastodon.org/methods/push/ Generic route: /v1/accounts/{accountId}/focus/push-subscription.
Try it with MCPAsk your agent to call mastodon-push-subscription-delete (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Instance
Mastodon: Get Server
/accounts/{accountId}/mastodon/instanceServer info, limits (characters, media, polls), API level, registrations, contact. Network docs: https://docs.joinmastodon.org/methods/instance/#v2 Generic route: /v1/accounts/{accountId}/focus/instance.
Try it with MCPAsk your agent to call mastodon-instance-get (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
domainstringrequiredtitlestringversionstringdescriptionstringsource_urlstring (uri) | nulllanguagesarray of stringapi_versionsobjectShow 1 child attributes
mastodonintegerlimitsobjectread-onlyconfigurationobjectregistrationsobjectShow 3 child attributes
enabledbooleanapproval_requiredbooleanmessagestring | nullcontactobjectShow 2 child attributes
emailstring | nullaccountobject | nullResponses
Instance rules
Mastodon: List Server rules
/accounts/{accountId}/mastodon/instance-rulesRules every post must follow (check automation / bot rules). Cursor pagination: pass next_cursor back as cursor. Network docs: https://docs.joinmastodon.org/methods/instance/#rules Generic route: /v1/accounts/{accountId}/focus/instance-rules.
Try it with MCPAsk your agent to call mastodon-instance-rules-list (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 4 item attributes
idstringrequiredtextstringrequiredhintstring | nulltranslationsobject | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Terms of service
Mastodon: Get Terms of service
/accounts/{accountId}/mastodon/terms-of-serviceNetwork docs: https://docs.joinmastodon.org/methods/instance/#terms_of_service Generic route: /v1/accounts/{accountId}/focus/terms-of-service.
Try it with MCPAsk your agent to call mastodon-terms-of-service-get (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
updated_atstring (date-time) | nullcontentstringeffective_datestring (date) | nullResponses
Privacy policy
Mastodon: Get Privacy policy
/accounts/{accountId}/mastodon/privacy-policyNetwork docs: https://docs.joinmastodon.org/methods/instance/#privacy_policy Generic route: /v1/accounts/{accountId}/focus/privacy-policy.
Try it with MCPAsk your agent to call mastodon-privacy-policy-get (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
updated_atstring (date-time) | nullcontentstringeffective_datestring (date) | nullResponses
Extended description
Mastodon: Get About this server
/accounts/{accountId}/mastodon/extended-descriptionNetwork docs: https://docs.joinmastodon.org/methods/instance/#extended_description Generic route: /v1/accounts/{accountId}/focus/extended-description.
Try it with MCPAsk your agent to call mastodon-extended-description-get (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
updated_atstring (date-time) | nullcontentstringeffective_datestring (date) | nullResponses
Instance peers
Mastodon: List Known servers
/accounts/{accountId}/mastodon/instance-peersDomains this server has federated with (admins may disable it). Cursor pagination: pass next_cursor back as cursor. Network docs: https://docs.joinmastodon.org/methods/instance/#peers Generic route: /v1/accounts/{accountId}/focus/instance-peers.
Try it with MCPAsk your agent to call mastodon-instance-peers-list (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 2 item attributes
idstringdomainstringrequiredlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Instance activity
Mastodon: List Server activity
/accounts/{accountId}/mastodon/instance-activityWeekly posts, logins and registrations (last 12 weeks). Cursor pagination: pass next_cursor back as cursor. Network docs: https://docs.joinmastodon.org/methods/instance/#activity Generic route: /v1/accounts/{accountId}/focus/instance-activity.
Try it with MCPAsk your agent to call mastodon-instance-activity-list (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 5 item attributes
idstringweekstring (date)requiredstatusesintegerloginsintegerregistrationsintegerlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Instance domain blocks
Mastodon: List Moderated servers
/accounts/{accountId}/mastodon/instance-domain-blocksServers this instance limits or suspends (when published by the admins). Cursor pagination: pass next_cursor back as cursor. Network docs: https://docs.joinmastodon.org/methods/instance/#domain_blocks Generic route: /v1/accounts/{accountId}/focus/instance-domain-blocks.
Try it with MCPAsk your agent to call mastodon-instance-domain-blocks-list (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 4 item attributes
domainstringrequireddigeststringseveritystringsilencesuspend
commentstring | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Translation languages
Mastodon: List Translation languages
/accounts/{accountId}/mastodon/translation-languagesCursor pagination: pass next_cursor back as cursor. Network docs: https://docs.joinmastodon.org/methods/instance/#translation_languages Generic route: /v1/accounts/{accountId}/focus/translation-languages.
Try it with MCPAsk your agent to call mastodon-translation-languages-list (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 3 item attributes
idstringsourcestringrequiredtargetsarray of stringlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Custom emojis
Mastodon: List Custom emoji
/accounts/{accountId}/mastodon/custom-emojisCursor pagination: pass next_cursor back as cursor. Network docs: https://docs.joinmastodon.org/methods/custom_emojis/ Generic route: /v1/accounts/{accountId}/focus/custom-emojis.
Try it with MCPAsk your agent to call mastodon-custom-emojis-list (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 5 item attributes
shortcodestringrequiredurlstring (uri)static_urlstring (uri)visible_in_pickerbooleancategorystring | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Announcements
Mastodon: List Announcements
/accounts/{accountId}/mastodon/announcementsServer announcements; dismiss or react. Cursor pagination: pass next_cursor back as cursor. Network docs: https://docs.joinmastodon.org/methods/announcements/ Generic route: /v1/accounts/{accountId}/focus/announcements.
Try it with MCPAsk your agent to call mastodon-announcements-list (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
with_dismissedbooleanReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 7 item attributes
idstringrequiredcontentstringstarts_atstring (date-time) | nullends_atstring (date-time) | nullpublished_atstring (date-time)readbooleanreactionsarray of objectShow 3 item attributes
namestringcountintegermebooleanlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Mastodon: Dismiss (Announcements)
/accounts/{accountId}/mastodon/announcements/{itemId}/dismissDismiss. Server announcements; dismiss or react. Requires scopes: write:accounts. Network docs: https://docs.joinmastodon.org/methods/announcements/ Generic route: /v1/accounts/{accountId}/focus/announcements.
Try it with MCPAsk your agent to call mastodon-announcements-dismiss (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: React (Announcements)
/accounts/{accountId}/mastodon/announcements/{itemId}/reactReact. Server announcements; dismiss or react. Requires scopes: write:favourites. Network docs: https://docs.joinmastodon.org/methods/announcements/ Generic route: /v1/accounts/{accountId}/focus/announcements.
Try it with MCPAsk your agent to call mastodon-announcements-react (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
namestringrequiredUnicode emoji or custom shortcode
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Remove reaction (Announcements)
/accounts/{accountId}/mastodon/announcements/{itemId}/unreactRemove reaction. Server announcements; dismiss or react. Requires scopes: write:favourites. Network docs: https://docs.joinmastodon.org/methods/announcements/ Generic route: /v1/accounts/{accountId}/focus/announcements.
Try it with MCPAsk your agent to call mastodon-announcements-unreact (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
namestringrequiredReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Account overview
Mastodon: List Account overview
/accounts/{accountId}/mastodon/account-overviewDaily engagement on posts created in the window (favourites, replies, boosts, quotes) plus current followers. Mastodon keeps no history, so engagement is attributed to the post’s creation day. Cursor pagination: pass next_cursor back as cursor. Requires scopes: read:accounts, read:statuses. Network docs: https://docs.joinmastodon.org/methods/accounts/#statuses Generic route: /v1/accounts/{accountId}/focus/account-overview.
Try it with MCPAsk your agent to call mastodon-account-overview-list (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
sincestring (date)Default: 30 days ago
untilstring (date)Default: today
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 9 item attributes
datestring (date)requiredpostsintegerlikesintegercommentsintegersharesintegerquotesintegerengagementsintegerfollowersinteger | nullfollowinginteger | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Post performance
Mastodon: List Post performance
/accounts/{accountId}/mastodon/post-performanceYour posts in the window ranked by engagements (favourites + replies + boosts + quotes). Cursor pagination: pass next_cursor back as cursor. Requires scopes: read:accounts, read:statuses. Network docs: https://docs.joinmastodon.org/methods/accounts/#statuses Generic route: /v1/accounts/{accountId}/focus/post-performance.
Try it with MCPAsk your agent to call mastodon-post-performance-list (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
sincestring (date)Default: 30 days ago
untilstring (date)Default: today
limitintegerdefault: 20≤ 200
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 9 item attributes
idstringrequiredcreated_atstring (date-time)textstringlikesintegercommentsintegersharesintegerquotesintegerengagementsintegerurlstring (uri) | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Admin accounts
Mastodon: List Accounts
/accounts/{accountId}/mastodon/admin-accountsGET /api/v2/admin/accounts. Moderate local and remote accounts: approve sign-ups, warn, limit, suspend. Cursor pagination: pass next_cursor back as cursor. Requires one of: admin:read | admin:read:accounts. Network docs: https://docs.joinmastodon.org/methods/admin/accounts/ Generic route: /v1/accounts/{accountId}/focus/admin-accounts.
Try it with MCPAsk your agent to call mastodon-admin-accounts-list (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringOpaque cursor from a previous next_cursor
limitintegerdefault: 201–80
originstringlocalremote
statusstringactivependingdisabledsilencedsuspended
permissionsstringstaff
role_idsarray of stringinvited_bystringusernamestringdisplay_namestringby_domainstringemailstringipstringReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 18 item attributes
idstringrequiredread-onlyusernamestringdomainstring | nullacctstringdisplay_namestring | nullcreated_atstring (date-time)emailstring (email) | nullipstring | nulllocalestring | nullroleobject | nullShow 3 child attributes
idstringnamestringpermissionsstringconfirmedbooleanapprovedbooleandisabledbooleansilencedbooleansuspendedbooleansensitizedbooleaninvite_requeststring | nullaccountobject | nullShow 23 child attributes
idstringrequiredread-onlyacctstringrequiredusernamestringdisplay_namestringurlstring (uri)avatarstringheaderstringnotestringnote_textstringlockedbooleanbotbooleangroupbooleandiscoverableboolean | nullindexableboolean | nullfollowers_countintegerfollowing_countintegerstatuses_countintegercreated_atstring (date-time)last_status_atstring (date) | nullfieldsarray of objectShow 3 item attributes
namestringvaluestringverified_atstring (date-time) | nullmovedobject | nullsuspendedbooleanlimitedbooleanlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Mastodon: Get a Accounts item
/accounts/{accountId}/mastodon/admin-accounts/{itemId}Moderate local and remote accounts: approve sign-ups, warn, limit, suspend. Requires one of: admin:read | admin:read:accounts. Network docs: https://docs.joinmastodon.org/methods/admin/accounts/ Generic route: /v1/accounts/{accountId}/focus/admin-accounts.
Try it with MCPAsk your agent to call mastodon-admin-accounts-get (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringrequiredread-onlyusernamestringdomainstring | nullacctstringdisplay_namestring | nullcreated_atstring (date-time)emailstring (email) | nullipstring | nulllocalestring | nullroleobject | nullShow 3 child attributes
idstringnamestringpermissionsstringconfirmedbooleanapprovedbooleandisabledbooleansilencedbooleansuspendedbooleansensitizedbooleaninvite_requeststring | nullaccountobject | nullShow 23 child attributes
idstringrequiredread-onlyacctstringrequiredusernamestringdisplay_namestringurlstring (uri)avatarstringheaderstringnotestringnote_textstringlockedbooleanbotbooleangroupbooleandiscoverableboolean | nullindexableboolean | nullfollowers_countintegerfollowing_countintegerstatuses_countintegercreated_atstring (date-time)last_status_atstring (date) | nullfieldsarray of objectShow 3 item attributes
namestringvaluestringverified_atstring (date-time) | nullmovedobject | nullsuspendedbooleanlimitedbooleanResponses
Mastodon: Delete a Accounts item
/accounts/{accountId}/mastodon/admin-accounts/{itemId}Delete the data of a suspended account. Moderate local and remote accounts: approve sign-ups, warn, limit, suspend. Requires scopes: admin:write:accounts. Requires one of: admin:read | admin:read:accounts. Network docs: https://docs.joinmastodon.org/methods/admin/accounts/ Generic route: /v1/accounts/{accountId}/focus/admin-accounts.
Try it with MCPAsk your agent to call mastodon-admin-accounts-delete (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Mastodon: Approve sign-up (Accounts)
/accounts/{accountId}/mastodon/admin-accounts/{itemId}/approveApprove sign-up. Moderate local and remote accounts: approve sign-ups, warn, limit, suspend. Requires scopes: admin:write:accounts. Requires one of: admin:read | admin:read:accounts. Network docs: https://docs.joinmastodon.org/methods/admin/accounts/ Generic route: /v1/accounts/{accountId}/focus/admin-accounts.
Try it with MCPAsk your agent to call mastodon-admin-accounts-approve (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Reject sign-up (Accounts)
/accounts/{accountId}/mastodon/admin-accounts/{itemId}/rejectReject sign-up. Moderate local and remote accounts: approve sign-ups, warn, limit, suspend. Destructive. Requires scopes: admin:write:accounts. Requires one of: admin:read | admin:read:accounts. Network docs: https://docs.joinmastodon.org/methods/admin/accounts/ Generic route: /v1/accounts/{accountId}/focus/admin-accounts.
Try it with MCPAsk your agent to call mastodon-admin-accounts-reject (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Moderate (Accounts)
/accounts/{accountId}/mastodon/admin-accounts/{itemId}/actionModerate. Moderate local and remote accounts: approve sign-ups, warn, limit, suspend. Destructive. Requires scopes: admin:write:accounts. Requires one of: admin:read | admin:read:accounts. Network docs: https://docs.joinmastodon.org/methods/admin/accounts/ Generic route: /v1/accounts/{accountId}/focus/admin-accounts.
Try it with MCPAsk your agent to call mastodon-admin-accounts-action (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
typestringrequirednonesensitivedisablesilencesuspend
report_idstringwarning_preset_idstringtextstringsend_email_notificationbooleandefault: trueReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Re-enable login (Accounts)
/accounts/{accountId}/mastodon/admin-accounts/{itemId}/enableRe-enable login. Moderate local and remote accounts: approve sign-ups, warn, limit, suspend. Requires scopes: admin:write:accounts. Requires one of: admin:read | admin:read:accounts. Network docs: https://docs.joinmastodon.org/methods/admin/accounts/ Generic route: /v1/accounts/{accountId}/focus/admin-accounts.
Try it with MCPAsk your agent to call mastodon-admin-accounts-enable (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Unlimit (Accounts)
/accounts/{accountId}/mastodon/admin-accounts/{itemId}/unsilenceUnlimit. Moderate local and remote accounts: approve sign-ups, warn, limit, suspend. Requires scopes: admin:write:accounts. Requires one of: admin:read | admin:read:accounts. Network docs: https://docs.joinmastodon.org/methods/admin/accounts/ Generic route: /v1/accounts/{accountId}/focus/admin-accounts.
Try it with MCPAsk your agent to call mastodon-admin-accounts-unsilence (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Unsuspend (Accounts)
/accounts/{accountId}/mastodon/admin-accounts/{itemId}/unsuspendUnsuspend. Moderate local and remote accounts: approve sign-ups, warn, limit, suspend. Requires scopes: admin:write:accounts. Requires one of: admin:read | admin:read:accounts. Network docs: https://docs.joinmastodon.org/methods/admin/accounts/ Generic route: /v1/accounts/{accountId}/focus/admin-accounts.
Try it with MCPAsk your agent to call mastodon-admin-accounts-unsuspend (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Unmark sensitive (Accounts)
/accounts/{accountId}/mastodon/admin-accounts/{itemId}/unsensitiveUnmark sensitive. Moderate local and remote accounts: approve sign-ups, warn, limit, suspend. Requires scopes: admin:write:accounts. Requires one of: admin:read | admin:read:accounts. Network docs: https://docs.joinmastodon.org/methods/admin/accounts/ Generic route: /v1/accounts/{accountId}/focus/admin-accounts.
Try it with MCPAsk your agent to call mastodon-admin-accounts-unsensitive (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Admin reports
Mastodon: List Reports
/accounts/{accountId}/mastodon/admin-reportsModeration reports: assign, resolve, reopen, recategorize. Cursor pagination: pass next_cursor back as cursor. Requires one of: admin:read | admin:read:reports. Network docs: https://docs.joinmastodon.org/methods/admin/reports/ Generic route: /v1/accounts/{accountId}/focus/admin-reports.
Try it with MCPAsk your agent to call mastodon-admin-reports-list (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringOpaque cursor from a previous next_cursor
limitintegerdefault: 201–80
resolvedbooleanaccount_idstringtarget_account_idstringReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 13 item attributes
idstringrequiredread-onlycreated_atstring (date-time)updated_atstring (date-time)categorystringspamlegalviolationother
commentstringforwardedbooleanaction_takenbooleanaction_taken_atstring (date-time) | nullreporterstring | nulltargetstring | nullassigned_tostring | nullrulesarray of objectShow 2 item attributes
idstringtextstringstatusesarray of objectShow 29 item attributes
idstringrequiredread-onlyuristring (uri)urlstring (uri) | nullcreated_atstring (date-time)edited_atstring (date-time) | nulltextstringread-onlycontentstringspoiler_textstringsensitivebooleanvisibilitystringpublicunlistedprivatedirect
languagestring | nullin_reply_to_idstring | nullin_reply_to_account_idstring | nullreplies_countintegerreblogs_countintegerfavourites_countintegerquotes_countinteger | nullauthorstringauthor_namestring | nullmedia_attachmentsarray of objectShow 8 item attributes
idstringread-onlytypestringimagegifvvideoaudiounknown
urlstring (uri) | nullpreview_urlstring (uri) | nullremote_urlstring (uri) | nulldescriptionstring | nullblurhashstring | nullmetaobjectpollobject | nullShow 9 child attributes
idstringread-onlyexpires_atstring (date-time) | nullexpiredbooleanmultiplebooleanvotes_countintegervoters_countinteger | nullvotedbooleanown_votesarray of integeroptionsarray of objectShow 2 item attributes
titlestringvotes_countinteger | nullfavouritedbooleanrebloggedbooleanbookmarkedbooleanmutedbooleanpinnedbooleanis_reblogbooleanquoteobject | nullShow 2 child attributes
statestringquoted_statusobject | nullquote_approvalobject | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Mastodon: Get a Reports item
/accounts/{accountId}/mastodon/admin-reports/{itemId}Moderation reports: assign, resolve, reopen, recategorize. Requires one of: admin:read | admin:read:reports. Network docs: https://docs.joinmastodon.org/methods/admin/reports/ Generic route: /v1/accounts/{accountId}/focus/admin-reports.
Try it with MCPAsk your agent to call mastodon-admin-reports-get (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringrequiredread-onlycreated_atstring (date-time)updated_atstring (date-time)categorystringspamlegalviolationother
commentstringforwardedbooleanaction_takenbooleanaction_taken_atstring (date-time) | nullreporterstring | nulltargetstring | nullassigned_tostring | nullrulesarray of objectShow 2 item attributes
idstringtextstringstatusesarray of objectShow 29 item attributes
idstringrequiredread-onlyuristring (uri)urlstring (uri) | nullcreated_atstring (date-time)edited_atstring (date-time) | nulltextstringread-onlycontentstringspoiler_textstringsensitivebooleanvisibilitystringpublicunlistedprivatedirect
languagestring | nullin_reply_to_idstring | nullin_reply_to_account_idstring | nullreplies_countintegerreblogs_countintegerfavourites_countintegerquotes_countinteger | nullauthorstringauthor_namestring | nullmedia_attachmentsarray of objectShow 8 item attributes
idstringread-onlytypestringimagegifvvideoaudiounknown
urlstring (uri) | nullpreview_urlstring (uri) | nullremote_urlstring (uri) | nulldescriptionstring | nullblurhashstring | nullmetaobjectpollobject | nullShow 9 child attributes
idstringread-onlyexpires_atstring (date-time) | nullexpiredbooleanmultiplebooleanvotes_countintegervoters_countinteger | nullvotedbooleanown_votesarray of integeroptionsarray of objectShow 2 item attributes
titlestringvotes_countinteger | nullfavouritedbooleanrebloggedbooleanbookmarkedbooleanmutedbooleanpinnedbooleanis_reblogbooleanquoteobject | nullShow 2 child attributes
statestringquoted_statusobject | nullquote_approvalobject | nullResponses
Mastodon: Update a Reports item
/accounts/{accountId}/mastodon/admin-reports/{itemId}Moderation reports: assign, resolve, reopen, recategorize. Requires scopes: admin:write:reports. Requires one of: admin:read | admin:read:reports. Network docs: https://docs.joinmastodon.org/methods/admin/reports/ Generic route: /v1/accounts/{accountId}/focus/admin-reports.
Try it with MCPAsk your agent to call mastodon-admin-reports-update (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
categorystringspamlegalviolationother
rule_idsarray of stringReturns object
idstringrequiredread-onlycreated_atstring (date-time)updated_atstring (date-time)categorystringspamlegalviolationother
commentstringforwardedbooleanaction_takenbooleanaction_taken_atstring (date-time) | nullreporterstring | nulltargetstring | nullassigned_tostring | nullrulesarray of objectShow 2 item attributes
idstringtextstringstatusesarray of objectShow 29 item attributes
idstringrequiredread-onlyuristring (uri)urlstring (uri) | nullcreated_atstring (date-time)edited_atstring (date-time) | nulltextstringread-onlycontentstringspoiler_textstringsensitivebooleanvisibilitystringpublicunlistedprivatedirect
languagestring | nullin_reply_to_idstring | nullin_reply_to_account_idstring | nullreplies_countintegerreblogs_countintegerfavourites_countintegerquotes_countinteger | nullauthorstringauthor_namestring | nullmedia_attachmentsarray of objectShow 8 item attributes
idstringread-onlytypestringimagegifvvideoaudiounknown
urlstring (uri) | nullpreview_urlstring (uri) | nullremote_urlstring (uri) | nulldescriptionstring | nullblurhashstring | nullmetaobjectpollobject | nullShow 9 child attributes
idstringread-onlyexpires_atstring (date-time) | nullexpiredbooleanmultiplebooleanvotes_countintegervoters_countinteger | nullvotedbooleanown_votesarray of integeroptionsarray of objectShow 2 item attributes
titlestringvotes_countinteger | nullfavouritedbooleanrebloggedbooleanbookmarkedbooleanmutedbooleanpinnedbooleanis_reblogbooleanquoteobject | nullShow 2 child attributes
statestringquoted_statusobject | nullquote_approvalobject | nullResponses
Mastodon: Assign to me (Reports)
/accounts/{accountId}/mastodon/admin-reports/{itemId}/assignAssign to me. Moderation reports: assign, resolve, reopen, recategorize. Requires scopes: admin:write:reports. Requires one of: admin:read | admin:read:reports. Network docs: https://docs.joinmastodon.org/methods/admin/reports/ Generic route: /v1/accounts/{accountId}/focus/admin-reports.
Try it with MCPAsk your agent to call mastodon-admin-reports-assign (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Unassign (Reports)
/accounts/{accountId}/mastodon/admin-reports/{itemId}/unassignUnassign. Moderation reports: assign, resolve, reopen, recategorize. Requires scopes: admin:write:reports. Requires one of: admin:read | admin:read:reports. Network docs: https://docs.joinmastodon.org/methods/admin/reports/ Generic route: /v1/accounts/{accountId}/focus/admin-reports.
Try it with MCPAsk your agent to call mastodon-admin-reports-unassign (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Resolve (Reports)
/accounts/{accountId}/mastodon/admin-reports/{itemId}/resolveResolve. Moderation reports: assign, resolve, reopen, recategorize. Requires scopes: admin:write:reports. Requires one of: admin:read | admin:read:reports. Network docs: https://docs.joinmastodon.org/methods/admin/reports/ Generic route: /v1/accounts/{accountId}/focus/admin-reports.
Try it with MCPAsk your agent to call mastodon-admin-reports-resolve (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Reopen (Reports)
/accounts/{accountId}/mastodon/admin-reports/{itemId}/reopenReopen. Moderation reports: assign, resolve, reopen, recategorize. Requires scopes: admin:write:reports. Requires one of: admin:read | admin:read:reports. Network docs: https://docs.joinmastodon.org/methods/admin/reports/ Generic route: /v1/accounts/{accountId}/focus/admin-reports.
Try it with MCPAsk your agent to call mastodon-admin-reports-reopen (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Admin domain blocks
Mastodon: List Domain blocks
/accounts/{accountId}/mastodon/admin-domain-blocksLimit or suspend remote servers (4.0+). Cursor pagination: pass next_cursor back as cursor. Requires one of: admin:read | admin:read:domain_blocks. Network docs: https://docs.joinmastodon.org/methods/admin/domain_blocks/ Generic route: /v1/accounts/{accountId}/focus/admin-domain-blocks.
Try it with MCPAsk your agent to call mastodon-admin-domain-blocks-list (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringOpaque cursor from a previous next_cursor
limitintegerdefault: 201–80
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 10 item attributes
idstringrequiredread-onlycreated_atstring (date-time)digeststringdomainstringrequiredseveritystringsilencesuspendnoop
reject_mediabooleanreject_reportsbooleanprivate_commentstringpublic_commentstringobfuscatebooleanlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Mastodon: Create a Domain blocks item
/accounts/{accountId}/mastodon/admin-domain-blocksLimit or suspend remote servers (4.0+). Requires scopes: admin:write:domain_blocks. Requires one of: admin:read | admin:read:domain_blocks. Network docs: https://docs.joinmastodon.org/methods/admin/domain_blocks/ Generic route: /v1/accounts/{accountId}/focus/admin-domain-blocks.
Try it with MCPAsk your agent to call mastodon-admin-domain-blocks-create (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
domainstringrequiredseveritystringsilencesuspendnoop
reject_mediabooleanreject_reportsbooleanprivate_commentstringpublic_commentstringobfuscatebooleanReturns object
idstringrequiredread-onlycreated_atstring (date-time)digeststringdomainstringrequiredseveritystringsilencesuspendnoop
reject_mediabooleanreject_reportsbooleanprivate_commentstringpublic_commentstringobfuscatebooleanResponses
Mastodon: Get a Domain blocks item
/accounts/{accountId}/mastodon/admin-domain-blocks/{itemId}Limit or suspend remote servers (4.0+). Requires one of: admin:read | admin:read:domain_blocks. Network docs: https://docs.joinmastodon.org/methods/admin/domain_blocks/ Generic route: /v1/accounts/{accountId}/focus/admin-domain-blocks.
Try it with MCPAsk your agent to call mastodon-admin-domain-blocks-get (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringrequiredread-onlycreated_atstring (date-time)digeststringdomainstringrequiredseveritystringsilencesuspendnoop
reject_mediabooleanreject_reportsbooleanprivate_commentstringpublic_commentstringobfuscatebooleanResponses
Mastodon: Update a Domain blocks item
/accounts/{accountId}/mastodon/admin-domain-blocks/{itemId}Limit or suspend remote servers (4.0+). Requires scopes: admin:write:domain_blocks. Requires one of: admin:read | admin:read:domain_blocks. Network docs: https://docs.joinmastodon.org/methods/admin/domain_blocks/ Generic route: /v1/accounts/{accountId}/focus/admin-domain-blocks.
Try it with MCPAsk your agent to call mastodon-admin-domain-blocks-update (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
domainstringseveritystringsilencesuspendnoop
reject_mediabooleanreject_reportsbooleanprivate_commentstringpublic_commentstringobfuscatebooleanReturns object
idstringrequiredread-onlycreated_atstring (date-time)digeststringdomainstringrequiredseveritystringsilencesuspendnoop
reject_mediabooleanreject_reportsbooleanprivate_commentstringpublic_commentstringobfuscatebooleanResponses
Mastodon: Delete a Domain blocks item
/accounts/{accountId}/mastodon/admin-domain-blocks/{itemId}Limit or suspend remote servers (4.0+). Requires scopes: admin:write:domain_blocks. Requires one of: admin:read | admin:read:domain_blocks. Network docs: https://docs.joinmastodon.org/methods/admin/domain_blocks/ Generic route: /v1/accounts/{accountId}/focus/admin-domain-blocks.
Try it with MCPAsk your agent to call mastodon-admin-domain-blocks-delete (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Admin domain allows
Mastodon: List Domain allows
/accounts/{accountId}/mastodon/admin-domain-allowsAllowed servers in limited-federation mode. Cursor pagination: pass next_cursor back as cursor. Requires one of: admin:read | admin:read:domain_allows. Network docs: https://docs.joinmastodon.org/methods/admin/domain_allows/ Generic route: /v1/accounts/{accountId}/focus/admin-domain-allows.
Try it with MCPAsk your agent to call mastodon-admin-domain-allows-list (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringOpaque cursor from a previous next_cursor
limitintegerdefault: 201–80
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 3 item attributes
idstringrequiredread-onlydomainstringrequiredcreated_atstring (date-time)limitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Mastodon: Create a Domain allows item
/accounts/{accountId}/mastodon/admin-domain-allowsAllowed servers in limited-federation mode. Requires scopes: admin:write:domain_allows. Requires one of: admin:read | admin:read:domain_allows. Network docs: https://docs.joinmastodon.org/methods/admin/domain_allows/ Generic route: /v1/accounts/{accountId}/focus/admin-domain-allows.
Try it with MCPAsk your agent to call mastodon-admin-domain-allows-create (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
domainstringrequiredReturns object
idstringrequiredread-onlydomainstringrequiredcreated_atstring (date-time)Responses
Mastodon: Get a Domain allows item
/accounts/{accountId}/mastodon/admin-domain-allows/{itemId}Allowed servers in limited-federation mode. Requires one of: admin:read | admin:read:domain_allows. Network docs: https://docs.joinmastodon.org/methods/admin/domain_allows/ Generic route: /v1/accounts/{accountId}/focus/admin-domain-allows.
Try it with MCPAsk your agent to call mastodon-admin-domain-allows-get (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringrequiredread-onlydomainstringrequiredcreated_atstring (date-time)Responses
Mastodon: Delete a Domain allows item
/accounts/{accountId}/mastodon/admin-domain-allows/{itemId}Allowed servers in limited-federation mode. Requires scopes: admin:write:domain_allows. Requires one of: admin:read | admin:read:domain_allows. Network docs: https://docs.joinmastodon.org/methods/admin/domain_allows/ Generic route: /v1/accounts/{accountId}/focus/admin-domain-allows.
Try it with MCPAsk your agent to call mastodon-admin-domain-allows-delete (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Admin ip blocks
Mastodon: List IP blocks
/accounts/{accountId}/mastodon/admin-ip-blocksCursor pagination: pass next_cursor back as cursor. Requires one of: admin:read | admin:read:ip_blocks. Network docs: https://docs.joinmastodon.org/methods/admin/ip_blocks/ Generic route: /v1/accounts/{accountId}/focus/admin-ip-blocks.
Try it with MCPAsk your agent to call mastodon-admin-ip-blocks-list (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringOpaque cursor from a previous next_cursor
limitintegerdefault: 201–80
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 7 item attributes
idstringrequiredread-onlycreated_atstring (date-time)expires_atstring (date-time) | nullipstringrequiredIP or CIDR range
severitystringsign_up_requires_approvalsign_up_blockno_access
commentstringexpires_inintegerSeconds
limitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Mastodon: Create a IP blocks item
/accounts/{accountId}/mastodon/admin-ip-blocksRequires scopes: admin:write:ip_blocks. Requires one of: admin:read | admin:read:ip_blocks. Network docs: https://docs.joinmastodon.org/methods/admin/ip_blocks/ Generic route: /v1/accounts/{accountId}/focus/admin-ip-blocks.
Try it with MCPAsk your agent to call mastodon-admin-ip-blocks-create (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
ipstringrequiredIP or CIDR range
severitystringrequiredsign_up_requires_approvalsign_up_blockno_access
commentstringexpires_inintegerSeconds
Returns object
idstringrequiredread-onlycreated_atstring (date-time)expires_atstring (date-time) | nullipstringrequiredIP or CIDR range
severitystringsign_up_requires_approvalsign_up_blockno_access
commentstringexpires_inintegerSeconds
Responses
Mastodon: Get a IP blocks item
/accounts/{accountId}/mastodon/admin-ip-blocks/{itemId}Requires one of: admin:read | admin:read:ip_blocks. Network docs: https://docs.joinmastodon.org/methods/admin/ip_blocks/ Generic route: /v1/accounts/{accountId}/focus/admin-ip-blocks.
Try it with MCPAsk your agent to call mastodon-admin-ip-blocks-get (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringrequiredread-onlycreated_atstring (date-time)expires_atstring (date-time) | nullipstringrequiredIP or CIDR range
severitystringsign_up_requires_approvalsign_up_blockno_access
commentstringexpires_inintegerSeconds
Responses
Mastodon: Update a IP blocks item
/accounts/{accountId}/mastodon/admin-ip-blocks/{itemId}Requires scopes: admin:write:ip_blocks. Requires one of: admin:read | admin:read:ip_blocks. Network docs: https://docs.joinmastodon.org/methods/admin/ip_blocks/ Generic route: /v1/accounts/{accountId}/focus/admin-ip-blocks.
Try it with MCPAsk your agent to call mastodon-admin-ip-blocks-update (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
ipstringIP or CIDR range
severitystringsign_up_requires_approvalsign_up_blockno_access
commentstringexpires_inintegerSeconds
Returns object
idstringrequiredread-onlycreated_atstring (date-time)expires_atstring (date-time) | nullipstringrequiredIP or CIDR range
severitystringsign_up_requires_approvalsign_up_blockno_access
commentstringexpires_inintegerSeconds
Responses
Mastodon: Delete a IP blocks item
/accounts/{accountId}/mastodon/admin-ip-blocks/{itemId}Requires scopes: admin:write:ip_blocks. Requires one of: admin:read | admin:read:ip_blocks. Network docs: https://docs.joinmastodon.org/methods/admin/ip_blocks/ Generic route: /v1/accounts/{accountId}/focus/admin-ip-blocks.
Try it with MCPAsk your agent to call mastodon-admin-ip-blocks-delete (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Admin email domain blocks
Mastodon: List Email domain blocks
/accounts/{accountId}/mastodon/admin-email-domain-blocksCursor pagination: pass next_cursor back as cursor. Requires one of: admin:read | admin:read:email_domain_blocks. Network docs: https://docs.joinmastodon.org/methods/admin/email_domain_blocks/ Generic route: /v1/accounts/{accountId}/focus/admin-email-domain-blocks.
Try it with MCPAsk your agent to call mastodon-admin-email-domain-blocks-list (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringOpaque cursor from a previous next_cursor
limitintegerdefault: 201–80
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 4 item attributes
idstringrequiredread-onlydomainstringrequiredcreated_atstring (date-time)historyarray of objectShow 3 item attributes
daystringaccountsstringusesstringlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Mastodon: Create a Email domain blocks item
/accounts/{accountId}/mastodon/admin-email-domain-blocksRequires scopes: admin:write:email_domain_blocks. Requires one of: admin:read | admin:read:email_domain_blocks. Network docs: https://docs.joinmastodon.org/methods/admin/email_domain_blocks/ Generic route: /v1/accounts/{accountId}/focus/admin-email-domain-blocks.
Try it with MCPAsk your agent to call mastodon-admin-email-domain-blocks-create (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
domainstringrequiredReturns object
idstringrequiredread-onlydomainstringrequiredcreated_atstring (date-time)historyarray of objectShow 3 item attributes
daystringaccountsstringusesstringResponses
Mastodon: Get a Email domain blocks item
/accounts/{accountId}/mastodon/admin-email-domain-blocks/{itemId}Requires one of: admin:read | admin:read:email_domain_blocks. Network docs: https://docs.joinmastodon.org/methods/admin/email_domain_blocks/ Generic route: /v1/accounts/{accountId}/focus/admin-email-domain-blocks.
Try it with MCPAsk your agent to call mastodon-admin-email-domain-blocks-get (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringrequiredread-onlydomainstringrequiredcreated_atstring (date-time)historyarray of objectShow 3 item attributes
daystringaccountsstringusesstringResponses
Mastodon: Delete a Email domain blocks item
/accounts/{accountId}/mastodon/admin-email-domain-blocks/{itemId}Requires scopes: admin:write:email_domain_blocks. Requires one of: admin:read | admin:read:email_domain_blocks. Network docs: https://docs.joinmastodon.org/methods/admin/email_domain_blocks/ Generic route: /v1/accounts/{accountId}/focus/admin-email-domain-blocks.
Try it with MCPAsk your agent to call mastodon-admin-email-domain-blocks-delete (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Admin canonical email blocks
Mastodon: List Email blocks
/accounts/{accountId}/mastodon/admin-canonical-email-blocksBlock specific (canonicalized) email addresses. Cursor pagination: pass next_cursor back as cursor. Requires one of: admin:read | admin:read:canonical_email_blocks. Network docs: https://docs.joinmastodon.org/methods/admin/canonical_email_blocks/ Generic route: /v1/accounts/{accountId}/focus/admin-canonical-email-blocks.
Try it with MCPAsk your agent to call mastodon-admin-canonical-email-blocks-list (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringOpaque cursor from a previous next_cursor
limitintegerdefault: 201–80
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 2 item attributes
idstringrequiredread-onlycanonical_email_hashstringlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Mastodon: Create a Email blocks item
/accounts/{accountId}/mastodon/admin-canonical-email-blocksBlock specific (canonicalized) email addresses. Requires scopes: admin:write:canonical_email_blocks. Requires one of: admin:read | admin:read:canonical_email_blocks. Network docs: https://docs.joinmastodon.org/methods/admin/canonical_email_blocks/ Generic route: /v1/accounts/{accountId}/focus/admin-canonical-email-blocks.
Try it with MCPAsk your agent to call mastodon-admin-canonical-email-blocks-create (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
emailstring (email)canonical_email_hashstringReturns object
idstringrequiredread-onlycanonical_email_hashstringResponses
Mastodon: Get a Email blocks item
/accounts/{accountId}/mastodon/admin-canonical-email-blocks/{itemId}Block specific (canonicalized) email addresses. Requires one of: admin:read | admin:read:canonical_email_blocks. Network docs: https://docs.joinmastodon.org/methods/admin/canonical_email_blocks/ Generic route: /v1/accounts/{accountId}/focus/admin-canonical-email-blocks.
Try it with MCPAsk your agent to call mastodon-admin-canonical-email-blocks-get (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringrequiredread-onlycanonical_email_hashstringResponses
Mastodon: Delete a Email blocks item
/accounts/{accountId}/mastodon/admin-canonical-email-blocks/{itemId}Block specific (canonicalized) email addresses. Requires scopes: admin:write:canonical_email_blocks. Requires one of: admin:read | admin:read:canonical_email_blocks. Network docs: https://docs.joinmastodon.org/methods/admin/canonical_email_blocks/ Generic route: /v1/accounts/{accountId}/focus/admin-canonical-email-blocks.
Try it with MCPAsk your agent to call mastodon-admin-canonical-email-blocks-delete (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Mastodon: Test an email (Email blocks)
/accounts/{accountId}/mastodon/admin-canonical-email-blocks/testTest an email. Block specific (canonicalized) email addresses. Requires one of: admin:read | admin:read:canonical_email_blocks. Network docs: https://docs.joinmastodon.org/methods/admin/canonical_email_blocks/ Generic route: /v1/accounts/{accountId}/focus/admin-canonical-email-blocks.
Try it with MCPAsk your agent to call mastodon-admin-canonical-email-blocks-test (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
emailstring (email)requiredReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Admin measures
Mastodon: List Server metrics
/accounts/{accountId}/mastodon/admin-measuresActive users, sign-ups, interactions, reports per day. Cursor pagination: pass next_cursor back as cursor. Requires scopes: admin:read. Network docs: https://docs.joinmastodon.org/methods/admin/measures/ Generic route: /v1/accounts/{accountId}/focus/admin-measures.
Try it with MCPAsk your agent to call mastodon-admin-measures-list (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
keysarray of stringsincestring (date)untilstring (date)paramsanyPer-key params, e.g. { tag_accounts: { id } } · JSON-encoded object or array
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 4 item attributes
idstringkeystringrequiredactive_usersnew_usersinteractionsopened_reportsresolved_reportstag_accountstag_usestag_serversinstance_accountsinstance_media_attachmentsinstance_reportsinstance_statusesinstance_followsinstance_followers
datestring (date)requiredvaluenumberlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Admin dimensions
Mastodon: List Server breakdowns
/accounts/{accountId}/mastodon/admin-dimensionsTop languages, sign-up sources, servers, software versions, space usage. Cursor pagination: pass next_cursor back as cursor. Requires scopes: admin:read. Network docs: https://docs.joinmastodon.org/methods/admin/dimensions/ Generic route: /v1/accounts/{accountId}/focus/admin-dimensions.
Try it with MCPAsk your agent to call mastodon-admin-dimensions-list (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
keysarray of stringsincestring (date)untilstring (date)limitintegerdefault: 10paramsanyJSON-encoded object or array
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 5 item attributes
idstringkeystringrequiredlanguagessourcesserversspace_usagesoftware_versionstag_serverstag_languagesinstance_accountsinstance_languages
itemstringlabelstringvaluenumberlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Admin retention
Mastodon: List Retention
/accounts/{accountId}/mastodon/admin-retentionSign-up cohorts and how many stay active. Cursor pagination: pass next_cursor back as cursor. Requires scopes: admin:read. Network docs: https://docs.joinmastodon.org/methods/admin/retention/ Generic route: /v1/accounts/{accountId}/focus/admin-retention.
Try it with MCPAsk your agent to call mastodon-admin-retention-list (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
sincestring (date)untilstring (date)frequencystringdaymonth
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 5 item attributes
idstringcohortstring (date)requireddatestring (date)requiredratenumbervalueintegerlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Admin trends links
Mastodon: List Trending links review
/accounts/{accountId}/mastodon/admin-trends-linksReview trending links: approve to allow them in public trends, reject to hide. Cursor pagination: pass next_cursor back as cursor. Requires scopes: admin:read. Network docs: https://docs.joinmastodon.org/methods/admin/trends/ Generic route: /v1/accounts/{accountId}/focus/admin-trends-links.
Try it with MCPAsk your agent to call mastodon-admin-trends-links-list (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 20cursorstringReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 5 item attributes
idstringurlstring (uri)requiredtitlestringprovider_namestringrequires_reviewbooleanlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Mastodon: Approve (Trending links review)
/accounts/{accountId}/mastodon/admin-trends-links/{itemId}/approveApprove. Review trending links: approve to allow them in public trends, reject to hide. Requires scopes: admin:read, admin:write. Network docs: https://docs.joinmastodon.org/methods/admin/trends/ Generic route: /v1/accounts/{accountId}/focus/admin-trends-links.
Try it with MCPAsk your agent to call mastodon-admin-trends-links-approve (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Reject (Trending links review)
/accounts/{accountId}/mastodon/admin-trends-links/{itemId}/rejectReject. Review trending links: approve to allow them in public trends, reject to hide. Destructive. Requires scopes: admin:read, admin:write. Network docs: https://docs.joinmastodon.org/methods/admin/trends/ Generic route: /v1/accounts/{accountId}/focus/admin-trends-links.
Try it with MCPAsk your agent to call mastodon-admin-trends-links-reject (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Admin trends statuses
Mastodon: List Trending posts review
/accounts/{accountId}/mastodon/admin-trends-statusesReview trending statuses: approve to allow them in public trends, reject to hide. Cursor pagination: pass next_cursor back as cursor. Requires scopes: admin:read. Network docs: https://docs.joinmastodon.org/methods/admin/trends/ Generic route: /v1/accounts/{accountId}/focus/admin-trends-statuses.
Try it with MCPAsk your agent to call mastodon-admin-trends-statuses-list (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 20cursorstringReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 30 item attributes
idstringrequiredread-onlyuristring (uri)urlstring (uri) | nullcreated_atstring (date-time)edited_atstring (date-time) | nulltextstringread-onlycontentstringspoiler_textstringsensitivebooleanvisibilitystringpublicunlistedprivatedirect
languagestring | nullin_reply_to_idstring | nullin_reply_to_account_idstring | nullreplies_countintegerreblogs_countintegerfavourites_countintegerquotes_countinteger | nullauthorstringauthor_namestring | nullmedia_attachmentsarray of objectShow 8 item attributes
idstringread-onlytypestringimagegifvvideoaudiounknown
urlstring (uri) | nullpreview_urlstring (uri) | nullremote_urlstring (uri) | nulldescriptionstring | nullblurhashstring | nullmetaobjectpollobject | nullShow 9 child attributes
idstringread-onlyexpires_atstring (date-time) | nullexpiredbooleanmultiplebooleanvotes_countintegervoters_countinteger | nullvotedbooleanown_votesarray of integeroptionsarray of objectShow 2 item attributes
titlestringvotes_countinteger | nullfavouritedbooleanrebloggedbooleanbookmarkedbooleanmutedbooleanpinnedbooleanis_reblogbooleanquoteobject | nullShow 2 child attributes
statestringquoted_statusobject | nullquote_approvalobject | nullrequires_reviewbooleanlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Mastodon: Approve (Trending posts review)
/accounts/{accountId}/mastodon/admin-trends-statuses/{itemId}/approveApprove. Review trending statuses: approve to allow them in public trends, reject to hide. Requires scopes: admin:read, admin:write. Network docs: https://docs.joinmastodon.org/methods/admin/trends/ Generic route: /v1/accounts/{accountId}/focus/admin-trends-statuses.
Try it with MCPAsk your agent to call mastodon-admin-trends-statuses-approve (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Reject (Trending posts review)
/accounts/{accountId}/mastodon/admin-trends-statuses/{itemId}/rejectReject. Review trending statuses: approve to allow them in public trends, reject to hide. Destructive. Requires scopes: admin:read, admin:write. Network docs: https://docs.joinmastodon.org/methods/admin/trends/ Generic route: /v1/accounts/{accountId}/focus/admin-trends-statuses.
Try it with MCPAsk your agent to call mastodon-admin-trends-statuses-reject (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Admin trends tags
Mastodon: List Trending hashtags review
/accounts/{accountId}/mastodon/admin-trends-tagsReview trending tags: approve to allow them in public trends, reject to hide. Cursor pagination: pass next_cursor back as cursor. Requires scopes: admin:read. Network docs: https://docs.joinmastodon.org/methods/admin/trends/ Generic route: /v1/accounts/{accountId}/focus/admin-trends-tags.
Try it with MCPAsk your agent to call mastodon-admin-trends-tags-list (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 20cursorstringReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 9 item attributes
idstring | nullnamestringrequiredurlstring (uri)followingboolean | nullfeaturingboolean | nullhistoryarray of objectShow 3 item attributes
daystringusesstringaccountsstringrequires_reviewbooleantrendablebooleanusablebooleanlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Mastodon: Approve (Trending hashtags review)
/accounts/{accountId}/mastodon/admin-trends-tags/{itemId}/approveApprove. Review trending tags: approve to allow them in public trends, reject to hide. Requires scopes: admin:read, admin:write. Network docs: https://docs.joinmastodon.org/methods/admin/trends/ Generic route: /v1/accounts/{accountId}/focus/admin-trends-tags.
Try it with MCPAsk your agent to call mastodon-admin-trends-tags-approve (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mastodon: Reject (Trending hashtags review)
/accounts/{accountId}/mastodon/admin-trends-tags/{itemId}/rejectReject. Review trending tags: approve to allow them in public trends, reject to hide. Destructive. Requires scopes: admin:read, admin:write. Network docs: https://docs.joinmastodon.org/methods/admin/trends/ Generic route: /v1/accounts/{accountId}/focus/admin-trends-tags.
Try it with MCPAsk your agent to call mastodon-admin-trends-tags-reject (toolset focus_mastodon)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)