Bluesky MCP server
MCP included on Free. No credit card required.
What you can do on Bluesky
Connect your account in SocialRobot, then use these capabilities from Claude, ChatGPT, Cursor, or another MCP client.
| Capability | Supported in SocialRobot |
|---|---|
| Accounts | Bluesky accounts connected through the SocialRobot account flow. |
| Post formats | Text posts, posts with images, and supported MP4 video. |
| Network options | Image alt text and per-network captions when you schedule the same idea on Bluesky and other connected accounts. |
| Analytics | Read SocialRobot publication status and scheduled posts. Bluesky engagement analytics are not exposed by the current MCP tools. |
| Requirements and limits | Bluesky text and media limits still apply. Supply MP4 video for MCP; MOV and WebM conversion happens in the browser composer, not in the MCP client. |
Three requests to try first
Give the assistant your content, name the connected account, and specify the date, time, and timezone. These examples show what to ask and what happens next.
Schedule an accessible photo post
“Schedule this photo on Bluesky tomorrow at 9 AM Europe/Amsterdam with a short caption about our new cups. Add alt text describing the handmade ceramic glaze.”
What happens: The assistant queues an image post with its caption and alt text for your connected Bluesky account.
Adapt a launch for Bluesky
“Draft this launch announcement for Bluesky and LinkedIn. Keep the Bluesky version under 300 characters and save both without publishing.”
What happens: The assistant saves an unpublished post with a short Bluesky version and a separate LinkedIn caption.
Check the week before it goes out
“List my scheduled Bluesky posts for next week. Move the cup launch to Wednesday at 9 AM Europe/Amsterdam and leave the image and alt text as they are.”
What happens: The assistant reads your SocialRobot schedule and moves the unpublished post to the new time.
Connect Bluesky to Claude, ChatGPT, or Cursor
First create a SocialRobot account and connect Bluesky under Accounts. Then add the server below in your AI client. SocialRobot manages the network connection; you do not need to build your own developer app.
Hosted MCP endpoint
https://socialrobot.io/api/mcpSign in with OAuth, or use a scoped API key from SocialRobot with Authorization: Bearer sk_YOUR_API_KEY. The same endpoint works for every supported network.
Works in Claude on the web, desktop and mobile, on every plan (Free allows one custom connector). Claude Code uses the terminal command below.
- 1Open Customize → Connectors, then + Add → Add custom connector.
- 2Name it SocialRobot.
- 3URL: https://socialrobot.io/api/mcp
- 4Sign in when Claude asks, then try: schedule tomorrow's Instagram post.
claude mcp add --transport http socialrobot https://socialrobot.io/api/mcpYou need a paid plan. OpenAI keeps renaming this screen (connectors, apps, plugins), but it's still a form, not a coding project.
- 1Go to chatgpt.com/plugins → Add → Create MCP App. If that's missing, turn on Developer mode in Settings first.
- 2Name it SocialRobot.
- 3Server URL: https://socialrobot.io/api/mcp. Authentication: OAuth.
- 4Create it, sign in, then pick SocialRobot from the + menu when you start a chat.
One click to sign in, or paste either mcp.json block into .cursor/mcp.json.
- 1Click Add to Cursor to sign in, or paste one of the JSON blocks below.
- 2Without a key, sign in when Cursor says Needs login. With a key, replace sk_YOUR_API_KEY and skip that prompt.
- 3Ask Cursor to schedule a post.
This version signs you in. Use it if you don't want to create a key.
{
"mcpServers": {
"socialrobot": {
"url": "https://socialrobot.io/api/mcp"
}
}
}This version uses a key from Scheduler → API Keys. Paste it over sk_YOUR_API_KEY. New keys start with sk_.
{
"mcpServers": {
"socialrobot": {
"url": "https://socialrobot.io/api/mcp",
"headers": {
"Authorization": "Bearer sk_YOUR_API_KEY"
}
}
}
}One click to sign in, or drop either mcp.json block into your workspace.
- 1Click Add to VS Code to sign in, or run MCP: Add Server and paste one of the snippets.
- 2Choose HTTP. URL: https://socialrobot.io/api/mcp. Name: SocialRobot.
- 3MCP: List Servers → SocialRobot → Start Server.
- 4Sign in if you used the first snippet. The API-key snippet skips that.
This version signs you in. Use it if you don't want to create a key.
{
"mcpServers": {
"socialrobot": {
"url": "https://socialrobot.io/api/mcp"
}
}
}This version uses a key from Scheduler → API Keys. Paste it over sk_YOUR_API_KEY. New keys start with sk_.
{
"mcpServers": {
"socialrobot": {
"url": "https://socialrobot.io/api/mcp",
"headers": {
"Authorization": "Bearer sk_YOUR_API_KEY"
}
}
}
}Put one of these in ~/.codeium/windsurf/mcp_config.json. Windsurf wants serverUrl, not url.
- 1Open mcp_config.json and paste either snippet.
- 2Refresh Cascade MCP settings (or restart Windsurf).
- 3Sign in on the first snippet. On the second, replace sk_YOUR_API_KEY first.
This version signs you in. Use it if you don't want to create a key.
{
"mcpServers": {
"socialrobot": {
"serverUrl": "https://socialrobot.io/api/mcp"
}
}
}This version uses a key from Scheduler → API Keys. Paste it over sk_YOUR_API_KEY. New keys start with sk_.
{
"mcpServers": {
"socialrobot": {
"serverUrl": "https://socialrobot.io/api/mcp",
"headers": {
"Authorization": "Bearer sk_YOUR_API_KEY"
}
}
}
}The SocialRobot block goes under context_servers in settings.json. Sign-in or an API key, your pick.
- 1Open Settings → AI → MCP Servers, or edit settings.json.
- 2Paste the first snippet to sign in, or the second and swap in your key.
- 3Sign in if Zed asks, then ask it to schedule a post.
This version signs you in. Use it if you don't want to create a key.
{
"context_servers": {
"socialrobot": {
"url": "https://socialrobot.io/api/mcp"
}
}
}This version uses a key from Scheduler → API Keys. Paste it over sk_YOUR_API_KEY. New keys start with sk_.
{
"context_servers": {
"socialrobot": {
"url": "https://socialrobot.io/api/mcp",
"headers": {
"Authorization": "Bearer sk_YOUR_API_KEY"
}
}
}
}Any app that can add a custom MCP server. Paste one of these into its mcp.json.
- 1Open the client's MCP config. It's usually called mcp.json.
- 2Paste the first block to sign in, or the second and replace sk_YOUR_API_KEY.
- 3Ask it to schedule a post.
This version signs you in. Use it if you don't want to create a key.
{
"mcpServers": {
"socialrobot": {
"url": "https://socialrobot.io/api/mcp"
}
}
}This version uses a key from Scheduler → API Keys. Paste it over sk_YOUR_API_KEY. New keys start with sk_.
{
"mcpServers": {
"socialrobot": {
"url": "https://socialrobot.io/api/mcp",
"headers": {
"Authorization": "Bearer sk_YOUR_API_KEY"
}
}
}
}MCP access is included in your SocialRobot plan. Your AI client may have its own subscription or administrator requirements for custom connectors.
The tools behind your requests
The assistant selects tools from the permissions you grant. Publishing tools work on your connected accounts; network-specific tools appear below where supported.
| MCP tool | What it does |
|---|---|
list_connected_accounts | Find the accounts and IDs available to your SocialRobot user. |
list_projects | Find your projects and IDs before reading their profiles. |
get_plan_usage | Check your plan, posts left this month, accounts left, and whether X is included. |
get_project_profile | Read the project profile and writing guide before drafting. |
get_project_tags | Read the hashtags per network and Threads topics a project uses most. |
get_media_upload_url | Get a presigned URL to upload file bytes, then use the returned media URL in a post. |
upload_media | Import media from a public HTTPS URL or a file shared by ChatGPT (up to 50 MB). |
create_post | Save a private draft, schedule a post, or publish now. |
list_posts | Read your drafts, scheduled posts, and publication status. |
update_post | Replace the content and targets of an unpublished post. Include any media you want to keep. |
reschedule_post | Move an unpublished post to a new future publication time. |
delete_post | Remove a draft or scheduled post from SocialRobot. |
You control the publishing mode: save a draft, schedule for later, or publish now. MCP can schedule or publish without a separate human approval step. Ask explicitly for a draft when you want to review it first.
MCP is included in your plan
No separate MCP add-on. Your connected-account and scheduled-post limits are the same as in the SocialRobot dashboard. Prices below are USD with monthly billing.
$0/monthFree
2 social accounts and 15 scheduled posts per month. MCP included. X is excluded.
$19/monthStarter
5 social accounts and unlimited scheduled posts. MCP included. X is excluded.
$29/monthPro
20 social accounts and unlimited scheduled posts. X included: up to 666 posts a month per X account, or 50 with links. MCP included.
If the first request does not work
Your account is missing
Connect the network in SocialRobot first. Ask the assistant to list your connected accounts, then name the right one in your request. Check that you signed into the same SocialRobot account in both places.
The assistant cannot access a tool
Reconnect the MCP server if OAuth has expired. For API keys, check the Bearer header, whether the key was revoked, and its scopes. Reading posts, publishing, media uploads, and analytics need their corresponding permissions.
A photo or video is rejected
Use the media upload tools or a public HTTPS media URL. Ask the assistant to inspect the validation error. Check the network’s file type, size, and aspect requirements; browser-only media conversions are not performed by an MCP client.
The time or publishing mode is wrong
Give an exact date, time, and timezone. Ask for a private draft to review first, a scheduled post for later, or immediate publishing. Check the result with list_posts. You can reschedule an unpublished post; deleting it in SocialRobot does not recall a post already live on the network.
Bluesky text and media limits still apply. Supply MP4 video for MCP; MOV and WebM conversion happens in the browser composer, not in the MCP client.
Bluesky MCP server questions
Which accounts can I connect?
What can I publish and schedule?
Does this Bluesky MCP server search feeds or follow accounts?
Will it always ask me to approve a post?
One MCP server. Your social networks.
Choose a network for its supported formats, account requirements, example requests, and setup. Every page connects to the same SocialRobot server.
Instagram MCP server
Photos, carousels, Reels, Stories, first comments, and account insights.
Connect InstagramPinterest MCP server
Pin scheduling, board tools, destination links, and top-Pin analytics.
Connect PinterestX MCP server (Twitter)
Text, images, video, and connected threads. Available on Pro.
Connect X (Twitter)LinkedIn MCP server
Personal profiles, Company Pages, documents, polls, and analytics.
Connect LinkedInTikTok MCP server
Videos, photo slideshows, creator settings, and TikTok inbox drafts.
Connect TikTokMastodon MCP server
Instance connection, visibility, content warnings, alt text, and polls.
Connect MastodonMeta Threads MCP server
Text, media, connected threads of up to 20 posts, and insights.
Connect Meta ThreadsFacebook MCP server
Facebook Page publishing, scheduled posts, and Page insights.
Connect FacebookGoogle Business Profile MCP server
Updates, events and offers for each Business Profile location.
Connect Google Business Profile
Start free
Your next post starts here.
Connect your accounts and try it with a real post. Two accounts and fifteen posts a month, free.
Start freeFree plan. No credit card required.
