Download PDFMarkdown Version
ClaudeChatGPTPerplexityGeminiMicrosoft CopilotRaycastMeta AIGrokZ.aiQwenKimi
DeepSeekMistralCursorVS CodeWindsurfJetBrainsClineLovableVercel AI SDKLangChain

Use Mastodon with your AI.

Connect your account once and let the AI you already use work with it, without building another integration. Automate social interactions on the Fediverse. post statuses, manage follows, and track trending content directly from your AI agent.

Included with plan

Ask AI about this Connector

Developed, maintained, and hosted by Vinkius.

MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED

Waiting for input…

Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.

ChatGPTClaudeCursorPerplexityGeminiMicrosoft CopilotRaycastMeta AI

Complete set · 32 capabilities

The complete Mastodon capability set.

These are the exact actions your AI can choose when you ask it to work with Mastodon.

Capability set01 / 08

01-04

4 capabilities in this set.

Part of 32 available through Mastodon.

  1. 01

    Get notifications v2

    Only available on Mastodon 4.3 or newer instances. Falls back to v1 if the instance does not support v2. View grouped notifications (Mastodon 4.3+)

  2. 02

    Register account

    Requires an approved OAuth application first. Most instances require manual admin approval after registration. Register a new user account on the Mastodon instance

  3. 03

    Clear notifications

    This is irreversible. Use with caution. Clear all notifications at once

  4. 04

    Unfollow account

    Their posts will no longer appear in your home timeline. Unfollow a user by account ID

Capability set02 / 08

05-08

4 capabilities in this set.

Part of 32 available through Mastodon.

  1. 05

    Create app

    Returns client_id and client_secret for the OAuth flow. Only needed once per application. not for posting or reading content. Register a new OAuth application on the Mastodon instance

  2. 06

    Favourite status

    The post author receives a notification. Use to acknowledge or endorse content. Requires the status ID from a previous capability result. Like a post to show appreciation

  3. 07

    Follow account

    Their posts will appear in your home timeline. Use after discovering an interesting account through search, timelines, or notifications. Requires the account ID. Follow a user by account ID

  4. 08

    Get account

    Returns display name, username, bio, follower/following counts. Use when you need details about a specific user after finding their account ID from a post or search. Retrieve a user profile by account ID

Capability set03 / 08

09-12

4 capabilities in this set.

Part of 32 available through Mastodon.

  1. 09

    Get notifications v1

    Use to discover who is interacting with you and respond to mentions. View your recent notifications. mentions, follows, favourites, boosts

  2. 10

    Get trending statuses

    These are posts with high organic engagement. Use to find popular conversations where your reply will have maximum visibility and impact. View posts that are trending right now

  3. 11

    Get trending tags

    Mastodon trends are algorithm-free and purely based on real usage, making them a reliable signal of genuine community interest. Use to discover active topics for engagement. View hashtags that are trending right now

  4. 12

    Bookmark status

    Unlike favouriting, the post author is NOT notified. Use to save interesting posts you want to revisit later. Save a post privately for later reference

Capability set04 / 08

13-16

4 capabilities in this set.

Part of 32 available through Mastodon.

  1. 13

    Mute account

    Their posts will be hidden from your timelines and notifications without unfollowing or blocking them. Mute a user by account ID

  2. 14

    Post status

    There is no other way to send content. if you want to reply to someone, you MUST call this capability. To reply to an existing post, set "in_reply_to_id" to the status ID of the post you are replying to. To create an original post, omit "in_reply_to_id". The "status" parameter is the full text content you want to publish. Never compose text without calling this capability. text only exists on Mastodon after this capability is called. Publish or reply on Mastodon. This is the ONLY way to send a message

  3. 15

    Search

    Use to find specific conversations, users, or topics. Set "type" to narrow results: "statuses" for posts, "accounts" for users, "hashtags" for tags. Without a type filter, returns all three. This is the primary discovery capability for finding content to interact with. Search for accounts, posts, or hashtags by keyword

  4. 16

    Get trending links

    Use to understand what external content the community is discussing. valuable for finding conversations around specific news or topics. View external articles and links being shared the most right now

Capability set05 / 08

