Mastodon MCP Server for Vercel AI SDKGive Vercel AI SDK instant access to 35 tools to Block Account, Bookmark Status, Check Health, and more
GDPR Free for SubscribersThe Vercel AI SDK is the TypeScript toolkit for building AI-powered applications. Connect Mastodon through Vinkius and every tool is available as a typed function. ready for React Server Components, API routes, or any Node.js backend.
Ask AI about this MCP Server for Vercel AI SDK
The Mastodon MCP Server for Vercel AI SDK 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 { createMCPClient } from "@ai-sdk/mcp";
import { generateText } from "ai";
import { openai } from "@ai-sdk/openai";
async function main() {
const mcpClient = await createMCPClient({
transport: {
type: "http",
// Your Vinkius token. get it at cloud.vinkius.com
url: "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
},
});
try {
const tools = await mcpClient.tools();
const { text } = await generateText({
model: openai("gpt-4o"),
tools,
prompt: "Using Mastodon, list all available capabilities.",
});
console.log(text);
} finally {
await mcpClient.close();
}
}
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.
The Vercel AI SDK gives every Mastodon tool full TypeScript type inference, IDE autocomplete, and compile-time error checking. Connect 35 tools through Vinkius and stream results progressively to React, Svelte, or Vue components. works on Edge Functions, Cloudflare Workers, and any Node.js runtime.
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 Vercel AI SDK 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 Vercel AI SDK
When Vercel AI SDK 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 Vercel AI SDK via MCP
Follow these steps to wire Mastodon into Vercel AI SDK. The entire setup takes under two minutes — your credentials stay safe behind Vinkius.
Install dependencies
npm install @ai-sdk/mcp ai @ai-sdk/openaiReplace the token
[YOUR_TOKEN_HERE] with your Vinkius tokenRun the script
agent.ts and run with npx tsx agent.tsExplore tools
Why Use Vercel AI SDK with the Mastodon MCP Server
Vercel AI SDK provides unique advantages when paired with Mastodon through the Model Context Protocol.
TypeScript-first: every MCP tool gets full type inference, IDE autocomplete, and compile-time error checking out of the box
Framework-agnostic core works with Next.js, Nuxt, SvelteKit, or any Node.js runtime. same Mastodon integration everywhere
Built-in streaming UI primitives let you display Mastodon tool results progressively in React, Svelte, or Vue components
Edge-compatible: the AI SDK runs on Vercel Edge Functions, Cloudflare Workers, and other edge runtimes for minimal latency
Mastodon + Vercel AI SDK Use Cases
Practical scenarios where Vercel AI SDK combined with the Mastodon MCP Server delivers measurable value.
AI-powered web apps: build dashboards that query Mastodon in real-time and stream results to the UI with zero loading states
API backends: create serverless endpoints that orchestrate Mastodon tools and return structured JSON responses to any frontend
Chatbots with tool use: embed Mastodon capabilities into conversational interfaces with streaming responses and tool call visibility
Internal tools: build admin panels where team members interact with Mastodon through natural language queries
Example Prompts for Mastodon in Vercel AI SDK
Ready-to-use prompts you can give your Vercel AI SDK 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 Vercel AI SDK
Common issues when connecting Mastodon to Vercel AI SDK through Vinkius, and how to resolve them.
createMCPClient is not a function
npm install @ai-sdk/mcpMastodon + Vercel AI SDK FAQ
Common questions about integrating Mastodon MCP Server with Vercel AI SDK.
How does the Vercel AI SDK connect to MCP servers?
createMCPClient from @ai-sdk/mcp and pass the server URL. The SDK discovers all tools and provides typed TypeScript interfaces for each one.Can I use MCP tools in Edge Functions?
Does it support streaming tool results?
useChat and streamText that handle tool calls and display results progressively in the UI.Explore More MCP Servers
View all →
AfterLogic Aurora
5 toolsEmail and webmail management — manage folders, messages, and accounts via AI.
LexisNexis
7 toolsManage your corporate intelligence — audit news, company data, and legal cases via AI.
OpenFGA (Fine-Grained Auth)
16 toolsManage fine-grained authorization with OpenFGA — create stores, define authorization models, and manage relationship tuples directly from your AI agent.
Factorial
12 toolsManage HR operations via Factorial — list employees and teams, track leave requests, monitor shifts and payslips, and handle company documents directly from any AI agent.