How to Use the Mastodon MCP in Cline

Q: Can Cline monitor my Mastodon notifications in real time?

Cline can poll your inbox using getnotificationsv2 to check for new mentions or boosts. You can ask Cline to run this check periodically or on demand, allowing it to alert you to important interactions while you code.

Give Cline the power to read timelines, post updates, and manage your Mastodon account directly from your VS Code sidebar.

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 Cline

Create your Vinkius account to connect Mastodon to Cline 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 Cline

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate your Mastodon presence with Cline.

Cline excels at executing multi-step tasks, and that includes managing your social presence. By connecting this MCP Server, you let Cline check your profile status using `verify_credentials` and pull recent posts with `get_account_statuses` to analyze your reach. If you want to share a code snippet, Cline can write the file, use `upload_media` to attach it, and run `post_status` to share it with your Fedi followers. It manages the entire process from generation to publication.

Interactive moderation and feed curation in VS Code.

Keep your social feed relevant without leaving your coding workspace. Tell Cline to search for specific tech topics using `search` and automatically run `favourite_status` or `reblog_status` on high-quality posts that match your criteria. When spam accounts pollute your notifications, Cline can parse the noise with `get_notifications_v1` and apply `block_account` or `mute_account` to keep your digital space clean. You get a curated feed without the manual effort.

Thread analysis and context gathering.

Finding the start of a complex Fedi thread is annoying. Ask Cline to retrieve a post using `get_status` and use `get_status_context` to reconstruct the entire conversation tree directly in your sidebar. Cline reads the ancestors and descendants of the status, summarizes the debate, and helps you draft a highly contextual reply. It turns a chaotic federated thread into structured, readable information.

Setup guide

Set up Mastodon MCP in Cline

Prerequisites

VS Code with Cline extension installed
Active Vinkius subscription with a valid endpoint token

1

Open Cline MCP settings

Click the Cline icon in the VS Code sidebar to open the Cline panel. Then click the MCP Servers icon (server stack) at the top-right corner of the panel.
2

Add a remote server

Click "Remote Servers" at the top, then click "Add Remote MCP". In the Name field, type mastodon-mcp. In the URL field, paste your Vinkius endpoint: https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp. Get your token from cloud.vinkius.com.
3

Enable the server

After saving, the server appears in the Cline MCP panel. Toggle the switch to enable it. The status indicator turns green when the connection is live.
4

Start using tools

Return to the Cline chat and ask: "Check my latest Mastodon refund status." Cline will discover the available tools and request your approval before invoking each one — giving you full control over every action.

Cline MCP Settings

{
  "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 Cline

Click the MCP Servers icon in the Cline sidebar and paste the connection URL in the Remote Servers tab. You can also manually add the server details under the `mcpServers` key in your `cline_mcp_settings.json` file.

Cline can poll your inbox using `get_notifications_v2` to check for new mentions or boosts. You can ask Cline to run this check periodically or on demand, allowing it to alert you to important interactions while you code.

Yes, Cline can handle media attachments easily. It reads the local file from your workspace, runs `upload_media` to send it to your Fedi instance, and then attaches the media ID to your next `post_status` call.

You can configure separate MCP Server instances in your settings file, each pointing to a different instance URL and access token. This lets Cline switch contexts or manage multiple profiles depending on your workspace needs.

Your Fedi access tokens and timeline data are saved locally in Cline's settings file on your machine. All API calls to your instance are routed directly from your local environment, ensuring your authentication tokens are never exposed to external logs.

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