Mallary

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, 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.

Supported destinations
- X
- Facebook
- Instagram
- LinkedIn
- YouTube
- TikTok
- Pinterest
- Reddit
- Threads
- Snapchat

Canonical links
- Main site: https://mallary.ai/
- Social media posting API: https://mallary.ai/social-media-posting-api
- Social media scheduling API: https://mallary.ai/social-media-scheduling-api
- 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
- MCP docs: https://docs.mallary.ai/home/mcp
- CLI docs: https://docs.mallary.ai/home/cli
- 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
- 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
- GET /api/v1/jobs/{id}
- GET /api/v1/posts
- DELETE /api/v1/posts/{id}
- GET /api/v1/analytics
- 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_list_posts
- mallary_delete_post
- mallary_get_analytics
- mallary_disconnect_platform
- mallary_list_webhooks
- mallary_create_webhook
- mallary_delete_webhook

CLI scope
- Upload local media
- Create and schedule posts
- Inspect jobs and grouped posts
- Fetch analytics
- 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
- Use API key auth: Authorization: Bearer {api_key}
- CLI uses the same API key via MALLARY_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

Plan and feature summary
- Paid plans include a 14-day free trial and 30-day money-back guarantee. No commitment. Cancel anytime.
- Starter: 120 posts/month, scheduling, analytics, MCP, and CLI.
- Pro: unlimited posts, scheduling, analytics, AI auto replies, MCP, and CLI.
- Business: unlimited posts, all features, dedicated support.
- For exact prices and billing cadence, use 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.