socialrobot
SocialRobot MCP

Bluesky MCP server

Schedule Bluesky posts from Claude, ChatGPT, or Cursor. Publish text, photos, and video through SocialRobot and manage them in one calendar.
ClaudeChatGPTCursor

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.

What you can do on Bluesky
CapabilitySupported in SocialRobot
AccountsBluesky accounts connected through the SocialRobot account flow.
Post formatsText posts, posts with images, and supported MP4 video.
Network optionsImage alt text and per-network captions when you schedule the same idea on Bluesky and other connected accounts.
AnalyticsRead SocialRobot publication status and scheduled posts. Bluesky engagement analytics are not exposed by the current MCP tools.
Requirements and limitsBluesky 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.
Explore all Bluesky features

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

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

  1. 1Open Customize → Connectors, then + Add → Add custom connector.
  2. 2Name it SocialRobot.
  3. 3URL: https://socialrobot.io/api/mcp
  4. 4Sign in when Claude asks, then try: schedule tomorrow's Instagram post.
terminal
claude mcp add --transport http socialrobot https://socialrobot.io/api/mcp

You need a paid plan. OpenAI keeps renaming this screen (connectors, apps, plugins), but it's still a form, not a coding project.

  1. 1Go to chatgpt.com/plugins → Add → Create MCP App. If that's missing, turn on Developer mode in Settings first.
  2. 2Name it SocialRobot.
  3. 3Server URL: https://socialrobot.io/api/mcp. Authentication: OAuth.
  4. 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.

  1. 1Click Add to Cursor to sign in, or paste one of the JSON blocks below.
  2. 2Without a key, sign in when Cursor says Needs login. With a key, replace sk_YOUR_API_KEY and skip that prompt.
  3. 3Ask Cursor to schedule a post.

This version signs you in. Use it if you don't want to create a key.

mcp.json without API 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_.

mcp.json with API key
{
  "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.

  1. 1Click Add to VS Code to sign in, or run MCP: Add Server and paste one of the snippets.
  2. 2Choose HTTP. URL: https://socialrobot.io/api/mcp. Name: SocialRobot.
  3. 3MCP: List Servers → SocialRobot → Start Server.
  4. 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.

mcp.json without API 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_.

mcp.json with API key
{
  "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.

  1. 1Open mcp_config.json and paste either snippet.
  2. 2Refresh Cascade MCP settings (or restart Windsurf).
  3. 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.

mcp_config.json without API 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_.

mcp_config.json with API key
{
  "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.

  1. 1Open Settings → AI → MCP Servers, or edit settings.json.
  2. 2Paste the first snippet to sign in, or the second and swap in your key.
  3. 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.

settings.json without API 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_.

settings.json with API key
{
  "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.

  1. 1Open the client's MCP config. It's usually called mcp.json.
  2. 2Paste the first block to sign in, or the second and replace sk_YOUR_API_KEY.
  3. 3Ask it to schedule a post.

This version signs you in. Use it if you don't want to create a key.

mcp.json without API 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_.

mcp.json with API key
{
  "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.

The tools behind your requests
MCP toolWhat it does
list_connected_accountsFind the accounts and IDs available to your SocialRobot user.
list_projectsFind your projects and IDs before reading their profiles.
get_plan_usageCheck your plan, posts left this month, accounts left, and whether X is included.
get_project_profileRead the project profile and writing guide before drafting.
get_project_tagsRead the hashtags per network and Threads topics a project uses most.
get_media_upload_urlGet a presigned URL to upload file bytes, then use the returned media URL in a post.
upload_mediaImport media from a public HTTPS URL or a file shared by ChatGPT (up to 50 MB).
create_postSave a private draft, schedule a post, or publish now.
list_postsRead your drafts, scheduled posts, and publication status.
update_postReplace the content and targets of an unpublished post. Include any media you want to keep.
reschedule_postMove an unpublished post to a new future publication time.
delete_postRemove 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/month

Free

2 social accounts and 15 scheduled posts per month. MCP included. X is excluded.

$19/month

Starter

5 social accounts and unlimited scheduled posts. MCP included. X is excluded.

$29/month

Pro

20 social accounts and unlimited scheduled posts. X included: up to 666 posts a month per X account, or 50 with links. MCP included.

Available on Free, Starter, and ProSee full pricing and annual options

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?

Bluesky accounts connected through the SocialRobot account flow.

What can I publish and schedule?

Text posts, posts with images, and supported MP4 video. Image alt text and per-network captions when you schedule the same idea on Bluesky and other connected accounts.

Does this Bluesky MCP server search feeds or follow accounts?

SocialRobot’s current MCP tools schedule and publish your own posts and manage drafts. They do not expose public-feed search, automated follows, likes, or Bluesky engagement analytics.

Will it always ask me to approve a post?

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.

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 free

Free plan. No credit card required.