Skip to content
Docs

Typed Focus mode operations for Mastodon accounts, generated from the Mastodon focus module (same behaviour as the generic /accounts/{accountId}/focus routes).

Base URLhttps://api.socialit.com/v1AuthenticationErrorsRate limits337 endpointsMCP toolset focus_mastodon

Statuses

Mastodon: List Posts

GET/accounts/{accountId}/mastodon/statuses

Own 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.

Access: read

Try it with MCPAsk your agent to call mastodon-statuses-list (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Opaque cursor from a previous next_cursor

limitintegerdefault: 20

1–80

account_idstring

Defaults to the connected account

only_mediaboolean
exclude_repliesboolean
exclude_reblogsboolean
pinnedboolean
taggedstring
exclude_directboolean

Mastodon 4.6+

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 29 item attributes
idstringrequiredread-only
uristring (uri)
urlstring (uri) | null
created_atstring (date-time)
edited_atstring (date-time) | null
textstringread-only
contentstring
spoiler_textstring
sensitiveboolean
visibilitystring

publicunlistedprivatedirect

languagestring | null
in_reply_to_idstring | null
in_reply_to_account_idstring | null
replies_countinteger
reblogs_countinteger
favourites_countinteger
quotes_countinteger | null
authorstring
author_namestring | null
media_attachmentsarray of object
Show 8 item attributes
idstringread-only
typestring

imagegifvvideoaudiounknown

urlstring (uri) | null
preview_urlstring (uri) | null
remote_urlstring (uri) | null
descriptionstring | null
blurhashstring | null
metaobject
pollobject | null
Show 9 child attributes
idstringread-only
expires_atstring (date-time) | null
expiredboolean
multipleboolean
votes_countinteger
voters_countinteger | null
votedboolean
own_votesarray of integer
optionsarray of object
Show 2 item attributes
titlestring
votes_countinteger | null
favouritedboolean
rebloggedboolean
bookmarkedboolean
mutedboolean
pinnedboolean
is_reblogboolean
quoteobject | null
Show 2 child attributes
statestring
quoted_statusobject | null
quote_approvalobject | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/statuses
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/statuses" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Create a Posts item

POST/accounts/{accountId}/mastodon/statuses

Publish (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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-statuses-create (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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

statusstring

Plain text; URLs count as 23 characters

visibilitystring

publicunlistedprivatedirect

spoiler_textstring
sensitiveboolean
languagestring

ISO 639-1

mediaarray of string

Socialit media ids (uploaded to the instance on publish)

media_idsarray of string

Already-uploaded Mastodon media ids

alt_textsarray of string

Alt text per media item, by index

pollobject
Show 4 child attributes
optionsarray of string

≥ 2 items

expires_inintegerdefault: 86400
multipleboolean
hide_totalsboolean
in_reply_to_idstring
quoted_status_idstring

Mastodon 4.5+

quote_approval_policystring

publicfollowersnobody

scheduled_atstring (date-time)

≥ 5 minutes ahead → ScheduledStatus

threadarray of string

Follow-up replies posted as a self-thread

Returns object

idstringrequiredread-only
uristring (uri)
urlstring (uri) | null
created_atstring (date-time)
edited_atstring (date-time) | null
textstringread-only
contentstring
spoiler_textstring
sensitiveboolean
visibilitystring

publicunlistedprivatedirect

languagestring | null
in_reply_to_idstring | null
in_reply_to_account_idstring | null
replies_countinteger
reblogs_countinteger
favourites_countinteger
quotes_countinteger | null
authorstring
author_namestring | null
media_attachmentsarray of object
Show 8 item attributes
idstringread-only
typestring

imagegifvvideoaudiounknown

urlstring (uri) | null
preview_urlstring (uri) | null
remote_urlstring (uri) | null
descriptionstring | null
blurhashstring | null
metaobject
pollobject | null
Show 9 child attributes
idstringread-only
expires_atstring (date-time) | null
expiredboolean
multipleboolean
votes_countinteger
voters_countinteger | null
votedboolean
own_votesarray of integer
optionsarray of object
Show 2 item attributes
titlestring
votes_countinteger | null
favouritedboolean
rebloggedboolean
bookmarkedboolean
mutedboolean
pinnedboolean
is_reblogboolean
quoteobject | null
Show 2 child attributes
statestring
quoted_statusobject | null
quote_approvalobject | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/statuses
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/statuses" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "string",
    "visibility": "public",
    "spoiler_text": "string",
    "sensitive": true,
    "language": "en"
  }'
Response · 201

Mastodon: Get a Posts item

GET/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.

Access: read

Try it with MCPAsk your agent to call mastodon-statuses-get (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstringrequiredread-only
uristring (uri)
urlstring (uri) | null
created_atstring (date-time)
edited_atstring (date-time) | null
textstringread-only
contentstring
spoiler_textstring
sensitiveboolean
visibilitystring

publicunlistedprivatedirect

languagestring | null
in_reply_to_idstring | null
in_reply_to_account_idstring | null
replies_countinteger
reblogs_countinteger
favourites_countinteger
quotes_countinteger | null
authorstring
author_namestring | null
media_attachmentsarray of object
Show 8 item attributes
idstringread-only
typestring

imagegifvvideoaudiounknown

urlstring (uri) | null
preview_urlstring (uri) | null
remote_urlstring (uri) | null
descriptionstring | null
blurhashstring | null
metaobject
pollobject | null
Show 9 child attributes
idstringread-only
expires_atstring (date-time) | null
expiredboolean
multipleboolean
votes_countinteger
voters_countinteger | null
votedboolean
own_votesarray of integer
optionsarray of object
Show 2 item attributes
titlestring
votes_countinteger | null
favouritedboolean
rebloggedboolean
bookmarkedboolean
mutedboolean
pinnedboolean
is_reblogboolean
quoteobject | null
Show 2 child attributes
statestring
quoted_statusobject | null
quote_approvalobject | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/statuses/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/statuses/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Update a Posts item

PATCH/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.

Access: write

Try it with MCPAsk your agent to call mastodon-statuses-update (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

statusstring
spoiler_textstring
sensitiveboolean
languagestring
media_idsarray of string

Final list of attachment ids (omit to keep)

mediaarray of string

New Socialit media to upload and append

media_attributesarray of object
Show 3 item attributes
idstring
descriptionstring
focusstring

"x,y"

pollobject | null
Show 4 child attributes
optionsarray of string
expires_ininteger
multipleboolean
hide_totalsboolean
quote_approval_policystring

publicfollowersnobody

Returns object

idstringrequiredread-only
uristring (uri)
urlstring (uri) | null
created_atstring (date-time)
edited_atstring (date-time) | null
textstringread-only
contentstring
spoiler_textstring
sensitiveboolean
visibilitystring

publicunlistedprivatedirect

languagestring | null
in_reply_to_idstring | null
in_reply_to_account_idstring | null
replies_countinteger
reblogs_countinteger
favourites_countinteger
quotes_countinteger | null
authorstring
author_namestring | null
media_attachmentsarray of object
Show 8 item attributes
idstringread-only
typestring

imagegifvvideoaudiounknown

urlstring (uri) | null
preview_urlstring (uri) | null
remote_urlstring (uri) | null
descriptionstring | null
blurhashstring | null
metaobject
pollobject | null
Show 9 child attributes
idstringread-only
expires_atstring (date-time) | null
expiredboolean
multipleboolean
votes_countinteger
voters_countinteger | null
votedboolean
own_votesarray of integer
optionsarray of object
Show 2 item attributes
titlestring
votes_countinteger | null
favouritedboolean
rebloggedboolean
bookmarkedboolean
mutedboolean
pinnedboolean
is_reblogboolean
quoteobject | null
Show 2 child attributes
statestring
quoted_statusobject | null
quote_approvalobject | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/mastodon/statuses/{itemId}
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/statuses/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "string",
    "spoiler_text": "string",
    "sensitive": true,
    "language": "en",
    "media_ids": [
      "string"
    ]
  }'
Response · 200

Mastodon: Delete a Posts item

DELETE/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.

Access: write

Try it with MCPAsk your agent to call mastodon-statuses-delete (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/mastodon/statuses/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/statuses/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Pin to profile (Posts)

POST/accounts/{accountId}/mastodon/statuses/{itemId}/pin

Pin 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-statuses-pin (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/statuses/{itemId}/pin
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/statuses/ITEM_ID/pin" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mastodon: Unpin (Posts)

POST/accounts/{accountId}/mastodon/statuses/{itemId}/unpin

Unpin. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-statuses-unpin (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/statuses/{itemId}/unpin
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/statuses/ITEM_ID/unpin" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mastodon: Boost (Posts)

POST/accounts/{accountId}/mastodon/statuses/{itemId}/boost

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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-statuses-boost (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

visibilitystring

publicunlistedprivate

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/statuses/{itemId}/boost
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/statuses/ITEM_ID/boost" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "visibility": "public"
  }'
Response · 200

Mastodon: Undo boost (Posts)

POST/accounts/{accountId}/mastodon/statuses/{itemId}/unboost

Undo 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-statuses-unboost (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/statuses/{itemId}/unboost
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/statuses/ITEM_ID/unboost" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mastodon: Favourite (Posts)

POST/accounts/{accountId}/mastodon/statuses/{itemId}/favourite

Favourite. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-statuses-favourite (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/statuses/{itemId}/favourite
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/statuses/ITEM_ID/favourite" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mastodon: Unfavourite (Posts)

POST/accounts/{accountId}/mastodon/statuses/{itemId}/unfavourite

Unfavourite. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-statuses-unfavourite (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/statuses/{itemId}/unfavourite
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/statuses/ITEM_ID/unfavourite" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mastodon: Bookmark (Posts)

POST/accounts/{accountId}/mastodon/statuses/{itemId}/bookmark

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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-statuses-bookmark (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/statuses/{itemId}/bookmark
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/statuses/ITEM_ID/bookmark" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mastodon: Remove bookmark (Posts)

POST/accounts/{accountId}/mastodon/statuses/{itemId}/unbookmark

Remove 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-statuses-unbookmark (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/statuses/{itemId}/unbookmark
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/statuses/ITEM_ID/unbookmark" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mastodon: Mute conversation (Posts)

POST/accounts/{accountId}/mastodon/statuses/{itemId}/mute

Mute 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-statuses-mute (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/statuses/{itemId}/mute
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/statuses/ITEM_ID/mute" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mastodon: Unmute conversation (Posts)

POST/accounts/{accountId}/mastodon/statuses/{itemId}/unmute

Unmute 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-statuses-unmute (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/statuses/{itemId}/unmute
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/statuses/ITEM_ID/unmute" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mastodon: Reply / continue thread (Posts)

POST/accounts/{accountId}/mastodon/statuses/{itemId}/reply

Reply / 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-statuses-reply (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

statusstring

Plain text; URLs count as 23 characters

visibilitystring

publicunlistedprivatedirect

spoiler_textstring
sensitiveboolean
languagestring

ISO 639-1

mediaarray of string

Socialit media ids (uploaded to the instance on publish)

media_idsarray of string

Already-uploaded Mastodon media ids

alt_textsarray of string

Alt text per media item, by index

pollobject
Show 4 child attributes
optionsarray of string

≥ 2 items

expires_inintegerdefault: 86400
multipleboolean
hide_totalsboolean
in_reply_to_idstring
quoted_status_idstring

Mastodon 4.5+

quote_approval_policystring

publicfollowersnobody

scheduled_atstring (date-time)

≥ 5 minutes ahead → ScheduledStatus

threadarray of string

Follow-up replies posted as a self-thread

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/statuses/{itemId}/reply
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/statuses/ITEM_ID/reply" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "string",
    "visibility": "public",
    "spoiler_text": "string",
    "sensitive": true,
    "language": "en"
  }'
Response · 200

Mastodon: Translate (Posts)

POST/accounts/{accountId}/mastodon/statuses/{itemId}/translate

Translate. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-statuses-translate (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

langstring

Target ISO 639-1 (default: user locale)

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/statuses/{itemId}/translate
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/statuses/ITEM_ID/translate" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "lang": "string"
  }'
Response · 200

Mastodon: Edit history (Posts)

POST/accounts/{accountId}/mastodon/statuses/{itemId}/history

Edit 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-statuses-history (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/statuses/{itemId}/history
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/statuses/ITEM_ID/history" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mastodon: Source text (Posts)

POST/accounts/{accountId}/mastodon/statuses/{itemId}/source

Source 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-statuses-source (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/statuses/{itemId}/source
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/statuses/ITEM_ID/source" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mastodon: Thread (Posts)

POST/accounts/{accountId}/mastodon/statuses/{itemId}/context

Thread. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-statuses-context (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/statuses/{itemId}/context
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/statuses/ITEM_ID/context" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mastodon: Delete & redraft (Posts)

POST/accounts/{accountId}/mastodon/statuses/{itemId}/redraft

Deletes 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.

Access: write

Try it with MCPAsk your agent to call mastodon-statuses-redraft (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

statusstring
spoiler_textstring
visibilitystring

publicunlistedprivatedirect

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/statuses/{itemId}/redraft
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/statuses/ITEM_ID/redraft" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "string",
    "spoiler_text": "string",
    "visibility": "public"
  }'
Response · 200

Mastodon: Favourited by (Posts)

POST/accounts/{accountId}/mastodon/statuses/{itemId}/favourited-by

Favourited 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-statuses-favourited-by (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

cursorstring

Opaque cursor from a previous next_cursor

limitintegerdefault: 20

1–80

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/statuses/{itemId}/favourited-by
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/statuses/ITEM_ID/favourited-by" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "cursor": "string",
    "limit": 20
  }'
Response · 200

Mastodon: Boosted by (Posts)

POST/accounts/{accountId}/mastodon/statuses/{itemId}/reblogged-by

Boosted 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-statuses-reblogged-by (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

cursorstring

Opaque cursor from a previous next_cursor

limitintegerdefault: 20

1–80

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/statuses/{itemId}/reblogged-by
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/statuses/ITEM_ID/reblogged-by" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "cursor": "string",
    "limit": 20
  }'
Response · 200

Mastodon: Quotes of this post (Posts)

POST/accounts/{accountId}/mastodon/statuses/{itemId}/quotes

Quotes 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-statuses-quotes (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

cursorstring

Opaque cursor from a previous next_cursor

limitintegerdefault: 20

1–80

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/statuses/{itemId}/quotes
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/statuses/ITEM_ID/quotes" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "cursor": "string",
    "limit": 20
  }'
Response · 200

Mastodon: Revoke a quote (Posts)

POST/accounts/{accountId}/mastodon/statuses/{itemId}/revoke-quote

Revoke 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.

Access: write

Try it with MCPAsk your agent to call mastodon-statuses-revoke-quote (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

quoting_status_idstringrequired

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/statuses/{itemId}/revoke-quote
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/statuses/ITEM_ID/revoke-quote" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "quoting_status_id": "string"
  }'
Response · 200

Mastodon: Who can quote (Posts)

POST/accounts/{accountId}/mastodon/statuses/{itemId}/interaction-policy

Who 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-statuses-interaction-policy (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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_policystringrequired

publicfollowersnobody

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/statuses/{itemId}/interaction-policy
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/statuses/ITEM_ID/interaction-policy" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "quote_approval_policy": "public"
  }'
Response · 200

Mastodon: Posts (People)

POST/accounts/{accountId}/mastodon/accounts/{itemId}/statuses

Posts. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-accounts-statuses (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

cursorstring

Opaque cursor from a previous next_cursor

limitintegerdefault: 20

1–80

only_mediaboolean
exclude_repliesboolean
exclude_reblogsboolean
pinnedboolean
taggedstring

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/accounts/{itemId}/statuses
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/accounts/ITEM_ID/statuses" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "cursor": "string",
    "limit": 20,
    "only_media": true,
    "exclude_replies": true,
    "exclude_reblogs": true
  }'
Response · 200

Scheduled statuses

Mastodon: List Scheduled posts

GET/accounts/{accountId}/mastodon/scheduled-statuses

Statuses 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.

Access: read

Try it with MCPAsk your agent to call mastodon-scheduled-statuses-list (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Opaque cursor from a previous next_cursor

limitintegerdefault: 20

1–80

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 9 item attributes
idstringrequiredread-only
scheduled_atstring (date-time)required
textstringread-only
visibilitystring | null

publicunlistedprivatedirect

spoiler_textstring | null
media_countinteger
poll_optionsarray of string | null
paramsobject
media_attachmentsarray of object
Show 8 item attributes
idstringread-only
typestring

imagegifvvideoaudiounknown

urlstring (uri) | null
preview_urlstring (uri) | null
remote_urlstring (uri) | null
descriptionstring | null
blurhashstring | null
metaobject
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/scheduled-statuses
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/scheduled-statuses" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Create a Scheduled posts item

POST/accounts/{accountId}/mastodon/scheduled-statuses

Schedule 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-scheduled-statuses-create (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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

statusstring

Plain text; URLs count as 23 characters

visibilitystring

publicunlistedprivatedirect

spoiler_textstring
sensitiveboolean
languagestring

ISO 639-1

mediaarray of string

Socialit media ids (uploaded to the instance on publish)

media_idsarray of string

Already-uploaded Mastodon media ids

alt_textsarray of string

Alt text per media item, by index

pollobject
Show 4 child attributes
optionsarray of string

≥ 2 items

expires_inintegerdefault: 86400
multipleboolean
hide_totalsboolean
in_reply_to_idstring
quoted_status_idstring

Mastodon 4.5+

quote_approval_policystring

publicfollowersnobody

scheduled_atstring (date-time)required

≥ 5 minutes ahead → ScheduledStatus

threadarray of string

Follow-up replies posted as a self-thread

Returns object

idstringrequiredread-only
scheduled_atstring (date-time)required
textstringread-only
visibilitystring | null

publicunlistedprivatedirect

spoiler_textstring | null
media_countinteger
poll_optionsarray of string | null
paramsobject
media_attachmentsarray of object
Show 8 item attributes
idstringread-only
typestring

imagegifvvideoaudiounknown

urlstring (uri) | null
preview_urlstring (uri) | null
remote_urlstring (uri) | null
descriptionstring | null
blurhashstring | null
metaobject

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/scheduled-statuses
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/scheduled-statuses" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "string",
    "visibility": "public",
    "spoiler_text": "string",
    "sensitive": true,
    "scheduled_at": "2026-10-13T09:00:00.000Z"
  }'
Response · 201

Mastodon: Get a Scheduled posts item

GET/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.

Access: read

Try it with MCPAsk your agent to call mastodon-scheduled-statuses-get (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstringrequiredread-only
scheduled_atstring (date-time)required
textstringread-only
visibilitystring | null

publicunlistedprivatedirect

spoiler_textstring | null
media_countinteger
poll_optionsarray of string | null
paramsobject
media_attachmentsarray of object
Show 8 item attributes
idstringread-only
typestring

imagegifvvideoaudiounknown

urlstring (uri) | null
preview_urlstring (uri) | null
remote_urlstring (uri) | null
descriptionstring | null
blurhashstring | null
metaobject

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/scheduled-statuses/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/scheduled-statuses/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Update a Scheduled posts item

PATCH/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.

Access: write

Try it with MCPAsk your agent to call mastodon-scheduled-statuses-update (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

scheduled_atstring (date-time)required

Returns object

idstringrequiredread-only
scheduled_atstring (date-time)required
textstringread-only
visibilitystring | null

publicunlistedprivatedirect

spoiler_textstring | null
media_countinteger
poll_optionsarray of string | null
paramsobject
media_attachmentsarray of object
Show 8 item attributes
idstringread-only
typestring

imagegifvvideoaudiounknown

urlstring (uri) | null
preview_urlstring (uri) | null
remote_urlstring (uri) | null
descriptionstring | null
blurhashstring | null
metaobject

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/mastodon/scheduled-statuses/{itemId}
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/scheduled-statuses/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "scheduled_at": "2026-10-13T09:00:00.000Z"
  }'
Response · 200

Mastodon: Delete a Scheduled posts item

DELETE/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.

Access: write

Try it with MCPAsk your agent to call mastodon-scheduled-statuses-delete (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/mastodon/scheduled-statuses/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/scheduled-statuses/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Polls

Mastodon: List Polls

GET/accounts/{accountId}/mastodon/polls

Own 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.

Access: read

Try it with MCPAsk your agent to call mastodon-polls-list (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Opaque cursor from a previous next_cursor

limitintegerdefault: 20

1–80

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 12 item attributes
idstringread-only
expires_atstring (date-time) | null
expiredboolean
multipleboolean
votes_countinteger
voters_countinteger | null
votedboolean
own_votesarray of integer
optionsarray of object
Show 2 item attributes
titlestring
votes_countinteger | null
status_idstring
questionstring
created_atstring (date-time)
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/polls
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/polls" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Get a Polls item

GET/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.

Access: read

Try it with MCPAsk your agent to call mastodon-polls-get (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstringread-only
expires_atstring (date-time) | null
expiredboolean
multipleboolean
votes_countinteger
voters_countinteger | null
votedboolean
own_votesarray of integer
optionsarray of object
Show 2 item attributes
titlestring
votes_countinteger | null
status_idstring
questionstring
created_atstring (date-time)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/polls/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/polls/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Vote (Polls)

POST/accounts/{accountId}/mastodon/polls/{itemId}/vote

Vote. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-polls-vote (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/polls/{itemId}/vote
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/polls/ITEM_ID/vote" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "choices": [
      0
    ]
  }'
Response · 200

Media

Mastodon: Get a Media item

GET/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.

Access: read

Try it with MCPAsk your agent to call mastodon-media-get (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstringread-only
typestring

imagegifvvideoaudiounknown

urlstring (uri) | null
preview_urlstring (uri) | null
remote_urlstring (uri) | null
descriptionstring | null
blurhashstring | null
metaobject

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/media/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/media/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Update a Media item

PATCH/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.

Access: write

Try it with MCPAsk your agent to call mastodon-media-update (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

descriptionstring
focusstring

Returns object

idstringread-only
typestring

imagegifvvideoaudiounknown

urlstring (uri) | null
preview_urlstring (uri) | null
remote_urlstring (uri) | null
descriptionstring | null
blurhashstring | null
metaobject

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/mastodon/media/{itemId}
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/media/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "description": "string",
    "focus": "string"
  }'
Response · 200

Mastodon: Delete a Media item

DELETE/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.

Access: write

Try it with MCPAsk your agent to call mastodon-media-delete (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/mastodon/media/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/media/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Create a Media item

POST/accounts/{accountId}/mastodon/media

POST /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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-media-create (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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

mediastring

Socialit media id

urlstring (uri)

Or a public URL

descriptionstring
focusstring

"x,y" in -1.0..1.0

thumbnailstring

Custom thumbnail (video/audio)

Returns object

idstringread-only
typestring

imagegifvvideoaudiounknown

urlstring (uri) | null
preview_urlstring (uri) | null
remote_urlstring (uri) | null
descriptionstring | null
blurhashstring | null
metaobject

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/media
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/media" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "media": "string",
    "url": "https://example.com",
    "description": "string",
    "focus": "string",
    "thumbnail": "string"
  }'
Response · 201

Pinned statuses

Mastodon: List Pinned posts

GET/accounts/{accountId}/mastodon/pinned-statuses

Statuses 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.

Access: read

Try it with MCPAsk your agent to call mastodon-pinned-statuses-list (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Opaque cursor from a previous next_cursor

limitintegerdefault: 20

1–80

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 29 item attributes
idstringrequiredread-only
uristring (uri)
urlstring (uri) | null
created_atstring (date-time)
edited_atstring (date-time) | null
textstringread-only
contentstring
spoiler_textstring
sensitiveboolean
visibilitystring

publicunlistedprivatedirect

languagestring | null
in_reply_to_idstring | null
in_reply_to_account_idstring | null
replies_countinteger
reblogs_countinteger
favourites_countinteger
quotes_countinteger | null
authorstring
author_namestring | null
media_attachmentsarray of object
Show 8 item attributes
idstringread-only
typestring

imagegifvvideoaudiounknown

urlstring (uri) | null
preview_urlstring (uri) | null
remote_urlstring (uri) | null
descriptionstring | null
blurhashstring | null
metaobject
pollobject | null
Show 9 child attributes
idstringread-only
expires_atstring (date-time) | null
expiredboolean
multipleboolean
votes_countinteger
voters_countinteger | null
votedboolean
own_votesarray of integer
optionsarray of object
Show 2 item attributes
titlestring
votes_countinteger | null
favouritedboolean
rebloggedboolean
bookmarkedboolean
mutedboolean
pinnedboolean
is_reblogboolean
quoteobject | null
Show 2 child attributes
statestring
quoted_statusobject | null
quote_approvalobject | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/pinned-statuses
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/pinned-statuses" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Create a Pinned posts item

POST/accounts/{accountId}/mastodon/pinned-statuses

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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-pinned-statuses-create (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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_idstringrequired

Returns object

idstringrequiredread-only
uristring (uri)
urlstring (uri) | null
created_atstring (date-time)
edited_atstring (date-time) | null
textstringread-only
contentstring
spoiler_textstring
sensitiveboolean
visibilitystring

publicunlistedprivatedirect

languagestring | null
in_reply_to_idstring | null
in_reply_to_account_idstring | null
replies_countinteger
reblogs_countinteger
favourites_countinteger
quotes_countinteger | null
authorstring
author_namestring | null
media_attachmentsarray of object
Show 8 item attributes
idstringread-only
typestring

imagegifvvideoaudiounknown

urlstring (uri) | null
preview_urlstring (uri) | null
remote_urlstring (uri) | null
descriptionstring | null
blurhashstring | null
metaobject
pollobject | null
Show 9 child attributes
idstringread-only
expires_atstring (date-time) | null
expiredboolean
multipleboolean
votes_countinteger
voters_countinteger | null
votedboolean
own_votesarray of integer
optionsarray of object
Show 2 item attributes
titlestring
votes_countinteger | null
favouritedboolean
rebloggedboolean
bookmarkedboolean
mutedboolean
pinnedboolean
is_reblogboolean
quoteobject | null
Show 2 child attributes
statestring
quoted_statusobject | null
quote_approvalobject | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/pinned-statuses
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/pinned-statuses" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "status_id": "string"
  }'
Response · 201

Mastodon: Delete a Pinned posts item

DELETE/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.

Access: write

Try it with MCPAsk your agent to call mastodon-pinned-statuses-delete (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/mastodon/pinned-statuses/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/pinned-statuses/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Notifications

Mastodon: List Notifications

GET/accounts/{accountId}/mastodon/notifications

All 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.

Access: read

Try it with MCPAsk your agent to call mastodon-notifications-list (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Opaque cursor from a previous next_cursor

limitintegerdefault: 20

1–80

typesarray of string
exclude_typesarray of string
account_idstring
include_filteredboolean

Include notifications filtered by the notification policy (4.3+)

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 15 item attributes
idstringrequiredread-only
typestringrequired

mentionstatusreblogfollowfollow_requestfavouritepollupdateadmin.sign_upadmin.reportsevered_relationshipsmoderation_warningquotequoted_updateadded_to_collectioncollection_update

created_atstring (date-time)
group_keystring | null
authorstring | null
author_namestring | null
textstring | null
status_idstring | null
visibilitystring | null
filteredboolean | null
accountobject | null
Show 23 child attributes
idstringrequiredread-only
acctstringrequired
usernamestring
display_namestring
urlstring (uri)
avatarstring
headerstring
notestring
note_textstring
lockedboolean
botboolean
groupboolean
discoverableboolean | null
indexableboolean | null
followers_countinteger
following_countinteger
statuses_countinteger
created_atstring (date-time)
last_status_atstring (date) | null
fieldsarray of object
Show 3 item attributes
namestring
valuestring
verified_atstring (date-time) | null
movedobject | null
suspendedboolean
limitedboolean
statusobject | null
Show 29 child attributes
idstringrequiredread-only
uristring (uri)
urlstring (uri) | null
created_atstring (date-time)
edited_atstring (date-time) | null
textstringread-only
contentstring
spoiler_textstring
sensitiveboolean
visibilitystring

publicunlistedprivatedirect

languagestring | null
in_reply_to_idstring | null
in_reply_to_account_idstring | null
replies_countinteger
reblogs_countinteger
favourites_countinteger
quotes_countinteger | null
authorstring
author_namestring | null
media_attachmentsarray of object
Show 8 item attributes
idstringread-only
typestring

imagegifvvideoaudiounknown

urlstring (uri) | null
preview_urlstring (uri) | null
remote_urlstring (uri) | null
descriptionstring | null
blurhashstring | null
metaobject
pollobject | null
Show 9 child attributes
idstringread-only
expires_atstring (date-time) | null
expiredboolean
multipleboolean
votes_countinteger
voters_countinteger | null
votedboolean
own_votesarray of integer
optionsarray of object
Show 2 item attributes
titlestring
votes_countinteger | null
favouritedboolean
rebloggedboolean
bookmarkedboolean
mutedboolean
pinnedboolean
is_reblogboolean
quoteobject | null
Show 2 child attributes
statestring
quoted_statusobject | null
quote_approvalobject | null
reportobject | null
moderation_warningobject | null
eventobject | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/notifications
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/notifications" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Get a Notifications item

GET/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.

Access: read

Try it with MCPAsk your agent to call mastodon-notifications-get (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstringrequiredread-only
typestringrequired

mentionstatusreblogfollowfollow_requestfavouritepollupdateadmin.sign_upadmin.reportsevered_relationshipsmoderation_warningquotequoted_updateadded_to_collectioncollection_update

created_atstring (date-time)
group_keystring | null
authorstring | null
author_namestring | null
textstring | null
status_idstring | null
visibilitystring | null
filteredboolean | null
accountobject | null
Show 23 child attributes
idstringrequiredread-only
acctstringrequired
usernamestring
display_namestring
urlstring (uri)
avatarstring
headerstring
notestring
note_textstring
lockedboolean
botboolean
groupboolean
discoverableboolean | null
indexableboolean | null
followers_countinteger
following_countinteger
statuses_countinteger
created_atstring (date-time)
last_status_atstring (date) | null
fieldsarray of object
Show 3 item attributes
namestring
valuestring
verified_atstring (date-time) | null
movedobject | null
suspendedboolean
limitedboolean
statusobject | null
Show 29 child attributes
idstringrequiredread-only
uristring (uri)
urlstring (uri) | null
created_atstring (date-time)
edited_atstring (date-time) | null
textstringread-only
contentstring
spoiler_textstring
sensitiveboolean
visibilitystring

publicunlistedprivatedirect

languagestring | null
in_reply_to_idstring | null
in_reply_to_account_idstring | null
replies_countinteger
reblogs_countinteger
favourites_countinteger
quotes_countinteger | null
authorstring
author_namestring | null
media_attachmentsarray of object
Show 8 item attributes
idstringread-only
typestring

imagegifvvideoaudiounknown

urlstring (uri) | null
preview_urlstring (uri) | null
remote_urlstring (uri) | null
descriptionstring | null
blurhashstring | null
metaobject
pollobject | null
Show 9 child attributes
idstringread-only
expires_atstring (date-time) | null
expiredboolean
multipleboolean
votes_countinteger
voters_countinteger | null
votedboolean
own_votesarray of integer
optionsarray of object
Show 2 item attributes
titlestring
votes_countinteger | null
favouritedboolean
rebloggedboolean
bookmarkedboolean
mutedboolean
pinnedboolean
is_reblogboolean
quoteobject | null
Show 2 child attributes
statestring
quoted_statusobject | null
quote_approvalobject | null
reportobject | null
moderation_warningobject | null
eventobject | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/notifications/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/notifications/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Dismiss (Notifications)

POST/accounts/{accountId}/mastodon/notifications/{itemId}/dismiss

Dismiss. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-notifications-dismiss (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/notifications/{itemId}/dismiss
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/notifications/ITEM_ID/dismiss" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mastodon: Clear all (Notifications)

POST/accounts/{accountId}/mastodon/notifications/clear

Clear 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.

Access: write

Try it with MCPAsk your agent to call mastodon-notifications-clear (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/notifications/clear
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/notifications/clear" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mastodon: Unread count (Notifications)

POST/accounts/{accountId}/mastodon/notifications/unread-count

Unread 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-notifications-unread-count (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/notifications/unread-count
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/notifications/unread-count" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mastodon: Reply (Notifications)

POST/accounts/{accountId}/mastodon/notifications/{itemId}/reply

Reply. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-notifications-reply (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

statusstring

Plain text; URLs count as 23 characters

visibilitystring

publicunlistedprivatedirect

spoiler_textstring
sensitiveboolean
languagestring

ISO 639-1

mediaarray of string

Socialit media ids (uploaded to the instance on publish)

media_idsarray of string

Already-uploaded Mastodon media ids

alt_textsarray of string

Alt text per media item, by index

pollobject
Show 4 child attributes
optionsarray of string

≥ 2 items

expires_inintegerdefault: 86400
multipleboolean
hide_totalsboolean
in_reply_to_idstring
quoted_status_idstring

Mastodon 4.5+

quote_approval_policystring

publicfollowersnobody

scheduled_atstring (date-time)

≥ 5 minutes ahead → ScheduledStatus

threadarray of string

Follow-up replies posted as a self-thread

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/notifications/{itemId}/reply
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/notifications/ITEM_ID/reply" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "string",
    "visibility": "public",
    "spoiler_text": "string",
    "sensitive": true,
    "language": "en"
  }'
Response · 200

Grouped notifications

Mastodon: List Grouped notifications

GET/accounts/{accountId}/mastodon/grouped-notifications

Notifications 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.

Access: read

Try it with MCPAsk your agent to call mastodon-grouped-notifications-list (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Opaque cursor from a previous next_cursor

limitintegerdefault: 20

1–80

typesarray of string
exclude_typesarray of string
grouped_typesarray of string
account_idstring
include_filteredboolean
expand_accountsstring

fullpartial_avatars

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 10 item attributes
group_keystringrequiredread-only
typestring

mentionstatusreblogfollowfollow_requestfavouritepollupdateadmin.sign_upadmin.reportsevered_relationshipsmoderation_warningquotequoted_updateadded_to_collectioncollection_update

notifications_countinteger
most_recent_notification_idstring
created_atstring (date-time) | null
authorstring | null
textstring | null
accountsarray of object
Show 23 item attributes
idstringrequiredread-only
acctstringrequired
usernamestring
display_namestring
urlstring (uri)
avatarstring
headerstring
notestring
note_textstring
lockedboolean
botboolean
groupboolean
discoverableboolean | null
indexableboolean | null
followers_countinteger
following_countinteger
statuses_countinteger
created_atstring (date-time)
last_status_atstring (date) | null
fieldsarray of object
Show 3 item attributes
namestring
valuestring
verified_atstring (date-time) | null
movedobject | null
suspendedboolean
limitedboolean
statusobject | null
Show 29 child attributes
idstringrequiredread-only
uristring (uri)
urlstring (uri) | null
created_atstring (date-time)
edited_atstring (date-time) | null
textstringread-only
contentstring
spoiler_textstring
sensitiveboolean
visibilitystring

publicunlistedprivatedirect

languagestring | null
in_reply_to_idstring | null
in_reply_to_account_idstring | null
replies_countinteger
reblogs_countinteger
favourites_countinteger
quotes_countinteger | null
authorstring
author_namestring | null
media_attachmentsarray of object
Show 8 item attributes
idstringread-only
typestring

imagegifvvideoaudiounknown

urlstring (uri) | null
preview_urlstring (uri) | null
remote_urlstring (uri) | null
descriptionstring | null
blurhashstring | null
metaobject
pollobject | null
Show 9 child attributes
idstringread-only
expires_atstring (date-time) | null
expiredboolean
multipleboolean
votes_countinteger
voters_countinteger | null
votedboolean
own_votesarray of integer
optionsarray of object
Show 2 item attributes
titlestring
votes_countinteger | null
favouritedboolean
rebloggedboolean
bookmarkedboolean
mutedboolean
pinnedboolean
is_reblogboolean
quoteobject | null
Show 2 child attributes
statestring
quoted_statusobject | null
quote_approvalobject | null
sample_account_idsarray of string
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/grouped-notifications
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/grouped-notifications" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Get a Grouped notifications item

GET/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.

Access: read

Try it with MCPAsk your agent to call mastodon-grouped-notifications-get (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

group_keystringrequiredread-only
typestring

mentionstatusreblogfollowfollow_requestfavouritepollupdateadmin.sign_upadmin.reportsevered_relationshipsmoderation_warningquotequoted_updateadded_to_collectioncollection_update

notifications_countinteger
most_recent_notification_idstring
created_atstring (date-time) | null
authorstring | null
textstring | null
accountsarray of object
Show 23 item attributes
idstringrequiredread-only
acctstringrequired
usernamestring
display_namestring
urlstring (uri)
avatarstring
headerstring
notestring
note_textstring
lockedboolean
botboolean
groupboolean
discoverableboolean | null
indexableboolean | null
followers_countinteger
following_countinteger
statuses_countinteger
created_atstring (date-time)
last_status_atstring (date) | null
fieldsarray of object
Show 3 item attributes
namestring
valuestring
verified_atstring (date-time) | null
movedobject | null
suspendedboolean
limitedboolean
statusobject | null
Show 29 child attributes
idstringrequiredread-only
uristring (uri)
urlstring (uri) | null
created_atstring (date-time)
edited_atstring (date-time) | null
textstringread-only
contentstring
spoiler_textstring
sensitiveboolean
visibilitystring

publicunlistedprivatedirect

languagestring | null
in_reply_to_idstring | null
in_reply_to_account_idstring | null
replies_countinteger
reblogs_countinteger
favourites_countinteger
quotes_countinteger | null
authorstring
author_namestring | null
media_attachmentsarray of object
Show 8 item attributes
idstringread-only
typestring

imagegifvvideoaudiounknown

urlstring (uri) | null
preview_urlstring (uri) | null
remote_urlstring (uri) | null
descriptionstring | null
blurhashstring | null
metaobject
pollobject | null
Show 9 child attributes
idstringread-only
expires_atstring (date-time) | null
expiredboolean
multipleboolean
votes_countinteger
voters_countinteger | null
votedboolean
own_votesarray of integer
optionsarray of object
Show 2 item attributes
titlestring
votes_countinteger | null
favouritedboolean
rebloggedboolean
bookmarkedboolean
mutedboolean
pinnedboolean
is_reblogboolean
quoteobject | null
Show 2 child attributes
statestring
quoted_statusobject | null
quote_approvalobject | null
sample_account_idsarray of string

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/grouped-notifications/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/grouped-notifications/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Dismiss group (Grouped notifications)

POST/accounts/{accountId}/mastodon/grouped-notifications/{itemId}/dismiss

Dismiss 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-grouped-notifications-dismiss (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/grouped-notifications/{itemId}/dismiss
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/grouped-notifications/ITEM_ID/dismiss" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mastodon: Accounts in group (Grouped notifications)

POST/accounts/{accountId}/mastodon/grouped-notifications/{itemId}/accounts

Accounts 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-grouped-notifications-accounts (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/grouped-notifications/{itemId}/accounts
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/grouped-notifications/ITEM_ID/accounts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mastodon: Unread count (Grouped notifications)

POST/accounts/{accountId}/mastodon/grouped-notifications/unread-count

Unread 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-grouped-notifications-unread-count (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/grouped-notifications/unread-count
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/grouped-notifications/unread-count" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Notification policy

Mastodon: Get Notification filtering

GET/accounts/{accountId}/mastodon/notification-policy

Filter 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.

Access: read

Try it with MCPAsk your agent to call mastodon-notification-policy-get (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

for_not_followingstring

acceptfilterdrop

for_not_followersstring

acceptfilterdrop

for_new_accountsstring

acceptfilterdrop

for_private_mentionsstring

acceptfilterdrop

for_limited_accountsstring

acceptfilterdrop

summaryobjectread-only
Show 2 child attributes
pending_requests_countinteger
pending_notifications_countinteger

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/notification-policy
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/notification-policy" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Update Notification filtering

PATCH/accounts/{accountId}/mastodon/notification-policy

Filter 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.

Access: write

Try it with MCPAsk your agent to call mastodon-notification-policy-update (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Body object

for_not_followingstring

acceptfilterdrop

for_not_followersstring

acceptfilterdrop

for_new_accountsstring

acceptfilterdrop

for_private_mentionsstring

acceptfilterdrop

for_limited_accountsstring

acceptfilterdrop

Returns object

for_not_followingstring

acceptfilterdrop

for_not_followersstring

acceptfilterdrop

for_new_accountsstring

acceptfilterdrop

for_private_mentionsstring

acceptfilterdrop

for_limited_accountsstring

acceptfilterdrop

summaryobjectread-only
Show 2 child attributes
pending_requests_countinteger
pending_notifications_countinteger

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/mastodon/notification-policy
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/notification-policy" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "for_not_following": "accept",
    "for_not_followers": "accept",
    "for_new_accounts": "accept",
    "for_private_mentions": "accept",
    "for_limited_accounts": "accept"
  }'
Response · 200

Notification requests

Mastodon: List Message requests

GET/accounts/{accountId}/mastodon/notification-requests

Notifications 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.

Access: read

Try it with MCPAsk your agent to call mastodon-notification-requests-list (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Opaque cursor from a previous next_cursor

limitintegerdefault: 20

1–80

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 8 item attributes
idstringrequiredread-only
created_atstring (date-time)
updated_atstring (date-time)
notifications_countstring
authorstring
textstring | null
accountobject
Show 23 child attributes
idstringrequiredread-only
acctstringrequired
usernamestring
display_namestring
urlstring (uri)
avatarstring
headerstring
notestring
note_textstring
lockedboolean
botboolean
groupboolean
discoverableboolean | null
indexableboolean | null
followers_countinteger
following_countinteger
statuses_countinteger
created_atstring (date-time)
last_status_atstring (date) | null
fieldsarray of object
Show 3 item attributes
namestring
valuestring
verified_atstring (date-time) | null
movedobject | null
suspendedboolean
limitedboolean
last_statusobject | null
Show 29 child attributes
idstringrequiredread-only
uristring (uri)
urlstring (uri) | null
created_atstring (date-time)
edited_atstring (date-time) | null
textstringread-only
contentstring
spoiler_textstring
sensitiveboolean
visibilitystring

publicunlistedprivatedirect

languagestring | null
in_reply_to_idstring | null
in_reply_to_account_idstring | null
replies_countinteger
reblogs_countinteger
favourites_countinteger
quotes_countinteger | null
authorstring
author_namestring | null
media_attachmentsarray of object
Show 8 item attributes
idstringread-only
typestring

imagegifvvideoaudiounknown

urlstring (uri) | null
preview_urlstring (uri) | null
remote_urlstring (uri) | null
descriptionstring | null
blurhashstring | null
metaobject
pollobject | null
Show 9 child attributes
idstringread-only
expires_atstring (date-time) | null
expiredboolean
multipleboolean
votes_countinteger
voters_countinteger | null
votedboolean
own_votesarray of integer
optionsarray of object
Show 2 item attributes
titlestring
votes_countinteger | null
favouritedboolean
rebloggedboolean
bookmarkedboolean
mutedboolean
pinnedboolean
is_reblogboolean
quoteobject | null
Show 2 child attributes
statestring
quoted_statusobject | null
quote_approvalobject | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/notification-requests
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/notification-requests" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Get a Message requests item

GET/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.

Access: read

Try it with MCPAsk your agent to call mastodon-notification-requests-get (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstringrequiredread-only
created_atstring (date-time)
updated_atstring (date-time)
notifications_countstring
authorstring
textstring | null
accountobject
Show 23 child attributes
idstringrequiredread-only
acctstringrequired
usernamestring
display_namestring
urlstring (uri)
avatarstring
headerstring
notestring
note_textstring
lockedboolean
botboolean
groupboolean
discoverableboolean | null
indexableboolean | null
followers_countinteger
following_countinteger
statuses_countinteger
created_atstring (date-time)
last_status_atstring (date) | null
fieldsarray of object
Show 3 item attributes
namestring
valuestring
verified_atstring (date-time) | null
movedobject | null
suspendedboolean
limitedboolean
last_statusobject | null
Show 29 child attributes
idstringrequiredread-only
uristring (uri)
urlstring (uri) | null
created_atstring (date-time)
edited_atstring (date-time) | null
textstringread-only
contentstring
spoiler_textstring
sensitiveboolean
visibilitystring

publicunlistedprivatedirect

languagestring | null
in_reply_to_idstring | null
in_reply_to_account_idstring | null
replies_countinteger
reblogs_countinteger
favourites_countinteger
quotes_countinteger | null
authorstring
author_namestring | null
media_attachmentsarray of object
Show 8 item attributes
idstringread-only
typestring

imagegifvvideoaudiounknown

urlstring (uri) | null
preview_urlstring (uri) | null
remote_urlstring (uri) | null
descriptionstring | null
blurhashstring | null
metaobject
pollobject | null
Show 9 child attributes
idstringread-only
expires_atstring (date-time) | null
expiredboolean
multipleboolean
votes_countinteger
voters_countinteger | null
votedboolean
own_votesarray of integer
optionsarray of object
Show 2 item attributes
titlestring
votes_countinteger | null
favouritedboolean
rebloggedboolean
bookmarkedboolean
mutedboolean
pinnedboolean
is_reblogboolean
quoteobject | null
Show 2 child attributes
statestring
quoted_statusobject | null
quote_approvalobject | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/notification-requests/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/notification-requests/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Accept (Message requests)

POST/accounts/{accountId}/mastodon/notification-requests/{itemId}/accept

Accept. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-notification-requests-accept (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/notification-requests/{itemId}/accept
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/notification-requests/ITEM_ID/accept" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mastodon: Dismiss (Message requests)

POST/accounts/{accountId}/mastodon/notification-requests/{itemId}/dismiss

Dismiss. 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.

Access: write

Try it with MCPAsk your agent to call mastodon-notification-requests-dismiss (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/notification-requests/{itemId}/dismiss
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/notification-requests/ITEM_ID/dismiss" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mastodon: Accept selected (Message requests)

POST/accounts/{accountId}/mastodon/notification-requests/accept-many

Accept 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-notification-requests-accept-many (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/notification-requests/accept-many
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/notification-requests/accept-many" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "ids": [
      "string"
    ]
  }'
Response · 200

Mastodon: Dismiss selected (Message requests)

POST/accounts/{accountId}/mastodon/notification-requests/dismiss-many

Dismiss 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.

Access: write

Try it with MCPAsk your agent to call mastodon-notification-requests-dismiss-many (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Body object

idsarray of stringrequired

≥ 1 items

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/notification-requests/dismiss-many
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/notification-requests/dismiss-many" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ids": [
      "string"
    ]
  }'
Response · 200

Mastodon: Merge status (Message requests)

POST/accounts/{accountId}/mastodon/notification-requests/merged

Merge 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-notification-requests-merged (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/notification-requests/merged
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/notification-requests/merged" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Conversations

Mastodon: List Direct messages

GET/accounts/{accountId}/mastodon/conversations

Private 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.

Access: read

Try it with MCPAsk your agent to call mastodon-conversations-list (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Opaque cursor from a previous next_cursor

limitintegerdefault: 20

1–80

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 8 item attributes
idstringrequiredread-only
updated_atstring (date-time) | null
unreadboolean
unread_countinteger
last_messagestring | null
last_status_idstring | null
participantsarray of object
Show 5 item attributes
idstring
namestring
usernamestring
avatar_urlstring (uri) | null
urlstring (uri) | null
messagesarray of object
Show 7 item attributes
idstring
textstring
directionstring

inout

sent_atstring (date-time)
from_idstring
from_usernamestring
attachmentsarray of object
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/conversations
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/conversations" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Create a Direct messages item

POST/accounts/{accountId}/mastodon/conversations

Start 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-conversations-create (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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

textstring
mediaarray of string
spoiler_textstring
sensitiveboolean

Returns object

idstringrequiredread-only
updated_atstring (date-time) | null
unreadboolean
unread_countinteger
last_messagestring | null
last_status_idstring | null
participantsarray of object
Show 5 item attributes
idstring
namestring
usernamestring
avatar_urlstring (uri) | null
urlstring (uri) | null
messagesarray of object
Show 7 item attributes
idstring
textstring
directionstring

inout

sent_atstring (date-time)
from_idstring
from_usernamestring
attachmentsarray of object

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/conversations
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/conversations" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "to": [
      "+15551234567"
    ],
    "text": "string",
    "media": [
      "string"
    ],
    "spoiler_text": "string",
    "sensitive": true
  }'
Response · 201

Mastodon: Get a Direct messages item

GET/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.

Access: read

Try it with MCPAsk your agent to call mastodon-conversations-get (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstringrequiredread-only
updated_atstring (date-time) | null
unreadboolean
unread_countinteger
last_messagestring | null
last_status_idstring | null
participantsarray of object
Show 5 item attributes
idstring
namestring
usernamestring
avatar_urlstring (uri) | null
urlstring (uri) | null
messagesarray of object
Show 7 item attributes
idstring
textstring
directionstring

inout

sent_atstring (date-time)
from_idstring
from_usernamestring
attachmentsarray of object

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/conversations/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/conversations/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Delete a Direct messages item

DELETE/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.

Access: write

Try it with MCPAsk your agent to call mastodon-conversations-delete (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/mastodon/conversations/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/conversations/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Mark as read (Direct messages)

POST/accounts/{accountId}/mastodon/conversations/{itemId}/read

Mark 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-conversations-read (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/conversations/{itemId}/read
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/conversations/ITEM_ID/read" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mastodon: Reply (Direct messages)

POST/accounts/{accountId}/mastodon/conversations/{itemId}/reply

Reply. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-conversations-reply (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

textstring
mediaarray of string
spoiler_textstring
sensitiveboolean

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/conversations/{itemId}/reply
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/conversations/ITEM_ID/reply" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "string",
    "media": [
      "string"
    ],
    "spoiler_text": "string",
    "sensitive": true
  }'
Response · 200

Comments

Mastodon: List Comments

GET/accounts/{accountId}/mastodon/comments

Replies 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.

Access: read

Try it with MCPAsk your agent to call mastodon-comments-list (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

post_idstring

Replies to one post; omit for recent replies across your posts

recent_postsintegerdefault: 5

How many recent own posts to scan when post_id is omitted

≤ 40

limitintegerdefault: 40

≤ 200

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 17 item attributes
idstringrequiredread-only
textstring
authorstring
author_namestring | null
author_avatarstring (uri) | null
created_atstring (date-time)
like_countinteger
reply_countinteger
share_countinteger
parent_idstring | null
post_idstring | null
visibilitystring
likedboolean
is_ownboolean
spoiler_textstring | null
urlstring (uri) | null
attachmentsarray of object
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/comments
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/comments" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Get a Comments item

GET/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.

Access: read

Try it with MCPAsk your agent to call mastodon-comments-get (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstringrequiredread-only
textstring
authorstring
author_namestring | null
author_avatarstring (uri) | null
created_atstring (date-time)
like_countinteger
reply_countinteger
share_countinteger
parent_idstring | null
post_idstring | null
visibilitystring
likedboolean
is_ownboolean
spoiler_textstring | null
urlstring (uri) | null
attachmentsarray of object

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/comments/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/comments/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Delete a Comments item

DELETE/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.

Access: write

Try it with MCPAsk your agent to call mastodon-comments-delete (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/mastodon/comments/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/comments/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Reply (Comments)

POST/accounts/{accountId}/mastodon/comments/{itemId}/reply

Reply. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-comments-reply (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

textstringrequired
visibilitystring

publicunlistedprivatedirect

mention_allboolean
mediaarray of string

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/comments/{itemId}/reply
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/comments/ITEM_ID/reply" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "string",
    "visibility": "public",
    "mention_all": true,
    "media": [
      "string"
    ]
  }'
Response · 200

Mastodon: Favourite (Comments)

POST/accounts/{accountId}/mastodon/comments/{itemId}/like

Favourite. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-comments-like (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/comments/{itemId}/like
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/comments/ITEM_ID/like" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mastodon: Unfavourite (Comments)

POST/accounts/{accountId}/mastodon/comments/{itemId}/unlike

Unfavourite. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-comments-unlike (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/comments/{itemId}/unlike
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/comments/ITEM_ID/unlike" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mastodon: Mute thread (Comments)

POST/accounts/{accountId}/mastodon/comments/{itemId}/mute-thread

Mute 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-comments-mute-thread (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/comments/{itemId}/mute-thread
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/comments/ITEM_ID/mute-thread" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Followers

Mastodon: List Followers

GET/accounts/{accountId}/mastodon/followers

Cursor pagination: pass next_cursor back as cursor. Network docs: https://docs.joinmastodon.org/methods/accounts/#followers Generic route: /v1/accounts/{accountId}/focus/followers.

Access: read

Try it with MCPAsk your agent to call mastodon-followers-list (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Opaque cursor from a previous next_cursor

limitintegerdefault: 20

1–80

account_idstring

Defaults to the connected account

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 23 item attributes
idstringrequiredread-only
acctstringrequired
usernamestring
display_namestring
urlstring (uri)
avatarstring
headerstring
notestring
note_textstring
lockedboolean
botboolean
groupboolean
discoverableboolean | null
indexableboolean | null
followers_countinteger
following_countinteger
statuses_countinteger
created_atstring (date-time)
last_status_atstring (date) | null
fieldsarray of object
Show 3 item attributes
namestring
valuestring
verified_atstring (date-time) | null
movedobject | null
suspendedboolean
limitedboolean
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/followers
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/followers" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Remove from followers (Followers)

POST/accounts/{accountId}/mastodon/followers/{itemId}/remove-from-followers

Remove from followers. Destructive. Requires scopes: write:follows. Network docs: https://docs.joinmastodon.org/methods/accounts/#followers Generic route: /v1/accounts/{accountId}/focus/followers.

Access: write

Try it with MCPAsk your agent to call mastodon-followers-remove-from-followers (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/followers/{itemId}/remove-from-followers
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/followers/ITEM_ID/remove-from-followers" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mastodon: Follow (Followers)

POST/accounts/{accountId}/mastodon/followers/{itemId}/follow

Follow. Requires scopes: write:follows. Network docs: https://docs.joinmastodon.org/methods/accounts/#followers Generic route: /v1/accounts/{accountId}/focus/followers.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-followers-follow (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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: true
notifyboolean
languagesarray of string

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/followers/{itemId}/follow
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/followers/ITEM_ID/follow" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "reblogs": true,
    "notify": true,
    "languages": [
      "string"
    ]
  }'
Response · 200

Mastodon: Block (Followers)

POST/accounts/{accountId}/mastodon/followers/{itemId}/block

Block. Destructive. Requires scopes: write:blocks. Network docs: https://docs.joinmastodon.org/methods/accounts/#followers Generic route: /v1/accounts/{accountId}/focus/followers.

Access: write

Try it with MCPAsk your agent to call mastodon-followers-block (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/followers/{itemId}/block
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/followers/ITEM_ID/block" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Following

Mastodon: List Following

GET/accounts/{accountId}/mastodon/following

Cursor pagination: pass next_cursor back as cursor. Network docs: https://docs.joinmastodon.org/methods/accounts/#following Generic route: /v1/accounts/{accountId}/focus/following.

Access: read

Try it with MCPAsk your agent to call mastodon-following-list (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Opaque cursor from a previous next_cursor

limitintegerdefault: 20

1–80

account_idstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 23 item attributes
idstringrequiredread-only
acctstringrequired
usernamestring
display_namestring
urlstring (uri)
avatarstring
headerstring
notestring
note_textstring
lockedboolean
botboolean
groupboolean
discoverableboolean | null
indexableboolean | null
followers_countinteger
following_countinteger
statuses_countinteger
created_atstring (date-time)
last_status_atstring (date) | null
fieldsarray of object
Show 3 item attributes
namestring
valuestring
verified_atstring (date-time) | null
movedobject | null
suspendedboolean
limitedboolean
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/following
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/following" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Create a Following item

POST/accounts/{accountId}/mastodon/following

Follow 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-following-create (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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_idstring
acctstring

@user@domain

reblogsbooleandefault: true
notifyboolean
languagesarray of string

Returns object

idstringrequiredread-only
acctstringrequired
usernamestring
display_namestring
urlstring (uri)
avatarstring
headerstring
notestring
note_textstring
lockedboolean
botboolean
groupboolean
discoverableboolean | null
indexableboolean | null
followers_countinteger
following_countinteger
statuses_countinteger
created_atstring (date-time)
last_status_atstring (date) | null
fieldsarray of object
Show 3 item attributes
namestring
valuestring
verified_atstring (date-time) | null
movedobject | null
suspendedboolean
limitedboolean

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/following
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/following" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "string",
    "acct": "string",
    "reblogs": true,
    "notify": true,
    "languages": [
      "string"
    ]
  }'
Response · 201

Mastodon: Delete a Following item

DELETE/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.

Access: write

Try it with MCPAsk your agent to call mastodon-following-delete (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/mastodon/following/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/following/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Notify on new posts (Following)

POST/accounts/{accountId}/mastodon/following/{itemId}/notify

Notify on new posts. Requires scopes: write:follows. Network docs: https://docs.joinmastodon.org/methods/accounts/#following Generic route: /v1/accounts/{accountId}/focus/following.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-following-notify (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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: true

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/following/{itemId}/notify
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/following/ITEM_ID/notify" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "notify": true
  }'
Response · 200

Mastodon: Mute (Following)

POST/accounts/{accountId}/mastodon/following/{itemId}/mute

Mute. Requires scopes: write:mutes. Network docs: https://docs.joinmastodon.org/methods/accounts/#following Generic route: /v1/accounts/{accountId}/focus/following.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-following-mute (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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: true
durationinteger

Seconds; 0 = indefinite

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/following/{itemId}/mute
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/following/ITEM_ID/mute" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "notifications": true,
    "duration": 0
  }'
Response · 200

Follow requests

Mastodon: List Follow requests

GET/accounts/{accountId}/mastodon/follow-requests

Pending 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.

Access: read

Try it with MCPAsk your agent to call mastodon-follow-requests-list (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Opaque cursor from a previous next_cursor

limitintegerdefault: 20

1–80

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 23 item attributes
idstringrequiredread-only
acctstringrequired
usernamestring
display_namestring
urlstring (uri)
avatarstring
headerstring
notestring
note_textstring
lockedboolean
botboolean
groupboolean
discoverableboolean | null
indexableboolean | null
followers_countinteger
following_countinteger
statuses_countinteger
created_atstring (date-time)
last_status_atstring (date) | null
fieldsarray of object
Show 3 item attributes
namestring
valuestring
verified_atstring (date-time) | null
movedobject | null
suspendedboolean
limitedboolean
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/follow-requests
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/follow-requests" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Accept (Follow requests)

POST/accounts/{accountId}/mastodon/follow-requests/{itemId}/authorize

Accept. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-follow-requests-authorize (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/follow-requests/{itemId}/authorize
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/follow-requests/ITEM_ID/authorize" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mastodon: Reject (Follow requests)

POST/accounts/{accountId}/mastodon/follow-requests/{itemId}/reject

Reject. 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.

Access: write

Try it with MCPAsk your agent to call mastodon-follow-requests-reject (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/follow-requests/{itemId}/reject
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/follow-requests/ITEM_ID/reject" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Relationships

Mastodon: List Relationships

GET/accounts/{accountId}/mastodon/relationships

Follow / 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.

Access: read

Try it with MCPAsk your agent to call mastodon-relationships-list (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

idsarray of stringrequired

≥ 1 items

with_suspendedboolean

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 16 item attributes
idstringrequiredread-only
followingboolean
showing_reblogsboolean
notifyingboolean
languagesarray of string | null
followed_byboolean
blockingboolean
blocked_byboolean
mutingboolean
muting_notificationsboolean
muting_expires_atstring (date-time) | null
requestedboolean
requested_byboolean
domain_blockingboolean
endorsedboolean
notestring
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/relationships
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/relationships?ids=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Follow (Relationships)

POST/accounts/{accountId}/mastodon/relationships/{itemId}/follow

Follow. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-relationships-follow (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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: true
notifyboolean
languagesarray of string

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/relationships/{itemId}/follow
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/relationships/ITEM_ID/follow" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "reblogs": true,
    "notify": true,
    "languages": [
      "string"
    ]
  }'
Response · 200

Mastodon: Unfollow (Relationships)

POST/accounts/{accountId}/mastodon/relationships/{itemId}/unfollow

Unfollow. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-relationships-unfollow (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/relationships/{itemId}/unfollow
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/relationships/ITEM_ID/unfollow" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mastodon: Remove from followers (Relationships)

POST/accounts/{accountId}/mastodon/relationships/{itemId}/remove-from-followers

Remove 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.

Access: write

Try it with MCPAsk your agent to call mastodon-relationships-remove-from-followers (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/relationships/{itemId}/remove-from-followers
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/relationships/ITEM_ID/remove-from-followers" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mastodon: Block (Relationships)

POST/accounts/{accountId}/mastodon/relationships/{itemId}/block

Block. 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.

Access: write

Try it with MCPAsk your agent to call mastodon-relationships-block (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/relationships/{itemId}/block
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/relationships/ITEM_ID/block" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mastodon: Unblock (Relationships)

POST/accounts/{accountId}/mastodon/relationships/{itemId}/unblock

Unblock. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-relationships-unblock (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/relationships/{itemId}/unblock
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/relationships/ITEM_ID/unblock" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mastodon: Mute (Relationships)

POST/accounts/{accountId}/mastodon/relationships/{itemId}/mute

Mute. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-relationships-mute (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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: true
durationinteger

Seconds; 0 = indefinite

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/relationships/{itemId}/mute
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/relationships/ITEM_ID/mute" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "notifications": true,
    "duration": 0
  }'
Response · 200

Mastodon: Unmute (Relationships)

POST/accounts/{accountId}/mastodon/relationships/{itemId}/unmute

Unmute. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-relationships-unmute (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/relationships/{itemId}/unmute
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/relationships/ITEM_ID/unmute" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mastodon: Private note (Relationships)

POST/accounts/{accountId}/mastodon/relationships/{itemId}/note

Private 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-relationships-note (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

commentstring

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/relationships/{itemId}/note
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/relationships/ITEM_ID/note" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "comment": "string"
  }'
Response · 200

Familiar followers

Mastodon: List Familiar followers

GET/accounts/{accountId}/mastodon/familiar-followers

Accounts 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.

Access: read

Try it with MCPAsk your agent to call mastodon-familiar-followers-list (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

idsarray of stringrequired

≥ 1 items

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 3 item attributes
idstringrequired
countinteger
accountsarray of object
Show 23 item attributes
idstringrequiredread-only
acctstringrequired
usernamestring
display_namestring
urlstring (uri)
avatarstring
headerstring
notestring
note_textstring
lockedboolean
botboolean
groupboolean
discoverableboolean | null
indexableboolean | null
followers_countinteger
following_countinteger
statuses_countinteger
created_atstring (date-time)
last_status_atstring (date) | null
fieldsarray of object
Show 3 item attributes
namestring
valuestring
verified_atstring (date-time) | null
movedobject | null
suspendedboolean
limitedboolean
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/familiar-followers
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/familiar-followers?ids=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Accounts

Mastodon: List People

GET/accounts/{accountId}/mastodon/accounts

Account 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.

Access: read

Try it with MCPAsk your agent to call mastodon-accounts-list (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

qstringrequired
resolveboolean

WebFinger-resolve remote handles

followingboolean
limitinteger

≤ 80

cursorstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 23 item attributes
idstringrequiredread-only
acctstringrequired
usernamestring
display_namestring
urlstring (uri)
avatarstring
headerstring
notestring
note_textstring
lockedboolean
botboolean
groupboolean
discoverableboolean | null
indexableboolean | null
followers_countinteger
following_countinteger
statuses_countinteger
created_atstring (date-time)
last_status_atstring (date) | null
fieldsarray of object
Show 3 item attributes
namestring
valuestring
verified_atstring (date-time) | null
movedobject | null
suspendedboolean
limitedboolean
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/accounts
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/accounts?q=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Get a People item

GET/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.

Access: read

Try it with MCPAsk your agent to call mastodon-accounts-get (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstringrequiredread-only
acctstringrequired
usernamestring
display_namestring
urlstring (uri)
avatarstring
headerstring
notestring
note_textstring
lockedboolean
botboolean
groupboolean
discoverableboolean | null
indexableboolean | null
followers_countinteger
following_countinteger
statuses_countinteger
created_atstring (date-time)
last_status_atstring (date) | null
fieldsarray of object
Show 3 item attributes
namestring
valuestring
verified_atstring (date-time) | null
movedobject | null
suspendedboolean
limitedboolean

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/accounts/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/accounts/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Look up handle (People)

POST/accounts/{accountId}/mastodon/accounts/lookup

Look 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-accounts-lookup (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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

acctstringrequired

user or user@domain

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/accounts/lookup
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/accounts/lookup" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "acct": "string"
  }'
Response · 200

Lists

Mastodon: Lists containing (People)

POST/accounts/{accountId}/mastodon/accounts/{itemId}/lists

Lists 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-accounts-lists (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/accounts/{itemId}/lists
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/accounts/ITEM_ID/lists" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mastodon: List Lists

GET/accounts/{accountId}/mastodon/lists

Cursor 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.

Access: read

Try it with MCPAsk your agent to call mastodon-lists-list (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 4 item attributes
idstringrequiredread-only
titlestringrequired
replies_policystring

followedlistnone

exclusiveboolean

Hide members from the home timeline (4.2+)

limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/lists
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/lists" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Create a Lists item

POST/accounts/{accountId}/mastodon/lists

Requires scopes: read:lists, write:lists. Network docs: https://docs.joinmastodon.org/methods/lists/ Generic route: /v1/accounts/{accountId}/focus/lists.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-lists-create (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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

titlestringrequired
replies_policystring

followedlistnone

exclusiveboolean

Returns object

idstringrequiredread-only
titlestringrequired
replies_policystring

followedlistnone

exclusiveboolean

Hide members from the home timeline (4.2+)

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/lists
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/lists" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "string",
    "replies_policy": "followed",
    "exclusive": true
  }'
Response · 201

Mastodon: Get a Lists item

GET/accounts/{accountId}/mastodon/lists/{itemId}

Requires scopes: read:lists. Network docs: https://docs.joinmastodon.org/methods/lists/ Generic route: /v1/accounts/{accountId}/focus/lists.

Access: read

Try it with MCPAsk your agent to call mastodon-lists-get (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstringrequiredread-only
titlestringrequired
replies_policystring

followedlistnone

exclusiveboolean

Hide members from the home timeline (4.2+)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/lists/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/lists/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Update a Lists item

PATCH/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.

Access: write

Try it with MCPAsk your agent to call mastodon-lists-update (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

titlestring
replies_policystring

followedlistnone

exclusiveboolean

Returns object

idstringrequiredread-only
titlestringrequired
replies_policystring

followedlistnone

exclusiveboolean

Hide members from the home timeline (4.2+)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/mastodon/lists/{itemId}
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/lists/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "string",
    "replies_policy": "followed",
    "exclusive": true
  }'
Response · 200

Mastodon: Delete a Lists item

DELETE/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.

Access: write

Try it with MCPAsk your agent to call mastodon-lists-delete (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/mastodon/lists/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/lists/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: List timeline (Lists)

POST/accounts/{accountId}/mastodon/lists/{itemId}/timeline

List timeline. Requires scopes: read:lists. Network docs: https://docs.joinmastodon.org/methods/lists/ Generic route: /v1/accounts/{accountId}/focus/lists.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-lists-timeline (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

cursorstring

Opaque cursor from a previous next_cursor

limitintegerdefault: 20

1–80

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/lists/{itemId}/timeline
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/lists/ITEM_ID/timeline" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "cursor": "string",
    "limit": 20
  }'
Response · 200

Mastodon: Members (Lists)

POST/accounts/{accountId}/mastodon/lists/{itemId}/members

Members. Requires scopes: read:lists. Network docs: https://docs.joinmastodon.org/methods/lists/ Generic route: /v1/accounts/{accountId}/focus/lists.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-lists-members (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

cursorstring

Opaque cursor from a previous next_cursor

limitintegerdefault: 20

1–80

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/lists/{itemId}/members
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/lists/ITEM_ID/members" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "cursor": "string",
    "limit": 20
  }'
Response · 200

Mastodon: Add accounts (Lists)

POST/accounts/{accountId}/mastodon/lists/{itemId}/add-accounts

Add accounts. Requires scopes: read:lists, write:lists. Network docs: https://docs.joinmastodon.org/methods/lists/ Generic route: /v1/accounts/{accountId}/focus/lists.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-lists-add-accounts (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/lists/{itemId}/add-accounts
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/lists/ITEM_ID/add-accounts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "account_ids": [
      "string"
    ]
  }'
Response · 200

Mastodon: Remove accounts (Lists)

POST/accounts/{accountId}/mastodon/lists/{itemId}/remove-accounts

Remove accounts. Requires scopes: read:lists, write:lists. Network docs: https://docs.joinmastodon.org/methods/lists/ Generic route: /v1/accounts/{accountId}/focus/lists.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-lists-remove-accounts (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/lists/{itemId}/remove-accounts
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/lists/ITEM_ID/remove-accounts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "account_ids": [
      "string"
    ]
  }'
Response · 200
POST/accounts/{accountId}/mastodon/accounts/{itemId}/featured-tags

Featured 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-accounts-featured-tags (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/accounts/{itemId}/featured-tags
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/accounts/ITEM_ID/featured-tags" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200
GET/accounts/{accountId}/mastodon/featured-tags

Hashtags 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.

Access: read

Try it with MCPAsk your agent to call mastodon-featured-tags-list (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 5 item attributes
idstringrequiredread-only
namestring
urlstring (uri)
statuses_countinteger
last_status_atstring (date) | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/featured-tags
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/featured-tags" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
POST/accounts/{accountId}/mastodon/featured-tags

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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-featured-tags-create (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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

namestringrequired

Without #

Returns object

idstringrequiredread-only
namestring
urlstring (uri)
statuses_countinteger
last_status_atstring (date) | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/featured-tags
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/featured-tags" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string"
  }'
Response · 201
DELETE/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.

Access: write

Try it with MCPAsk your agent to call mastodon-featured-tags-delete (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/mastodon/featured-tags/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/featured-tags/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
POST/accounts/{accountId}/mastodon/featured-tags/suggestions

Suggestions. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-featured-tags-suggestions (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/featured-tags/suggestions
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/featured-tags/suggestions" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Endorsements

Mastodon: Featured accounts (People)

POST/accounts/{accountId}/mastodon/accounts/{itemId}/endorsements

Featured 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-accounts-endorsements (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

cursorstring

Opaque cursor from a previous next_cursor

limitintegerdefault: 20

1–80

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/accounts/{itemId}/endorsements
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/accounts/ITEM_ID/endorsements" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "cursor": "string",
    "limit": 20
  }'
Response · 200

Mastodon: List Featured accounts

GET/accounts/{accountId}/mastodon/endorsements

Accounts 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.

Access: read

Try it with MCPAsk your agent to call mastodon-endorsements-list (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Opaque cursor from a previous next_cursor

limitintegerdefault: 20

1–80

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 23 item attributes
idstringrequiredread-only
acctstringrequired
usernamestring
display_namestring
urlstring (uri)
avatarstring
headerstring
notestring
note_textstring
lockedboolean
botboolean
groupboolean
discoverableboolean | null
indexableboolean | null
followers_countinteger
following_countinteger
statuses_countinteger
created_atstring (date-time)
last_status_atstring (date) | null
fieldsarray of object
Show 3 item attributes
namestring
valuestring
verified_atstring (date-time) | null
movedobject | null
suspendedboolean
limitedboolean
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/endorsements
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/endorsements" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Create a Featured accounts item

POST/accounts/{accountId}/mastodon/endorsements

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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-endorsements-create (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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_idstringrequired

Returns object

idstringrequiredread-only
acctstringrequired
usernamestring
display_namestring
urlstring (uri)
avatarstring
headerstring
notestring
note_textstring
lockedboolean
botboolean
groupboolean
discoverableboolean | null
indexableboolean | null
followers_countinteger
following_countinteger
statuses_countinteger
created_atstring (date-time)
last_status_atstring (date) | null
fieldsarray of object
Show 3 item attributes
namestring
valuestring
verified_atstring (date-time) | null
movedobject | null
suspendedboolean
limitedboolean

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/endorsements
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/endorsements" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "string"
  }'
Response · 201

Mastodon: Delete a Featured accounts item

DELETE/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.

Access: write

Try it with MCPAsk your agent to call mastodon-endorsements-delete (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/mastodon/endorsements/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/endorsements/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Follow

Mastodon: Follow (People)

POST/accounts/{accountId}/mastodon/accounts/{itemId}/follow

Follow. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-accounts-follow (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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: true
notifyboolean
languagesarray of string

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/accounts/{itemId}/follow
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/accounts/ITEM_ID/follow" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "reblogs": true,
    "notify": true,
    "languages": [
      "string"
    ]
  }'
Response · 200

Unfollow

Mastodon: Unfollow (People)

POST/accounts/{accountId}/mastodon/accounts/{itemId}/unfollow

Unfollow. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-accounts-unfollow (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/accounts/{itemId}/unfollow
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/accounts/ITEM_ID/unfollow" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Remove from followers

Mastodon: Remove from followers (People)

POST/accounts/{accountId}/mastodon/accounts/{itemId}/remove-from-followers

Remove 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.

Access: write

Try it with MCPAsk your agent to call mastodon-accounts-remove-from-followers (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/accounts/{itemId}/remove-from-followers
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/accounts/ITEM_ID/remove-from-followers" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Block

Mastodon: Block (People)

POST/accounts/{accountId}/mastodon/accounts/{itemId}/block

Block. 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.

Access: write

Try it with MCPAsk your agent to call mastodon-accounts-block (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/accounts/{itemId}/block
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/accounts/ITEM_ID/block" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Unblock

Mastodon: Unblock (People)

POST/accounts/{accountId}/mastodon/accounts/{itemId}/unblock

Unblock. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-accounts-unblock (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/accounts/{itemId}/unblock
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/accounts/ITEM_ID/unblock" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mute

Mastodon: Mute (People)

POST/accounts/{accountId}/mastodon/accounts/{itemId}/mute

Mute. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-accounts-mute (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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: true
durationinteger

Seconds; 0 = indefinite

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/accounts/{itemId}/mute
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/accounts/ITEM_ID/mute" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "notifications": true,
    "duration": 0
  }'
Response · 200

Unmute

Mastodon: Unmute (People)

POST/accounts/{accountId}/mastodon/accounts/{itemId}/unmute

Unmute. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-accounts-unmute (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/accounts/{itemId}/unmute
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/accounts/ITEM_ID/unmute" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Endorse

Mastodon: Feature on profile (People)

POST/accounts/{accountId}/mastodon/accounts/{itemId}/endorse

Feature 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-accounts-endorse (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/accounts/{itemId}/endorse
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/accounts/ITEM_ID/endorse" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Unendorse

Mastodon: Unfeature (People)

POST/accounts/{accountId}/mastodon/accounts/{itemId}/unendorse

Unfeature. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-accounts-unendorse (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/accounts/{itemId}/unendorse
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/accounts/ITEM_ID/unendorse" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Note

Mastodon: Private note (People)

POST/accounts/{accountId}/mastodon/accounts/{itemId}/note

Private 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-accounts-note (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

commentstring

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/accounts/{itemId}/note
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/accounts/ITEM_ID/note" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "comment": "string"
  }'
Response · 200

List members

Mastodon: List List members

GET/accounts/{accountId}/mastodon/list-members

Accounts 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.

Access: read

Try it with MCPAsk your agent to call mastodon-list-members-list (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Opaque cursor from a previous next_cursor

limitintegerdefault: 20

1–80

list_idstringrequired

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 25 item attributes
idstringrequired

<list_id>:<account_id>

acctstring
usernamestring
display_namestring
urlstring (uri)
avatarstring
headerstring
notestring
note_textstring
lockedboolean
botboolean
groupboolean
discoverableboolean | null
indexableboolean | null
followers_countinteger
following_countinteger
statuses_countinteger
created_atstring (date-time)
last_status_atstring (date) | null
fieldsarray of object
Show 3 item attributes
namestring
valuestring
verified_atstring (date-time) | null
movedobject | null
suspendedboolean
limitedboolean
account_idstring
list_idstring
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/list-members
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/list-members?list_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Create a List members item

POST/accounts/{accountId}/mastodon/list-members

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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-list-members-create (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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_idstringrequired
account_idsarray of stringrequired

≥ 1 items

Returns object

idstringrequired

<list_id>:<account_id>

acctstring
usernamestring
display_namestring
urlstring (uri)
avatarstring
headerstring
notestring
note_textstring
lockedboolean
botboolean
groupboolean
discoverableboolean | null
indexableboolean | null
followers_countinteger
following_countinteger
statuses_countinteger
created_atstring (date-time)
last_status_atstring (date) | null
fieldsarray of object
Show 3 item attributes
namestring
valuestring
verified_atstring (date-time) | null
movedobject | null
suspendedboolean
limitedboolean
account_idstring
list_idstring

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/list-members
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/list-members" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "list_id": "string",
    "account_ids": [
      "string"
    ]
  }'
Response · 201

Mastodon: Delete a List members item

DELETE/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.

Access: write

Try it with MCPAsk your agent to call mastodon-list-members-delete (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/mastodon/list-members/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/list-members/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Collections

Mastodon: List Collections

GET/accounts/{accountId}/mastodon/collections

Curated 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.

Access: read

Try it with MCPAsk your agent to call mastodon-collections-list (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Opaque cursor from a previous next_cursor

limitintegerdefault: 20

1–80

account_idstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 11 item attributes
idstringrequiredread-only
namestring
descriptionstring | null
sensitiveboolean | null
discoverableboolean | null
languagestring | null
tagobject | null
items_countinteger | null
itemsarray of object
Show 3 item attributes
idstring
statestring
accountobject | null
Show 23 child attributes
idstringrequiredread-only
acctstringrequired
usernamestring
display_namestring
urlstring (uri)
avatarstring
headerstring
notestring
note_textstring
lockedboolean
botboolean
groupboolean
discoverableboolean | null
indexableboolean | null
followers_countinteger
following_countinteger
statuses_countinteger
created_atstring (date-time)
last_status_atstring (date) | null
fieldsarray of object
Show 3 item attributes
namestring
valuestring
verified_atstring (date-time) | null
movedobject | null
suspendedboolean
limitedboolean
created_atstring (date-time) | null
updated_atstring (date-time) | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/collections
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/collections" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Create a Collections item

POST/accounts/{accountId}/mastodon/collections

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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-collections-create (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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

namestringrequired
descriptionstring
sensitiveboolean
discoverableboolean
languagestring
tag_namestring
account_idsarray of string

≤ 25 items

Returns object

idstringrequiredread-only
namestring
descriptionstring | null
sensitiveboolean | null
discoverableboolean | null
languagestring | null
tagobject | null
items_countinteger | null
itemsarray of object
Show 3 item attributes
idstring
statestring
accountobject | null
Show 23 child attributes
idstringrequiredread-only
acctstringrequired
usernamestring
display_namestring
urlstring (uri)
avatarstring
headerstring
notestring
note_textstring
lockedboolean
botboolean
groupboolean
discoverableboolean | null
indexableboolean | null
followers_countinteger
following_countinteger
statuses_countinteger
created_atstring (date-time)
last_status_atstring (date) | null
fieldsarray of object
Show 3 item attributes
namestring
valuestring
verified_atstring (date-time) | null
movedobject | null
suspendedboolean
limitedboolean
created_atstring (date-time) | null
updated_atstring (date-time) | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/collections
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/collections" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string",
    "description": "string",
    "sensitive": true,
    "discoverable": true,
    "language": "en"
  }'
Response · 201

Mastodon: Get a Collections item

GET/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.

Access: read

Try it with MCPAsk your agent to call mastodon-collections-get (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstringrequiredread-only
namestring
descriptionstring | null
sensitiveboolean | null
discoverableboolean | null
languagestring | null
tagobject | null
items_countinteger | null
itemsarray of object
Show 3 item attributes
idstring
statestring
accountobject | null
Show 23 child attributes
idstringrequiredread-only
acctstringrequired
usernamestring
display_namestring
urlstring (uri)
avatarstring
headerstring
notestring
note_textstring
lockedboolean
botboolean
groupboolean
discoverableboolean | null
indexableboolean | null
followers_countinteger
following_countinteger
statuses_countinteger
created_atstring (date-time)
last_status_atstring (date) | null
fieldsarray of object
Show 3 item attributes
namestring
valuestring
verified_atstring (date-time) | null
movedobject | null
suspendedboolean
limitedboolean
created_atstring (date-time) | null
updated_atstring (date-time) | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/collections/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/collections/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Update a Collections item

PATCH/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.

Access: write

Try it with MCPAsk your agent to call mastodon-collections-update (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

namestring
descriptionstring
sensitiveboolean
discoverableboolean
languagestring
tag_namestring
account_idsarray of string

≤ 25 items

Returns object

idstringrequiredread-only
namestring
descriptionstring | null
sensitiveboolean | null
discoverableboolean | null
languagestring | null
tagobject | null
items_countinteger | null
itemsarray of object
Show 3 item attributes
idstring
statestring
accountobject | null
Show 23 child attributes
idstringrequiredread-only
acctstringrequired
usernamestring
display_namestring
urlstring (uri)
avatarstring
headerstring
notestring
note_textstring
lockedboolean
botboolean
groupboolean
discoverableboolean | null
indexableboolean | null
followers_countinteger
following_countinteger
statuses_countinteger
created_atstring (date-time)
last_status_atstring (date) | null
fieldsarray of object
Show 3 item attributes
namestring
valuestring
verified_atstring (date-time) | null
movedobject | null
suspendedboolean
limitedboolean
created_atstring (date-time) | null
updated_atstring (date-time) | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/mastodon/collections/{itemId}
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/collections/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string",
    "description": "string",
    "sensitive": true,
    "discoverable": true,
    "language": "en"
  }'
Response · 200

Mastodon: Delete a Collections item

DELETE/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.

Access: write

Try it with MCPAsk your agent to call mastodon-collections-delete (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/mastodon/collections/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/collections/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Add account (Collections)

POST/accounts/{accountId}/mastodon/collections/{itemId}/add-item

Add 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-collections-add-item (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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_idstringrequired

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/collections/{itemId}/add-item
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/collections/ITEM_ID/add-item" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "string"
  }'
Response · 200

Mastodon: Remove account (Collections)

POST/accounts/{accountId}/mastodon/collections/{itemId}/remove-item

Remove 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-collections-remove-item (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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_idstringrequired

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/collections/{itemId}/remove-item
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/collections/ITEM_ID/remove-item" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "item_id": "string"
  }'
Response · 200

Mastodon: Remove me from this collection (Collections)

POST/accounts/{accountId}/mastodon/collections/{itemId}/revoke

Remove 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.

Access: write

Try it with MCPAsk your agent to call mastodon-collections-revoke (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

item_idstringrequired

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/collections/{itemId}/revoke
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/collections/ITEM_ID/revoke" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "item_id": "string"
  }'
Response · 200

Mastodon: Collections featuring an account (Collections)

POST/accounts/{accountId}/mastodon/collections/in-collections

Collections 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-collections-in-collections (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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

cursorstring

Opaque cursor from a previous next_cursor

limitintegerdefault: 20

1–80

account_idstring

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/collections/in-collections
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/collections/in-collections" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "cursor": "string",
    "limit": 20,
    "account_id": "string"
  }'
Response · 200

Suggestions

Mastodon: List Who to follow

GET/accounts/{accountId}/mastodon/suggestions

Cursor 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.

Access: read

Try it with MCPAsk your agent to call mastodon-suggestions-list (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 40

≤ 80

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 24 item attributes
idstringrequiredread-only
acctstring
usernamestring
display_namestring
urlstring (uri)
avatarstring
headerstring
notestring
note_textstring
lockedboolean
botboolean
groupboolean
discoverableboolean | null
indexableboolean | null
followers_countinteger
following_countinteger
statuses_countinteger
created_atstring (date-time)
last_status_atstring (date) | null
fieldsarray of object
Show 3 item attributes
namestring
valuestring
verified_atstring (date-time) | null
movedobject | null
suspendedboolean
limitedboolean
sourcesarray of string
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/suggestions
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/suggestions" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Delete a Who to follow item

DELETE/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.

Access: write

Try it with MCPAsk your agent to call mastodon-suggestions-delete (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/mastodon/suggestions/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/suggestions/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Follow (Who to follow)

POST/accounts/{accountId}/mastodon/suggestions/{itemId}/follow

Follow. Requires scopes: read:accounts, write:follows. Network docs: https://docs.joinmastodon.org/methods/suggestions/ Generic route: /v1/accounts/{accountId}/focus/suggestions.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-suggestions-follow (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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: true
notifyboolean
languagesarray of string

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/suggestions/{itemId}/follow
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/suggestions/ITEM_ID/follow" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "reblogs": true,
    "notify": true,
    "languages": [
      "string"
    ]
  }'
Response · 200

Directory

Mastodon: List Profile directory

GET/accounts/{accountId}/mastodon/directory

Discoverable 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.

Access: read

Try it with MCPAsk your agent to call mastodon-directory-list (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

orderstring

activenew

localboolean
limitintegerdefault: 40

≤ 80

cursorstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 23 item attributes
idstringrequiredread-only
acctstringrequired
usernamestring
display_namestring
urlstring (uri)
avatarstring
headerstring
notestring
note_textstring
lockedboolean
botboolean
groupboolean
discoverableboolean | null
indexableboolean | null
followers_countinteger
following_countinteger
statuses_countinteger
created_atstring (date-time)
last_status_atstring (date) | null
fieldsarray of object
Show 3 item attributes
namestring
valuestring
verified_atstring (date-time) | null
movedobject | null
suspendedboolean
limitedboolean
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/directory
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/directory" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Follow (Profile directory)

POST/accounts/{accountId}/mastodon/directory/{itemId}/follow

Follow. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-directory-follow (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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: true
notifyboolean
languagesarray of string

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/directory/{itemId}/follow
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/directory/ITEM_ID/follow" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "reblogs": true,
    "notify": true,
    "languages": [
      "string"
    ]
  }'
Response · 200

Bookmarks

Mastodon: List Bookmarks

GET/accounts/{accountId}/mastodon/bookmarks

Cursor 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.

Access: read

Try it with MCPAsk your agent to call mastodon-bookmarks-list (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Opaque cursor from a previous next_cursor

limitintegerdefault: 20

1–80

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 29 item attributes
idstringrequiredread-only
uristring (uri)
urlstring (uri) | null
created_atstring (date-time)
edited_atstring (date-time) | null
textstringread-only
contentstring
spoiler_textstring
sensitiveboolean
visibilitystring

publicunlistedprivatedirect

languagestring | null
in_reply_to_idstring | null
in_reply_to_account_idstring | null
replies_countinteger
reblogs_countinteger
favourites_countinteger
quotes_countinteger | null
authorstring
author_namestring | null
media_attachmentsarray of object
Show 8 item attributes
idstringread-only
typestring

imagegifvvideoaudiounknown

urlstring (uri) | null
preview_urlstring (uri) | null
remote_urlstring (uri) | null
descriptionstring | null
blurhashstring | null
metaobject
pollobject | null
Show 9 child attributes
idstringread-only
expires_atstring (date-time) | null
expiredboolean
multipleboolean
votes_countinteger
voters_countinteger | null
votedboolean
own_votesarray of integer
optionsarray of object
Show 2 item attributes
titlestring
votes_countinteger | null
favouritedboolean
rebloggedboolean
bookmarkedboolean
mutedboolean
pinnedboolean
is_reblogboolean
quoteobject | null
Show 2 child attributes
statestring
quoted_statusobject | null
quote_approvalobject | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/bookmarks
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/bookmarks" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Create a Bookmarks item

POST/accounts/{accountId}/mastodon/bookmarks

Requires scopes: read:bookmarks, write:bookmarks. Network docs: https://docs.joinmastodon.org/methods/bookmarks/ Generic route: /v1/accounts/{accountId}/focus/bookmarks.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-bookmarks-create (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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_idstringrequired

Returns object

idstringrequiredread-only
uristring (uri)
urlstring (uri) | null
created_atstring (date-time)
edited_atstring (date-time) | null
textstringread-only
contentstring
spoiler_textstring
sensitiveboolean
visibilitystring

publicunlistedprivatedirect

languagestring | null
in_reply_to_idstring | null
in_reply_to_account_idstring | null
replies_countinteger
reblogs_countinteger
favourites_countinteger
quotes_countinteger | null
authorstring
author_namestring | null
media_attachmentsarray of object
Show 8 item attributes
idstringread-only
typestring

imagegifvvideoaudiounknown

urlstring (uri) | null
preview_urlstring (uri) | null
remote_urlstring (uri) | null
descriptionstring | null
blurhashstring | null
metaobject
pollobject | null
Show 9 child attributes
idstringread-only
expires_atstring (date-time) | null
expiredboolean
multipleboolean
votes_countinteger
voters_countinteger | null
votedboolean
own_votesarray of integer
optionsarray of object
Show 2 item attributes
titlestring
votes_countinteger | null
favouritedboolean
rebloggedboolean
bookmarkedboolean
mutedboolean
pinnedboolean
is_reblogboolean
quoteobject | null
Show 2 child attributes
statestring
quoted_statusobject | null
quote_approvalobject | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/bookmarks
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/bookmarks" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "status_id": "string"
  }'
Response · 201

Mastodon: Delete a Bookmarks item

DELETE/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.

Access: write

Try it with MCPAsk your agent to call mastodon-bookmarks-delete (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/mastodon/bookmarks/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/bookmarks/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Favourite (Bookmarks)

POST/accounts/{accountId}/mastodon/bookmarks/{itemId}/favourite

Favourite. Requires scopes: read:bookmarks, write:favourites. Network docs: https://docs.joinmastodon.org/methods/bookmarks/ Generic route: /v1/accounts/{accountId}/focus/bookmarks.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-bookmarks-favourite (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/bookmarks/{itemId}/favourite
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/bookmarks/ITEM_ID/favourite" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mastodon: Boost (Bookmarks)

POST/accounts/{accountId}/mastodon/bookmarks/{itemId}/boost

Boost. Requires scopes: read:bookmarks, write:statuses. Network docs: https://docs.joinmastodon.org/methods/bookmarks/ Generic route: /v1/accounts/{accountId}/focus/bookmarks.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-bookmarks-boost (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

visibilitystring

publicunlistedprivate

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/bookmarks/{itemId}/boost
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/bookmarks/ITEM_ID/boost" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "visibility": "public"
  }'
Response · 200

Mastodon: Reply (Bookmarks)

POST/accounts/{accountId}/mastodon/bookmarks/{itemId}/reply

Reply. Requires scopes: read:bookmarks, write:statuses. Network docs: https://docs.joinmastodon.org/methods/bookmarks/ Generic route: /v1/accounts/{accountId}/focus/bookmarks.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-bookmarks-reply (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

statusstring

Plain text; URLs count as 23 characters

visibilitystring

publicunlistedprivatedirect

spoiler_textstring
sensitiveboolean
languagestring

ISO 639-1

mediaarray of string

Socialit media ids (uploaded to the instance on publish)

media_idsarray of string

Already-uploaded Mastodon media ids

alt_textsarray of string

Alt text per media item, by index

pollobject
Show 4 child attributes
optionsarray of string

≥ 2 items

expires_inintegerdefault: 86400
multipleboolean
hide_totalsboolean
in_reply_to_idstring
quoted_status_idstring

Mastodon 4.5+

quote_approval_policystring

publicfollowersnobody

scheduled_atstring (date-time)

≥ 5 minutes ahead → ScheduledStatus

threadarray of string

Follow-up replies posted as a self-thread

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/bookmarks/{itemId}/reply
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/bookmarks/ITEM_ID/reply" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "string",
    "visibility": "public",
    "spoiler_text": "string",
    "sensitive": true,
    "language": "en"
  }'
Response · 200

Favourites

Mastodon: List Favourites

GET/accounts/{accountId}/mastodon/favourites

Cursor 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.

Access: read

Try it with MCPAsk your agent to call mastodon-favourites-list (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Opaque cursor from a previous next_cursor

limitintegerdefault: 20

1–80

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 29 item attributes
idstringrequiredread-only
uristring (uri)
urlstring (uri) | null
created_atstring (date-time)
edited_atstring (date-time) | null
textstringread-only
contentstring
spoiler_textstring
sensitiveboolean
visibilitystring

publicunlistedprivatedirect

languagestring | null
in_reply_to_idstring | null
in_reply_to_account_idstring | null
replies_countinteger
reblogs_countinteger
favourites_countinteger
quotes_countinteger | null
authorstring
author_namestring | null
media_attachmentsarray of object
Show 8 item attributes
idstringread-only
typestring

imagegifvvideoaudiounknown

urlstring (uri) | null
preview_urlstring (uri) | null
remote_urlstring (uri) | null
descriptionstring | null
blurhashstring | null
metaobject
pollobject | null
Show 9 child attributes
idstringread-only
expires_atstring (date-time) | null
expiredboolean
multipleboolean
votes_countinteger
voters_countinteger | null
votedboolean
own_votesarray of integer
optionsarray of object
Show 2 item attributes
titlestring
votes_countinteger | null
favouritedboolean
rebloggedboolean
bookmarkedboolean
mutedboolean
pinnedboolean
is_reblogboolean
quoteobject | null
Show 2 child attributes
statestring
quoted_statusobject | null
quote_approvalobject | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/favourites
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/favourites" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Create a Favourites item

POST/accounts/{accountId}/mastodon/favourites

Requires scopes: read:favourites, write:favourites. Network docs: https://docs.joinmastodon.org/methods/favourites/ Generic route: /v1/accounts/{accountId}/focus/favourites.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-favourites-create (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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_idstringrequired

Returns object

idstringrequiredread-only
uristring (uri)
urlstring (uri) | null
created_atstring (date-time)
edited_atstring (date-time) | null
textstringread-only
contentstring
spoiler_textstring
sensitiveboolean
visibilitystring

publicunlistedprivatedirect

languagestring | null
in_reply_to_idstring | null
in_reply_to_account_idstring | null
replies_countinteger
reblogs_countinteger
favourites_countinteger
quotes_countinteger | null
authorstring
author_namestring | null
media_attachmentsarray of object
Show 8 item attributes
idstringread-only
typestring

imagegifvvideoaudiounknown

urlstring (uri) | null
preview_urlstring (uri) | null
remote_urlstring (uri) | null
descriptionstring | null
blurhashstring | null
metaobject
pollobject | null
Show 9 child attributes
idstringread-only
expires_atstring (date-time) | null
expiredboolean
multipleboolean
votes_countinteger
voters_countinteger | null
votedboolean
own_votesarray of integer
optionsarray of object
Show 2 item attributes
titlestring
votes_countinteger | null
favouritedboolean
rebloggedboolean
bookmarkedboolean
mutedboolean
pinnedboolean
is_reblogboolean
quoteobject | null
Show 2 child attributes
statestring
quoted_statusobject | null
quote_approvalobject | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/favourites
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/favourites" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "status_id": "string"
  }'
Response · 201

Mastodon: Delete a Favourites item

DELETE/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.

Access: write

Try it with MCPAsk your agent to call mastodon-favourites-delete (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/mastodon/favourites/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/favourites/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Bookmark (Favourites)

POST/accounts/{accountId}/mastodon/favourites/{itemId}/bookmark

Bookmark. Requires scopes: read:favourites, write:bookmarks. Network docs: https://docs.joinmastodon.org/methods/favourites/ Generic route: /v1/accounts/{accountId}/focus/favourites.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-favourites-bookmark (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/favourites/{itemId}/bookmark
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/favourites/ITEM_ID/bookmark" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mastodon: Boost (Favourites)

POST/accounts/{accountId}/mastodon/favourites/{itemId}/boost

Boost. Requires scopes: read:favourites, write:statuses. Network docs: https://docs.joinmastodon.org/methods/favourites/ Generic route: /v1/accounts/{accountId}/focus/favourites.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-favourites-boost (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

visibilitystring

publicunlistedprivate

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/favourites/{itemId}/boost
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/favourites/ITEM_ID/boost" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "visibility": "public"
  }'
Response · 200

Mastodon: Reply (Favourites)

POST/accounts/{accountId}/mastodon/favourites/{itemId}/reply

Reply. Requires scopes: read:favourites, write:statuses. Network docs: https://docs.joinmastodon.org/methods/favourites/ Generic route: /v1/accounts/{accountId}/focus/favourites.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-favourites-reply (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

statusstring

Plain text; URLs count as 23 characters

visibilitystring

publicunlistedprivatedirect

spoiler_textstring
sensitiveboolean
languagestring

ISO 639-1

mediaarray of string

Socialit media ids (uploaded to the instance on publish)

media_idsarray of string

Already-uploaded Mastodon media ids

alt_textsarray of string

Alt text per media item, by index

pollobject
Show 4 child attributes
optionsarray of string

≥ 2 items

expires_inintegerdefault: 86400
multipleboolean
hide_totalsboolean
in_reply_to_idstring
quoted_status_idstring

Mastodon 4.5+

quote_approval_policystring

publicfollowersnobody

scheduled_atstring (date-time)

≥ 5 minutes ahead → ScheduledStatus

threadarray of string

Follow-up replies posted as a self-thread

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/favourites/{itemId}/reply
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/favourites/ITEM_ID/reply" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "string",
    "visibility": "public",
    "spoiler_text": "string",
    "sensitive": true,
    "language": "en"
  }'
Response · 200

Followed tags

Mastodon: List Followed hashtags

GET/accounts/{accountId}/mastodon/followed-tags

Hashtags 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.

Access: read

Try it with MCPAsk your agent to call mastodon-followed-tags-list (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Opaque cursor from a previous next_cursor

limitintegerdefault: 20

1–80

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 6 item attributes
idstring | null
namestring
urlstring (uri)
followingboolean | null
featuringboolean | null
historyarray of object
Show 3 item attributes
daystring
usesstring
accountsstring
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/followed-tags
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/followed-tags" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Create a Followed hashtags item

POST/accounts/{accountId}/mastodon/followed-tags

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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-followed-tags-create (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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

namestringrequired

Without #

Returns object

idstring | null
namestring
urlstring (uri)
followingboolean | null
featuringboolean | null
historyarray of object
Show 3 item attributes
daystring
usesstring
accountsstring

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/followed-tags
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/followed-tags" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string"
  }'
Response · 201

Mastodon: Get a Followed hashtags item

GET/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.

Access: read

Try it with MCPAsk your agent to call mastodon-followed-tags-get (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstring | null
namestring
urlstring (uri)
followingboolean | null
featuringboolean | null
historyarray of object
Show 3 item attributes
daystring
usesstring
accountsstring

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/followed-tags/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/followed-tags/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Delete a Followed hashtags item

DELETE/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.

Access: write

Try it with MCPAsk your agent to call mastodon-followed-tags-delete (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/mastodon/followed-tags/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/followed-tags/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Filters

Mastodon: List Filters

GET/accounts/{accountId}/mastodon/filters

Keyword / 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.

Access: read

Try it with MCPAsk your agent to call mastodon-filters-list (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 7 item attributes
idstringrequiredread-only
titlestringrequired
contextarray of string

≥ 1 items

filter_actionstring

warnhideblur

expires_atstring (date-time) | null
keywordsarray of object
Show 3 item attributes
idstring
keywordstring
whole_wordboolean
statusesarray of object
Show 2 item attributes
idstring
status_idstring
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/filters
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/filters" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Create a Filters item

POST/accounts/{accountId}/mastodon/filters

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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-filters-create (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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

titlestringrequired
contextarray of stringrequired
filter_actionstring

warnhideblur

expires_ininteger

Seconds; omit for never

keywords_attributesarray of object
Show 4 item attributes
idstring
keywordstring
whole_wordboolean
_destroyboolean

Returns object

idstringrequiredread-only
titlestringrequired
contextarray of string

≥ 1 items

filter_actionstring

warnhideblur

expires_atstring (date-time) | null
keywordsarray of object
Show 3 item attributes
idstring
keywordstring
whole_wordboolean
statusesarray of object
Show 2 item attributes
idstring
status_idstring

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/filters
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/filters" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "string",
    "context": [
      "home"
    ],
    "filter_action": "warn",
    "expires_in": 1,
    "keywords_attributes": [
      {
        "id": "string",
        "keyword": "string"
      }
    ]
  }'
Response · 201

Mastodon: Get a Filters item

GET/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.

Access: read

Try it with MCPAsk your agent to call mastodon-filters-get (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstringrequiredread-only
titlestringrequired
contextarray of string

≥ 1 items

filter_actionstring

warnhideblur

expires_atstring (date-time) | null
keywordsarray of object
Show 3 item attributes
idstring
keywordstring
whole_wordboolean
statusesarray of object
Show 2 item attributes
idstring
status_idstring

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/filters/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/filters/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Update a Filters item

PATCH/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.

Access: write

Try it with MCPAsk your agent to call mastodon-filters-update (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

titlestring
contextarray of string
filter_actionstring

warnhideblur

expires_ininteger

Seconds; omit for never

keywords_attributesarray of object
Show 4 item attributes
idstring
keywordstring
whole_wordboolean
_destroyboolean

Returns object

idstringrequiredread-only
titlestringrequired
contextarray of string

≥ 1 items

filter_actionstring

warnhideblur

expires_atstring (date-time) | null
keywordsarray of object
Show 3 item attributes
idstring
keywordstring
whole_wordboolean
statusesarray of object
Show 2 item attributes
idstring
status_idstring

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/mastodon/filters/{itemId}
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/filters/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "string",
    "context": [
      "home"
    ],
    "filter_action": "warn",
    "expires_in": 1,
    "keywords_attributes": [
      {
        "id": "string",
        "keyword": "string"
      }
    ]
  }'
Response · 200

Mastodon: Delete a Filters item

DELETE/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.

Access: write

Try it with MCPAsk your agent to call mastodon-filters-delete (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/mastodon/filters/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/filters/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Add keyword (Filters)

POST/accounts/{accountId}/mastodon/filters/{itemId}/add-keyword

Add 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-filters-add-keyword (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

keywordstringrequired
whole_wordboolean

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/filters/{itemId}/add-keyword
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/filters/ITEM_ID/add-keyword" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "keyword": "string",
    "whole_word": true
  }'
Response · 200

Mastodon: Filter a status (Filters)

POST/accounts/{accountId}/mastodon/filters/{itemId}/add-status

Filter 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-filters-add-status (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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_idstringrequired

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/filters/{itemId}/add-status
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/filters/ITEM_ID/add-status" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "status_id": "string"
  }'
Response · 200

Filter keywords

Mastodon: List Filter keywords

GET/accounts/{accountId}/mastodon/filter-keywords

Cursor 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.

Access: read

Try it with MCPAsk your agent to call mastodon-filter-keywords-list (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

filter_idstringrequired

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 4 item attributes
idstringrequiredread-only
keywordstringrequired
whole_wordboolean
filter_idstring
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/filter-keywords
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/filter-keywords?filter_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Create a Filter keywords item

POST/accounts/{accountId}/mastodon/filter-keywords

Requires scopes: read:filters, write:filters. Network docs: https://docs.joinmastodon.org/methods/filters/#keywords-get Generic route: /v1/accounts/{accountId}/focus/filter-keywords.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-filter-keywords-create (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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_idstringrequired
keywordstringrequired
whole_wordboolean

Returns object

idstringrequiredread-only
keywordstringrequired
whole_wordboolean
filter_idstring

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/filter-keywords
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/filter-keywords" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "filter_id": "string",
    "keyword": "string",
    "whole_word": true
  }'
Response · 201

Mastodon: Get a Filter keywords item

GET/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.

Access: read

Try it with MCPAsk your agent to call mastodon-filter-keywords-get (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstringrequiredread-only
keywordstringrequired
whole_wordboolean
filter_idstring

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/filter-keywords/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/filter-keywords/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Update a Filter keywords item

PATCH/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.

Access: write

Try it with MCPAsk your agent to call mastodon-filter-keywords-update (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

keywordstring
whole_wordboolean

Returns object

idstringrequiredread-only
keywordstringrequired
whole_wordboolean
filter_idstring

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/mastodon/filter-keywords/{itemId}
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/filter-keywords/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "keyword": "string",
    "whole_word": true
  }'
Response · 200

Mastodon: Delete a Filter keywords item

DELETE/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.

Access: write

Try it with MCPAsk your agent to call mastodon-filter-keywords-delete (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/mastodon/filter-keywords/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/filter-keywords/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Filter statuses

Mastodon: List Filtered posts

GET/accounts/{accountId}/mastodon/filter-statuses

Cursor 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.

Access: read

Try it with MCPAsk your agent to call mastodon-filter-statuses-list (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

filter_idstringrequired

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 3 item attributes
idstringrequiredread-only
status_idstringrequired
filter_idstring
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/filter-statuses
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/filter-statuses?filter_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Create a Filtered posts item

POST/accounts/{accountId}/mastodon/filter-statuses

Requires scopes: read:filters, write:filters. Network docs: https://docs.joinmastodon.org/methods/filters/#statuses-get Generic route: /v1/accounts/{accountId}/focus/filter-statuses.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-filter-statuses-create (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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_idstringrequired
status_idstringrequired

Returns object

idstringrequiredread-only
status_idstringrequired
filter_idstring

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/filter-statuses
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/filter-statuses" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "filter_id": "string",
    "status_id": "string"
  }'
Response · 201

Mastodon: Get a Filtered posts item

GET/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.

Access: read

Try it with MCPAsk your agent to call mastodon-filter-statuses-get (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstringrequiredread-only
status_idstringrequired
filter_idstring

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/filter-statuses/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/filter-statuses/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Delete a Filtered posts item

DELETE/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.

Access: write

Try it with MCPAsk your agent to call mastodon-filter-statuses-delete (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/mastodon/filter-statuses/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/filter-statuses/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Markers

Mastodon: List Read markers

GET/accounts/{accountId}/mastodon/markers

Last-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.

Access: read

Try it with MCPAsk your agent to call mastodon-markers-list (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 4 item attributes
idstringrequired

homenotifications

last_read_idstring
versioninteger
updated_atstring (date-time)
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/markers
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/markers" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Update a Read markers item

PATCH/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.

Access: write

Try it with MCPAsk your agent to call mastodon-markers-update (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

last_read_idstringrequired

Returns object

idstringrequired

homenotifications

last_read_idstring
versioninteger
updated_atstring (date-time)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/mastodon/markers/{itemId}
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/markers/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "last_read_id": "string"
  }'
Response · 200

Home timeline

Mastodon: List Home

GET/accounts/{accountId}/mastodon/home-timeline

Posts 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.

Access: read

Try it with MCPAsk your agent to call mastodon-home-timeline-list (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Opaque cursor from a previous next_cursor

limitintegerdefault: 20

1–80

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 29 item attributes
idstringrequiredread-only
uristring (uri)
urlstring (uri) | null
created_atstring (date-time)
edited_atstring (date-time) | null
textstringread-only
contentstring
spoiler_textstring
sensitiveboolean
visibilitystring

publicunlistedprivatedirect

languagestring | null
in_reply_to_idstring | null
in_reply_to_account_idstring | null
replies_countinteger
reblogs_countinteger
favourites_countinteger
quotes_countinteger | null
authorstring
author_namestring | null
media_attachmentsarray of object
Show 8 item attributes
idstringread-only
typestring

imagegifvvideoaudiounknown

urlstring (uri) | null
preview_urlstring (uri) | null
remote_urlstring (uri) | null
descriptionstring | null
blurhashstring | null
metaobject
pollobject | null
Show 9 child attributes
idstringread-only
expires_atstring (date-time) | null
expiredboolean
multipleboolean
votes_countinteger
voters_countinteger | null
votedboolean
own_votesarray of integer
optionsarray of object
Show 2 item attributes
titlestring
votes_countinteger | null
favouritedboolean
rebloggedboolean
bookmarkedboolean
mutedboolean
pinnedboolean
is_reblogboolean
quoteobject | null
Show 2 child attributes
statestring
quoted_statusobject | null
quote_approvalobject | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/home-timeline
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/home-timeline" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Favourite (Home)

POST/accounts/{accountId}/mastodon/home-timeline/{itemId}/favourite

Favourite. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-home-timeline-favourite (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/home-timeline/{itemId}/favourite
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/home-timeline/ITEM_ID/favourite" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mastodon: Unfavourite (Home)

POST/accounts/{accountId}/mastodon/home-timeline/{itemId}/unfavourite

Unfavourite. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-home-timeline-unfavourite (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/home-timeline/{itemId}/unfavourite
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/home-timeline/ITEM_ID/unfavourite" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mastodon: Boost (Home)

POST/accounts/{accountId}/mastodon/home-timeline/{itemId}/boost

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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-home-timeline-boost (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

visibilitystring

publicunlistedprivate

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/home-timeline/{itemId}/boost
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/home-timeline/ITEM_ID/boost" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "visibility": "public"
  }'
Response · 200

Mastodon: Undo boost (Home)

POST/accounts/{accountId}/mastodon/home-timeline/{itemId}/unboost

Undo 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-home-timeline-unboost (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/home-timeline/{itemId}/unboost
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/home-timeline/ITEM_ID/unboost" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mastodon: Bookmark (Home)

POST/accounts/{accountId}/mastodon/home-timeline/{itemId}/bookmark

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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-home-timeline-bookmark (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/home-timeline/{itemId}/bookmark
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/home-timeline/ITEM_ID/bookmark" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mastodon: Remove bookmark (Home)

POST/accounts/{accountId}/mastodon/home-timeline/{itemId}/unbookmark

Remove 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-home-timeline-unbookmark (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/home-timeline/{itemId}/unbookmark
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/home-timeline/ITEM_ID/unbookmark" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mastodon: Reply (Home)

POST/accounts/{accountId}/mastodon/home-timeline/{itemId}/reply

Reply. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-home-timeline-reply (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

statusstring

Plain text; URLs count as 23 characters

visibilitystring

publicunlistedprivatedirect

spoiler_textstring
sensitiveboolean
languagestring

ISO 639-1

mediaarray of string

Socialit media ids (uploaded to the instance on publish)

media_idsarray of string

Already-uploaded Mastodon media ids

alt_textsarray of string

Alt text per media item, by index

pollobject
Show 4 child attributes
optionsarray of string

≥ 2 items

expires_inintegerdefault: 86400
multipleboolean
hide_totalsboolean
in_reply_to_idstring
quoted_status_idstring

Mastodon 4.5+

quote_approval_policystring

publicfollowersnobody

scheduled_atstring (date-time)

≥ 5 minutes ahead → ScheduledStatus

threadarray of string

Follow-up replies posted as a self-thread

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/home-timeline/{itemId}/reply
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/home-timeline/ITEM_ID/reply" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "string",
    "visibility": "public",
    "spoiler_text": "string",
    "sensitive": true,
    "language": "en"
  }'
Response · 200

Local timeline

Mastodon: List Local

GET/accounts/{accountId}/mastodon/local-timeline

Public 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.

Access: read

Try it with MCPAsk your agent to call mastodon-local-timeline-list (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Opaque cursor from a previous next_cursor

limitintegerdefault: 20

1–80

only_mediaboolean

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 29 item attributes
idstringrequiredread-only
uristring (uri)
urlstring (uri) | null
created_atstring (date-time)
edited_atstring (date-time) | null
textstringread-only
contentstring
spoiler_textstring
sensitiveboolean
visibilitystring

publicunlistedprivatedirect

languagestring | null
in_reply_to_idstring | null
in_reply_to_account_idstring | null
replies_countinteger
reblogs_countinteger
favourites_countinteger
quotes_countinteger | null
authorstring
author_namestring | null
media_attachmentsarray of object
Show 8 item attributes
idstringread-only
typestring

imagegifvvideoaudiounknown

urlstring (uri) | null
preview_urlstring (uri) | null
remote_urlstring (uri) | null
descriptionstring | null
blurhashstring | null
metaobject
pollobject | null
Show 9 child attributes
idstringread-only
expires_atstring (date-time) | null
expiredboolean
multipleboolean
votes_countinteger
voters_countinteger | null
votedboolean
own_votesarray of integer
optionsarray of object
Show 2 item attributes
titlestring
votes_countinteger | null
favouritedboolean
rebloggedboolean
bookmarkedboolean
mutedboolean
pinnedboolean
is_reblogboolean
quoteobject | null
Show 2 child attributes
statestring
quoted_statusobject | null
quote_approvalobject | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/local-timeline
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/local-timeline" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Favourite (Local)

POST/accounts/{accountId}/mastodon/local-timeline/{itemId}/favourite

Favourite. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-local-timeline-favourite (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/local-timeline/{itemId}/favourite
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/local-timeline/ITEM_ID/favourite" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mastodon: Unfavourite (Local)

POST/accounts/{accountId}/mastodon/local-timeline/{itemId}/unfavourite

Unfavourite. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-local-timeline-unfavourite (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/local-timeline/{itemId}/unfavourite
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/local-timeline/ITEM_ID/unfavourite" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mastodon: Boost (Local)

POST/accounts/{accountId}/mastodon/local-timeline/{itemId}/boost

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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-local-timeline-boost (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

visibilitystring

publicunlistedprivate

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/local-timeline/{itemId}/boost
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/local-timeline/ITEM_ID/boost" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "visibility": "public"
  }'
Response · 200

Mastodon: Undo boost (Local)

POST/accounts/{accountId}/mastodon/local-timeline/{itemId}/unboost

Undo 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-local-timeline-unboost (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/local-timeline/{itemId}/unboost
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/local-timeline/ITEM_ID/unboost" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mastodon: Bookmark (Local)

POST/accounts/{accountId}/mastodon/local-timeline/{itemId}/bookmark

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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-local-timeline-bookmark (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/local-timeline/{itemId}/bookmark
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/local-timeline/ITEM_ID/bookmark" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mastodon: Remove bookmark (Local)

POST/accounts/{accountId}/mastodon/local-timeline/{itemId}/unbookmark

Remove 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-local-timeline-unbookmark (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/local-timeline/{itemId}/unbookmark
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/local-timeline/ITEM_ID/unbookmark" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mastodon: Reply (Local)

POST/accounts/{accountId}/mastodon/local-timeline/{itemId}/reply

Reply. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-local-timeline-reply (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

statusstring

Plain text; URLs count as 23 characters

visibilitystring

publicunlistedprivatedirect

spoiler_textstring
sensitiveboolean
languagestring

ISO 639-1

mediaarray of string

Socialit media ids (uploaded to the instance on publish)

media_idsarray of string

Already-uploaded Mastodon media ids

alt_textsarray of string

Alt text per media item, by index

pollobject
Show 4 child attributes
optionsarray of string

≥ 2 items

expires_inintegerdefault: 86400
multipleboolean
hide_totalsboolean
in_reply_to_idstring
quoted_status_idstring

Mastodon 4.5+

quote_approval_policystring

publicfollowersnobody

scheduled_atstring (date-time)

≥ 5 minutes ahead → ScheduledStatus

threadarray of string

Follow-up replies posted as a self-thread

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/local-timeline/{itemId}/reply
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/local-timeline/ITEM_ID/reply" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "string",
    "visibility": "public",
    "spoiler_text": "string",
    "sensitive": true,
    "language": "en"
  }'
Response · 200

Federated timeline

Mastodon: List Federated

GET/accounts/{accountId}/mastodon/federated-timeline

Public 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.

Access: read

Try it with MCPAsk your agent to call mastodon-federated-timeline-list (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Opaque cursor from a previous next_cursor

limitintegerdefault: 20

1–80

only_mediaboolean
remoteboolean

Only remote posts

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 29 item attributes
idstringrequiredread-only
uristring (uri)
urlstring (uri) | null
created_atstring (date-time)
edited_atstring (date-time) | null
textstringread-only
contentstring
spoiler_textstring
sensitiveboolean
visibilitystring

publicunlistedprivatedirect

languagestring | null
in_reply_to_idstring | null
in_reply_to_account_idstring | null
replies_countinteger
reblogs_countinteger
favourites_countinteger
quotes_countinteger | null
authorstring
author_namestring | null
media_attachmentsarray of object
Show 8 item attributes
idstringread-only
typestring

imagegifvvideoaudiounknown

urlstring (uri) | null
preview_urlstring (uri) | null
remote_urlstring (uri) | null
descriptionstring | null
blurhashstring | null
metaobject
pollobject | null
Show 9 child attributes
idstringread-only
expires_atstring (date-time) | null
expiredboolean
multipleboolean
votes_countinteger
voters_countinteger | null
votedboolean
own_votesarray of integer
optionsarray of object
Show 2 item attributes
titlestring
votes_countinteger | null
favouritedboolean
rebloggedboolean
bookmarkedboolean
mutedboolean
pinnedboolean
is_reblogboolean
quoteobject | null
Show 2 child attributes
statestring
quoted_statusobject | null
quote_approvalobject | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/federated-timeline
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/federated-timeline" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Favourite (Federated)

POST/accounts/{accountId}/mastodon/federated-timeline/{itemId}/favourite

Favourite. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-federated-timeline-favourite (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/federated-timeline/{itemId}/favourite
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/federated-timeline/ITEM_ID/favourite" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mastodon: Unfavourite (Federated)

POST/accounts/{accountId}/mastodon/federated-timeline/{itemId}/unfavourite

Unfavourite. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-federated-timeline-unfavourite (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/federated-timeline/{itemId}/unfavourite
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/federated-timeline/ITEM_ID/unfavourite" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mastodon: Boost (Federated)

POST/accounts/{accountId}/mastodon/federated-timeline/{itemId}/boost

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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-federated-timeline-boost (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

visibilitystring

publicunlistedprivate

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/federated-timeline/{itemId}/boost
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/federated-timeline/ITEM_ID/boost" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "visibility": "public"
  }'
Response · 200

Mastodon: Undo boost (Federated)

POST/accounts/{accountId}/mastodon/federated-timeline/{itemId}/unboost

Undo 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-federated-timeline-unboost (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/federated-timeline/{itemId}/unboost
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/federated-timeline/ITEM_ID/unboost" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mastodon: Bookmark (Federated)

POST/accounts/{accountId}/mastodon/federated-timeline/{itemId}/bookmark

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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-federated-timeline-bookmark (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/federated-timeline/{itemId}/bookmark
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/federated-timeline/ITEM_ID/bookmark" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mastodon: Remove bookmark (Federated)

POST/accounts/{accountId}/mastodon/federated-timeline/{itemId}/unbookmark

Remove 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-federated-timeline-unbookmark (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/federated-timeline/{itemId}/unbookmark
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/federated-timeline/ITEM_ID/unbookmark" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mastodon: Reply (Federated)

POST/accounts/{accountId}/mastodon/federated-timeline/{itemId}/reply

Reply. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-federated-timeline-reply (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

statusstring

Plain text; URLs count as 23 characters

visibilitystring

publicunlistedprivatedirect

spoiler_textstring
sensitiveboolean
languagestring

ISO 639-1

mediaarray of string

Socialit media ids (uploaded to the instance on publish)

media_idsarray of string

Already-uploaded Mastodon media ids

alt_textsarray of string

Alt text per media item, by index

pollobject
Show 4 child attributes
optionsarray of string

≥ 2 items

expires_inintegerdefault: 86400
multipleboolean
hide_totalsboolean
in_reply_to_idstring
quoted_status_idstring

Mastodon 4.5+

quote_approval_policystring

publicfollowersnobody

scheduled_atstring (date-time)

≥ 5 minutes ahead → ScheduledStatus

threadarray of string

Follow-up replies posted as a self-thread

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/federated-timeline/{itemId}/reply
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/federated-timeline/ITEM_ID/reply" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "string",
    "visibility": "public",
    "spoiler_text": "string",
    "sensitive": true,
    "language": "en"
  }'
Response · 200

Hashtag timeline

Mastodon: List Hashtag

GET/accounts/{accountId}/mastodon/hashtag-timeline

Public 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.

Access: read

Try it with MCPAsk your agent to call mastodon-hashtag-timeline-list (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Opaque cursor from a previous next_cursor

limitintegerdefault: 20

1–80

tagstringrequired
anyarray of string
allarray of string
nonearray of string
localboolean
remoteboolean
only_mediaboolean

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 29 item attributes
idstringrequiredread-only
uristring (uri)
urlstring (uri) | null
created_atstring (date-time)
edited_atstring (date-time) | null
textstringread-only
contentstring
spoiler_textstring
sensitiveboolean
visibilitystring

publicunlistedprivatedirect

languagestring | null
in_reply_to_idstring | null
in_reply_to_account_idstring | null
replies_countinteger
reblogs_countinteger
favourites_countinteger
quotes_countinteger | null
authorstring
author_namestring | null
media_attachmentsarray of object
Show 8 item attributes
idstringread-only
typestring

imagegifvvideoaudiounknown

urlstring (uri) | null
preview_urlstring (uri) | null
remote_urlstring (uri) | null
descriptionstring | null
blurhashstring | null
metaobject
pollobject | null
Show 9 child attributes
idstringread-only
expires_atstring (date-time) | null
expiredboolean
multipleboolean
votes_countinteger
voters_countinteger | null
votedboolean
own_votesarray of integer
optionsarray of object
Show 2 item attributes
titlestring
votes_countinteger | null
favouritedboolean
rebloggedboolean
bookmarkedboolean
mutedboolean
pinnedboolean
is_reblogboolean
quoteobject | null
Show 2 child attributes
statestring
quoted_statusobject | null
quote_approvalobject | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/hashtag-timeline
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/hashtag-timeline?tag=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Favourite (Hashtag)

POST/accounts/{accountId}/mastodon/hashtag-timeline/{itemId}/favourite

Favourite. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-hashtag-timeline-favourite (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/hashtag-timeline/{itemId}/favourite
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/hashtag-timeline/ITEM_ID/favourite" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mastodon: Unfavourite (Hashtag)

POST/accounts/{accountId}/mastodon/hashtag-timeline/{itemId}/unfavourite

Unfavourite. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-hashtag-timeline-unfavourite (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/hashtag-timeline/{itemId}/unfavourite
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/hashtag-timeline/ITEM_ID/unfavourite" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mastodon: Boost (Hashtag)

POST/accounts/{accountId}/mastodon/hashtag-timeline/{itemId}/boost

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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-hashtag-timeline-boost (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

visibilitystring

publicunlistedprivate

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/hashtag-timeline/{itemId}/boost
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/hashtag-timeline/ITEM_ID/boost" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "visibility": "public"
  }'
Response · 200

Mastodon: Undo boost (Hashtag)

POST/accounts/{accountId}/mastodon/hashtag-timeline/{itemId}/unboost

Undo 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-hashtag-timeline-unboost (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/hashtag-timeline/{itemId}/unboost
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/hashtag-timeline/ITEM_ID/unboost" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mastodon: Bookmark (Hashtag)

POST/accounts/{accountId}/mastodon/hashtag-timeline/{itemId}/bookmark

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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-hashtag-timeline-bookmark (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/hashtag-timeline/{itemId}/bookmark
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/hashtag-timeline/ITEM_ID/bookmark" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mastodon: Remove bookmark (Hashtag)

POST/accounts/{accountId}/mastodon/hashtag-timeline/{itemId}/unbookmark

Remove 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-hashtag-timeline-unbookmark (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/hashtag-timeline/{itemId}/unbookmark
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/hashtag-timeline/ITEM_ID/unbookmark" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mastodon: Reply (Hashtag)

POST/accounts/{accountId}/mastodon/hashtag-timeline/{itemId}/reply

Reply. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-hashtag-timeline-reply (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

statusstring

Plain text; URLs count as 23 characters

visibilitystring

publicunlistedprivatedirect

spoiler_textstring
sensitiveboolean
languagestring

ISO 639-1

mediaarray of string

Socialit media ids (uploaded to the instance on publish)

media_idsarray of string

Already-uploaded Mastodon media ids

alt_textsarray of string

Alt text per media item, by index

pollobject
Show 4 child attributes
optionsarray of string

≥ 2 items

expires_inintegerdefault: 86400
multipleboolean
hide_totalsboolean
in_reply_to_idstring
quoted_status_idstring

Mastodon 4.5+

quote_approval_policystring

publicfollowersnobody

scheduled_atstring (date-time)

≥ 5 minutes ahead → ScheduledStatus

threadarray of string

Follow-up replies posted as a self-thread

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/hashtag-timeline/{itemId}/reply
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/hashtag-timeline/ITEM_ID/reply" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "string",
    "visibility": "public",
    "spoiler_text": "string",
    "sensitive": true,
    "language": "en"
  }'
Response · 200
GET/accounts/{accountId}/mastodon/link-timeline

Posts 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.

Access: read

Try it with MCPAsk your agent to call mastodon-link-timeline-list (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Opaque cursor from a previous next_cursor

limitintegerdefault: 20

1–80

urlstring (uri)required

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 29 item attributes
idstringrequiredread-only
uristring (uri)
urlstring (uri) | null
created_atstring (date-time)
edited_atstring (date-time) | null
textstringread-only
contentstring
spoiler_textstring
sensitiveboolean
visibilitystring

publicunlistedprivatedirect

languagestring | null
in_reply_to_idstring | null
in_reply_to_account_idstring | null
replies_countinteger
reblogs_countinteger
favourites_countinteger
quotes_countinteger | null
authorstring
author_namestring | null
media_attachmentsarray of object
Show 8 item attributes
idstringread-only
typestring

imagegifvvideoaudiounknown

urlstring (uri) | null
preview_urlstring (uri) | null
remote_urlstring (uri) | null
descriptionstring | null
blurhashstring | null
metaobject
pollobject | null
Show 9 child attributes
idstringread-only
expires_atstring (date-time) | null
expiredboolean
multipleboolean
votes_countinteger
voters_countinteger | null
votedboolean
own_votesarray of integer
optionsarray of object
Show 2 item attributes
titlestring
votes_countinteger | null
favouritedboolean
rebloggedboolean
bookmarkedboolean
mutedboolean
pinnedboolean
is_reblogboolean
quoteobject | null
Show 2 child attributes
statestring
quoted_statusobject | null
quote_approvalobject | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/link-timeline
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/link-timeline?url=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
POST/accounts/{accountId}/mastodon/link-timeline/{itemId}/favourite

Favourite. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-link-timeline-favourite (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/link-timeline/{itemId}/favourite
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/link-timeline/ITEM_ID/favourite" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200
POST/accounts/{accountId}/mastodon/link-timeline/{itemId}/unfavourite

Unfavourite. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-link-timeline-unfavourite (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/link-timeline/{itemId}/unfavourite
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/link-timeline/ITEM_ID/unfavourite" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200
POST/accounts/{accountId}/mastodon/link-timeline/{itemId}/boost

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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-link-timeline-boost (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

visibilitystring

publicunlistedprivate

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/link-timeline/{itemId}/boost
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/link-timeline/ITEM_ID/boost" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "visibility": "public"
  }'
Response · 200
POST/accounts/{accountId}/mastodon/link-timeline/{itemId}/unboost

Undo 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-link-timeline-unboost (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/link-timeline/{itemId}/unboost
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/link-timeline/ITEM_ID/unboost" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200
POST/accounts/{accountId}/mastodon/link-timeline/{itemId}/bookmark

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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-link-timeline-bookmark (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/link-timeline/{itemId}/bookmark
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/link-timeline/ITEM_ID/bookmark" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200
POST/accounts/{accountId}/mastodon/link-timeline/{itemId}/unbookmark

Remove 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-link-timeline-unbookmark (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/link-timeline/{itemId}/unbookmark
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/link-timeline/ITEM_ID/unbookmark" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200
POST/accounts/{accountId}/mastodon/link-timeline/{itemId}/reply

Reply. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-link-timeline-reply (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

statusstring

Plain text; URLs count as 23 characters

visibilitystring

publicunlistedprivatedirect

spoiler_textstring
sensitiveboolean
languagestring

ISO 639-1

mediaarray of string

Socialit media ids (uploaded to the instance on publish)

media_idsarray of string

Already-uploaded Mastodon media ids

alt_textsarray of string

Alt text per media item, by index

pollobject
Show 4 child attributes
optionsarray of string

≥ 2 items

expires_inintegerdefault: 86400
multipleboolean
hide_totalsboolean
in_reply_to_idstring
quoted_status_idstring

Mastodon 4.5+

quote_approval_policystring

publicfollowersnobody

scheduled_atstring (date-time)

≥ 5 minutes ahead → ScheduledStatus

threadarray of string

Follow-up replies posted as a self-thread

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/link-timeline/{itemId}/reply
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/link-timeline/ITEM_ID/reply" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "string",
    "visibility": "public",
    "spoiler_text": "string",
    "sensitive": true,
    "language": "en"
  }'
Response · 200

List timeline

Mastodon: List List

GET/accounts/{accountId}/mastodon/list-timeline

Posts 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.

Access: read

Try it with MCPAsk your agent to call mastodon-list-timeline-list (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Opaque cursor from a previous next_cursor

limitintegerdefault: 20

1–80

list_idstringrequired

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 29 item attributes
idstringrequiredread-only
uristring (uri)
urlstring (uri) | null
created_atstring (date-time)
edited_atstring (date-time) | null
textstringread-only
contentstring
spoiler_textstring
sensitiveboolean
visibilitystring

publicunlistedprivatedirect

languagestring | null
in_reply_to_idstring | null
in_reply_to_account_idstring | null
replies_countinteger
reblogs_countinteger
favourites_countinteger
quotes_countinteger | null
authorstring
author_namestring | null
media_attachmentsarray of object
Show 8 item attributes
idstringread-only
typestring

imagegifvvideoaudiounknown

urlstring (uri) | null
preview_urlstring (uri) | null
remote_urlstring (uri) | null
descriptionstring | null
blurhashstring | null
metaobject
pollobject | null
Show 9 child attributes
idstringread-only
expires_atstring (date-time) | null
expiredboolean
multipleboolean
votes_countinteger
voters_countinteger | null
votedboolean
own_votesarray of integer
optionsarray of object
Show 2 item attributes
titlestring
votes_countinteger | null
favouritedboolean
rebloggedboolean
bookmarkedboolean
mutedboolean
pinnedboolean
is_reblogboolean
quoteobject | null
Show 2 child attributes
statestring
quoted_statusobject | null
quote_approvalobject | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/list-timeline
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/list-timeline?list_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Favourite (List)

POST/accounts/{accountId}/mastodon/list-timeline/{itemId}/favourite

Favourite. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-list-timeline-favourite (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/list-timeline/{itemId}/favourite
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/list-timeline/ITEM_ID/favourite" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mastodon: Unfavourite (List)

POST/accounts/{accountId}/mastodon/list-timeline/{itemId}/unfavourite

Unfavourite. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-list-timeline-unfavourite (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/list-timeline/{itemId}/unfavourite
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/list-timeline/ITEM_ID/unfavourite" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mastodon: Boost (List)

POST/accounts/{accountId}/mastodon/list-timeline/{itemId}/boost

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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-list-timeline-boost (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

visibilitystring

publicunlistedprivate

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/list-timeline/{itemId}/boost
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/list-timeline/ITEM_ID/boost" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "visibility": "public"
  }'
Response · 200

Mastodon: Undo boost (List)

POST/accounts/{accountId}/mastodon/list-timeline/{itemId}/unboost

Undo 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-list-timeline-unboost (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/list-timeline/{itemId}/unboost
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/list-timeline/ITEM_ID/unboost" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mastodon: Bookmark (List)

POST/accounts/{accountId}/mastodon/list-timeline/{itemId}/bookmark

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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-list-timeline-bookmark (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/list-timeline/{itemId}/bookmark
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/list-timeline/ITEM_ID/bookmark" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mastodon: Remove bookmark (List)

POST/accounts/{accountId}/mastodon/list-timeline/{itemId}/unbookmark

Remove 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-list-timeline-unbookmark (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/list-timeline/{itemId}/unbookmark
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/list-timeline/ITEM_ID/unbookmark" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mastodon: Reply (List)

POST/accounts/{accountId}/mastodon/list-timeline/{itemId}/reply

Reply. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-list-timeline-reply (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

statusstring

Plain text; URLs count as 23 characters

visibilitystring

publicunlistedprivatedirect

spoiler_textstring
sensitiveboolean
languagestring

ISO 639-1

mediaarray of string

Socialit media ids (uploaded to the instance on publish)

media_idsarray of string

Already-uploaded Mastodon media ids

alt_textsarray of string

Alt text per media item, by index

pollobject
Show 4 child attributes
optionsarray of string

≥ 2 items

expires_inintegerdefault: 86400
multipleboolean
hide_totalsboolean
in_reply_to_idstring
quoted_status_idstring

Mastodon 4.5+

quote_approval_policystring

publicfollowersnobody

scheduled_atstring (date-time)

≥ 5 minutes ahead → ScheduledStatus

threadarray of string

Follow-up replies posted as a self-thread

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/list-timeline/{itemId}/reply
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/list-timeline/ITEM_ID/reply" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "string",
    "visibility": "public",
    "spoiler_text": "string",
    "sensitive": true,
    "language": "en"
  }'
Response · 200
GET/accounts/{accountId}/mastodon/trends-tags

Cursor pagination: pass next_cursor back as cursor. Network docs: https://docs.joinmastodon.org/methods/trends/#tags Generic route: /v1/accounts/{accountId}/focus/trends-tags.

Access: read

Try it with MCPAsk your agent to call mastodon-trends-tags-list (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 10

≤ 20

cursorstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 6 item attributes
idstring | null
namestring
urlstring (uri)
followingboolean | null
featuringboolean | null
historyarray of object
Show 3 item attributes
daystring
usesstring
accountsstring
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/trends-tags
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/trends-tags" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
POST/accounts/{accountId}/mastodon/trends-tags/{itemId}/follow

Follow hashtag. Requires scopes: write:follows. Network docs: https://docs.joinmastodon.org/methods/trends/#tags Generic route: /v1/accounts/{accountId}/focus/trends-tags.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-trends-tags-follow (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/trends-tags/{itemId}/follow
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/trends-tags/ITEM_ID/follow" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200
GET/accounts/{accountId}/mastodon/trends-statuses

Cursor pagination: pass next_cursor back as cursor. Network docs: https://docs.joinmastodon.org/methods/trends/#statuses Generic route: /v1/accounts/{accountId}/focus/trends-statuses.

Access: read

Try it with MCPAsk your agent to call mastodon-trends-statuses-list (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 20

≤ 40

cursorstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 29 item attributes
idstringrequiredread-only
uristring (uri)
urlstring (uri) | null
created_atstring (date-time)
edited_atstring (date-time) | null
textstringread-only
contentstring
spoiler_textstring
sensitiveboolean
visibilitystring

publicunlistedprivatedirect

languagestring | null
in_reply_to_idstring | null
in_reply_to_account_idstring | null
replies_countinteger
reblogs_countinteger
favourites_countinteger
quotes_countinteger | null
authorstring
author_namestring | null
media_attachmentsarray of object
Show 8 item attributes
idstringread-only
typestring

imagegifvvideoaudiounknown

urlstring (uri) | null
preview_urlstring (uri) | null
remote_urlstring (uri) | null
descriptionstring | null
blurhashstring | null
metaobject
pollobject | null
Show 9 child attributes
idstringread-only
expires_atstring (date-time) | null
expiredboolean
multipleboolean
votes_countinteger
voters_countinteger | null
votedboolean
own_votesarray of integer
optionsarray of object
Show 2 item attributes
titlestring
votes_countinteger | null
favouritedboolean
rebloggedboolean
bookmarkedboolean
mutedboolean
pinnedboolean
is_reblogboolean
quoteobject | null
Show 2 child attributes
statestring
quoted_statusobject | null
quote_approvalobject | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/trends-statuses
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/trends-statuses" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
POST/accounts/{accountId}/mastodon/trends-statuses/{itemId}/favourite

Favourite. Requires scopes: write:favourites. Network docs: https://docs.joinmastodon.org/methods/trends/#statuses Generic route: /v1/accounts/{accountId}/focus/trends-statuses.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-trends-statuses-favourite (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/trends-statuses/{itemId}/favourite
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/trends-statuses/ITEM_ID/favourite" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200
POST/accounts/{accountId}/mastodon/trends-statuses/{itemId}/unfavourite

Unfavourite. Requires scopes: write:favourites. Network docs: https://docs.joinmastodon.org/methods/trends/#statuses Generic route: /v1/accounts/{accountId}/focus/trends-statuses.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-trends-statuses-unfavourite (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/trends-statuses/{itemId}/unfavourite
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/trends-statuses/ITEM_ID/unfavourite" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200
POST/accounts/{accountId}/mastodon/trends-statuses/{itemId}/boost

Boost. Requires scopes: write:statuses. Network docs: https://docs.joinmastodon.org/methods/trends/#statuses Generic route: /v1/accounts/{accountId}/focus/trends-statuses.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-trends-statuses-boost (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

visibilitystring

publicunlistedprivate

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/trends-statuses/{itemId}/boost
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/trends-statuses/ITEM_ID/boost" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "visibility": "public"
  }'
Response · 200
POST/accounts/{accountId}/mastodon/trends-statuses/{itemId}/unboost

Undo boost. Requires scopes: write:statuses. Network docs: https://docs.joinmastodon.org/methods/trends/#statuses Generic route: /v1/accounts/{accountId}/focus/trends-statuses.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-trends-statuses-unboost (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/trends-statuses/{itemId}/unboost
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/trends-statuses/ITEM_ID/unboost" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200
POST/accounts/{accountId}/mastodon/trends-statuses/{itemId}/bookmark

Bookmark. Requires scopes: write:bookmarks. Network docs: https://docs.joinmastodon.org/methods/trends/#statuses Generic route: /v1/accounts/{accountId}/focus/trends-statuses.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-trends-statuses-bookmark (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/trends-statuses/{itemId}/bookmark
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/trends-statuses/ITEM_ID/bookmark" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200
POST/accounts/{accountId}/mastodon/trends-statuses/{itemId}/unbookmark

Remove bookmark. Requires scopes: write:bookmarks. Network docs: https://docs.joinmastodon.org/methods/trends/#statuses Generic route: /v1/accounts/{accountId}/focus/trends-statuses.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-trends-statuses-unbookmark (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/trends-statuses/{itemId}/unbookmark
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/trends-statuses/ITEM_ID/unbookmark" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200
POST/accounts/{accountId}/mastodon/trends-statuses/{itemId}/reply

Reply. Requires scopes: write:statuses. Network docs: https://docs.joinmastodon.org/methods/trends/#statuses Generic route: /v1/accounts/{accountId}/focus/trends-statuses.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-trends-statuses-reply (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

statusstring

Plain text; URLs count as 23 characters

visibilitystring

publicunlistedprivatedirect

spoiler_textstring
sensitiveboolean
languagestring

ISO 639-1

mediaarray of string

Socialit media ids (uploaded to the instance on publish)

media_idsarray of string

Already-uploaded Mastodon media ids

alt_textsarray of string

Alt text per media item, by index

pollobject
Show 4 child attributes
optionsarray of string

≥ 2 items

expires_inintegerdefault: 86400
multipleboolean
hide_totalsboolean
in_reply_to_idstring
quoted_status_idstring

Mastodon 4.5+

quote_approval_policystring

publicfollowersnobody

scheduled_atstring (date-time)

≥ 5 minutes ahead → ScheduledStatus

threadarray of string

Follow-up replies posted as a self-thread

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/trends-statuses/{itemId}/reply
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/trends-statuses/ITEM_ID/reply" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "string",
    "visibility": "public",
    "spoiler_text": "string",
    "sensitive": true,
    "language": "en"
  }'
Response · 200
GET/accounts/{accountId}/mastodon/trends-links

Cursor pagination: pass next_cursor back as cursor. Network docs: https://docs.joinmastodon.org/methods/trends/#links Generic route: /v1/accounts/{accountId}/focus/trends-links.

Access: read

Try it with MCPAsk your agent to call mastodon-trends-links-list (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 10

≤ 20

cursorstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 9 item attributes
urlstring (uri)required
titlestring
descriptionstring
typestring

linkphotovideorich

provider_namestring
author_namestring
imagestring (uri) | null
published_atstring (date-time) | null
historyarray of object
Show 3 item attributes
daystring
usesstring
accountsstring
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/trends-links
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/trends-links" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: List Search

GET/accounts/{accountId}/mastodon/search

Search 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.

Access: read

Try it with MCPAsk your agent to call mastodon-search-list (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

qstringrequired
typestring

accountsstatuseshashtags

resolveboolean
followingboolean
account_idstring
exclude_unreviewedboolean
limitintegerdefault: 20

≤ 40

cursorstring

offset=

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 7 item attributes
idstringrequired
kindstringrequired

accountstatushashtag

titlestring
urlstring (uri) | null
accountobject | null
Show 23 child attributes
idstringrequiredread-only
acctstringrequired
usernamestring
display_namestring
urlstring (uri)
avatarstring
headerstring
notestring
note_textstring
lockedboolean
botboolean
groupboolean
discoverableboolean | null
indexableboolean | null
followers_countinteger
following_countinteger
statuses_countinteger
created_atstring (date-time)
last_status_atstring (date) | null
fieldsarray of object
Show 3 item attributes
namestring
valuestring
verified_atstring (date-time) | null
movedobject | null
suspendedboolean
limitedboolean
statusobject | null
Show 29 child attributes
idstringrequiredread-only
uristring (uri)
urlstring (uri) | null
created_atstring (date-time)
edited_atstring (date-time) | null
textstringread-only
contentstring
spoiler_textstring
sensitiveboolean
visibilitystring

publicunlistedprivatedirect

languagestring | null
in_reply_to_idstring | null
in_reply_to_account_idstring | null
replies_countinteger
reblogs_countinteger
favourites_countinteger
quotes_countinteger | null
authorstring
author_namestring | null
media_attachmentsarray of object
Show 8 item attributes
idstringread-only
typestring

imagegifvvideoaudiounknown

urlstring (uri) | null
preview_urlstring (uri) | null
remote_urlstring (uri) | null
descriptionstring | null
blurhashstring | null
metaobject
pollobject | null
Show 9 child attributes
idstringread-only
expires_atstring (date-time) | null
expiredboolean
multipleboolean
votes_countinteger
voters_countinteger | null
votedboolean
own_votesarray of integer
optionsarray of object
Show 2 item attributes
titlestring
votes_countinteger | null
favouritedboolean
rebloggedboolean
bookmarkedboolean
mutedboolean
pinnedboolean
is_reblogboolean
quoteobject | null
Show 2 child attributes
statestring
quoted_statusobject | null
quote_approvalobject | null
hashtagobject | null
Show 6 child attributes
idstring | null
namestring
urlstring (uri)
followingboolean | null
featuringboolean | null
historyarray of object
Show 3 item attributes
daystring
usesstring
accountsstring
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/search
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/search?q=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Tags

Mastodon: Get a Hashtags item

GET/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.

Access: read

Try it with MCPAsk your agent to call mastodon-tags-get (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstring | null
namestring
urlstring (uri)
followingboolean | null
featuringboolean | null
historyarray of object
Show 3 item attributes
daystring
usesstring
accountsstring

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/tags/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/tags/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Follow (Hashtags)

POST/accounts/{accountId}/mastodon/tags/{itemId}/follow

Follow. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-tags-follow (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/tags/{itemId}/follow
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/tags/ITEM_ID/follow" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mastodon: Unfollow (Hashtags)

POST/accounts/{accountId}/mastodon/tags/{itemId}/unfollow

Unfollow. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-tags-unfollow (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/tags/{itemId}/unfollow
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/tags/ITEM_ID/unfollow" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mastodon: Feature on profile (Hashtags)

POST/accounts/{accountId}/mastodon/tags/{itemId}/feature

Feature 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-tags-feature (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/tags/{itemId}/feature
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/tags/ITEM_ID/feature" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mastodon: Unfeature (Hashtags)

POST/accounts/{accountId}/mastodon/tags/{itemId}/unfeature

Unfeature. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-tags-unfeature (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/tags/{itemId}/unfeature
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/tags/ITEM_ID/unfeature" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Blocks

Mastodon: List Blocked accounts

GET/accounts/{accountId}/mastodon/blocks

Cursor 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.

Access: read

Try it with MCPAsk your agent to call mastodon-blocks-list (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Opaque cursor from a previous next_cursor

limitintegerdefault: 20

1–80

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 23 item attributes
idstringrequiredread-only
acctstringrequired
usernamestring
display_namestring
urlstring (uri)
avatarstring
headerstring
notestring
note_textstring
lockedboolean
botboolean
groupboolean
discoverableboolean | null
indexableboolean | null
followers_countinteger
following_countinteger
statuses_countinteger
created_atstring (date-time)
last_status_atstring (date) | null
fieldsarray of object
Show 3 item attributes
namestring
valuestring
verified_atstring (date-time) | null
movedobject | null
suspendedboolean
limitedboolean
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/blocks
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/blocks" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Create a Blocked accounts item

POST/accounts/{accountId}/mastodon/blocks

Requires scopes: read:blocks, write:blocks. Network docs: https://docs.joinmastodon.org/methods/blocks/ Generic route: /v1/accounts/{accountId}/focus/blocks.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-blocks-create (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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_idstringrequired

Returns object

idstringrequiredread-only
acctstringrequired
usernamestring
display_namestring
urlstring (uri)
avatarstring
headerstring
notestring
note_textstring
lockedboolean
botboolean
groupboolean
discoverableboolean | null
indexableboolean | null
followers_countinteger
following_countinteger
statuses_countinteger
created_atstring (date-time)
last_status_atstring (date) | null
fieldsarray of object
Show 3 item attributes
namestring
valuestring
verified_atstring (date-time) | null
movedobject | null
suspendedboolean
limitedboolean

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/blocks
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/blocks" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "string"
  }'
Response · 201

Mastodon: Delete a Blocked accounts item

DELETE/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.

Access: write

Try it with MCPAsk your agent to call mastodon-blocks-delete (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/mastodon/blocks/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/blocks/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mutes

Mastodon: List Muted accounts

GET/accounts/{accountId}/mastodon/mutes

Cursor 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.

Access: read

Try it with MCPAsk your agent to call mastodon-mutes-list (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Opaque cursor from a previous next_cursor

limitintegerdefault: 20

1–80

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 24 item attributes
idstringrequiredread-only
acctstring
usernamestring
display_namestring
urlstring (uri)
avatarstring
headerstring
notestring
note_textstring
lockedboolean
botboolean
groupboolean
discoverableboolean | null
indexableboolean | null
followers_countinteger
following_countinteger
statuses_countinteger
created_atstring (date-time)
last_status_atstring (date) | null
fieldsarray of object
Show 3 item attributes
namestring
valuestring
verified_atstring (date-time) | null
movedobject | null
suspendedboolean
limitedboolean
mute_expires_atstring (date-time) | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/mutes
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/mutes" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Create a Muted accounts item

POST/accounts/{accountId}/mastodon/mutes

Requires scopes: read:mutes, write:mutes. Network docs: https://docs.joinmastodon.org/methods/mutes/ Generic route: /v1/accounts/{accountId}/focus/mutes.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-mutes-create (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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_idstringrequired
notificationsbooleandefault: true
durationinteger

Seconds; 0 = indefinite

Returns object

idstringrequiredread-only
acctstring
usernamestring
display_namestring
urlstring (uri)
avatarstring
headerstring
notestring
note_textstring
lockedboolean
botboolean
groupboolean
discoverableboolean | null
indexableboolean | null
followers_countinteger
following_countinteger
statuses_countinteger
created_atstring (date-time)
last_status_atstring (date) | null
fieldsarray of object
Show 3 item attributes
namestring
valuestring
verified_atstring (date-time) | null
movedobject | null
suspendedboolean
limitedboolean
mute_expires_atstring (date-time) | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/mutes
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/mutes" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "string",
    "notifications": true,
    "duration": 0
  }'
Response · 201

Mastodon: Delete a Muted accounts item

DELETE/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.

Access: write

Try it with MCPAsk your agent to call mastodon-mutes-delete (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/mastodon/mutes/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/mutes/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Domain blocks

Mastodon: List Blocked servers

GET/accounts/{accountId}/mastodon/domain-blocks

Hide 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.

Access: read

Try it with MCPAsk your agent to call mastodon-domain-blocks-list (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Opaque cursor from a previous next_cursor

limitintegerdefault: 20

1–80

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 2 item attributes
idstring
domainstringrequired
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/domain-blocks
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/domain-blocks" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Create a Blocked servers item

POST/accounts/{accountId}/mastodon/domain-blocks

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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-domain-blocks-create (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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

domainstringrequired

Returns object

idstring
domainstringrequired

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/domain-blocks
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/domain-blocks" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "string"
  }'
Response · 201

Mastodon: Delete a Blocked servers item

DELETE/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.

Access: write

Try it with MCPAsk your agent to call mastodon-domain-blocks-delete (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/mastodon/domain-blocks/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/domain-blocks/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Reports

Mastodon: Create a Report item

POST/accounts/{accountId}/mastodon/reports

Report 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-reports-create (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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_idstringrequired
status_idsarray of string
collection_idsarray of string
commentstring
forwardboolean
forward_to_domainsarray of string
categorystring

spamlegalviolationother

rule_idsarray of string

Returns object

idstringread-only
account_idstringrequired
status_idsarray of string
collection_idsarray of string
commentstring

≤ 1000 characters

forwardboolean

Also send to the remote server

forward_to_domainsarray of string
categorystring

spamlegalviolationother

rule_idsarray of string
action_takenbooleanread-only
created_atstring (date-time)read-only

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/reports
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/reports" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "string",
    "status_ids": [
      "string"
    ],
    "collection_ids": [
      "string"
    ],
    "comment": "string",
    "forward": true
  }'
Response · 201

Profile

Mastodon: Get Profile

GET/accounts/{accountId}/mastodon/profile

Your 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.

Access: read

Try it with MCPAsk your agent to call mastodon-profile-get (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

idstringrequiredread-only
acctstring
usernamestring
display_namestring
urlstring (uri)
avatarstring
headerstring
notestring
note_textstring
lockedboolean
botboolean
groupboolean
discoverableboolean | null
indexableboolean | null
followers_countinteger
following_countinteger
statuses_countinteger
created_atstring (date-time)
last_status_atstring (date) | null
fieldsarray of object
Show 3 item attributes
namestring
valuestring
verified_atstring (date-time) | null
movedobject | null
suspendedboolean
limitedboolean
avatar_descriptionstring | null

4.6+

header_descriptionstring | null

4.6+

hide_collectionsboolean | null
show_mediaboolean | null
show_media_repliesboolean | null
show_featuredboolean | null
attribution_domainsarray of string | null

≤ 10 items

sourceobject
Show 6 child attributes
privacystring

publicunlistedprivatedirect

sensitiveboolean
languagestring | null
notestring
fieldsarray of object
Show 2 item attributes
namestring
valuestring
quote_policystring | null

publicfollowersnobody

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/profile
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/profile" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Update Profile

PATCH/accounts/{accountId}/mastodon/profile

PATCH /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.

Access: write

Try it with MCPAsk your agent to call mastodon-profile-update (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Body object

display_namestring

configuration.accounts.max_display_name_length (40 on 4.6+)

notestring

max_note_length (500)

avatarstring

Image (Socialit media id)

avatar_descriptionstring
headerstring
header_descriptionstring
lockedboolean
botboolean
discoverableboolean
indexableboolean
hide_collectionsboolean
show_mediaboolean
show_media_repliesboolean
show_featuredboolean
attribution_domainsarray of string

≤ 10 items

fields_attributesarray of object

≤ 4 items

Show 2 item attributes
namestring
valuestring
sourceobject
Show 4 child attributes
privacystring

publicunlistedprivate

sensitiveboolean
languagestring
quote_policystring

publicfollowersnobody

Returns object

idstringrequiredread-only
acctstring
usernamestring
display_namestring
urlstring (uri)
avatarstring
headerstring
notestring
note_textstring
lockedboolean
botboolean
groupboolean
discoverableboolean | null
indexableboolean | null
followers_countinteger
following_countinteger
statuses_countinteger
created_atstring (date-time)
last_status_atstring (date) | null
fieldsarray of object
Show 3 item attributes
namestring
valuestring
verified_atstring (date-time) | null
movedobject | null
suspendedboolean
limitedboolean
avatar_descriptionstring | null

4.6+

header_descriptionstring | null

4.6+

hide_collectionsboolean | null
show_mediaboolean | null
show_media_repliesboolean | null
show_featuredboolean | null
attribution_domainsarray of string | null

≤ 10 items

sourceobject
Show 6 child attributes
privacystring

publicunlistedprivatedirect

sensitiveboolean
languagestring | null
notestring
fieldsarray of object
Show 2 item attributes
namestring
valuestring
quote_policystring | null

publicfollowersnobody

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/mastodon/profile
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/profile" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "display_name": "string",
    "note": "string",
    "avatar": "string",
    "avatar_description": "string",
    "header": "string"
  }'
Response · 200

Mastodon: Remove avatar (Profile)

POST/accounts/{accountId}/mastodon/profile/delete-avatar

Remove 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.

Access: write

Try it with MCPAsk your agent to call mastodon-profile-delete-avatar (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/profile/delete-avatar
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/profile/delete-avatar" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mastodon: Remove header (Profile)

POST/accounts/{accountId}/mastodon/profile/delete-header

Remove 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.

Access: write

Try it with MCPAsk your agent to call mastodon-profile-delete-header (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/profile/delete-header
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/profile/delete-header" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Preferences

Mastodon: Get Preferences

GET/accounts/{accountId}/mastodon/preferences

Posting 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.

Access: read

Try it with MCPAsk your agent to call mastodon-preferences-get (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

posting:default:visibilitystring

publicunlistedprivatedirect

posting:default:sensitiveboolean
posting:default:languagestring | null
posting:default:quote_policystring | null

publicfollowersnobody

reading:expand:mediastring

defaultshow_allhide_all

reading:expand:spoilersboolean

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/preferences
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/preferences" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Annual reports

Mastodon: List Year in review

GET/accounts/{accountId}/mastodon/annual-reports

Wrapstodon 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.

Access: read

Try it with MCPAsk your agent to call mastodon-annual-reports-list (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 4 item attributes
idstring
yearintegerrequired
schema_versioninteger
dataobject
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/annual-reports
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/annual-reports" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Get a Year in review item

GET/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.

Access: read

Try it with MCPAsk your agent to call mastodon-annual-reports-get (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstring
yearintegerrequired
schema_versioninteger
dataobject

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/annual-reports/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/annual-reports/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Mark as read (Year in review)

POST/accounts/{accountId}/mastodon/annual-reports/{itemId}/mark-read

Mark 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-annual-reports-mark-read (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/annual-reports/{itemId}/mark-read
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/annual-reports/ITEM_ID/mark-read" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mastodon: Generate (Year in review)

POST/accounts/{accountId}/mastodon/annual-reports/{itemId}/generate

Generate. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-annual-reports-generate (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/annual-reports/{itemId}/generate
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/annual-reports/ITEM_ID/generate" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mastodon: Generation state (Year in review)

POST/accounts/{accountId}/mastodon/annual-reports/{itemId}/state

Generation 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-annual-reports-state (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/annual-reports/{itemId}/state
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/annual-reports/ITEM_ID/state" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Push subscription

Mastodon: Get Push subscription

GET/accounts/{accountId}/mastodon/push-subscription

Web 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.

Access: read

Try it with MCPAsk your agent to call mastodon-push-subscription-get (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

idstringread-only
endpointstring (uri)
standardboolean

RFC 8291 aes128gcm (4.4+)

policystring

allfollowedfollowernone

server_keystringread-only
alertsobject
Show 12 child attributes
mentionboolean
statusboolean
reblogboolean
followboolean
follow_requestboolean
favouriteboolean
pollboolean
updateboolean
quoteboolean
quoted_updateboolean
admin.sign_upboolean
admin.reportboolean

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/push-subscription
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/push-subscription" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Create a Push subscription item

POST/accounts/{accountId}/mastodon/push-subscription

Web 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-push-subscription-create (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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)required
keysobjectrequired
Show 2 child attributes
p256dhstringrequired
authstringrequired
alertsobject
Show 12 child attributes
mentionboolean
statusboolean
reblogboolean
followboolean
follow_requestboolean
favouriteboolean
pollboolean
updateboolean
quoteboolean
quoted_updateboolean
admin.sign_upboolean
admin.reportboolean
policystring

allfollowedfollowernone

standardbooleandefault: true

Returns object

idstringread-only
endpointstring (uri)
standardboolean

RFC 8291 aes128gcm (4.4+)

policystring

allfollowedfollowernone

server_keystringread-only
alertsobject
Show 12 child attributes
mentionboolean
statusboolean
reblogboolean
followboolean
follow_requestboolean
favouriteboolean
pollboolean
updateboolean
quoteboolean
quoted_updateboolean
admin.sign_upboolean
admin.reportboolean

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/push-subscription
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/push-subscription" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "endpoint": "https://example.com",
    "keys": {
      "p256dh": "string",
      "auth": "string"
    },
    "alerts": {
      "mention": true,
      "status": true
    },
    "policy": "all",
    "standard": true
  }'
Response · 201

Mastodon: Update Push subscription

PATCH/accounts/{accountId}/mastodon/push-subscription

Web 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.

Access: write

Try it with MCPAsk your agent to call mastodon-push-subscription-update (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Body object

alertsobject
Show 12 child attributes
mentionboolean
statusboolean
reblogboolean
followboolean
follow_requestboolean
favouriteboolean
pollboolean
updateboolean
quoteboolean
quoted_updateboolean
admin.sign_upboolean
admin.reportboolean
policystring

allfollowedfollowernone

Returns object

idstringread-only
endpointstring (uri)
standardboolean

RFC 8291 aes128gcm (4.4+)

policystring

allfollowedfollowernone

server_keystringread-only
alertsobject
Show 12 child attributes
mentionboolean
statusboolean
reblogboolean
followboolean
follow_requestboolean
favouriteboolean
pollboolean
updateboolean
quoteboolean
quoted_updateboolean
admin.sign_upboolean
admin.reportboolean

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/mastodon/push-subscription
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/push-subscription" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "alerts": {
      "mention": true,
      "status": true
    },
    "policy": "all"
  }'
Response · 200

Mastodon: Delete Push subscription

DELETE/accounts/{accountId}/mastodon/push-subscription

Web 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.

Access: write

Try it with MCPAsk your agent to call mastodon-push-subscription-delete (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/mastodon/push-subscription
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/push-subscription" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Instance

Mastodon: Get Server

GET/accounts/{accountId}/mastodon/instance

Server 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.

Access: read

Try it with MCPAsk your agent to call mastodon-instance-get (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

domainstringrequired
titlestring
versionstring
descriptionstring
source_urlstring (uri) | null
languagesarray of string
api_versionsobject
Show 1 child attributes
mastodoninteger
limitsobjectread-only
configurationobject
registrationsobject
Show 3 child attributes
enabledboolean
approval_requiredboolean
messagestring | null
contactobject
Show 2 child attributes
emailstring | null
accountobject | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/instance
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/instance" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Instance rules

Mastodon: List Server rules

GET/accounts/{accountId}/mastodon/instance-rules

Rules 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.

Access: read

Try it with MCPAsk your agent to call mastodon-instance-rules-list (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 4 item attributes
idstringrequired
textstringrequired
hintstring | null
translationsobject | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/instance-rules
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/instance-rules" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Terms of service

Mastodon: Get Terms of service

GET/accounts/{accountId}/mastodon/terms-of-service

Network docs: https://docs.joinmastodon.org/methods/instance/#terms_of_service Generic route: /v1/accounts/{accountId}/focus/terms-of-service.

Access: read

Try it with MCPAsk your agent to call mastodon-terms-of-service-get (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

updated_atstring (date-time) | null
contentstring
effective_datestring (date) | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/terms-of-service
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/terms-of-service" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Privacy policy

Mastodon: Get Privacy policy

GET/accounts/{accountId}/mastodon/privacy-policy

Network docs: https://docs.joinmastodon.org/methods/instance/#privacy_policy Generic route: /v1/accounts/{accountId}/focus/privacy-policy.

Access: read

Try it with MCPAsk your agent to call mastodon-privacy-policy-get (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

updated_atstring (date-time) | null
contentstring
effective_datestring (date) | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/privacy-policy
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/privacy-policy" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Extended description

Mastodon: Get About this server

GET/accounts/{accountId}/mastodon/extended-description

Network docs: https://docs.joinmastodon.org/methods/instance/#extended_description Generic route: /v1/accounts/{accountId}/focus/extended-description.

Access: read

Try it with MCPAsk your agent to call mastodon-extended-description-get (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

updated_atstring (date-time) | null
contentstring
effective_datestring (date) | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/extended-description
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/extended-description" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Instance peers

Mastodon: List Known servers

GET/accounts/{accountId}/mastodon/instance-peers

Domains 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.

Access: read

Try it with MCPAsk your agent to call mastodon-instance-peers-list (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 2 item attributes
idstring
domainstringrequired
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/instance-peers
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/instance-peers" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Instance activity

Mastodon: List Server activity

GET/accounts/{accountId}/mastodon/instance-activity

Weekly 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.

Access: read

Try it with MCPAsk your agent to call mastodon-instance-activity-list (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 5 item attributes
idstring
weekstring (date)required
statusesinteger
loginsinteger
registrationsinteger
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/instance-activity
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/instance-activity" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Instance domain blocks

Mastodon: List Moderated servers

GET/accounts/{accountId}/mastodon/instance-domain-blocks

Servers 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.

Access: read

Try it with MCPAsk your agent to call mastodon-instance-domain-blocks-list (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 4 item attributes
domainstringrequired
digeststring
severitystring

silencesuspend

commentstring | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/instance-domain-blocks
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/instance-domain-blocks" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Translation languages

Mastodon: List Translation languages

GET/accounts/{accountId}/mastodon/translation-languages

Cursor 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.

Access: read

Try it with MCPAsk your agent to call mastodon-translation-languages-list (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 3 item attributes
idstring
sourcestringrequired
targetsarray of string
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/translation-languages
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/translation-languages" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Custom emojis

Mastodon: List Custom emoji

GET/accounts/{accountId}/mastodon/custom-emojis

Cursor pagination: pass next_cursor back as cursor. Network docs: https://docs.joinmastodon.org/methods/custom_emojis/ Generic route: /v1/accounts/{accountId}/focus/custom-emojis.

Access: read

Try it with MCPAsk your agent to call mastodon-custom-emojis-list (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 5 item attributes
shortcodestringrequired
urlstring (uri)
static_urlstring (uri)
visible_in_pickerboolean
categorystring | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/custom-emojis
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/custom-emojis" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Announcements

Mastodon: List Announcements

GET/accounts/{accountId}/mastodon/announcements

Server 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.

Access: read

Try it with MCPAsk your agent to call mastodon-announcements-list (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

with_dismissedboolean

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 7 item attributes
idstringrequired
contentstring
starts_atstring (date-time) | null
ends_atstring (date-time) | null
published_atstring (date-time)
readboolean
reactionsarray of object
Show 3 item attributes
namestring
countinteger
meboolean
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/announcements
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/announcements" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Dismiss (Announcements)

POST/accounts/{accountId}/mastodon/announcements/{itemId}/dismiss

Dismiss. Server announcements; dismiss or react. Requires scopes: write:accounts. Network docs: https://docs.joinmastodon.org/methods/announcements/ Generic route: /v1/accounts/{accountId}/focus/announcements.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-announcements-dismiss (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/announcements/{itemId}/dismiss
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/announcements/ITEM_ID/dismiss" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mastodon: React (Announcements)

POST/accounts/{accountId}/mastodon/announcements/{itemId}/react

React. Server announcements; dismiss or react. Requires scopes: write:favourites. Network docs: https://docs.joinmastodon.org/methods/announcements/ Generic route: /v1/accounts/{accountId}/focus/announcements.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-announcements-react (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

namestringrequired

Unicode emoji or custom shortcode

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/announcements/{itemId}/react
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/announcements/ITEM_ID/react" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string"
  }'
Response · 200

Mastodon: Remove reaction (Announcements)

POST/accounts/{accountId}/mastodon/announcements/{itemId}/unreact

Remove 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-announcements-unreact (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

namestringrequired

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/announcements/{itemId}/unreact
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/announcements/ITEM_ID/unreact" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string"
  }'
Response · 200

Account overview

Mastodon: List Account overview

GET/accounts/{accountId}/mastodon/account-overview

Daily 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.

Access: read

Try it with MCPAsk your agent to call mastodon-account-overview-list (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

sincestring (date)

Default: 30 days ago

untilstring (date)

Default: today

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 9 item attributes
datestring (date)required
postsinteger
likesinteger
commentsinteger
sharesinteger
quotesinteger
engagementsinteger
followersinteger | null
followinginteger | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/account-overview
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/account-overview" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Post performance

Mastodon: List Post performance

GET/accounts/{accountId}/mastodon/post-performance

Your 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.

Access: read

Try it with MCPAsk your agent to call mastodon-post-performance-list (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

sincestring (date)

Default: 30 days ago

untilstring (date)

Default: today

limitintegerdefault: 20

≤ 200

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 9 item attributes
idstringrequired
created_atstring (date-time)
textstring
likesinteger
commentsinteger
sharesinteger
quotesinteger
engagementsinteger
urlstring (uri) | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/post-performance
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/post-performance" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Admin accounts

Mastodon: List Accounts

GET/accounts/{accountId}/mastodon/admin-accounts

GET /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.

Access: read

Try it with MCPAsk your agent to call mastodon-admin-accounts-list (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Opaque cursor from a previous next_cursor

limitintegerdefault: 20

1–80

originstring

localremote

statusstring

activependingdisabledsilencedsuspended

permissionsstring

staff

role_idsarray of string
invited_bystring
usernamestring
display_namestring
by_domainstring
emailstring
ipstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 18 item attributes
idstringrequiredread-only
usernamestring
domainstring | null
acctstring
display_namestring | null
created_atstring (date-time)
emailstring (email) | null
ipstring | null
localestring | null
roleobject | null
Show 3 child attributes
idstring
namestring
permissionsstring
confirmedboolean
approvedboolean
disabledboolean
silencedboolean
suspendedboolean
sensitizedboolean
invite_requeststring | null
accountobject | null
Show 23 child attributes
idstringrequiredread-only
acctstringrequired
usernamestring
display_namestring
urlstring (uri)
avatarstring
headerstring
notestring
note_textstring
lockedboolean
botboolean
groupboolean
discoverableboolean | null
indexableboolean | null
followers_countinteger
following_countinteger
statuses_countinteger
created_atstring (date-time)
last_status_atstring (date) | null
fieldsarray of object
Show 3 item attributes
namestring
valuestring
verified_atstring (date-time) | null
movedobject | null
suspendedboolean
limitedboolean
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/admin-accounts
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-accounts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Get a Accounts item

GET/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.

Access: read

Try it with MCPAsk your agent to call mastodon-admin-accounts-get (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstringrequiredread-only
usernamestring
domainstring | null
acctstring
display_namestring | null
created_atstring (date-time)
emailstring (email) | null
ipstring | null
localestring | null
roleobject | null
Show 3 child attributes
idstring
namestring
permissionsstring
confirmedboolean
approvedboolean
disabledboolean
silencedboolean
suspendedboolean
sensitizedboolean
invite_requeststring | null
accountobject | null
Show 23 child attributes
idstringrequiredread-only
acctstringrequired
usernamestring
display_namestring
urlstring (uri)
avatarstring
headerstring
notestring
note_textstring
lockedboolean
botboolean
groupboolean
discoverableboolean | null
indexableboolean | null
followers_countinteger
following_countinteger
statuses_countinteger
created_atstring (date-time)
last_status_atstring (date) | null
fieldsarray of object
Show 3 item attributes
namestring
valuestring
verified_atstring (date-time) | null
movedobject | null
suspendedboolean
limitedboolean

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/admin-accounts/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-accounts/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Delete a Accounts item

DELETE/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.

Access: write

Try it with MCPAsk your agent to call mastodon-admin-accounts-delete (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/mastodon/admin-accounts/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-accounts/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Approve sign-up (Accounts)

POST/accounts/{accountId}/mastodon/admin-accounts/{itemId}/approve

Approve 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-admin-accounts-approve (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/admin-accounts/{itemId}/approve
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-accounts/ITEM_ID/approve" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mastodon: Reject sign-up (Accounts)

POST/accounts/{accountId}/mastodon/admin-accounts/{itemId}/reject

Reject 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.

Access: write

Try it with MCPAsk your agent to call mastodon-admin-accounts-reject (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/admin-accounts/{itemId}/reject
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-accounts/ITEM_ID/reject" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mastodon: Moderate (Accounts)

POST/accounts/{accountId}/mastodon/admin-accounts/{itemId}/action

Moderate. 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.

Access: write

Try it with MCPAsk your agent to call mastodon-admin-accounts-action (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

typestringrequired

nonesensitivedisablesilencesuspend

report_idstring
warning_preset_idstring
textstring
send_email_notificationbooleandefault: true

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/admin-accounts/{itemId}/action
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-accounts/ITEM_ID/action" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "none",
    "report_id": "string",
    "warning_preset_id": "string",
    "text": "string",
    "send_email_notification": true
  }'
Response · 200

Mastodon: Re-enable login (Accounts)

POST/accounts/{accountId}/mastodon/admin-accounts/{itemId}/enable

Re-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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-admin-accounts-enable (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/admin-accounts/{itemId}/enable
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-accounts/ITEM_ID/enable" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mastodon: Unlimit (Accounts)

POST/accounts/{accountId}/mastodon/admin-accounts/{itemId}/unsilence

Unlimit. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-admin-accounts-unsilence (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/admin-accounts/{itemId}/unsilence
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-accounts/ITEM_ID/unsilence" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mastodon: Unsuspend (Accounts)

POST/accounts/{accountId}/mastodon/admin-accounts/{itemId}/unsuspend

Unsuspend. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-admin-accounts-unsuspend (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/admin-accounts/{itemId}/unsuspend
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-accounts/ITEM_ID/unsuspend" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mastodon: Unmark sensitive (Accounts)

POST/accounts/{accountId}/mastodon/admin-accounts/{itemId}/unsensitive

Unmark 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-admin-accounts-unsensitive (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/admin-accounts/{itemId}/unsensitive
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-accounts/ITEM_ID/unsensitive" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Admin reports

Mastodon: List Reports

GET/accounts/{accountId}/mastodon/admin-reports

Moderation 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.

Access: read

Try it with MCPAsk your agent to call mastodon-admin-reports-list (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Opaque cursor from a previous next_cursor

limitintegerdefault: 20

1–80

resolvedboolean
account_idstring
target_account_idstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 13 item attributes
idstringrequiredread-only
created_atstring (date-time)
updated_atstring (date-time)
categorystring

spamlegalviolationother

commentstring
forwardedboolean
action_takenboolean
action_taken_atstring (date-time) | null
reporterstring | null
targetstring | null
assigned_tostring | null
rulesarray of object
Show 2 item attributes
idstring
textstring
statusesarray of object
Show 29 item attributes
idstringrequiredread-only
uristring (uri)
urlstring (uri) | null
created_atstring (date-time)
edited_atstring (date-time) | null
textstringread-only
contentstring
spoiler_textstring
sensitiveboolean
visibilitystring

publicunlistedprivatedirect

languagestring | null
in_reply_to_idstring | null
in_reply_to_account_idstring | null
replies_countinteger
reblogs_countinteger
favourites_countinteger
quotes_countinteger | null
authorstring
author_namestring | null
media_attachmentsarray of object
Show 8 item attributes
idstringread-only
typestring

imagegifvvideoaudiounknown

urlstring (uri) | null
preview_urlstring (uri) | null
remote_urlstring (uri) | null
descriptionstring | null
blurhashstring | null
metaobject
pollobject | null
Show 9 child attributes
idstringread-only
expires_atstring (date-time) | null
expiredboolean
multipleboolean
votes_countinteger
voters_countinteger | null
votedboolean
own_votesarray of integer
optionsarray of object
Show 2 item attributes
titlestring
votes_countinteger | null
favouritedboolean
rebloggedboolean
bookmarkedboolean
mutedboolean
pinnedboolean
is_reblogboolean
quoteobject | null
Show 2 child attributes
statestring
quoted_statusobject | null
quote_approvalobject | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/admin-reports
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-reports" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Get a Reports item

GET/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.

Access: read

Try it with MCPAsk your agent to call mastodon-admin-reports-get (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstringrequiredread-only
created_atstring (date-time)
updated_atstring (date-time)
categorystring

spamlegalviolationother

commentstring
forwardedboolean
action_takenboolean
action_taken_atstring (date-time) | null
reporterstring | null
targetstring | null
assigned_tostring | null
rulesarray of object
Show 2 item attributes
idstring
textstring
statusesarray of object
Show 29 item attributes
idstringrequiredread-only
uristring (uri)
urlstring (uri) | null
created_atstring (date-time)
edited_atstring (date-time) | null
textstringread-only
contentstring
spoiler_textstring
sensitiveboolean
visibilitystring

publicunlistedprivatedirect

languagestring | null
in_reply_to_idstring | null
in_reply_to_account_idstring | null
replies_countinteger
reblogs_countinteger
favourites_countinteger
quotes_countinteger | null
authorstring
author_namestring | null
media_attachmentsarray of object
Show 8 item attributes
idstringread-only
typestring

imagegifvvideoaudiounknown

urlstring (uri) | null
preview_urlstring (uri) | null
remote_urlstring (uri) | null
descriptionstring | null
blurhashstring | null
metaobject
pollobject | null
Show 9 child attributes
idstringread-only
expires_atstring (date-time) | null
expiredboolean
multipleboolean
votes_countinteger
voters_countinteger | null
votedboolean
own_votesarray of integer
optionsarray of object
Show 2 item attributes
titlestring
votes_countinteger | null
favouritedboolean
rebloggedboolean
bookmarkedboolean
mutedboolean
pinnedboolean
is_reblogboolean
quoteobject | null
Show 2 child attributes
statestring
quoted_statusobject | null
quote_approvalobject | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/admin-reports/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-reports/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Update a Reports item

PATCH/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.

Access: write

Try it with MCPAsk your agent to call mastodon-admin-reports-update (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

categorystring

spamlegalviolationother

rule_idsarray of string

Returns object

idstringrequiredread-only
created_atstring (date-time)
updated_atstring (date-time)
categorystring

spamlegalviolationother

commentstring
forwardedboolean
action_takenboolean
action_taken_atstring (date-time) | null
reporterstring | null
targetstring | null
assigned_tostring | null
rulesarray of object
Show 2 item attributes
idstring
textstring
statusesarray of object
Show 29 item attributes
idstringrequiredread-only
uristring (uri)
urlstring (uri) | null
created_atstring (date-time)
edited_atstring (date-time) | null
textstringread-only
contentstring
spoiler_textstring
sensitiveboolean
visibilitystring

publicunlistedprivatedirect

languagestring | null
in_reply_to_idstring | null
in_reply_to_account_idstring | null
replies_countinteger
reblogs_countinteger
favourites_countinteger
quotes_countinteger | null
authorstring
author_namestring | null
media_attachmentsarray of object
Show 8 item attributes
idstringread-only
typestring

imagegifvvideoaudiounknown

urlstring (uri) | null
preview_urlstring (uri) | null
remote_urlstring (uri) | null
descriptionstring | null
blurhashstring | null
metaobject
pollobject | null
Show 9 child attributes
idstringread-only
expires_atstring (date-time) | null
expiredboolean
multipleboolean
votes_countinteger
voters_countinteger | null
votedboolean
own_votesarray of integer
optionsarray of object
Show 2 item attributes
titlestring
votes_countinteger | null
favouritedboolean
rebloggedboolean
bookmarkedboolean
mutedboolean
pinnedboolean
is_reblogboolean
quoteobject | null
Show 2 child attributes
statestring
quoted_statusobject | null
quote_approvalobject | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/mastodon/admin-reports/{itemId}
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-reports/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "category": "spam",
    "rule_ids": [
      "string"
    ]
  }'
Response · 200

Mastodon: Assign to me (Reports)

POST/accounts/{accountId}/mastodon/admin-reports/{itemId}/assign

Assign 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-admin-reports-assign (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/admin-reports/{itemId}/assign
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-reports/ITEM_ID/assign" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mastodon: Unassign (Reports)

POST/accounts/{accountId}/mastodon/admin-reports/{itemId}/unassign

Unassign. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-admin-reports-unassign (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/admin-reports/{itemId}/unassign
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-reports/ITEM_ID/unassign" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mastodon: Resolve (Reports)

POST/accounts/{accountId}/mastodon/admin-reports/{itemId}/resolve

Resolve. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-admin-reports-resolve (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/admin-reports/{itemId}/resolve
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-reports/ITEM_ID/resolve" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mastodon: Reopen (Reports)

POST/accounts/{accountId}/mastodon/admin-reports/{itemId}/reopen

Reopen. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-admin-reports-reopen (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/admin-reports/{itemId}/reopen
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-reports/ITEM_ID/reopen" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Admin domain blocks

Mastodon: List Domain blocks

GET/accounts/{accountId}/mastodon/admin-domain-blocks

Limit 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.

Access: read

Try it with MCPAsk your agent to call mastodon-admin-domain-blocks-list (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Opaque cursor from a previous next_cursor

limitintegerdefault: 20

1–80

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 10 item attributes
idstringrequiredread-only
created_atstring (date-time)
digeststring
domainstringrequired
severitystring

silencesuspendnoop

reject_mediaboolean
reject_reportsboolean
private_commentstring
public_commentstring
obfuscateboolean
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/admin-domain-blocks
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-domain-blocks" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Create a Domain blocks item

POST/accounts/{accountId}/mastodon/admin-domain-blocks

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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-admin-domain-blocks-create (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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

domainstringrequired
severitystring

silencesuspendnoop

reject_mediaboolean
reject_reportsboolean
private_commentstring
public_commentstring
obfuscateboolean

Returns object

idstringrequiredread-only
created_atstring (date-time)
digeststring
domainstringrequired
severitystring

silencesuspendnoop

reject_mediaboolean
reject_reportsboolean
private_commentstring
public_commentstring
obfuscateboolean

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/admin-domain-blocks
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-domain-blocks" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "string",
    "severity": "silence",
    "reject_media": true,
    "reject_reports": true,
    "private_comment": "string"
  }'
Response · 201

Mastodon: Get a Domain blocks item

GET/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.

Access: read

Try it with MCPAsk your agent to call mastodon-admin-domain-blocks-get (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstringrequiredread-only
created_atstring (date-time)
digeststring
domainstringrequired
severitystring

silencesuspendnoop

reject_mediaboolean
reject_reportsboolean
private_commentstring
public_commentstring
obfuscateboolean

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/admin-domain-blocks/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-domain-blocks/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Update a Domain blocks item

PATCH/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.

Access: write

Try it with MCPAsk your agent to call mastodon-admin-domain-blocks-update (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

domainstring
severitystring

silencesuspendnoop

reject_mediaboolean
reject_reportsboolean
private_commentstring
public_commentstring
obfuscateboolean

Returns object

idstringrequiredread-only
created_atstring (date-time)
digeststring
domainstringrequired
severitystring

silencesuspendnoop

reject_mediaboolean
reject_reportsboolean
private_commentstring
public_commentstring
obfuscateboolean

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/mastodon/admin-domain-blocks/{itemId}
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-domain-blocks/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "string",
    "severity": "silence",
    "reject_media": true,
    "reject_reports": true,
    "private_comment": "string"
  }'
Response · 200

Mastodon: Delete a Domain blocks item

DELETE/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.

Access: write

Try it with MCPAsk your agent to call mastodon-admin-domain-blocks-delete (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/mastodon/admin-domain-blocks/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-domain-blocks/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Admin domain allows

Mastodon: List Domain allows

GET/accounts/{accountId}/mastodon/admin-domain-allows

Allowed 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.

Access: read

Try it with MCPAsk your agent to call mastodon-admin-domain-allows-list (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Opaque cursor from a previous next_cursor

limitintegerdefault: 20

1–80

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 3 item attributes
idstringrequiredread-only
domainstringrequired
created_atstring (date-time)
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/admin-domain-allows
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-domain-allows" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Create a Domain allows item

POST/accounts/{accountId}/mastodon/admin-domain-allows

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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-admin-domain-allows-create (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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

domainstringrequired

Returns object

idstringrequiredread-only
domainstringrequired
created_atstring (date-time)

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/admin-domain-allows
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-domain-allows" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "string"
  }'
Response · 201

Mastodon: Get a Domain allows item

GET/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.

Access: read

Try it with MCPAsk your agent to call mastodon-admin-domain-allows-get (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstringrequiredread-only
domainstringrequired
created_atstring (date-time)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/admin-domain-allows/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-domain-allows/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Delete a Domain allows item

DELETE/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.

Access: write

Try it with MCPAsk your agent to call mastodon-admin-domain-allows-delete (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/mastodon/admin-domain-allows/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-domain-allows/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Admin ip blocks

Mastodon: List IP blocks

GET/accounts/{accountId}/mastodon/admin-ip-blocks

Cursor 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.

Access: read

Try it with MCPAsk your agent to call mastodon-admin-ip-blocks-list (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Opaque cursor from a previous next_cursor

limitintegerdefault: 20

1–80

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 7 item attributes
idstringrequiredread-only
created_atstring (date-time)
expires_atstring (date-time) | null
ipstringrequired

IP or CIDR range

severitystring

sign_up_requires_approvalsign_up_blockno_access

commentstring
expires_ininteger

Seconds

limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/admin-ip-blocks
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-ip-blocks" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Create a IP blocks item

POST/accounts/{accountId}/mastodon/admin-ip-blocks

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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-admin-ip-blocks-create (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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

ipstringrequired

IP or CIDR range

severitystringrequired

sign_up_requires_approvalsign_up_blockno_access

commentstring
expires_ininteger

Seconds

Returns object

idstringrequiredread-only
created_atstring (date-time)
expires_atstring (date-time) | null
ipstringrequired

IP or CIDR range

severitystring

sign_up_requires_approvalsign_up_blockno_access

commentstring
expires_ininteger

Seconds

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/admin-ip-blocks
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-ip-blocks" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "ip": "string",
    "severity": "sign_up_requires_approval",
    "comment": "string",
    "expires_in": 1
  }'
Response · 201

Mastodon: Get a IP blocks item

GET/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.

Access: read

Try it with MCPAsk your agent to call mastodon-admin-ip-blocks-get (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstringrequiredread-only
created_atstring (date-time)
expires_atstring (date-time) | null
ipstringrequired

IP or CIDR range

severitystring

sign_up_requires_approvalsign_up_blockno_access

commentstring
expires_ininteger

Seconds

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/admin-ip-blocks/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-ip-blocks/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Update a IP blocks item

PATCH/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.

Access: write

Try it with MCPAsk your agent to call mastodon-admin-ip-blocks-update (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

ipstring

IP or CIDR range

severitystring

sign_up_requires_approvalsign_up_blockno_access

commentstring
expires_ininteger

Seconds

Returns object

idstringrequiredread-only
created_atstring (date-time)
expires_atstring (date-time) | null
ipstringrequired

IP or CIDR range

severitystring

sign_up_requires_approvalsign_up_blockno_access

commentstring
expires_ininteger

Seconds

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/mastodon/admin-ip-blocks/{itemId}
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-ip-blocks/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ip": "string",
    "severity": "sign_up_requires_approval",
    "comment": "string",
    "expires_in": 1
  }'
Response · 200

Mastodon: Delete a IP blocks item

DELETE/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.

Access: write

Try it with MCPAsk your agent to call mastodon-admin-ip-blocks-delete (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/mastodon/admin-ip-blocks/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-ip-blocks/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Admin email domain blocks

Mastodon: List Email domain blocks

GET/accounts/{accountId}/mastodon/admin-email-domain-blocks

Cursor 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.

Access: read

Try it with MCPAsk your agent to call mastodon-admin-email-domain-blocks-list (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Opaque cursor from a previous next_cursor

limitintegerdefault: 20

1–80

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 4 item attributes
idstringrequiredread-only
domainstringrequired
created_atstring (date-time)
historyarray of object
Show 3 item attributes
daystring
accountsstring
usesstring
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/admin-email-domain-blocks
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-email-domain-blocks" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Create a Email domain blocks item

POST/accounts/{accountId}/mastodon/admin-email-domain-blocks

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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-admin-email-domain-blocks-create (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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

domainstringrequired

Returns object

idstringrequiredread-only
domainstringrequired
created_atstring (date-time)
historyarray of object
Show 3 item attributes
daystring
accountsstring
usesstring

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/admin-email-domain-blocks
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-email-domain-blocks" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "string"
  }'
Response · 201

Mastodon: Get a Email domain blocks item

GET/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.

Access: read

Try it with MCPAsk your agent to call mastodon-admin-email-domain-blocks-get (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstringrequiredread-only
domainstringrequired
created_atstring (date-time)
historyarray of object
Show 3 item attributes
daystring
accountsstring
usesstring

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/admin-email-domain-blocks/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-email-domain-blocks/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Delete a Email domain blocks item

DELETE/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.

Access: write

Try it with MCPAsk your agent to call mastodon-admin-email-domain-blocks-delete (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/mastodon/admin-email-domain-blocks/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-email-domain-blocks/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Admin canonical email blocks

Mastodon: List Email blocks

GET/accounts/{accountId}/mastodon/admin-canonical-email-blocks

Block 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.

Access: read

Try it with MCPAsk your agent to call mastodon-admin-canonical-email-blocks-list (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Opaque cursor from a previous next_cursor

limitintegerdefault: 20

1–80

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 2 item attributes
idstringrequiredread-only
canonical_email_hashstring
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/admin-canonical-email-blocks
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-canonical-email-blocks" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Create a Email blocks item

POST/accounts/{accountId}/mastodon/admin-canonical-email-blocks

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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-admin-canonical-email-blocks-create (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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_hashstring

Returns object

idstringrequiredread-only
canonical_email_hashstring

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/admin-canonical-email-blocks
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-canonical-email-blocks" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "you@example.com",
    "canonical_email_hash": "string"
  }'
Response · 201

Mastodon: Get a Email blocks item

GET/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.

Access: read

Try it with MCPAsk your agent to call mastodon-admin-canonical-email-blocks-get (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstringrequiredread-only
canonical_email_hashstring

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/admin-canonical-email-blocks/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-canonical-email-blocks/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Delete a Email blocks item

DELETE/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.

Access: write

Try it with MCPAsk your agent to call mastodon-admin-canonical-email-blocks-delete (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/mastodon/admin-canonical-email-blocks/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-canonical-email-blocks/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mastodon: Test an email (Email blocks)

POST/accounts/{accountId}/mastodon/admin-canonical-email-blocks/test

Test 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-admin-canonical-email-blocks-test (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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)required

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/admin-canonical-email-blocks/test
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-canonical-email-blocks/test" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "you@example.com"
  }'
Response · 200

Admin measures

Mastodon: List Server metrics

GET/accounts/{accountId}/mastodon/admin-measures

Active 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.

Access: read

Try it with MCPAsk your agent to call mastodon-admin-measures-list (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

keysarray of string
sincestring (date)
untilstring (date)
paramsany

Per-key params, e.g. { tag_accounts: { id } } · JSON-encoded object or array

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 4 item attributes
idstring
keystringrequired

active_usersnew_usersinteractionsopened_reportsresolved_reportstag_accountstag_usestag_serversinstance_accountsinstance_media_attachmentsinstance_reportsinstance_statusesinstance_followsinstance_followers

datestring (date)required
valuenumber
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/admin-measures
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-measures" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Admin dimensions

Mastodon: List Server breakdowns

GET/accounts/{accountId}/mastodon/admin-dimensions

Top 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.

Access: read

Try it with MCPAsk your agent to call mastodon-admin-dimensions-list (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

keysarray of string
sincestring (date)
untilstring (date)
limitintegerdefault: 10
paramsany

JSON-encoded object or array

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 5 item attributes
idstring
keystringrequired

languagessourcesserversspace_usagesoftware_versionstag_serverstag_languagesinstance_accountsinstance_languages

itemstring
labelstring
valuenumber
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/admin-dimensions
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-dimensions" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Admin retention

Mastodon: List Retention

GET/accounts/{accountId}/mastodon/admin-retention

Sign-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.

Access: read

Try it with MCPAsk your agent to call mastodon-admin-retention-list (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

sincestring (date)
untilstring (date)
frequencystring

daymonth

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 5 item attributes
idstring
cohortstring (date)required
datestring (date)required
ratenumber
valueinteger
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/admin-retention
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-retention" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
GET/accounts/{accountId}/mastodon/admin-trends-links

Review 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.

Access: read

Try it with MCPAsk your agent to call mastodon-admin-trends-links-list (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 20
cursorstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 5 item attributes
idstring
urlstring (uri)required
titlestring
provider_namestring
requires_reviewboolean
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/admin-trends-links
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-trends-links" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
POST/accounts/{accountId}/mastodon/admin-trends-links/{itemId}/approve

Approve. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-admin-trends-links-approve (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/admin-trends-links/{itemId}/approve
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-trends-links/ITEM_ID/approve" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200
POST/accounts/{accountId}/mastodon/admin-trends-links/{itemId}/reject

Reject. 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.

Access: write

Try it with MCPAsk your agent to call mastodon-admin-trends-links-reject (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/admin-trends-links/{itemId}/reject
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-trends-links/ITEM_ID/reject" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200
GET/accounts/{accountId}/mastodon/admin-trends-statuses

Review 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.

Access: read

Try it with MCPAsk your agent to call mastodon-admin-trends-statuses-list (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 20
cursorstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 30 item attributes
idstringrequiredread-only
uristring (uri)
urlstring (uri) | null
created_atstring (date-time)
edited_atstring (date-time) | null
textstringread-only
contentstring
spoiler_textstring
sensitiveboolean
visibilitystring

publicunlistedprivatedirect

languagestring | null
in_reply_to_idstring | null
in_reply_to_account_idstring | null
replies_countinteger
reblogs_countinteger
favourites_countinteger
quotes_countinteger | null
authorstring
author_namestring | null
media_attachmentsarray of object
Show 8 item attributes
idstringread-only
typestring

imagegifvvideoaudiounknown

urlstring (uri) | null
preview_urlstring (uri) | null
remote_urlstring (uri) | null
descriptionstring | null
blurhashstring | null
metaobject
pollobject | null
Show 9 child attributes
idstringread-only
expires_atstring (date-time) | null
expiredboolean
multipleboolean
votes_countinteger
voters_countinteger | null
votedboolean
own_votesarray of integer
optionsarray of object
Show 2 item attributes
titlestring
votes_countinteger | null
favouritedboolean
rebloggedboolean
bookmarkedboolean
mutedboolean
pinnedboolean
is_reblogboolean
quoteobject | null
Show 2 child attributes
statestring
quoted_statusobject | null
quote_approvalobject | null
requires_reviewboolean
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/admin-trends-statuses
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-trends-statuses" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
POST/accounts/{accountId}/mastodon/admin-trends-statuses/{itemId}/approve

Approve. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-admin-trends-statuses-approve (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/admin-trends-statuses/{itemId}/approve
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-trends-statuses/ITEM_ID/approve" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200
POST/accounts/{accountId}/mastodon/admin-trends-statuses/{itemId}/reject

Reject. 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.

Access: write

Try it with MCPAsk your agent to call mastodon-admin-trends-statuses-reject (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/admin-trends-statuses/{itemId}/reject
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-trends-statuses/ITEM_ID/reject" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200
GET/accounts/{accountId}/mastodon/admin-trends-tags

Review 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.

Access: read

Try it with MCPAsk your agent to call mastodon-admin-trends-tags-list (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 20
cursorstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 9 item attributes
idstring | null
namestringrequired
urlstring (uri)
followingboolean | null
featuringboolean | null
historyarray of object
Show 3 item attributes
daystring
usesstring
accountsstring
requires_reviewboolean
trendableboolean
usableboolean
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/mastodon/admin-trends-tags
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-trends-tags" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
POST/accounts/{accountId}/mastodon/admin-trends-tags/{itemId}/approve

Approve. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mastodon-admin-trends-tags-approve (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/admin-trends-tags/{itemId}/approve
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-trends-tags/ITEM_ID/approve" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200
POST/accounts/{accountId}/mastodon/admin-trends-tags/{itemId}/reject

Reject. 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.

Access: write

Try it with MCPAsk your agent to call mastodon-admin-trends-tags-reject (toolset focus_mastodon)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/mastodon/admin-trends-tags/{itemId}/reject
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/mastodon/admin-trends-tags/ITEM_ID/reject" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200