mastodon-mcp-server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| DEBUG | No | Enable verbose logging | false |
| READ_ONLY | No | Disable all write operations | false |
| MASTODON_INSTANCE | Yes | Mastodon instance URL (e.g. https://mastodon.social or just mastodon.social) | |
| MASTODON_MCP_HOST | No | HTTP transport bind address | 127.0.0.1 |
| MASTODON_MCP_PORT | No | HTTP transport port | 8000 |
| MASTODON_ACCESS_TOKEN | Yes | OAuth access token | |
| MASTODON_MCP_TRANSPORT | No | Transport: stdio or streamable-http | stdio |
| MASTODON_MCP_STATELESS_HTTP | No | Disable HTTP session state | false |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| instance_infoA | Get information about the connected Mastodon instance. |
| account_verifyA | Get the authenticated account's own profile. |
| account_getB | Get a Mastodon account by its numeric ID. |
| account_searchC | Search for accounts by username or display name. |
| account_statusesB | Get statuses posted by a specific account. |
| account_followersA | Get followers of an account. |
| account_followingC | Get accounts that a given account follows. |
| account_followC | Follow an account. |
| account_unfollowB | Unfollow an account. |
| account_muteC | Mute an account. |
| account_unmuteB | Unmute an account. |
| account_blockB | Block an account. |
| account_unblockB | Unblock an account. |
| account_relationshipsB | Get the authenticated user's relationship to one or more accounts. |
| account_updateA | Update the authenticated account's profile. |
| timeline_homeB | Get the authenticated user's home timeline. |
| timeline_localA | Get the local (instance) public timeline. |
| timeline_publicC | Get the federated public timeline. |
| timeline_hashtagB | Get statuses with a specific hashtag. |
| status_getC | Get a single status by ID. |
| status_contextB | Get ancestors and descendants of a status (thread context). |
| status_postC | Post a new status (toot). |
| status_deleteB | Delete a status posted by the authenticated account. |
| status_favouriteB | Favourite (like) a status. |
| status_unfavouriteB | Remove a favourite from a status. |
| status_reblogB | Reblog (boost) a status. |
| status_unreblogB | Remove a reblog (unboost) of a status. |
| status_bookmarkC | Bookmark a status. |
| status_unbookmarkB | Remove a bookmark from a status. |
| status_favourited_byB | Get accounts that favourited a status. |
| status_reblogged_byB | Get accounts that reblogged a status. |
| notifications_getB | Get notifications for the authenticated account. |
| notification_dismissA | Dismiss (clear) a single notification. |
| notifications_clearA | Dismiss all notifications for the authenticated account. |
| searchC | Search Mastodon for accounts, statuses, and hashtags. |
| trending_tagsC | Get trending hashtags on the instance. |
| trending_statusesC | Get trending statuses on the instance. |
| trending_linksB | Get trending links (articles) on the instance. |
| favouritesB | Get statuses favourited by the authenticated account. |
| bookmarksB | Get statuses bookmarked by the authenticated account. |
| lists_getA | Get all lists created by the authenticated account. |
| list_accountsB | Get accounts in a specific list. |
| list_createC | Create a new list. |
| list_deleteB | Delete a list. |
| list_accounts_addC | Add accounts to a list. |
| list_accounts_deleteB | Remove accounts from a list. |
| poll_voteC | Vote in a poll. |
| follow_requestsA | Get pending follow requests for the authenticated account. |
| follow_request_authorizeB | Approve a follow request. |
| follow_request_rejectB | Reject a follow request. |
| mutesA | Get accounts muted by the authenticated account. |
| blocksA | Get accounts blocked by the authenticated account. |
| media_postB | Upload a media file (image, video, audio) to Mastodon. |
| directoryB | Browse the profile directory of the instance. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/VitexSoftware/mastodon-mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server