Integration

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.

Connect Mastodon How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

When this happens, do that in Mastodon.Built from the 23 Mastodon tools below, on the connection you add once.

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

get_accountGet accountGETRetrieves public information about a Mastodon account including username, display name, bio, avatar, and follower counts.
lookup_accountLookup accountGETQuickly looks up a Mastodon account by username or WebFinger address without full resolution.
verify_credentialsVerify credentialsGETVerifies the access token and returns the authenticated user's account information including ID, username, display name, and profile details.

Notification, 3 operations

clear_notificationsClear notificationsPOSTClears all notifications from the server permanently.
dismiss_notificationDismiss notificationPOSTDismisses a single notification, removing it from the notification list.
list_notificationsList notificationsGETRetrieves notifications for the authenticated user with filtering by type and account.

Status, 3 operations

create_statusCreate statusPOSTCreates a new status (toot) on Mastodon with support for text, media, polls, replies, content warnings, and visibility settings.
delete_statusDelete statusDELETEDeletes a status you have posted. Returns the deleted status for potential redrafting.
get_statusGet statusGETRetrieves a single Mastodon status by ID with full content, author info, and engagement metrics.

Timeline, 3 operations

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

Favourite, 2 operations

favourite_statusFavourite statusPOSTFavourites (likes) a Mastodon status, notifying the author and adding it to your favourites list.
unfavourite_statusUnfavourite statusPOSTRemoves a favourite (like) from a Mastodon status.

Reblog, 2 operations

reblog_statusReblog statusPOSTBoosts (reblogs) a status to share it with your followers on your profile and their timelines.
unreblog_statusUnreblog statusPOSTRemoves a boost (reblog) from a status, removing it from your profile.

Relationship, 2 operations

follow_accountFollow accountPOSTFollows a Mastodon account to receive their posts in your home timeline. Configurable reblog visibility and notifications.
unfollow_accountUnfollow accountPOSTUnfollows a Mastodon account, removing them from your home timeline.

Context, 1 operation

get_status_contextGet status contextGETRetrieves the conversation thread context for a status including ancestor and descendant replies.

Follower, 1 operation

get_account_followersGet account followersGETRetrieves the list of accounts following a specified user with pagination support.

Following, 1 operation

get_account_followingGet account followingGETRetrieves the list of accounts that a user follows with pagination support.

Media, 1 operation

upload_mediaUpload mediaPOSTUploads a media file for status attachments. Returns media ID for use in status creation.

Search result, 1 operation

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