Mastodon
Publish, search, and monitor statuses on Mastodon-compatible servers.
Tools
| Name | Description |
|---|---|
create_statusPublish a Mastodon status. | Publish a Mastodon status. |
update_statusEdit an existing Mastodon status by ID. | Edit an existing Mastodon status by ID. |
delete_statusDelete a Mastodon status by exact status ID. | Delete a Mastodon status by exact status ID. |
get_statusGet a Mastodon status by ID. | Get a Mastodon status by ID. |
searchSearch statuses, accounts, or hashtags on the connected Mastodon instance. | Search statuses, accounts, or hashtags on the connected Mastodon instance. |
list_home_timelineList recent statuses from the authenticated account home timeline. | List recent statuses from the authenticated account home timeline. |
list_account_statusesList statuses posted by a Mastodon account. | List statuses posted by a Mastodon account. |
get_accountGet a Mastodon account profile by account ID. | Get a Mastodon account profile by account ID. |
favourite_statusFavourite a Mastodon status by ID. | Favourite a Mastodon status by ID. |
unfavourite_statusRemove a favourite from a Mastodon status by ID. | Remove a favourite from a Mastodon status by ID. |
boost_statusBoost a Mastodon status by ID. | Boost a Mastodon status by ID. |
unboost_statusRemove a boost from a Mastodon status by ID. | Remove a boost from a Mastodon status by ID. |
Triggers
| Name | Description |
|---|---|
new_home_statusTriggers when a new status appears in the authenticated account home timeline. | Triggers when a new status appears in the authenticated account home timeline. |
Quick Start
import { WeavzClient } from '@weavz-io/sdk'
const weavz = new WeavzClient({ apiKey: 'wvz_...' })
const result = await weavz.actions.execute('mastodon', 'create_status', {
workspaceId: '550e8400-e29b-41d4-a716-446655440000',
integrationAlias: 'mastodon',
input: { /* ... */ },
})Related Integrations
Works well with
Frequently Asked Questions
How do I connect Mastodon to my app?
Use Weavz Hosted Connect for Custom authentication. Install the SDK, create a connection through the connect portal or API, then execute tools programmatically.
What tools does Mastodon support?
Mastodon supports 12 tools including Create Status, Update Status, Delete Status, Get Status, Search, and more.
Can I use Mastodon with AI agents?
Yes. Add Mastodon to an MCP server in Tool Mode or Code Mode. Code Mode provides 3 meta-tools with on-demand API discovery so agents can compose stateful workflows without loading every action schema up front.
How do I connect Mastodon to ChatGPT or Claude?
Open the Weavz connector setup, sign in, choose a workspace, and add Mastodon as an approved app. ChatGPT, Claude, and other remote MCP clients can then call the scoped Mastodon tools exposed by that workspace.
Does Mastodon work with Claude Code, Cursor, Codex, and local agents?
Yes. Remote and local MCP clients can connect to a Weavz MCP endpoint for the workspace. Local coding agents can also use the Weavz CLI to inspect apps, discover actions, run approved Mastodon work, and execute Code Mode workflows from a terminal.
What can I ask an AI agent to do with Mastodon?
Mastodon exposes 12 tools, including Create Status, Update Status, Delete Status, Get Status, Search, and more. Use Weavz to keep credentials scoped, require approval for sensitive work, and audit what the agent did.
Can Mastodon be used in stateful agent workflows?
Yes. Agents can combine Mastodon tools with Filesystem, State KV, Human Gates, input partials, and other workspace integrations while keeping execution scoped to the selected workspace or end user.
What authentication does Mastodon use?
Mastodon uses Custom. Weavz stores credentials securely and uses them for authorized action execution.
How much does the Mastodon integration cost?
The Mastodon integration is included on all Weavz plans including the free tier with 20,000 actions per month. No credit card required.
What triggers does Mastodon support?
Mastodon supports 1 triggers including New Home Timeline Status.
Connect Mastodon in minutes
Get 20,000 free action executions every month. No credit card required.