Mastodon MCP Server for Mastra AIGive Mastra AI instant access to 35 tools to Block Account, Bookmark Status, Check Health, and more
GDPR Free for SubscribersMastra AI is a TypeScript-native agent framework built for modern web stacks. Connect Mastodon through Vinkius and Mastra agents discover all tools automatically. type-safe, streaming-ready, and deployable anywhere Node.js runs.
Ask AI about this MCP Server for Mastra AI
The Mastodon MCP Server for Mastra AI is a standout in the Communication Messaging category — giving your AI agent 35 tools to work with, ready to go from day one.
Vinkius delivers Streamable HTTP and SSE to any MCP client
Geminiimport { Agent } from "@mastra/core/agent";
import { createMCPClient } from "@mastra/mcp";
import { openai } from "@ai-sdk/openai";
async function main() {
// Your Vinkius token. get it at cloud.vinkius.com
const mcpClient = await createMCPClient({
servers: {
"mastodon": {
url: "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
},
},
});
const tools = await mcpClient.getTools();
const agent = new Agent({
name: "Mastodon Agent",
instructions:
"You help users interact with Mastodon " +
"using 35 tools.",
model: openai("gpt-4o"),
tools,
});
const result = await agent.generate(
"What can I do with Mastodon?"
);
console.log(result.text);
}
main();
* 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
About Mastodon MCP Server
Connect your Mastodon account to any AI agent and manage your decentralized social presence through natural conversation.
Mastra's agent abstraction provides a clean separation between LLM logic and Mastodon tool infrastructure. Connect 35 tools through Vinkius and use Mastra's built-in workflow engine to chain tool calls with conditional logic, retries, and parallel execution. deployable to any Node.js host in one command.
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.
The Mastodon MCP Server exposes 35 tools through the Vinkius. Connect it to Mastra AI in under two minutes — credentials fully managed, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.
All 35 Mastodon tools available for Mastra AI
When Mastra AI connects to Mastodon through Vinkius, your AI agent gets direct access to every tool listed below — spanning fediverse, microblogging, activitypub, and more. Every call runs in a secure, isolated environment with full audit visibility. Beyond a simple connection, you get real-time monitoring of agent activity, enterprise governance, and optimized token usage.
Block account on Mastodon
Block a Mastodon account
Bookmark status on Mastodon
Bookmark a Mastodon status
Check health on Mastodon
Check server health status
Clear notifications on Mastodon
Clear all notifications
Create app on Mastodon
Create a new Mastodon application
Delete status on Mastodon
Delete a Mastodon status
Dismiss notification on Mastodon
Dismiss a single notification
Favourite status on Mastodon
Favourite a Mastodon status
Follow account on Mastodon
Follow a Mastodon account
Get account on Mastodon
Get a Mastodon account profile
Get account statuses on Mastodon
Get statuses posted by a Mastodon account
Get home timeline on Mastodon
View statuses from followed users
Get instance info on Mastodon
Get general information about the server
Get instance rules on Mastodon
View server rules
Get list timeline on Mastodon
View statuses in a specific list
Get media on Mastodon
Check status of an uploaded media attachment
Get notifications v1 on Mastodon
View notifications for the user (v1)
Get notifications v2 on Mastodon
View grouped notifications for the user (v2, Mastodon 4.3+)
Get public timeline on Mastodon
View public statuses (local or federated)
Get status on Mastodon
View a single Mastodon status
Get status context on Mastodon
View thread ancestors and descendants for a status
Get tag timeline on Mastodon
View statuses containing a specific hashtag
Get trending links on Mastodon
View trending links
Get trending statuses on Mastodon
View trending statuses
Get trending tags on Mastodon
View trending hashtags
Mute account on Mastodon
Mute a Mastodon account
Post status on Mastodon
Post a new status (toot) to Mastodon
Reblog status on Mastodon
Boost (reblog) a Mastodon status
Register account on Mastodon
Register a new Mastodon account
Search on Mastodon
Search for accounts, statuses, and hashtags
Unfollow account on Mastodon
Unfollow a Mastodon account
Update credentials on Mastodon
Update Mastodon profile credentials
Update media on Mastodon
Update media description or focal point
Upload media on Mastodon
Upload media asynchronously
Verify credentials on Mastodon
Verify Mastodon account credentials
Connect Mastodon to Mastra AI via MCP
Follow these steps to wire Mastodon into Mastra AI. The entire setup takes under two minutes — your credentials stay safe behind Vinkius.
Install dependencies
npm install @mastra/core @mastra/mcp @ai-sdk/openaiReplace the token
[YOUR_TOKEN_HERE] with your Vinkius tokenRun the agent
agent.ts and run with npx tsx agent.tsExplore tools
Why Use Mastra AI with the Mastodon MCP Server
Mastra AI provides unique advantages when paired with Mastodon through the Model Context Protocol.
Mastra's agent abstraction provides a clean separation between LLM logic and tool infrastructure. add Mastodon without touching business code
Built-in workflow engine chains MCP tool calls with conditional logic, retries, and parallel execution for complex automation
TypeScript-native: full type inference for every Mastodon tool response with IDE autocomplete and compile-time checks
One-command deployment to any Node.js host. Vercel, Railway, Fly.io, or your own infrastructure
Mastodon + Mastra AI Use Cases
Practical scenarios where Mastra AI combined with the Mastodon MCP Server delivers measurable value.
Automated workflows: build multi-step agents that query Mastodon, process results, and trigger downstream actions in a typed pipeline
SaaS integrations: embed Mastodon as a first-class tool in your product's AI features with Mastra's clean agent API
Background jobs: schedule Mastra agents to query Mastodon on a cron and store results in your database automatically
Multi-agent systems: create specialist agents that collaborate using Mastodon tools alongside other MCP servers
Example Prompts for Mastodon in Mastra AI
Ready-to-use prompts you can give your Mastra AI agent to start working with Mastodon immediately.
"Post a new status saying 'Hello from my AI agent!' with public visibility."
"Show me the top 5 trending tags on this instance."
"Verify my account and show my profile details."
Troubleshooting Mastodon MCP Server with Mastra AI
Common issues when connecting Mastodon to Mastra AI through Vinkius, and how to resolve them.
createMCPClient not exported
npm install @mastra/mcpMastodon + Mastra AI FAQ
Common questions about integrating Mastodon MCP Server with Mastra AI.
How does Mastra AI connect to MCP servers?
MCPClient with the server URL and pass it to your agent. Mastra discovers all tools and makes them available with full TypeScript types.Can Mastra agents use tools from multiple servers?
Does Mastra support workflow orchestration?
Explore More MCP Servers
View all →
Football-Data.org
14 toolsAccess real-time football scores, standings, and player statistics from major global leagues via Football-Data.org.
Lyko
12 toolsAccess European public transit via Lyko — plan intermodal trips, check departures, search stops, and monitor transit operators from any AI agent.
RongCloud
10 toolsLeading IM and RTC platform in China — manage users, messages, and chatrooms via AI.
Vapi
10 toolsCommand Voice AI assistants directly from your chat. Make outbound phone calls, update personas, and retrieve full transcripts via Vapi.