# Bluesky MCP server > Connect Claude, ChatGPT or Cursor to Bluesky. Your agent posts threads, images with alt text and links that turn into cards, and reads your likes. Canonical: https://omnisocials.com/bluesky-mcp | Channel page: https://omnisocials.com/bluesky.md | Bluesky API: https://omnisocials.com/bluesky-api.md | Pricing: https://omnisocials.com/pricing.md | 14-day free trial: https://app.omnisocials.com/signup This is the machine-readable version of [omnisocials.com/bluesky-mcp](https://omnisocials.com/bluesky-mcp), maintained for AI agents. Facts checked against the OmniSocials app on October 16, 2026. - **Server URL:** https://mcp.omnisocials.com - **Auth:** OAuth sign-in, or an API key for agents that run on their own - **Discovery file:** https://omnisocials.com/.well-known/mcp.json - **Docs:** https://docs.omnisocials.com/mcp-server - **With your AI agent:** Connect Claude, ChatGPT or any MCP client to Bluesky with the OmniSocials MCP server. Your agent posts threads, images with alt text and links that turn into cards, and reads your likes and reposts. - **With your coding agent:** Claude Code and Codex add the OmniSocials MCP server with one command, and agents that run on their own use an API key. Or call the Bluesky API from your own code. ## What your agent does Ask in plain words. Your agent writes the words. The MCP server does the links, uploads and thread chains. - **Threads in one request.** 2 to 25 posts of up to 300 characters, each with its own images, chained in order. (`create_post`, `upload_media`) - **Links that turn into cards.** Links, mentions and hashtags turn clickable, and a post with a link gets its card. (`create_post`, `get_best_times`) - **Alt text on every image.** Up to 10 images or one video per post, each with its own description. (`create_post`, `list_media`) - **Know what worked.** Your best post, its likes and reposts, and the best time to post the next one. (`get_recent_platform_posts`, `get_best_times`) ## Setup Connected in a minute. One URL and one sign-in. No API key for chat apps. 1. **Connect Bluesky in OmniSocials.** Sign in with your handle, on your own domain too. No app password. 2. **Add the server to your agent.** Paste one URL as a custom connector, or run one command. 3. **Sign in and pick a workspace.** OAuth in the browser. Agents that run on their own use an API key. - **Claude:** Customize > Connectors > Add custom connector > Paste the URL. Claude sends you to OmniSocials to sign in. No API key needed. Guide: https://omnisocials.com/claude - **Claude Code:** `claude mcp add --transport http omnisocials https://mcp.omnisocials.com`. Then type /mcp in Claude Code and sign in to OmniSocials. Guide: https://omnisocials.com/claude-code - **Codex:** `codex mcp add omnisocials --url https://mcp.omnisocials.com`. Then run codex mcp login omnisocials to sign in. Guide: https://omnisocials.com/codex - **API key:** `claude mcp add --transport http omnisocials https://mcp.omnisocials.com --header "Authorization: Bearer YOUR_API_KEY"`. For agents that run on their own. Create the key in Settings, API Keys. Docs: https://docs.omnisocials.com/mcp-server ## Tools 19 tools in 4 groups. Your agent picks them from a plain request. ### Publishing Posts, images, video and threads, now or on a schedule. Try asking: "Post the threads launch as a thread Thursday at 9 AM, with alt text on the image." - create_post: Schedule a post or a thread of up to 25 posts, with alt text on each image. - create_and_publish_post: Post to Bluesky right away. - update_post: Change the text, images, thread or time of a scheduled post. - upload_media: Upload images or a video from a URL or the chat. - check_media_compatibility: Check a file against Bluesky's size and format limits first. - retry_post: Publish a failed post again. ### Insights What each post did, and when to post the next one. Try asking: "Did my threads beat my single posts last month?" - get_post_analytics: The numbers Bluesky reports for one post. - get_posts_analytics: The numbers for many posts at once, to compare them. - get_account_analytics: Your followers and how they grow. - get_best_times: Your best days and hours from your own posts, or industry defaults until you have 15. - get_recent_platform_posts: Your latest posts with their likes and reposts, also the ones made in Bluesky. ### Approvals Your team or client signs off before a post goes out. Try asking: "Approve the Bluesky posts that are waiting for me." - list_approval_workflows: The review steps a post can go through. - approve_post: Approve a post that waits for you. - reject_post: Send a post back with what to change. - get_post_approval: Where a post stands in its review. ### Accounts and setup Which account, which workspace, which images. Try asking: "Which workspaces can you post to? Find the threads launch image." - list_accounts: The accounts connected to the workspace. - switch_workspace: Work in another workspace. - list_media: Find an image in your library before uploading it again. - create_webhook: Get an event when a post is scheduled, published, approved, rejected or fails. ## FAQ ### What is the Bluesky MCP server? It is the OmniSocials MCP server with your Bluesky account connected. Your AI agent calls its tools to post, schedule threads and read your numbers. The server lives at https://mcp.omnisocials.com, and the same tools post to your other channels too. ### Can my agent post a Bluesky thread? Yes. create_post takes the thread as 2 to 25 parts of up to 300 characters each, and every part can carry one video or up to 10 images. OmniSocials posts the parts in order, each a reply to the one before, so the thread goes out as one chain. ### Can it add alt text to images? Yes. Every image and video your agent attaches can carry its own description, up to 1,500 characters, which Bluesky shows as the image's alt text. ### Do links in my agent's posts become clickable? Yes. Links, mentions and hashtags turn clickable on their own, so your agent never builds Bluesky's facets. A post with a link and no images or video also gets a link card with the page's title, description and image. ### Can it answer Bluesky replies? No. Bluesky replies and mentions don't come into the Social Inbox, so the MCP server has no reply tools for Bluesky. Your agent can still read how many replies each post got. ### Can it read other people's Bluesky accounts? No. It works with the account you connected: your posts and your numbers. It doesn't scrape other accounts, feeds or followers. ### How do I connect Claude, ChatGPT or Cursor to Bluesky? Connect Bluesky in OmniSocials first, with your handle and no app password. In Claude, open Customize, then Connectors, click Add, choose Add custom connector and paste https://mcp.omnisocials.com. In ChatGPT, add the same URL as a custom MCP server under Plugins; in Cursor, put it in ~/.cursor/mcp.json. Each one sends you to OmniSocials to sign in and pick a workspace. ### Can an AI agent post to Bluesky safely? Yes. Your agent can send a post through an approval workflow: it waits until a teammate or client approves it, and only then goes out at its time. You can also ask your agent to save drafts, or to show you each post before it schedules it. ### Does the Bluesky MCP server need a paid plan? It needs an active OmniSocials plan or the 14-day free trial; without one, the server turns the connection down. The trial needs a card to start, and the MCP server is part of the one plan, like every other feature. ### How much does OmniSocials cost? One plan with every feature included: $10 per seat per month billed annually, or $12 billed monthly. Team members and client seats cost the same. Every account starts with a 14-day free trial. ## Related ### Set up your agent - [Claude](https://omnisocials.com/claude) - [ChatGPT](https://omnisocials.com/chatgpt) - [Claude Code](https://omnisocials.com/claude-code) - [Codex](https://omnisocials.com/codex) - [Cursor](https://omnisocials.com/cursor) - [Every agent](https://omnisocials.com/mcp) ### Bluesky - [Bluesky scheduler](https://omnisocials.com/bluesky) - [Best time to post on Bluesky](https://omnisocials.com/best-time-to-post-on-bluesky) - [Bluesky character limits](https://omnisocials.com/bluesky-character-limits) - [Bluesky image sizes](https://omnisocials.com/bluesky-image-sizes) ### For developers - [MCP server docs](https://docs.omnisocials.com/mcp-server) - [Bluesky API](https://omnisocials.com/bluesky-api) - [CLI](https://omnisocials.com/cli) ## More machine-readable pages - [Bluesky](https://omnisocials.com/bluesky.md) - [Bluesky API](https://omnisocials.com/bluesky-api.md) - [All channels](https://omnisocials.com/channels.md) - [MCP server](https://omnisocials.com/mcp.md) - [REST API](https://omnisocials.com/api.md) - [Pricing](https://omnisocials.com/pricing.md) - [llms.txt](https://omnisocials.com/llms.txt)