bluesky-post

name: bluesky-post description: Post to Bluesky with rich text facets, images, videos, and alt text support via your social MCP

Bluesky Post

Create and schedule posts to Bluesky using the your social MCP server. Supports text posts with auto-detected hashtags and URLs, images with alt text, and videos.

Prerequisites

Plans: Free Starter (15 posts/month), Pro, Premium

Getting Started

1. Create account at your-publisher.example/register (free)
2. Generate app password in Bluesky Settings > App Passwords (NOT your main password)
3. Connect Bluesky in SocialPublisher Dashboard using your handle + app password
4. Get API key at your-publisher.example/settings/api
5. Configure MCP in Claude Desktop (~/.claude/claude_desktop_config.json):

{
  "mcpServers": {
    "social-poster": {
      "type": "http",
      "url": "https://mcp.your-publisher.example",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

REST API Fallback

If the MCP server is unavailable or returns errors, use the REST API directly:

Base URL: https://api.your-publisher.example/api/v1

Authentication: Use x-social-poster-key header (NOT Authorization: Bearer):

# Get your connected platforms
curl -X GET "https://api.your-publisher.example/api/v1/platform-connections" \
  -H "x-social-poster-key: sk_your_api_key"

# Create a post
curl -X POST "https://api.your-publisher.example/api/v1/create-post" \
  -H "x-social-poster-key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "platforms": ["bluesky-did:plc:abc123xyz"],
    "content": "Your post content here",
    "scheduledTime": "2026-03-25T10:00:00Z"
  }'

Platform ID Format: bluesky-{did} where {did} is from /platform-connections response.

Example IDs: bluesky-did:plc:abc123xyz, bluesky-did:plc:def456uvw

📖 Full API documentation: docs.your-publisher.example

Plan Limits

Platform Limits

Video Size Tiers

Rich Text Facets

Bluesky uses a unique rich text system. SocialPublisher handles the complexity automatically:

• Hashtags: #hashtag auto-detected and made clickable
• URLs: Any URL auto-detected and made clickable
• Byte offsets: Calculated correctly for multi-byte characters (emojis, CJK)

No special formatting needed - just write naturally.

Available Tools

create_post

Create a new Bluesky post.

Parameters:

• platforms: Array with your Bluesky connection ID (e.g., ["bluesky-did:plc:abc123xyz"])
• content: Post text (up to 300 characters)
• scheduledTime: ISO 8601 datetime (required - for immediate posting, use current time + 1 minute)
• altTexts: Array of alt text for images (optional)

get_upload_url

Get presigned URL for media uploads.

Parameters:

• postGroupId: Post ID to attach media to
• fileName: File name (e.g., "photo.jpg")
• contentType: image/jpeg, image/png, video/mp4
• type: "image" or "video"

list_posts / update_post / delete_post

Manage scheduled and draft posts.

Examples

Simple Post with Hashtags

Post this to Bluesky:
"Just launched our new API documentation! Check it out at https://docs.example.com #devtools #api"

Hashtags and URLs are automatically made clickable.

Post with Image and Alt Text

Post this to Bluesky with a dashboard screenshot:
"Our new analytics view is live! #buildinpublic"

Alt text: "Screenshot of analytics dashboard showing user growth charts"

Multiple Images

Create a Bluesky post with before/after comparison images:
"Office renovation complete! What a transformation."

Note: Up to 4 images allowed per post.

Video Post

Post this 60-second demo video to Bluesky:
"Quick tour of our new mobile app features"

Scheduled Post

Schedule this for tomorrow at 10 AM:
"Good morning! Here's your daily productivity tip..."

Important Restrictions

1. App password required: You must use a Bluesky app password, NOT your main account password. Generate one at Settings > App Passwords.

2. All images converted to JPEG: Regardless of input format (PNG, WebP, GIF), all images are converted to JPEG before upload.

3. ~1 MB image limit: The AT Protocol enforces a strict ~1 MB limit. Compress images to 80-85% JPEG quality.

4. DID-based platform ID: Unlike other platforms using numeric IDs, Bluesky uses did:plc:xxx format.

5. Email verification for video: You must verify your email in Bluesky before uploading videos.

6. 25 video daily limit: Maximum 25 videos OR 10 GB per day.

Best Practices

Content

1. Concise posts: 300 chars is shorter than Twitter - be punchy
2. Natural hashtags: 1-2 relevant hashtags work well
3. Alt text: Always add alt text for accessibility
4. URLs work: Links are clickable (unlike some platforms)

Timing

• Growing platform: Less crowded than X, easier to get noticed
• Tech-savvy audience: Developer and early-adopter heavy
• Frequency: 1-3 posts per day

Engagement

• Bluesky favors authentic conversation
• Reply to comments to build community
• Follow relevant users to grow network

Troubleshooting