Integration · Marketing
AI agents for Mastodon
Post, schedule, edit and delete statuses, reply to mentions, boost and favourite posts, read the home timeline and notifications, and search people, hashtags and posts on any Mastodon server.
- Actions
- 14
- Read
- 9
- Write
- 5
Actions
What your agents can do in Mastodon
Post, schedule, edit and delete statuses, reply to mentions, boost and favourite posts, read the home timeline and notifications, and search people, hashtags and posts on any Mastodon server, as the account that made the token.
Read 9
Look things up. Nothing changes.
Get the signed-in account
Reads the account the token belongs to: its id, username, acct, display_name, note (bio, HTML), url, followers_count, following_count, statuses_count, locked, bot, created_at, and source.
Get a status
Reads one status by its ID: id, created_at, url, content (HTML), spoiler_text, visibility, in_reply_to_id, account.
Get a status's thread
Reads the thread around a status: ancestors (the statuses it replies to, oldest first) and descendants (the replies below it), each a status with id, created_at, content, account and in_reply_to_id.
List notifications
Lists the account's notifications, newest first, optionally only some types (mention, reblog, favourite, follow, follow_request, poll, status, update).
Read the home timeline
Reads the statuses from accounts the account follows, newest first.
List an account's statuses
Lists the statuses posted by an account (the signed-in one by default: find its id with "Get the signed-in account", others with "Look up an account"), newest first.
Look up an account
Finds an account by its address, like jane (on this server) or jane@example.social (elsewhere, if this server knows it).
Search
Searches accounts, hashtags and statuses on the server for a term, or resolves a full address or post URL from another server when resolve is true.
List scheduled statuses
Lists the account's statuses scheduled for later.
Write 5
Create, change or send.
Post a status
Publishes a status (a toot) as the account, or schedules it when scheduled_at is given (at least 5 minutes ahead).
Edit a status
Changes the text, content warning, sensitive flag or language of one of the account's own statuses by its ID; the server keeps the edit history.
Delete a statusDeletes data
Deletes one of the account's own statuses by its ID; boosts and replies by others lose their target.
Favourite a status
Favourites (likes) a status by its ID.
Boost a status
Boosts (reblogs) a status by its ID to the account's followers, optionally with a visibility (public, unlisted or private).
A person can approve first
Any write action can be set to wait for a person's approval before it runs, so an agent asks before it changes anything. Actions that delete data ask first by default.
Connection
How it connects
Connect it once in the console, then give it to the agents and workflows that need it.
Paste an API key from your Mastodon account.
What you enter
- Access token
Settings
- Server address
Kept safe
- Credentials are stored encrypted with your organization's own keys.
- They are opened only by the process that makes the call, at the moment it runs, and never go into a prompt or the browser.
- Calls go only to the tool's own servers.
Ideas
Ideas to start with
Starting points made only from the actions above. Mix them with any other tool your agents can use.
- 01
Ask about your Mastodon data
Ask a question in plain words. The agent can get the signed-in account, get a status or get a status's thread in Mastodon, then answers with what it found.
- 02
Let an agent update Mastodon
Have the agent post a status or delete a status in Mastodon as part of a larger task. Turn on approval and a person signs off on each change first.
- 03
Share what it finds in Slack
Give one agent Mastodon and Slack: it can get the signed-in account in Mastodon and post a summary to a Slack channel in the same run.
Works well with
More Marketing tools
- Mailchimp2 actionsAdd people to your Mailchimp audiences or update them, with their merge fields and tags, and look up your audiences.
- Klaviyo3 actionsCreate or update Klaviyo profiles, subscribe people to email marketing on a list, and record events that start flows.
- ActiveCampaign4 actionsCreate or update ActiveCampaign contacts, find them by email, and add them to lists and tags.
- LinkedIn2 actionsPublish text posts on a member's LinkedIn profile and read the signed-in member's name and email, after the member signs in with LinkedIn.
- X4 actionsPost and delete on X as the signed-in account, read an account's recent posts, and look up X users by username.
- YouTube4 actionsRead a YouTube channel's statistics, its uploaded videos, a video's details and the comments people leave, signed in with the channel owner's Google account.
FAQ
Mastodon and MyDeepAgents
Can MyDeepAgents connect to Mastodon?
Yes. The Mastodon connector has 14 actions: 9 read and 5 make changes. Your agents can call them as tools, and your workflows can run them as steps.
How do I connect Mastodon?
Paste an API key from your Mastodon account. You'll need: Access token. The connection also asks for: Server address. Credentials are stored encrypted with your organization's own keys and are opened only at the moment of a call.
Can an agent change data in Mastodon without asking?
Only if you let it. Each of the 5 actions that change data can be set to wait for a person's approval before it runs, and the one that deletes data asks first by default.
Can I use Mastodon in workflows as well as agents?
Yes. Every Mastodon action also works as a step in a workflow, and the same connection serves your agents and your workflows.
Early access
Put Mastodon to work
Connect it in a few minutes, give an agent the actions it needs, and decide which changes wait for a person.