4,000+ servers built on vurb.ts
Vinkius
WindsurfIDE
Mastodon MCP Server

Bring Fediverse
to Windsurf

Learn how to connect Mastodon to Windsurf and start using 35 AI agent tools in minutes. Fully managed, enterprise secure, and ready to use without writing a single line of code.

MCP Inspector GDPR Free for Subscribers
Block AccountBookmark StatusCheck HealthClear NotificationsCreate AppDelete StatusDismiss NotificationFavourite StatusFollow AccountGet AccountGet Account StatusesGet Home TimelineGet Instance InfoGet Instance RulesGet List TimelineGet MediaGet Notifications V1Get Notifications V2Get Public TimelineGet StatusGet Status ContextGet Tag TimelineGet Trending LinksGet Trending StatusesGet Trending TagsMute AccountPost StatusReblog StatusRegister AccountSearchUnfollow AccountUpdate CredentialsUpdate MediaUpload MediaVerify Credentials

Compatible with every major AI agent and IDE

ClaudeClaude
ChatGPTChatGPT
CursorCursor
GeminiGemini
WindsurfWindsurf
VS CodeVS Code
JetBrainsJetBrains
VercelVercel
+ other MCP clients
Mastodon

What is the Mastodon MCP Server?

Connect your Mastodon account to any AI agent and manage your decentralized social presence through natural conversation.

What you can do

  • Status Management — Post new toots, reply to threads, and manage visibility settings (public, unlisted, private, direct) using post_status.
  • Engagement — Favorite, bookmark, and reblog content to interact with your community effortlessly.
  • Timeline Discovery — Access your home timeline, public feeds, or specific tag streams to stay updated on the latest discussions.
  • Account Control — Follow or unfollow users, manage blocks and mutes, and update your profile metadata directly.
  • Trending Insights — Query trending tags, links, and statuses to understand what's happening across the instance.

How it works

  1. Subscribe to this server
  2. Enter your Mastodon Personal Access Token
  3. Start interacting with the Fediverse from Claude, Cursor, or any MCP-compatible client

Who is this for?

  • Content Creators — Schedule or draft posts and engage with followers without leaving your workflow.
  • Social Researchers — Analyze trending topics and public timelines using AI-driven queries.
  • Community Managers — Monitor notifications and manage account relationships efficiently.

Built-in capabilities (35)

block_account

Block a Mastodon account

bookmark_status

Bookmark a Mastodon status

check_health

Check server health status

clear_notifications

Clear all notifications

create_app

Create a new Mastodon application

delete_status

Delete a Mastodon status

dismiss_notification

Dismiss a single notification

favourite_status

Favourite a Mastodon status

follow_account

Follow a Mastodon account

get_account

Get a Mastodon account profile

get_account_statuses

Get statuses posted by a Mastodon account

get_home_timeline

View statuses from followed users

get_instance_info

Get general information about the server

get_instance_rules

View server rules

get_list_timeline

View statuses in a specific list

get_media

Check status of an uploaded media attachment

get_notifications_v1

View notifications for the user (v1)

get_notifications_v2

View grouped notifications for the user (v2, Mastodon 4.3+)

get_public_timeline

View public statuses (local or federated)

get_status

View a single Mastodon status

get_status_context

View thread ancestors and descendants for a status

get_tag_timeline

View statuses containing a specific hashtag

get_trending_links

View trending links

get_trending_statuses

View trending statuses

get_trending_tags

View trending hashtags

mute_account

Mute a Mastodon account

post_status

Post a new status (toot) to Mastodon

reblog_status

Boost (reblog) a Mastodon status

register_account

Register a new Mastodon account

search

Search for accounts, statuses, and hashtags

unfollow_account

Unfollow a Mastodon account

update_credentials

Update Mastodon profile credentials

update_media

Update media description or focal point

upload_media

Upload media asynchronously

verify_credentials

Verify Mastodon account credentials

Why Windsurf?

Windsurf's Cascade agent chains multiple Mastodon tool calls autonomously. query data, analyze results, and generate code in a single agentic session. Paste Vinkius Edge URL, reload, and all 35 tools are immediately available. Real-time tool feedback appears inline, so you see API responses directly in your editor.

  • Windsurf's Cascade agent autonomously chains multiple tool calls in sequence, solving complex multi-step tasks without manual intervention

  • Purpose-built for agentic workflows. Cascade understands context across your entire codebase and integrates MCP tools natively

  • JSON-based configuration means zero code changes: paste a URL, reload, and all 35 tools are immediately available

  • Real-time tool feedback is displayed inline, so you see API responses directly in your editor without switching contexts

See it in action

Mastodon in Windsurf

AI AgentVinkius
High Security·Kill Switch·Plug and Play
Why Vinkius

Mastodon and 4,000+ other MCP servers. One platform. One governance layer.

Teams that connect Mastodon to Windsurf through Vinkius don't need to source, host, or maintain individual MCP servers. Every tool call runs inside a hardened runtime with credential isolation, DLP, and a signed audit chain.

4,000+MCP Servers ready
<40msCold start
60%Token savings
Raw MCP
Vinkius
Server catalogFind and host yourself4,000+ managed
InfrastructureSelf-hostedSandboxed V8 isolates
Credential handlingPlaintext in configVault + runtime injection
Data loss preventionNoneConfigurable DLP policies
Kill switchNoneGlobal instant shutdown
Financial circuit breakersNonePer-server limits + alerts
Audit trailNoneEd25519 signed logs
SIEM log streamingNoneSplunk, Datadog, Webhook
HoneytokensNoneCanary alerts on leak
Custom domainsNot applicableDNS challenge verified
GDPR complianceManual effortAutomated purge + export
Enterprise Security

Why teams choose Vinkius for Mastodon in Windsurf

The Mastodon MCP Server runs on Vinkius-managed infrastructure inside AWS — a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts. All 35 tools execute in hardened sandboxes optimized for native MCP execution.

Your AI agents in Windsurf only access the data you authorize, with DLP that blocks sensitive information from ever reaching the model, kill switch for instant shutdown, and up to 60% token savings. Enterprise-grade infrastructure, zero maintenance.

Mastodon
Fully ManagedVinkius Servers
60%Token savings
High SecurityEnterprise-grade
IAMAccess control
EU AI ActCompliant
DLPData protection
V8 IsolateSandboxed
Ed25519Audit chain
<40msKill switch
Stream every event to Splunk, Datadog, or your own webhook in real-time

* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure

The Vinkius Advantage

How Vinkius secures Mastodon for Windsurf

Every tool call from Windsurf to the Mastodon MCP Server is protected by DLP redaction, cryptographic audit chains, V8 sandbox isolation, kill switch, and financial circuit breakers.

< 40msCold start
Ed25519Signed audit chain
60%Token savings
FAQ

Frequently asked questions

01

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.

02

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.

03

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.

04

How does Windsurf discover MCP tools?

Windsurf reads the mcp_config.json file on startup and connects to each configured server via Streamable HTTP. Tools are listed in the MCP panel and available to Cascade automatically.

05

Can Cascade chain multiple MCP tool calls?

Yes. Cascade is an agentic system. it can plan and execute multi-step workflows, calling several tools in sequence to accomplish complex tasks without manual prompting between steps.

06

Does Windsurf support multiple MCP servers?

Yes. Add as many servers as needed in mcp_config.json. Each server's tools appear in the MCP panel and Cascade can use tools from different servers in a single flow.

07

Server not connecting

Check Settings → MCP for the server status. Try toggling it off and on.

Explore More MCP Servers

View all →