4,000+ servers built on vurb.ts
Vinkius

Mastodon MCP Server for Google ADKGive Google ADK instant access to 35 tools to Block Account, Bookmark Status, Check Health, and more

MCP Inspector GDPR Free for Subscribers

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.

Built for AI Agents by Vinkius

Vinkius delivers Streamable HTTP and SSE to any MCP client

ClaudeClaude
ChatGPTChatGPT
CursorCursor
GeminiGemini
WindsurfWindsurf
VS CodeVS Code
JetBrainsJetBrains
VercelVercel
+ other MCP clients
python
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],
)
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

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

Block account on Mastodon

Block a Mastodon account

bookmark

Bookmark status on Mastodon

Bookmark a Mastodon status

check

Check health on Mastodon

Check server health status

clear

Clear notifications on Mastodon

Clear all notifications

create

Create app on Mastodon

Create a new Mastodon application

delete

Delete status on Mastodon

Delete a Mastodon status

dismiss

Dismiss notification on Mastodon

Dismiss a single notification

favourite

Favourite status on Mastodon

Favourite a Mastodon status

follow

Follow account on Mastodon

Follow a Mastodon account

get

Get account on Mastodon

Get a Mastodon account profile

get

Get account statuses on Mastodon

Get statuses posted by a Mastodon account

get

Get home timeline on Mastodon

View statuses from followed users

get

Get instance info on Mastodon

Get general information about the server

get

Get instance rules on Mastodon

View server rules

get

Get list timeline on Mastodon

View statuses in a specific list

get

Get media on Mastodon

Check status of an uploaded media attachment

get

Get notifications v1 on Mastodon

View notifications for the user (v1)

get

Get notifications v2 on Mastodon

View grouped notifications for the user (v2, Mastodon 4.3+)

get

Get public timeline on Mastodon

View public statuses (local or federated)

get

Get status on Mastodon

View a single Mastodon status

get

Get status context on Mastodon

View thread ancestors and descendants for a status

get

Get tag timeline on Mastodon

View statuses containing a specific hashtag

get

Get trending links on Mastodon

View trending links

get

Get trending statuses on Mastodon

View trending statuses

get

Get trending tags on Mastodon

View trending hashtags

mute

Mute account on Mastodon

Mute a Mastodon account

post

Post status on Mastodon

Post a new status (toot) to Mastodon

reblog

Reblog status on Mastodon

Boost (reblog) a Mastodon status

register

Register account on Mastodon

Register a new Mastodon account

action

Search on Mastodon

Search for accounts, statuses, and hashtags

unfollow

Unfollow account on Mastodon

Unfollow a Mastodon account

update

Update credentials on Mastodon

Update Mastodon profile credentials

update

Update media on Mastodon

Update media description or focal point

upload

Upload media on Mastodon

Upload media asynchronously

verify

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.

01

Install Google ADK

Run pip install google-adk
02

Replace the token

Replace [YOUR_TOKEN_HERE] with your Vinkius token
03

Create the agent

Save the code above and integrate into your ADK workflow
04

Explore tools

The agent will discover 35 tools from Mastodon via MCP

Why Use Google ADK with the Mastodon MCP Server

Google ADK provides unique advantages when paired with Mastodon through the Model Context Protocol.

01

Google ADK natively supports MCP tool servers. declare a tool provider and the framework handles discovery, validation, and execution

02

Built on Gemini models, ADK provides long-context reasoning ideal for complex multi-tool workflows with Mastodon

03

Production-ready features like session management, evaluation, and deployment come built-in. not bolted on

04

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.

01

Enterprise data agents: ADK agents query Mastodon and cross-reference results with internal databases for comprehensive analysis

02

Multi-modal workflows: combine Mastodon tool responses with Gemini's vision and language capabilities in a single agent

03

Automated compliance checks: schedule ADK agents to query Mastodon regularly and flag policy violations or configuration drift

04

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.

01

"Post a new status saying 'Hello from my AI agent!' with public visibility."

02

"Show me the top 5 trending tags on this instance."

03

"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.

01

McpToolset not found

Update: pip install --upgrade google-adk

Mastodon + Google ADK FAQ

Common questions about integrating Mastodon MCP Server with Google ADK.

01

How does Google ADK connect to MCP servers?

Import the MCP toolset class and pass the server URL. ADK discovers and registers all tools automatically, making them available to your agent's tool-use loop.
02

Can ADK agents use multiple MCP servers?

Yes. Declare multiple MCP tool providers in your agent configuration. ADK merges all tool schemas and the agent can call tools from any server in a single turn.
03

Which Gemini models work best with MCP tools?

Gemini 2.0 Flash and Pro models both support function calling required for MCP tools. Flash is recommended for latency-sensitive use cases, Pro for complex reasoning.

Explore More MCP Servers

View all →