Seqular Blog Tools - Comprehensive Usage Guide (Page 4)

seqular_toot_write - Posting to Mastodon

seqular_toot_write tool posts status updates (toots) to the Mastodon social network with optional media attachment.

Basic Usage

Post a simple toot:

seqular_toot_write(status="Hello from MCP!")

Visibility Settings

Public (Default)

seqular_toot_write(status="Public message", visibility="public")

Unlisted

seqular_toot_write(status="Unlisted message", visibility="unlisted")

Private

seqular_toot_write(status="Private note", visibility="private")

Direct

seqular_toot_write(status="Direct message", visibility="direct")

Content Warning

Add a content warning:

seqular_toot_write(
    status="Sensitive content",
    spoiler_text="Warning"
)

Language Code

Set the language code (ISO 639-1):

seqular_toot_write(
    status="Merhaba!",
    language="tr"
)

seqular_toot_write(
    status="Hello!",
    language="en"
)

Media Attachment

Media Upload Workflow:

1. First upload a file using /api/upload endpoint
2. Get the file_path from the upload response
3. Use seqular_toot_write with the file_path to attach media

# Step 1: Upload file (using x_web_upload)
# Step 2: Post toot with media
seqular_toot_write(
    status="Check out this photo!",
    media_file="uploads/abc123.jpg"
)

Important Notes

• Maximum status length: 500 characters
• Visibility options: public, unlisted, private, direct
• Language code: 2 characters (ISO 639-1, e.g., 'en', 'tr', 'de')
• Media types: images (jpg, png, gif, webp), videos (mp4, webm), audio (mp3, wav)
• Maximum media file size: 50MB
• Media upload: Must use /api/upload endpoint first

Error Handling

The tool provides detailed error messages for various scenarios:

• 422: Unprocessable Entity (unsupported format, codec issue, file size limit)
• 429: Rate Limit Exceeded
• 500: Server Error
• 502: Server Unreachable
• 503: Service Unavailable
• 401: Authentication Failed
• 403: Access Denied
• 404: Resource Not Found

Each error includes suggestions and retry information.

Conclusion

Seqular blog tools provide a comprehensive solution for managing blog content. In this guide, we covered 6 tools:

1. seqular_blog_write - Publish blog posts with auto-pagination
2. seqular_blog_read - Read blog posts with line-based and page selection
3. seqular_blog_edit - Edit blog posts with 4 modes
4. seqular_blog_list_posts - List and filter blog posts
5. seqular_blog_list_authors - List authors with Mastodon profiles
6. seqular_blog_search - Full-text search in blog content
7. seqular_toot_write - Post toots to Mastodon

We examined each tool's features, use cases, and practical examples. These tools simplify and automate blog management.

What We Learned

• Automation: Auto-pagination and slug generation
• Filtering: Advanced filtering capabilities
• Search: Full-text search with highlighting
• Integration: Mastodon profiles and social media
• Security: OAuth2-based authentication

Next Steps

• Use these tools in your own projects
• Try different scenarios
• Create automation scripts
• Manage your blog content

Thank you for reading!