Mastodon Connector for AI agents.

32 live capabilities

Manage your Fediverse social presence and community engagement from your workspace.

Live agent request Mastodon / Connector

Waiting for input…

AI Agent

Why people use Mastodon

Mastodon for Fediverse Community Engagement

This Mastodon MCP changes that by bringing the Fediverse into your current workspace. You can ask your agent to find trending links, follow new accounts, or post updates using simple commands. You get a clean, conversational way to handle your social presence without the tab-switching fatigue.

What Vinkius changes

You get a hands-free way to manage your Mastodon account through natural conversation.

Use it from Claude, ChatGPT, Cursor or another AI client you already have.

One account · 5,900+ Connectors

Real-world use case 01

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.
Real-world use case 02

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.
Real-world use case 03

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.

Complete set · 32capabilities

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.

01 Capability
Favourite status
Like a post to show appreciation and notify the author. This is the best way to acknowledge content you enjoy.
02 Capability
Get notifications v2
View grouped notifications if your instance supports Mastodon 4.3 or newer. This provides a cleaner view of your interactions.
03 Capability
Get trending statuses
Find high-engagement posts that are currently trending. Use these to find popular conversations where your reply has impact.
04 Capability
Get trending tags
See which hashtags are currently trending in the community. These are based on real usage rather than algorithms.

Capability set02 / 08

05—08

4 capabilities in this set.

Part of 32 available through Mastodon.

05 Capability
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.
06 Capability
Register account
Create a new user profile on your Mastodon instance. Note that most instances require manual admin approval after you register.
07 Capability
Clear notifications
Wipe all your current notifications at once to clean your dashboard. This action is irreversible, so use it with caution.
08 Capability
Unfollow account
Stop seeing posts from a specific user by their account ID. This helps you keep your home timeline relevant.

Capability set03 / 08

09—12

4 capabilities in this set.

Part of 32 available through Mastodon.

09 Capability
Bookmark status
Save a post privately for later reference without notifying the author. Use this to keep track of interesting content quietly.
10 Capability
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.
11 Capability
Mute account
Hide a user's posts from your timeline and notifications without unfollowing them. It is a great way to silence specific accounts.
12 Capability
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.

Capability set04 / 08

13—16

4 capabilities in this set.

Part of 32 available through Mastodon.

13 Capability
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.
14 Capability
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.
15 Capability
Dismiss notification
Remove a single notification from your list without undoing the action that caused it. Use this to tidy up your alert feed.
16 Capability
Block account
Prevent a user from interacting with you or seeing your posts. Use this for spam, harassment, or other abusive behavior.

Capability set05 / 08

17—20

4 capabilities in this set.

Part of 32 available through Mastodon.

17 Capability
Check health
Verify that your Mastodon instance is online and responding. Use this to check connectivity before you start your session.
18 Capability
Follow account
Add a user to your home timeline by using their account ID. This is perfect for following new people you discover.
19 Capability
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.
20 Capability
Get account
Pull the display name, username, bio, and follower counts for a specific user. Use this to get details after finding an account.

Capability set06 / 08

21—24

4 capabilities in this set.

Part of 32 available through Mastodon.

21 Capability
Get home timeline
View the latest posts from the people you follow in your personalized feed. Use this to stay updated on your community.
22 Capability
Get instance info
Get the name, description, and user counts for your current Mastodon instance. This helps you understand the community focus.
23 Capability
Get instance rules
View the community guidelines for your Mastodon instance to ensure you follow the local rules.
24 Capability
Get list timeline
View posts from a specific curated list of accounts you have pre-configured. This is great for monitoring specific groups.

Capability set07 / 08

25—28

4 capabilities in this set.

Part of 32 available through Mastodon.

25 Capability
Get notifications v1
View your recent notifications including mentions, follows, favorites, and boosts. Use this to see who is interacting with you.
26 Capability
Get public timeline
Browse recent posts from all users across all connected instances. This is the best way to discover new conversations.
27 Capability
Search
Search for accounts, posts, or hashtags using keywords. This is your primary capability for finding new content and people.
28 Capability
Update credentials
Update the profile of the currently authenticated account. This does not affect your ability to post or interact.

Capability set08 / 08

29—32

4 capabilities in this set.

Part of 32 available through Mastodon.

29 Capability
Verify credentials
Confirm your login details and pull your current profile data. Use this to check your identity before performing actions.
30 Capability
Get status context
Fetch the full conversation thread for a specific post. Use this to understand the history before you join the talk.
31 Capability
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.
32 Capability
Get tag timeline
View the most recent posts containing a specific hashtag. Pass the tag without the symbol to find topic-specific discussions.

Set up in minutes

One URL. Then ask Mastodon to work.

Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use Mastodon from the conversation.

Choose your client

Live preview

Advanced clients IDE · CLI

Claude · Web + desktop

Official guide ↗

Connector URL · ready to paste

Streamable HTTP

https://edge.vinkius.com/vk_preview_SxjdFxntzzY9J4FSjI8RNXNt5mhqmozDb3HkoROF/mcp

Step 01

Open Connectors

In Claude Web or Claude Desktop, open Settings and choose Connectors.
Step 02

Add the URL

Choose Add custom connector, name it Mastodon, and paste the URL above.
Step 03

Turn it on in chat

