Authenticate with WriteFreely and obtain an access token.

    If WRITEFREELY_ACCESS_TOKEN environment variable is set, this tool will use
    that token automatically without requiring username and password.
    You can provide username and password to authenticate with a different
    account, or use the environment variable for better security
    (recommended for production).

    Args:
        username: Your WriteFreely username
            (optional if WRITEFREELY_ACCESS_TOKEN is set)
        password: Your WriteFreely password
            (optional if WRITEFREELY_ACCESS_TOKEN is set)

    Returns:
        Success message with access token, or information about existing token
    

    Create and publish a new post on WriteFreely.
    Supports anonymous posts or publishing to a specific collection/blog.

    Args:
        content:     The main body of the post (Markdown supported)
        title:       Optional post title
        access_token: Access token from login() or WRITEFREELY_ACCESS_TOKEN env var
                     Leave empty for anonymous publishing or to use env var token
        collection:  Optional blog/collection alias to publish into
                     (only works with access_token)

    Returns:
        Success message with post URL or error
    

    Update an existing post's content and/or title.

    Args:
        post_id: The ID of the post to update
        content: The new body content for the post (Markdown supported)
        title: Optional new title (leave None to keep existing title)
        access_token: Access token from login() or WRITEFREELY_ACCESS_TOKEN env var
                     (optional if token is set via env var)
        edit_token: Edit token for anonymous posts (from publish_post response)

    Returns:
        Success message with updated post URL or error
    

    Permanently delete a post.

    Args:
        post_id: The ID of the post to delete
        access_token: Access token from login() or WRITEFREELY_ACCESS_TOKEN env var
                     (optional if token is set via env var)
        edit_token: Edit token for anonymous posts (from publish_post response)

    Returns:
        Success or error message
    

    Retrieve the content of an existing post by its ID.

    Args:
        post_id: The ID of the post (or slug for public posts)
        access_token: Optional - needed only for private/draft posts
                     Can also use WRITEFREELY_ACCESS_TOKEN env var

    Returns:
        Post title + body (or error message)
    

    Retrieve all posts for the authenticated user.

    Args:
        access_token: Access token from login() or WRITEFREELY_ACCESS_TOKEN env var
                     (optional if token is set via env var)

    Returns:
        Formatted list of all user's posts with IDs, titles, and URLs
    

    Get all blogs/collections owned by the authenticated user.

    Args:
        access_token: Access token from login() or WRITEFREELY_ACCESS_TOKEN env var
                     (optional if token is set via env var)

    Returns:
        Formatted list of all user's collections with aliases, titles, and URLs
    

    List posts in a specific collection/blog.

    Args:
        collection_alias: The alias/name of the collection to browse
        page: Page number for pagination (default: 1, returns 10 posts per page)

    Returns:
        Formatted list of posts in the collection
    

    Read posts from the public read.write.as feed.

    Args:
        skip: Number of posts to skip for pagination
            (default: 0, returns 10 posts per request)

    Returns:
        Formatted list of posts from the public feed