Supercharge your AI with Mastodon. Manage Posts, Follows, and Trends from Any Agent.

Mastodon connects your agent directly to the Fediverse. You can manage every damn thing on your social profile—from posting out a quick toot to tracking down what's hot right now—all through your AI client.

Posting and Content Control. Use post_status to publish new content instantly, specifying exactly who sees it. If you wanna share someone else’s post or 'boost' it, hit up reblog_status. You can also mark statuses you like using favourite_status, or if you gotta clean house and delete a post immediately, call delete_status.

When you write content that includes media—an image or video—you first run upload_media to get it uploaded asynchronously; then you use get_media to check its upload status, and finally, you can fine-tune the descriptive text using update_media.

Managing Your Network. You control who you talk to. To start following a user, run follow_account. If you need distance from someone but don't wanna officially unfollow them, use mute_account. You can instantly cut off all interaction with an account by running block_account. Need to drop yourself from someone else’s feed? Use unfollow_account.

To keep tabs on specific people, run get_account to pull general profile info or get_account_statuses to see a list of their past posts. For deep dives into threads, get_status_context maps out all related statuses, showing both ancestors and descendants.

Sifting Through the Noise. You don't wanna scroll forever just to find something good. Use get_home_timeline for everything you follow. If you want a view of every public post on the entire server—like looking at the main town square—use get_public_timeline. To filter stuff by topic, run get_tag_timeline using a specific hashtag.

Want to know what people are really talking about right now? You check two things: get_trending_statuses gives you a list of the most popular posts, and get_trending_tags lists all the hot topics being discussed.

Discovering Content. The general-purpose search tool lets you perform broad searches across accounts, statuses, or hashtags on the server. You can also view curated content feeds by running get_list_timeline against a specific list you created. For single items, get_status retrieves all the full content and metadata for one post, while if you’re just checking out what an account posted, use get_account_statuses.

Taming Your Notifications & Profile. You gotta keep your settings current. Run update_credentials to change core profile info like your bio or display name. To deal with the notification pile-up, you can run clear_notifications to reset everything, or use dismiss_notification to mark single alerts as handled. For the latest API standards (Mastodon 4.3+), get_notifications_v2 pulls grouped and categorized notifications; if that fails, you've got get_notifications_v1.

System Tools & Utility. You can always verify your setup by running verify_credentials to ensure your account info is legit, or using check_health to confirm the server itself is up and running. Need to know what rules you gotta live by? get_instance_rules shows them, and get_instance_info gives general details about this specific server instance.

You can even register a whole new account with register_account, or if you're building an app for the platform, create_app handles that setup.

That’s it—you get direct access to every part of your decentralized social presence. Your agent treats Mastodon like a straightforward API endpoint.