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 |
Capabilities
Features and capabilities supported by this server
| 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
- 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