Mastodon MCP Server for Google ADKGive Google ADK instant access to 35 tools to Block Account, Bookmark Status, Check Health, and more
Google Agent Development Kit (ADK) is Google's framework for building production AI agents. Add Mastodon as an MCP tool provider through Vinkius and your ADK agents can call every tool with full schema introspection.
Ask AI about this MCP Server for Google ADK
The Mastodon MCP Server for Google ADK 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
from google.adk.agents import Agent
from google.adk.tools.mcp_tool import McpToolset
from google.adk.tools.mcp_tool.mcp_session_manager import (
StreamableHTTPConnectionParams,
)
# Your Vinkius token. get it at cloud.vinkius.com
mcp_tools = McpToolset(
connection_params=StreamableHTTPConnectionParams(
url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
)
)
agent = Agent(
model="gemini-2.5-pro",
name="mastodon_agent",
instruction=(
"You help users interact with Mastodon "
"using 35 available tools."
),
tools=[mcp_tools],
)
* 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.
Google ADK natively supports Mastodon as an MCP tool provider. declare Vinkius Edge URL and the framework handles discovery, validation, and execution automatically. Combine 35 tools with Gemini's long-context reasoning for complex multi-tool workflows, with production-ready session management and evaluation built in.
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 Google ADK 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 Google ADK
When Google ADK 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 Google ADK via MCP
Follow these steps to wire Mastodon into Google ADK. The entire setup takes under two minutes — your credentials stay safe behind Vinkius.
Install Google ADK
pip install google-adkReplace the token
[YOUR_TOKEN_HERE] with your Vinkius tokenCreate the agent
Explore tools
Why Use Google ADK with the Mastodon MCP Server
Google ADK provides unique advantages when paired with Mastodon through the Model Context Protocol.
Google ADK natively supports MCP tool servers. declare a tool provider and the framework handles discovery, validation, and execution
Built on Gemini models, ADK provides long-context reasoning ideal for complex multi-tool workflows with Mastodon
Production-ready features like session management, evaluation, and deployment come built-in. not bolted on
Seamless integration with Google Cloud services means you can combine Mastodon tools with BigQuery, Vertex AI, and Cloud Functions
Mastodon + Google ADK Use Cases
Practical scenarios where Google ADK combined with the Mastodon MCP Server delivers measurable value.
Enterprise data agents: ADK agents query Mastodon and cross-reference results with internal databases for comprehensive analysis
Multi-modal workflows: combine Mastodon tool responses with Gemini's vision and language capabilities in a single agent
Automated compliance checks: schedule ADK agents to query Mastodon regularly and flag policy violations or configuration drift
Internal tool platforms: build self-service agent platforms where teams connect their own MCP servers including Mastodon
Example Prompts for Mastodon in Google ADK
Ready-to-use prompts you can give your Google ADK 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 Google ADK
Common issues when connecting Mastodon to Google ADK through Vinkius, and how to resolve them.
McpToolset not found
pip install --upgrade google-adkMastodon + Google ADK FAQ
Common questions about integrating Mastodon MCP Server with Google ADK.
How does Google ADK connect to MCP servers?
Can ADK agents use multiple MCP servers?
Which Gemini models work best with MCP tools?
Explore More MCP Servers
View all →
ScreenshotOne
6 toolsCapture website screenshots — audit visual content and generate PDFs via AI.

Flexport
12 toolsManage global freight shipments, purchase orders, and logistics documents via AI agents with Flexport.

Tomorrow.io Alternative
10 toolsAccess hyperlocal weather intelligence — real-time conditions, forecasts, historical archives, severe alerts and route weather from the Tomorrow.io API.

Databricks
8 toolsManage lakehouse via Databricks — monitor compute clusters, track job executions, audit SQL warehouses, and explore Unity Catalog directly from any AI agent.
