Mastodon

mastodon.social

Community

Mastodon is a decentralized, open-source social network based on the ActivityPub protocol. The API allows agents to post statuses (toots), browse timelines, interact with posts via boosts and favorites, search content, and manage account information across federated instances.

Auth

oauth2

Pricing

free

Spec version

1.0

Base URL

https://mastodon.social

Last verified

2026-03-01 11:54:00

Health

Loading health data...

Capabilities

boost_status

social

Reblog (boost) a status to share it with your followers on your profile.

Detail: https://mastodon.social/capabilities/boost_status

favorite_status

social

Mark a status as a favorite (like) to show appreciation and save it to your favorites list.

Detail: https://mastodon.social/capabilities/favorite_status

get_account

social

Retrieve profile information for the authenticated user or a specified account, including display name, bio, and follower counts.

Detail: https://mastodon.social/capabilities/get_account

get_notifications

communication

Fetch a paginated list of notifications including mentions, follows, boosts, and favorites.

Detail: https://mastodon.social/capabilities/get_notifications

get_status

social

Retrieve a single status by its ID, including content, author, media attachments, and engagement counts.

Detail: https://mastodon.social/capabilities/get_status

get_timeline

social

Fetch the home, local, or federated timeline as a paginated list of statuses.

Detail: https://mastodon.social/capabilities/get_timeline

post_status

social

Publish a new status (toot) with text content, optional media attachments, content warnings, and visibility settings.

Detail: https://mastodon.social/capabilities/post_status

search_content

social

Search Mastodon for statuses, accounts, or hashtags matching a query string.

Detail: https://mastodon.social/capabilities/search_content

Agent Preview

This is what an AI agent sees when it discovers this service via the Gateway:

Service: Mastodon
Description: Mastodon is a decentralized, open-source social network based on the ActivityPub protocol. The API allows agents to post statuses (toots), browse timelines, interact with posts via boosts and favorites, search content, and manage account information across federated instances.
Auth: oauth2
Capabilities:
  - boost_status: Reblog (boost) a status to share it with your followers on your profile.
  - favorite_status: Mark a status as a favorite (like) to show appreciation and save it to your favorites list.
  - get_account: Retrieve profile information for the authenticated user or a specified account, including display name, bio, and follower counts.
  - get_notifications: Fetch a paginated list of notifications including mentions, follows, boosts, and favorites.
  - get_status: Retrieve a single status by its ID, including content, author, media attachments, and engagement counts.
  - get_timeline: Fetch the home, local, or federated timeline as a paginated list of statuses.
  - post_status: Publish a new status (toot) with text content, optional media attachments, content warnings, and visibility settings.
  - search_content: Search Mastodon for statuses, accounts, or hashtags matching a query string.