Bluesky Social MCP

Instructions

Implementation Reference

• server.py:806-864 (handler)

  The main handler function for the 'send_image' tool. Decorated with @mcp.tool(), it decodes base64-encoded image data, constructs a Bluesky post with the image and optional parameters, sends it via the authenticated Bluesky client, and returns the post URI/CID on success or an error message.
  @mcp.tool() def send_image( ctx: Context, text: str, image_data: str, image_alt: str, profile_identify: Optional[str] = None, reply_to: Optional[Dict[str, Any]] = None, langs: Optional[List[str]] = None, facets: Optional[List[Dict[str, Any]]] = None, ) -> Dict: """Send a post with a single image. Args: ctx: MCP context text: Text content of the post image_data: Base64-encoded image data image_alt: Alternative text description for the image profile_identify: Optional handle or DID for the post author reply_to: Optional reply information dict with keys uri and cid langs: Optional list of language codes facets: Optional list of facets (mentions, links, etc.) Returns: Status of the post creation """ try: bluesky_client = get_authenticated_client(ctx) # Decode base64 image try: image_bytes = base64.b64decode(image_data) except Exception as e: return { "status": "error", "message": f"Failed to decode image data: {str(e)}", } # Send the post with image post_response = bluesky_client.send_image( text=text, image=image_bytes, image_alt=image_alt, profile_identify=profile_identify, reply_to=reply_to, langs=langs, facets=facets, ) return { "status": "success", "message": "Post with image created successfully", "post_uri": post_response.uri, "post_cid": post_response.cid, } except Exception as e: error_msg = f"Failed to create post with image: {str(e)}" return {"status": "error", "message": error_msg}