Select +, open Connectors, and enable Mastodon for the conversation.

ChatGPT · Web + desktop

Official guide ↗

Connector URL · ready to paste

Streamable HTTP

https://edge.vinkius.com/vk_preview_SxjdFxntzzY9J4FSjI8RNXNt5mhqmozDb3HkoROF/mcp

Step 01

Open MCP settings

On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
Step 02

Add the URL

Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the Mastodon URL.
Step 03

Save and start

Save the connection and enable Mastodon in your conversation. Desktop may ask you to restart once.

Cursor · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "mastodon": {
      "url": "https://edge.vinkius.com/vk_preview_SxjdFxntzzY9J4FSjI8RNXNt5mhqmozDb3HkoROF/mcp"
    }
  }
}

Step 01

Open MCP Settings

Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
Step 02

Add the server config

Paste the JSON configuration above into the mcp.json file that opens
Step 03

Save the file

Cursor will automatically detect the new Connector
Step 04

Start using Mastodon

Open Agent mode in chat and ask: "Using Mastodon, help me...". 32 tools available

VS Code Copilot · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "mastodon": {
      "url": "https://edge.vinkius.com/vk_preview_SxjdFxntzzY9J4FSjI8RNXNt5mhqmozDb3HkoROF/mcp"
    }
  }
}

Step 01

Create MCP config

Create a .vscode/mcp.json file in your project root
Step 02

Add the server config

Paste the JSON configuration above
Step 03

Enable Agent mode

Open GitHub Copilot Chat and switch to Agent mode using the dropdown
Step 04

Start using Mastodon

Ask Copilot: "Using Mastodon, help me...". 32 tools available

Windsurf · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "mastodon": {
      "url": "https://edge.vinkius.com/vk_preview_SxjdFxntzzY9J4FSjI8RNXNt5mhqmozDb3HkoROF/mcp"
    }
  }
}

Step 01

Open MCP Settings

Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
Step 02

Add the server

Paste the JSON configuration above into mcp_config.json
Step 03

Save and reload

Windsurf will detect the new server automatically
Step 04

Start using Mastodon

Open Cascade and ask: "Using Mastodon, help me...". 32 tools available

Cline · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "mastodon": {
      "url": "https://edge.vinkius.com/vk_preview_SxjdFxntzzY9J4FSjI8RNXNt5mhqmozDb3HkoROF/mcp"
    }
  }
}

Step 01

Open Cline MCP Settings

Click the Connectors icon in the Cline sidebar panel
Step 02

Add remote server

Click "Add Connector" and paste the configuration above
Step 03

Enable the server

Toggle the server switch to ON
Step 04

Start using Mastodon

Ask Cline: "Using Mastodon, help me...". 32 tools available

Claude Code · Terminal command

Official guide ↗

Advanced setup

claude mcp add mastodon --transport http "https://edge.vinkius.com/vk_preview_SxjdFxntzzY9J4FSjI8RNXNt5mhqmozDb3HkoROF/mcp"

Step 01

Install Claude Code

Run npm install -g @anthropic-ai/claude-code if not already installed
Step 02

Add the Connector

Run the command above in your terminal
Step 03

Verify the connection

Run claude mcp to list connected servers, or type /mcp inside a session
Step 04

Start using Mastodon

Ask Claude: "Using Mastodon, show me...". 32 tools are ready

Where the request belongs

Work Mastodon can move forward.

Built around the request

This is for people who live in the Fediverse but hate the friction of manual social management. It's for those who need to stay active across multiple instances without the constant tab-switching.

01

Content Creator

Drafts and schedules posts while engaging with followers in real-time without leaving their main workspace.

02

Social Researcher

Monitors trending tags and public timelines to identify emerging topics and community sentiment.

03

Community Manager

Handles blocks, mutes, and notifications to keep the community safe and organized efficiently.

Build the capability set

Each Connector adds new actions and data without changing how you work.

Browse Connectors

01 6 capabilities

Mastodon Intelligence

Monitor trending hashtags, viral posts, and community pulse across any Mastodon instance with authenticated API access.

02 12 capabilities

Bluesky Social

Publish posts, follow accounts, and engage with the decentralized social network through your AI-powered workflow.

03 23 capabilities

GetStream

Build and manage scalable activity feeds and social networks. Manage activities, feeds, and follower relationships directly through your AI agent.

04 17 capabilities

Pixelfed (Instagram Alternative)

Manage your Pixelfed presence. post photos, interact with the community, and track notifications directly from any AI agent.

05 22 capabilities

Farcaster (Decentralized Social Protocol)

Interact with the Farcaster protocol. manage channels, moderate casts, and explore social graphs directly from your AI agent.

06 16 capabilities

X (Twitter) OAuth

Full read and write access to X (Twitter) via OAuth 2.0. post tweets, like content, follow users, browse timelines, track mentions, and monitor trends directly from any AI agent.

Bring your own AI

Change the model, client or framework. Keep Mastodon connected.

Before you connect

Questions about Mastodon.

The practical details behind the request, access and result.

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 capability 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 capability, 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 capability. 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 capability to retrieve the most popular hashtags used on your instance recently.

One connection away

Give your agent a direct line to Mastodon.

Connect Mastodon once. Keep it beside 5,900+ managed Connectors when the next task needs more.

Explore every Connector No credit card required · Free tier available