# Mastodon MCP for AI Agents AI Agent Connect > Mastodon MCP lets you manage your Fediverse presence through your AI agent. You can post updates, reply to threads, follow accounts, and monitor trending hashtags without switching tabs. It handles the heavy lifting of social management, from clearing notifications to tracking community insights, making it easier to stay active in decentralized social networks. ## Overview - **Category:** communication-messaging - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_SxjdFxntzzY9J4FSjI8RNXNt5mhqmozDb3HkoROF/ai-agent-connect - **Tags:** fediverse, microblogging, activitypub, social-automation, mastodon-api ## Description This Mastodon MCP gives your AI agent a direct line to your Fediverse account. Instead of jumping between tabs to check your feed or manually typing out replies, you can just tell your agent what you want to do. You can draft and publish toots, engage with your community by favoriting or reblogging content, and keep your timeline clean by muting or blocking accounts on the fly. It handles the nitty-gritty of social media management so you can stay focused on your content. Whether you're a researcher looking for specific trends or a creator trying to manage a growing following, this connection makes the Fediverse feel like a natural extension of your workspace. You can pull real-time data on what's trending across the instance, browse curated lists of accounts, or quickly fetch the context of a conversation before you jump in. It's part of the Vinkius catalog, which makes it easy to plug into your existing workflow and start interacting with decentralized social media immediately. By connecting this Connector, you turn a manual social media routine into a conversational experience where your agent does the heavy lifting of navigating the Fediverse for you. ## Tools ### favourite_status Like a post to show appreciation and notify the author. This is the best way to acknowledge content you enjoy. ### get_notifications_v2 View grouped notifications if your instance supports Mastodon 4.3 or newer. This provides a cleaner view of your interactions. ### get_trending_statuses Find high-engagement posts that are currently trending. Use these to find popular conversations where your reply has impact. ### get_trending_tags See which hashtags are currently trending in the community. These are based on real usage rather than algorithms. ### post_status This is the only way to publish content or reply to threads on Mastodon. Use it to send your full text and set the reply ID if needed. ### register_account Create a new user profile on your Mastodon instance. Note that most instances require manual admin approval after you register. ### clear_notifications Wipe all your current notifications at once to clean your dashboard. This action is irreversible, so use it with caution. ### unfollow_account Stop seeing posts from a specific user by their account ID. This helps you keep your home timeline relevant. ### bookmark_status Save a post privately for later reference without notifying the author. Use this to keep track of interesting content quietly. ### get_trending_links See which external links are being shared most by the community right now. This helps you find relevant news or articles quickly. ### mute_account Hide a user's posts from your timeline and notifications without unfollowing them. It is a great way to silence specific accounts. ### reblog_status Share a post with your followers to boost its visibility. You just need the status ID from a previous search or timeline view. ### create_app Register a new OAuth application on your instance to get your client ID and secret. You only need to do this once per application. ### delete_status Remove one of your own posts from your profile using its status ID. This is for fixing your own mistakes and cannot be used on others. ### dismiss_notification Remove a single notification from your list without undoing the action that caused it. Use this to tidy up your alert feed. ### block_account Prevent a user from interacting with you or seeing your posts. Use this for spam, harassment, or other abusive behavior. ### check_health Verify that your Mastodon instance is online and responding. Use this to check connectivity before you start your session. ### follow_account Add a user to your home timeline by using their account ID. This is perfect for following new people you discover. ### get_account_statuses List the recent posts from a specific user to see what they have been sharing. You just need their account ID to pull the data. ### get_account Pull the display name, username, bio, and follower counts for a specific user. Use this to get details after finding an account. ### get_home_timeline View the latest posts from the people you follow in your personalized feed. Use this to stay updated on your community. ### get_instance_info Get the name, description, and user counts for your current Mastodon instance. This helps you understand the community focus. ### get_instance_rules View the community guidelines for your Mastodon instance to ensure you follow the local rules. ### get_list_timeline View posts from a specific curated list of accounts you have pre-configured. This is great for monitoring specific groups. ### get_notifications_v1 View your recent notifications including mentions, follows, favorites, and boosts. Use this to see who is interacting with you. ### get_public_timeline Browse recent posts from all users across all connected instances. This is the best way to discover new conversations. ### search Search for accounts, posts, or hashtags using keywords. This is your primary tool for finding new content and people. ### update_credentials Update the profile of the currently authenticated account. This does not affect your ability to post or interact. ### verify_credentials Confirm your login details and pull your current profile data. Use this to check your identity before performing actions. ### get_status_context Fetch the full conversation thread for a specific post. Use this to understand the history before you join the talk. ### get_status Fetch the content of a single post using its status ID. Use this to verify a post's content before you reply to it. ### get_tag_timeline View the most recent posts containing a specific hashtag. Pass the tag without the symbol to find topic-specific discussions. ## Prompt Examples **Prompt:** ``` What's trending on my Mastodon instance right now? ``` **Response:** ``` Here are the current trends for your instance: **Trending Tags:** - #Fediverse - #TechTalk - #ArtCommunity - #Mastodon **Trending Links:** - [New AI Research Paper](https://example.com) - [Community Guidelines Update](https://example.org) Would you like me to show you the latest posts for any of these tags? ``` **Prompt:** ``` Can you find the latest posts from the #AI hashtag and show me the top 3? ``` **Response:** ``` I've pulled the latest posts from the #AI tag for you. Here are the top 3: 1. **@user1**: 'Just finished a new project using decentralized protocols!' (50 likes) 2. **@user2**: 'Anyone tried the new updates on Mastodon today?' (30 likes) 3. **@user3**: 'Looking for some new tools to automate my workflow.' (12 likes) Let me know if you'd like to see more or reply to any of these. ``` **Prompt:** ``` Follow the user @dev_mind and then tell me what they're talking about lately. ``` **Response:** ``` I've added @dev_mind to your home timeline. Here are their recent posts: - 'Just pushed a new update to my Connector project!' - 'Working on some cool stuff with ActivityPub today.' - 'Had a great coffee and some deep coding time.' Is there anything else you'd like to know about their profile? ``` ## Capabilities ### Post and reply to statuses Publish new content or join existing conversations using your agent. ### Follow or unfollow users Manage your home timeline by adding or removing accounts instantly. ### Browse home and public timelines See what's happening in your feed or across the entire Fediverse. ### Monitor trending tags and links Track community trends and external links in real-time. ### Manage notifications and blocks Keep your feed clean by muting, blocking, and clearing alerts. ### Favorite and reblog content Interact with and amplify posts from your favorite creators. ### Search for users and hashtags Find specific conversations or accounts using keywords. ## Use Cases ### Joining a trending conversation A content creator finds a popular topic and asks their agent to find the thread using `get_status_context` before using `post_status` to join the discussion. ### Monitoring niche community trends A social researcher asks their agent to pull trending tags using `get_trending_tags` and then browse the results using `get_tag_timeline` to find news. ### Cleaning up spam and noise A community manager tells their agent to `block_account` for several spam users and `clear_notifications` to reset their dashboard and keep the instance safe. ### Curating a personalized feed A user wants to find new content and asks their agent to `search` for specific keywords and then `follow_account` to add them to their home timeline. ## Benefits - Interact with your community faster by using `favourite_status` and `reblog_status` to engage with content instantly. This lets you acknowledge posts and amplify your favorite content without ever leaving your primary workspace. - Keep your feed organized by using `mute_account` and `block_account` to filter out noise and harassment instantly. This helps you maintain a healthy social environment with zero manual effort. - Stay on top of trends by using `get_trending_tags` and `get_trending_links` to see what the community is talking about. You can identify high-impact conversations and news as they happen. - Manage your content lifecycle easily with `post_status` to publish and `delete_status` to fix mistakes on your own profile. This gives you full control over your public presence through natural conversation. - Discover new content and people by using `search` and `get_public_timeline` to explore the broader Fediverse. It makes finding new communities and niche topics much faster than manual browsing. - Keep your workspace clean by using `clear_notifications` and `dismiss_notification` to manage your alert history. You can tidy up your dashboard in seconds so you only see what matters. ## How It Works The bottom line is you get a hands-free way to manage your Mastodon account through natural conversation. 1. Subscribe to the Connector in the Vinkius catalog. 2. Provide your Mastodon Personal Access Token. 3. Give your agent commands like "post a status" or "show me trending tags." ## Frequently Asked Questions **How does the Mastodon MCP help with social media?** It lets you manage your Fediverse account through your AI agent. You can post, follow, and interact with content using natural language instead of clicking through a website. **Can I use the Mastodon MCP to see what's trending?** Yes, you can ask your agent to pull trending tags and links from your instance to see what the community is discussing in real-time. **Is it possible to mute users with the Mastodon MCP?** You can tell your agent to mute or block specific accounts. This helps you keep your home timeline clean and free of noise without having to do it manually. **Can I post replies using the Mastodon MCP?** Yes, you can ask your agent to reply to specific posts. It can even fetch the full conversation context first so your reply makes sense in the thread. **How do I keep my feed organized with this Connector?** You can use it to follow specific accounts, view curated lists, and manage your notifications. It's a great way to stay organized without constant manual sorting. **Can the Mastodon MCP help with community management?** It's a great tool for community managers who need to quickly block spam, dismiss notifications, and monitor public timelines to keep the instance healthy. **Can I post a status with a content warning (spoiler text)?** Yes. When using the `post_status` tool, you can provide a `spoiler_text` string which will act as a content warning for your followers. **How do I verify if my access token is working correctly?** You can use the `verify_credentials` tool. It will test your current token and return your authenticated profile information if successful. **Is it possible to see what is currently trending on my instance?** Absolutely. Use the `get_trending_tags` tool to retrieve the most popular hashtags used on your instance recently.