How to Use the Mastodon MCP in Windsurf

Q: How do I install this Mastodon MCP Server in Windsurf?

Open your /.codeium/windsurf/mcpconfig.json file and add the server configuration under the mcpServers key. Alternatively, use the Settings menu, navigate to Cascade, and use the MCP Servers UI to paste the connection URL.

Let Windsurf and Cascade post toots, read your home timeline, and manage your Mastodon presence without leaving your editor.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Mastodon MCP to Windsurf

Create your Vinkius account to connect Mastodon to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Mastodon with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Let Windsurf manage your Mastodon feed autonomously.

Cascade doesn't just read your code; it reads your social graph. By connecting this MCP Server, you let your IDE pull your home feed via `get_home_timeline` and find trending topics with `get_trending_tags` while you work on your main project. Instead of jumping to a browser tab, you can ask Cascade to summarize the latest Fedi discussions. This lets the agent parse the context and present a clean markdown summary directly in your active workspace.

Publish and boost updates directly from Windsurf.

Writing a release note and want to share it? Cascade can automatically run `post_status` to announce it to your followers. If you need to attach a screenshot of your new UI, Cascade uploads the file using `upload_media` and associates it with the post in one go. It can even check the health of your instance with `check_health` before pushing the update. You don't have to manually format the API calls; you just tell Cascade what to say and it handles the rest.

Keep your Mastodon network clean and curated.

Social noise gets distracting when you are trying to write code. You can have your agent watch for specific keywords or annoying bots and immediately call `mute_account` or `block_account` to clean up your feed. When you find a useful technical tip in your timeline, ask Cascade to run `bookmark_status` so you can reference it later. It keeps your focus on the editor while keeping your Fedi presence organized.

Setup guide

Set up Mastodon MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Mastodon MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Mastodon payment history." If connected, Cascade will call the Mastodon tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "mastodon-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Mastodon. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Mastodon now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Mastodon MCP in Windsurf

Open your `~/.codeium/windsurf/mcp_config.json` file and add the server configuration under the `mcpServers` key. Alternatively, use the Settings menu, navigate to Cascade, and use the MCP Servers UI to paste the connection URL.

Yes, because Cascade can monitor your terminal output and immediately invoke `post_status` once a task finishes. You can configure a workflow where Cascade drafts the release notes, uploads the asset via `upload_media`, and posts the update.

Absolutely. This MCP Server works with any standard Fedi instance by specifying your custom domain and access token. Cascade uses `get_instance_info` to verify the instance rules and capabilities before making other API requests.

You can ask Cascade to check your recent interactions. It will run `get_notifications_v2` to retrieve grouped updates, showing you who liked your posts or mentioned your account without forcing you to open a web browser.

Your instance access tokens and post data are stored locally in your Windsurf configuration files. This server processes your API requests using secure, ephemeral sandboxes, meaning your private Fedi credentials never pass through third-party servers.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript