Weavz
Mastodon

Mastodon

Publish, search, and monitor statuses on Mastodon-compatible servers.

12 tools
1 trigger
Use withChatGPTClaudeClaude CodeCursorCodexMCP clientsSetup guide

Tools

Name
create_status

Publish a Mastodon status.

update_status

Edit an existing Mastodon status by ID.

delete_status

Delete a Mastodon status by exact status ID.

get_status

Get a Mastodon status by ID.

search

Search statuses, accounts, or hashtags on the connected Mastodon instance.

list_home_timeline

List recent statuses from the authenticated account home timeline.

list_account_statuses

List statuses posted by a Mastodon account.

get_account

Get a Mastodon account profile by account ID.

favourite_status

Favourite a Mastodon status by ID.

unfavourite_status

Remove a favourite from a Mastodon status by ID.

boost_status

Boost a Mastodon status by ID.

unboost_status

Remove a boost from a Mastodon status by ID.

Triggers

Name
new_home_status

Triggers when a new status appears in the authenticated account home timeline.

Quick Start

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