17-20

4 capabilities in this set.

Part of 32 available through Mastodon.

  1. 17

    Reblog status

    Equivalent to a retweet. Use to amplify content you want to endorse. Requires the status ID from a previous capability result. Boost (share) a post to your followers

  2. 18

    Delete status

    Cannot delete posts by other users. Use only for correcting mistakes on your own posts. Delete one of your own posts by status ID

  3. 19

    Dismiss notification

    Does not undo the action that caused it. Dismiss a single notification

  4. 20

    Check health

    Returns OK if the server is up. Use to verify connectivity before performing actions. Check if the Mastodon instance is online and responding

Capability set06 / 08

21-24

4 capabilities in this set.

Part of 32 available through Mastodon.

  1. 21

    Block account

    They will not be able to see your posts or interact with you. Use only for spam, harassment, or abusive accounts. Block a user by account ID

  2. 22

    Get account statuses

    Use when you want to see what a specific user has been posting recently. Requires the account ID. get it from search results, timeline posts, or notifications. List recent posts by a specific account

  3. 23

    Get home timeline

    This is your personalized feed. Use to discover what the people you follow are discussing right now. View your home feed. posts from accounts you follow

  4. 24

    Get instance info

    Use to understand the community size and focus of the instance. Get instance metadata. name, description, user counts

Capability set07 / 08

25-28

4 capabilities in this set.

Part of 32 available through Mastodon.

  1. 25

    Get instance rules

    Read these before interacting to ensure compliance with community guidelines. View the rules of the Mastodon instance

  2. 26

    Get list timeline

    Lists are curated groups of accounts. Use when you have a pre-configured list of accounts to monitor. View posts from a curated list of accounts

  3. 27

    Get public timeline

    This is the broadest discovery capability. shows posts from all users across all connected instances. Use when you want to find new conversations and people to interact with. View the public timeline. recent posts from all users

  4. 28

    Update credentials

    Does not affect posting or interactions. Update the authenticated account profile

Capability set08 / 08

29-32

4 capabilities in this set.

Part of 32 available through Mastodon.

  1. 29

    Verify credentials

    Use this to confirm identity before performing actions. Check if credentials are valid and get the authenticated account profile

  2. 30

    Get status

    Use when you need to read a post before replying to it, or to verify the content of a post found in timelines or search results. Fetch a single post by its status ID

  3. 31

    Get tag timeline

    Use to find conversations about a specific topic. Pass the hashtag without the # symbol (e.g. "AI" not "#AI"). Great for discovering posts about specific technologies, events, or communities. View recent posts containing a specific hashtag

  4. 32

    Get status context

    Use when you want to understand the full discussion before replying to a post. Fetch the full conversation thread for a post

Observed, not estimated

998ms average. Fast in production.

Mastodon is checked daily against the live service.

Daily averagePeak 1297ms
Aug 20Today
Fastest day
875ms
Slowest day
1297ms
14-day trend
Slowing+11%

Connect your client

One URL. Every client.

Activate the Connector, copy your link, and paste it into the client you already use. 32 capabilities arrive ready to run.

Preview access · not provider authentication

The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of Mastodon, so you can see the experience inside your AI.

It does not authenticate your account with Mastodon. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.

Mastodon Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_SxjdFxntzzY9J4FSjI8RNXNt5mhqmozDb3HkoROF/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Mastodon capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "mastodon-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_SxjdFxntzzY9J4FSjI8RNXNt5mhqmozDb3HkoROF/mcp"
    }
  }
}
  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Step-by-step instructions for each client are in the guide. How to connect

FAQ

Questions Mastodon owners ask.

  • 01

    Can I post a status with a content warning (spoiler text)?

    Yes. When using the post_status capability, you can provide a spoiler_text string which will act as a content warning for your followers.

  • 02

    How do I verify if my access token is working correctly?

    You can use the verify_credentials capability. It will test your current token and return your authenticated profile information if successful.

  • 03

    Is it possible to see what is currently trending on my instance?

    Absolutely. Use the get_trending_tags capability to retrieve the most popular hashtags used on your instance recently.

Explore

More in Communication Messaging

Suggestions