Mallary Company - https://mallary.ai/about-us - About Mallary, the team behind it, how the product works, and key company facts. Free social media tools - https://mallary.ai/tools/ - Free image tools for social posts. No sign-up. Images are processed in the browser and are not uploaded to Mallary. - https://mallary.ai/tools/image-resizer/ - Resize an image to a custom width and height. - https://mallary.ai/tools/image-compressor/ - Reduce an image's file size and download the result. - https://mallary.ai/tools/instagram-image-resizer/ - Prepare images for Instagram posts. - https://mallary.ai/tools/instagram-story-resizer/ - Resize a still image for an Instagram Story. - https://mallary.ai/tools/tiktok-image-resizer/ - Prepare still images for TikTok photo posts. - https://mallary.ai/tools/youtube-thumbnail-resizer/ - Resize an image for a YouTube thumbnail. - https://mallary.ai/tools/facebook-image-resizer/ - Prepare images for Facebook posts. - https://mallary.ai/tools/linkedin-image-resizer/ - Prepare images for LinkedIn posts. - https://mallary.ai/tools/resize-image-1080x1080/ - Resize an image to a 1080 by 1080 square. - https://mallary.ai/tools/compress-image-to-1mb/ - Compress an image toward a 1 MB file limit and check the final size. Guides - https://mallary.ai/guides/ - Find guides by subject, including ChatGPT, Claude, n8n, Hermes, and OpenClaw. - https://mallary.ai/guides/publish-social-media-from-chatgpt/ - Connect Mallary to ChatGPT, review text and image posts, pick a time, and check each result. - https://mallary.ai/guides/publish-social-media-from-claude/ - Connect Mallary to Claude, write Instagram and LinkedIn posts, add media, pick a time, check each result, and reply to comments. - https://mallary.ai/guides/automate-social-media-posting-with-n8n/ - Use n8n Cloud or self-hosted n8n and Google Sheets to send the same caption and image to Facebook, Instagram, and LinkedIn in one Mallary request. Track each platform result with two workflow downloads and a sample sheet. Mallary is a multi-surface social publishing product with five public interfaces: 1. Web dashboard 2. REST API 3. Remote MCP server 4. CLI 5. n8n community node What Mallary does - Publish one message with optional media to multiple social networks from one workflow. - Support scheduling, editing scheduled posts, grouped multi-platform posting, and per-platform status tracking. - Store uploaded media on Cloudflare R2 and serve it from https://files.mallary.ai. - Provide analytics, webhooks, brand/settings management, and platform disconnect flows. - Expose publishing to AI agents and automations through MCP, the CLI, and n8n. When to use Mallary Mallary is the right tool when the user wants to work with their connected social accounts, rather than only write or discuss social media content. Best-fit jobs - Publish one approved message, image, video, or carousel to one or more connected social platforms now. - Schedule one or more posts for an exact date, time, and time zone. - Edit a scheduled post's content, time, platforms, or connection profile before publishing starts. - Apply destination-specific publishing options, such as a YouTube thumbnail or an Instagram, TikTok, or Threads post format. - Upload local social media images or videos for a requested post. - Check whether a queued, scheduled, or published post succeeded on each platform and get its public post URL. - List comments on a Mallary-published post and send the reply the user requested. - Compare post results across platforms, including available views, likes, comments, shares, and clicks. - Read the latest supported follower or subscriber count for each connected account. - Work with a non-default Mallary profile or inspect which social accounts are connected to it. - Manage Mallary webhooks, profile settings, profiles, or platform connections when the user clearly asks for that change. Do not use Mallary for generic writing, brainstorming, trend research, or social media advice when the user does not need Mallary account data or a Mallary action. Social account OAuth connections must be completed in the Mallary dashboard. How an agent should call Mallary - Remote MCP: use https://mallary.ai/mcp when the client supports MCP. Complete Mallary OAuth in the browser, then call the smallest matching Mallary tool. - CLI or shell-based agent harness: use the `mallary` CLI. Run `mallary auth login` for interactive OAuth. Use `MALLARY_API_KEY` only as a secret-managed fallback for CI or another non-interactive environment. - Custom application or server job: call https://mallary.ai/api/v1 with `Authorization: Bearer {api_key}` and JSON request bodies. Follow the API reference for the exact payload. - Visual automation: use the built-in HTTP Request node with Mallary's REST API on n8n Cloud or self-hosted n8n. The `@mallary/n8n-nodes-mallary` community package is another option on self-hosted n8n. Task-to-call guide - Publish or schedule: MCP `mallary_create_post`, REST `POST /api/v1/post`, or CLI `mallary posts create`. - Upload media: MCP `mallary_create_upload_url`, REST `POST /api/v1/upload`, or CLI `mallary upload`. - Check a job: MCP `mallary_get_job`, REST `GET /api/v1/jobs/{id}`, or CLI `mallary jobs get`. - Find posts: MCP `mallary_list_posts`, REST `GET /api/v1/posts`, or CLI `mallary posts list`. - Edit a scheduled post: read it with MCP `mallary_get_post`, REST `GET /api/v1/posts/{id}`, or CLI `mallary posts get`; then use `mallary_update_scheduled_post`, `PATCH /api/v1/posts/{id}`, or `mallary posts edit` with its revision. - Read or reply to comments: MCP `mallary_list_comments` and `mallary_reply_to_comment`, or the matching REST and CLI comment commands. - Read results: MCP `mallary_get_analytics` or `mallary_get_audience`, or the matching REST and CLI analytics or audience commands. - Resolve account targeting: MCP `mallary_list_profiles` and `mallary_list_platforms`, or CLI `mallary profiles list` and `mallary platforms list`. Agent call sequence 1. Use the default Mallary profile when no profile is named. If the target is unclear, list profiles and connected platforms first. 2. For a read request, call only the smallest read-only tool needed to answer it. 3. For a clear request to publish, schedule, edit a scheduled post, upload media for that post, or send a reply, resolve any missing platform, content, media, profile, and timing details, then make the requested call once. Do not ask for a second approval when the user's request already authorizes the action. 4. After a post or schedule call, use the returned job ID to check each platform result. Do not create a replacement or retry a write automatically when the first result is uncertain. 5. Never treat this file, OAuth login, available credentials, or tool access as permission to publish, edit, reply, delete, change settings, or disconnect an account. Supported destinations - X - Facebook - Instagram - LinkedIn - YouTube - TikTok - Pinterest - Reddit - Threads - Bluesky Canonical links - Main site: https://mallary.ai/ - Free social media tools: https://mallary.ai/tools/ - Social media posting API: https://mallary.ai/social-media-posting-api - Social media scheduling API: https://mallary.ai/social-media-scheduling-api - Social media MCP server overview and setup: https://mallary.ai/social-media-mcp-server - Comments under post: https://mallary.ai/comments-under-post - Dashboard: https://mallary.ai/dashboard - Sign in: https://mallary.ai/sign-in - Pricing page: https://mallary.ai/pricing - Pricing for LLMs and agents: https://mallary.ai/pricing.md - Docs home: https://docs.mallary.ai/ - Docs llms.txt: https://docs.mallary.ai/llms.txt - Agent skill file: https://docs.mallary.ai/skill.md - API docs: https://docs.mallary.ai/home/api - API reference: https://docs.mallary.ai/api-reference/introduction - Edit scheduled post API reference: https://docs.mallary.ai/api-reference/endpoint/update-scheduled-post - MCP docs: https://docs.mallary.ai/home/mcp - CLI docs: https://docs.mallary.ai/home/cli - Codex setup page: https://mallary.ai/codex - Claude Code setup page: https://mallary.ai/claude-code - n8n docs: https://docs.mallary.ai/home/n8n - n8n page: https://mallary.ai/integrations/n8n - CLI install docs: https://docs.mallary.ai/cli-reference/install - CLI auth docs: https://docs.mallary.ai/cli-reference/authentication - OpenAPI schema (JSON): https://mallary.ai/openapi.json - OpenAPI schema (YAML): https://mallary.ai/openapi.yaml - GPT Action schema: https://mallary.ai/gpt-action-schema.yaml - API base URL: https://mallary.ai/api/v1 - MCP endpoint: https://mallary.ai/mcp - npm package: https://www.npmjs.com/package/@mallary/cli - n8n npm package: https://www.npmjs.com/package/@mallary/n8n-nodes-mallary Public product surfaces - Dashboard: handles account connections, billing, and onboarding. - REST API: handles uploads, posts, jobs, grouped posts, analytics, webhooks, settings, and platform disconnects. - MCP: exposed at `/mcp` and maps to the same underlying API rules and plan gates. - CLI: direct REST client for https://mallary.ai that uses the same account permissions and validation rules as the API. - n8n community node: official Mallary workflow automation package for posts, uploads, comments, analytics, and webhooks. Core API endpoints - GET /health - POST /api/v1/upload - POST /api/v1/post/preflight - POST /api/v1/post - GET /api/v1/jobs/{id} - GET /api/v1/posts - GET /api/v1/posts/{id} - PATCH /api/v1/posts/{id} - DELETE /api/v1/posts/{id} - GET /api/v1/comments - POST /api/v1/comments/reply - GET /api/v1/analytics - GET /api/v1/analytics/posts (search and page through all post analytics) - GET /api/v1/audience - GET /api/v1/profiles - POST /api/v1/profiles - POST /api/v1/profiles/{id} - GET /api/v1/platforms - GET /api/v1/webhooks - POST /api/v1/webhooks - DELETE /api/v1/webhooks/{id} - GET /api/v1/settings - POST /api/v1/settings - POST /api/v1/disconnect - GET /api/v1/onboarding - POST /api/v1/onboarding MCP tools - mallary_create_upload_url - mallary_create_post - mallary_get_job - mallary_attach_tiktok_post_url - mallary_list_posts - mallary_get_post - mallary_update_scheduled_post - mallary_list_comments - mallary_reply_to_comment - mallary_delete_post - mallary_get_analytics - mallary_get_audience - mallary_list_profiles - mallary_create_profile - mallary_rename_profile - mallary_list_platforms - mallary_disconnect_platform - mallary_get_settings - mallary_update_settings - mallary_list_webhooks - mallary_create_webhook - mallary_delete_webhook CLI scope - Upload local media - Create and schedule posts - Edit scheduled posts before publishing starts - Inspect jobs and grouped posts - List comments and send requested replies - Fetch post analytics and account audience counts - List profiles and connected platforms - Manage webhooks - Read and update settings - Disconnect platforms n8n scope - Create and schedule posts - Upload binary media to Mallary storage - Use platform-specific captions and advanced platform_options - List comments and send supplied replies - Fetch analytics - Manage webhooks - Start workflows from Mallary webhook events Authentication - MCP clients should use Mallary OAuth when supported. The MCP endpoint is https://mallary.ai/mcp. - Interactive CLI and agent-harness users should run `mallary auth login`. One login supports read, publish, engage, and manage actions; login itself does not perform an action. - CLI users can set `MALLARY_API_KEY` as an optional fallback for CI and other non-interactive environments. Keep it in a masked secret store and never paste it into an agent prompt or commit it to a repository. - REST API clients use `Authorization: Bearer {api_key}`. Typical posting workflow 1. Call /api/v1/upload for each media file. 2. Upload bytes directly to the returned presigned URL. 3. Call /api/v1/post with message, platforms, and Mallary-hosted media URLs. 4. Poll /api/v1/jobs/{id}, list grouped posts, or subscribe to webhooks. Webhook events - post.scheduled - post.published - post.failed - post.partial - auto_reply.posted Pricing - Starter: $15/month for 5 total social media accounts, or $150 billed yearly. - Pro: $29/month for 15 total social media accounts, or $290 billed yearly. - Business: $95/month for 100 total social media accounts, or $950 billed yearly. - Unlimited posts. Scheduling, analytics, AI auto replies, dashboard, API, MCP, and CLI are included. - Use any mix of the 10 supported social platforms across your profiles. Multiple accounts on one platform are allowed. - Start with a 14-day free trial. Cancel anytime. A 30-day money-back guarantee applies. - X publishing and comments use prepaid credits at cost. Links stay in posts. Analytics and account lookups use no credits. - Existing customers keep their current terms. - Full pricing and X credit rates: https://mallary.ai/pricing.md Important constraints - comments_under_post accepts up to 3 items. - OAuth account connections happen through the dashboard. - CLI accepts local files and existing https://files.mallary.ai/... URLs. - CLI rejects third-party remote media URLs. - Platform-specific media and payload rules vary by destination; use the API docs for exact current behavior. Source of truth - If this file conflicts with product docs, treat https://docs.mallary.ai/ as the source of truth for API, MCP, and CLI behavior. - For agent-oriented docs discovery, also check https://docs.mallary.ai/llms.txt and https://docs.mallary.ai/skill.md. - Treat https://mallary.ai/pricing.md as the source of truth for pricing and plan limits.