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

Bring Fediverse
to LlamaIndex

Learn how to connect Mastodon to LlamaIndex 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 LlamaIndex?

LlamaIndex agents combine Mastodon tool responses with indexed documents for comprehensive, grounded answers. Connect 35 tools through Vinkius and query live data alongside vector stores and SQL databases in a single turn. ideal for hybrid search, data enrichment, and analytical workflows.

  • Data-first architecture: LlamaIndex agents combine Mastodon tool responses with indexed documents for comprehensive, grounded answers

  • Query pipeline framework lets you chain Mastodon tool calls with transformations, filters, and re-rankers in a typed pipeline

  • Multi-source reasoning: agents can query Mastodon, a vector store, and a SQL database in a single turn and synthesize results

  • Observability integrations show exactly what Mastodon tools were called, what data was returned, and how it influenced the final answer

L
See it in action

Mastodon in LlamaIndex

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 LlamaIndex 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 LlamaIndex

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 LlamaIndex 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 LlamaIndex

Every tool call from LlamaIndex 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 LlamaIndex connect to MCP servers?

Use the MCP client adapter to create a connection. LlamaIndex discovers all tools and wraps them as query engine tools compatible with any LlamaIndex agent.

05

Can I combine MCP tools with vector stores?

Yes. LlamaIndex agents can query Mastodon tools and vector store indexes in the same turn, combining real-time and embedded data for grounded responses.

06

Does LlamaIndex support async MCP calls?

Yes. LlamaIndex's async agent framework supports concurrent MCP tool calls for high-throughput data processing pipelines.

07

BasicMCPClient not found

Install: pip install llama-index-tools-mcp

Explore More MCP Servers

View all →