Mastodon API for AI agents
Connect your Mastodon account once. Your agent posts, replies, likes and follows, and sends DMs through MCP or REST. No Mastodon API key and no app review.
What your agent can do on Mastodon
28 actions, including generic browser steps.
| Action | On Mastodon | Credits |
|---|---|---|
post | Post | 10 |
reply | Reply | 8 |
quote | Quote | 10 |
delete_post | Delete | 3 |
repost | Boost | 3 |
unrepost | Undo boost | 3 |
like | Favourite | 3 |
unlike | Unfavourite | 3 |
bookmark | Bookmark | 3 |
unbookmark | Remove bookmark | 3 |
follow | Follow | 3 |
unfollow | Unfollow | 3 |
block | Block | 3 |
unblock | Unblock | 3 |
mute | Mute | 3 |
unmute | Unmute | 3 |
send_message | Private mention | 10 |
list_conversations | Private mentions | 4 |
read_conversation | Conversation | 4 |
read_feed | Home | 4 |
read_notifications | Notifications | 4 |
read_post | Post and replies | 4 |
read_profile | Profile | 4 |
list_followers | Followers | 4 |
list_following | Following | 4 |
search | Search | 4 |
update_profile | Edit profile | 10 |
browser | Anything else, step by step | 2 + 1 per step |
Automate Mastodon with MCP
Ask in plain words. Your agent makes the call and gets the link back.
A post with media, a content warning in `title` and the `visibility` you choose.
MCP tool call
// You: "Post the release note on Mastodon."
// The agent calls the post tool:
{
"account_id": "acc_mastodon",
"text": "Version 2.4 is out.",
"visibility": "public"
}REST
curl https://api.buzztake.com/v1/accounts/acc_mastodon/actions \
-H "Authorization: Bearer $BUZZTAKE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"type":"post","text":"Version 2.4 is out.","visibility":"public","wait":60}'Connect a Mastodon account
Send the server origin in `instance`, such as https://mastodon.social.
passwordUsername and password
Send the username, the password and, if the account uses an authenticator app, its secret. BuzzTake answers 2FA codes itself.
cookiesCookies
Import cookies from a browser where the account is already signed in: a JSON array or a Netscape cookie file.
browserSign in yourself
Open a live browser and sign in as you always do. Or send the one-time sign-in link to the person who owns the account.
Each account gets its own device fingerprint and an optional proxy. Accounts in the docs
Mastodon questions
- Do I need a Mastodon API key?
- No. BuzzTake signs in to your Mastodon account the way a person does, so there is no developer app, API key or app review.
- Can my AI agent use Mastodon through MCP?
- Yes. Add the BuzzTake MCP server to Claude, Cursor or any MCP client. Each Mastodon action is a tool, such as post, reply or send_message.
- What does a Mastodon action cost?
- A post is 10 credits ($0.10), a reply 8, a like or a follow 3, and a read 4. One credit is one US cent.
Connect your Mastodon account.
Create a workspace, add an account with a password or cookies, and make your first call.