What can you do with the Mastodon integration?

LiveContext exposes 23 operations on Mastodon, covering account, notification, status and timeline. Common uses include content discovery, cleanup automation and cleanup.

LiveContext

All integrations

Mastodon integration

Mastodon is a free, open-source decentralized social networking platform that is part of the Fediverse. Create statuses (toots), follow users, boost and favourite content, browse timelines, manage notifications, search posts and accounts, and upload media. Mastodon enables federated social networking with user control, content warnings, and interoperability via ActivityPub. Perfect for building social applications, content automation, analytics tools, and decentralized social bots.

23 toolsOAuthAPI docs

Connect Mastodon How integrations work

Common Mastodon use cases

content discovery
cleanup automation
cleanup
liking posts
finding users
posting images
removing likes
removing boosts
following hashtags
unfollowing accounts

What you can do with Mastodon

Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.

Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.

Account, 3 operations

GETget_account
Retrieves public information about a Mastodon account including username, display name, bio, avatar, and follower counts.
GETlookup_account
Quickly looks up a Mastodon account by username or WebFinger address without full resolution.
GETverify_credentials
Verifies the access token and returns the authenticated user's account information including ID, username, display name, and profile details.

Notification, 3 operations

POSTclear_notifications
Clears all notifications from the server permanently.
POSTdismiss_notification
Dismisses a single notification, removing it from the notification list.
GETlist_notifications
Retrieves notifications for the authenticated user with filtering by type and account.

Status, 3 operations

POSTcreate_status
Creates a new status (toot) on Mastodon with support for text, media, polls, replies, content warnings, and visibility settings.
DELETEdelete_status
Deletes a status you have posted. Returns the deleted status for potential redrafting.
GETget_status
Retrieves a single Mastodon status by ID with full content, author info, and engagement metrics.

Timeline, 3 operations

GETget_hashtag_timeline
Retrieves public statuses containing a specific hashtag with optional tag filters.
GETget_home_timeline
Retrieves the home timeline with statuses from followed accounts and hashtags in reverse chronological order.
GETget_public_timeline
Retrieves the public timeline with all public statuses, filterable by local/remote and media content.

Favourite, 2 operations

POSTfavourite_status
Favourites (likes) a Mastodon status, notifying the author and adding it to your favourites list.
POSTunfavourite_status
Removes a favourite (like) from a Mastodon status.

Reblog, 2 operations

POSTreblog_status
Boosts (reblogs) a status to share it with your followers on your profile and their timelines.
POSTunreblog_status
Removes a boost (reblog) from a status, removing it from your profile.

Relationship, 2 operations

POSTfollow_account
Follows a Mastodon account to receive their posts in your home timeline. Configurable reblog visibility and notifications.
POSTunfollow_account
Unfollows a Mastodon account, removing them from your home timeline.

Context, 1 operation

GETget_status_context
Retrieves the conversation thread context for a status including ancestor and descendant replies.

Follower, 1 operation

GETget_account_followers
Retrieves the list of accounts following a specified user with pagination support.

Following, 1 operation

GETget_account_following
Retrieves the list of accounts that a user follows with pagination support.

Media, 1 operation

POSTupload_media
Uploads a media file for status attachments. Returns media ID for use in status creation.

Search result, 1 operation

GETsearch
Searches for accounts, hashtags, and statuses across Mastodon with filtering options.

Mastodon API rate limits

60 requests per minute
Bursts of up to 300 requests

300 requests per 5 minutes per account/IP. Media uploads limited to 30 per 30 minutes. Status deletion limited to 30 per 30 minutes.

These are the limits Mastodon documents, not ones LiveContext measured. They can change and often depend on your plan, so check the Mastodon documentation for current values.

Use Mastodon from Claude Code, Cursor or Codex

Connect Mastodon in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Mastodon operations become tools the client can call, next to every other integration you connected.

Claude Code

claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"

Codex (~/.codex/config.toml)

[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"

[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"

Cursor, Claude Desktop and other JSON configs

{
  "mcpServers": {
    "livecontext": {
      "type": "http",
      "url": "https://livecontext.ai/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Set up the MCP server step by step

How to connect Mastodon

Create your workspace
Sign up free. Nothing to install.
Connect Mastodon once
Add your Mastodon connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.

Mastodon integration FAQ

What can you do with the Mastodon integration?: LiveContext exposes 23 operations on Mastodon, covering account, notification, status and timeline. Common uses include content discovery, cleanup automation and cleanup.
What are the Mastodon API rate limits?: Mastodon documents 60 requests per minute and bursts of up to 300 requests. 300 requests per 5 minutes per account/IP. Media uploads limited to 30 per 30 minutes. Status deletion limited to 30 per 30 minutes. Limits are set by Mastodon and can depend on your plan.