posterly

MCP connector

Bluesky MCP server

Schedule Bluesky posts with images, alt text, and content labels from Claude or ChatGPT.

This is the posterly MCP server, used for Bluesky. The same connection works from Claude, ChatGPT, Cursor, and other MCP clients. It is not a separate Bluesky-only download.

Get Starter + API · $10/moHow to connect the MCP server

What you can do on Bluesky

Bluesky posts are short at 300 characters, and your AI client can publish text and up to 4 images with alt text on each. Links, @mentions, and #hashtags are made clickable for you, and a link can show a preview card. Alt text matters on Bluesky, so ask Claude to describe each image instead of leaving it blank.

There are Bluesky-specific controls too. Add a content label to hide a post behind a tap-to-reveal warning, quote another post by its URL, stop others from quoting yours, set language tags, and add up to 8 hidden discovery tags that stay out of the visible text.

Bluesky connects with your handle and an app password created in your Bluesky settings, not your main password, so there is no OAuth screen to click through. Because the limit is tight, it pays to let Claude tighten a longer draft before you schedule it, or adapt one announcement you are also sending to X or Threads. The MCP server does not read Bluesky analytics.

  • Text posts
  • Images
  • Multi-image
  • Extra tagging tools
  • Audience controls

Post types: text, image, carousel. Analytics are not read for this platform.

Tools

These are the tools your AI client uses for Bluesky. Ask it to call list_platforms with view=schema and the account_id before it sets anything specific to Bluesky.

Account and connection

  • whoamiWho am I

  • list_accountsConnected accounts

  • list_platformsPlatforms

  • create_connect_sessionStart a connect session

  • connect_accountConnect with credentials

Posts

  • validate_postValidate a post

  • create_postCreate a post

    Show the caption, account, and time, then wait for confirmation before confirm=true.

  • create_posts_batchCreate posts in bulk

    1 to 25 posts in one confirmed request.

  • update_postEdit a post

    Show the caption, account, and time, then wait for confirmation before confirm=true.

  • list_postsPosts

  • get_postOne post

  • delete_postDelete posts

    Live removal needs an eligible connection and confirm_published. A refusal keeps the posterly record.

  • find_available_slotFind a free slot

  • generate_captionsGenerate captions

Media

  • upload_mediaUpload media

    Hosted requests are about 4MB, so this path is for small files. Large files use create_signed_upload or create_media_drop.

  • create_signed_uploadSigned upload link

  • create_media_dropMedia drop link

  • list_mediaMedia library

How to connect

  1. Add the hosted server in Claude, ChatGPT, Cursor, or another MCP client. Server URL: https://www.poster.ly/api/mcp. Sign in with posterly OAuth and press Allow. Use the www host. In ChatGPT, write actions need a Business, Enterprise, or Edu plan.
  2. Or, in a client that can run a local process (Cursor, Claude Code, Windsurf, and similar), use npx -y posterly-mcp-server@latest with a POSTERLY_API_KEY placeholder in that client's MCP config.
  3. Call whoami and list_accounts so you know which workspace the client is using.
  4. Connect Bluesky with the method below, then call list_platforms with view=schema and the account_id.

Bluesky

Paste your credentials into the dashboard form. You can also give them to your AI client, but anything you type into a chat becomes part of that chat history.

  • Handle (required): Bluesky handle, for example posterly.bsky.social.
  • App password (required): Bluesky app password generated from the account settings.
Connect Bluesky in the dashboard

Example prompts

  • Schedule this photo on Bluesky tomorrow at 8am with alt text describing the scene and the hashtag #photography.
  • Quote this Bluesky post with a short comment from us and schedule it for this afternoon.
  • Post this on Bluesky with a content label, and stop other people from quote-posting it.

Bluesky limits

Caption or text
300 characters.
Media count
Up to 4 images.

Request rates depend on your plan. The posterly MCP page lists them.

Pricing

API and MCP access is an add-on to any posterly plan. Starter plus API is $10 a month, charged now with no free trial on this checkout.

Get Starter + API · $10/moSee every plan

FAQ

What is the Bluesky MCP server?

It is the posterly MCP server, not a separate product. Connect it once and the same connection covers Bluesky and 17 other platforms, from Claude, ChatGPT, Cursor, and other MCP clients.

How do I connect Bluesky?

Add the hosted server at https://www.poster.ly/api/mcp and sign in with posterly, or run npx -y posterly-mcp-server@latest in a client that can start a local process. Bluesky: Paste your credentials into the dashboard form. You can also give them to your AI client, but anything you type into a chat becomes part of that chat history.

How do I connect Bluesky to the MCP server?

Use your Bluesky handle and an app password, which you create in your Bluesky settings. It is separate from your main password. Enter them in the dashboard form once, then your AI client can post to that account.

Can Claude quote a Bluesky post or add a content warning?

Yes. Give it the post URL to quote, and ask for a content label to hide the post behind a tap-to-reveal warning. You can also stop others from quote-posting yours.

Keep reading

MCP

posterly MCP server

Hosted OAuth setup, the local npm package, and the full tool list.

Scheduler

Bluesky scheduler

Schedule Bluesky from the posterly calendar and composer.

Guide

Bluesky guide

Read the long Bluesky guide, then come back to connect it.

Pricing

posterly pricing

Compare plans, then add API and MCP at checkout.

Other platform MCP servers