Skip to content
BuzzTake
MenuClose

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.

ActionOn MastodonCredits
postPost10
replyReply8
quoteQuote10
delete_postDelete3
repostBoost3
unrepostUndo boost3
likeFavourite3
unlikeUnfavourite3
bookmarkBookmark3
unbookmarkRemove bookmark3
followFollow3
unfollowUnfollow3
blockBlock3
unblockUnblock3
muteMute3
unmuteUnmute3
send_messagePrivate mention10
list_conversationsPrivate mentions4
read_conversationConversation4
read_feedHome4
read_notificationsNotifications4
read_postPost and replies4
read_profileProfile4
list_followersFollowers4
list_followingFollowing4
searchSearch4
update_profileEdit profile10
browserAnything else, step by step2 + 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

post
// 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

POST /v1/accounts/acc_mastodon/actions
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.

  • password

    Username and password

    Send the username, the password and, if the account uses an authenticator app, its secret. BuzzTake answers 2FA codes itself.

  • cookies

    Cookies

    Import cookies from a browser where the account is already signed in: a JSON array or a Netscape cookie file.

  • browser

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