postifys-mcp
This MCP server lets agents use the Postifys production API to discover accounts, prepare media, publish social posts, and manage Content Queue scheduling.
Test the API key and list connected social accounts, Pinterest boards, and TikTok creator info.
Upload media from source URLs (including Drive/Dropbox) to get a Postifys
serve_url, then poll media job status.Publish asynchronously to Facebook, Instagram, YouTube, Pinterest, LinkedIn, and TikTok, with platform-specific options and idempotent retries.
Check async post status, list post history, and retry posts.
Operate the Postifys Content Queue: overview, list/create tables, list/create/update jobs, run jobs now, and list/add/import rows.
Configure server URL, timeout, and retry behavior via environment variables; safe requests retry on 429/5xx/network errors.
Allows publishing posts to Facebook through the Postifys MCP server.
Allows publishing content such as Reels to Instagram through the Postifys MCP server.
Allows publishing image Pins to Pinterest, including listing Pinterest boards and requiring a boardId for publishing.
Allows publishing content to TikTok, with support for creator info and noting that posts may land in the creator inbox or require approval for Direct Post.
Allows publishing videos to YouTube through the Postifys MCP server.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@postifys-mcp Upload this MP4 to Postifys media and publish it as a Reel on Instagram."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
postifys-mcp
Official Model Context Protocol server for Postifys. Agents call the production Postifys API with your API key — the same surface as the n8n community node.
The package is free. Publishing still requires a Postifys entitlement (trial or paid seat).
What's new in 0.2.0
New tools:
postifys_list_post_historyandpostifys_retry_post.accountIdis optional (Postifys uses your default account per platform).Default
typenow matches the API docs: FacebookIMAGEwith media /FEEDwithout; InstagramIMAGE(passREELfor video).Automatic retries with backoff for 429/5xx; publishes always send an
Idempotency-Keyso retries never double-post.Configurable
POSTIFYS_TIMEOUT_MS,POSTIFYS_MAX_RETRIES,POSTIFYS_RETRY_BASE_MS.Handles a missing
postIdsafely; server version read from package.json.
Related MCP server: Postiz MCP Server
Cursor plugin (Marketplace)
This repo is also a Cursor plugin named postifys:
.cursor-plugin/plugin.json: manifest. Declares one variable,POSTIFYS_API_KEY, which is required.mcp.json: starts the server withnpx -y postifys-mcp@latestand passesPOSTIFYS_API_KEYin.skills/postifys/SKILL.md: tells the agent how to publish with these tools.assets/logo.png: the plugin logo.
To set it up:
Install Postifys from the Cursor Marketplace.
Open Plugins → Postifys → Configure.
Paste your API key (from Postifys → Settings → API keys).
The plugin always talks to https://postifys.com. To point it at another server, or to change the timeout or retry settings, use the manual MCP config below with the environment variables listed under Env.
Install (Cursor)
Create an API key in Postifys → Settings (scopes:
connections,media,publish,status).Add to Cursor MCP settings (or merge cursor.mcp.example.json):
{
"mcpServers": {
"postifys": {
"command": "npx",
"args": ["-y", "postifys-mcp"],
"env": {
"POSTIFYS_API_KEY": "pfs_...",
"POSTIFYS_SERVER_URL": "https://postifys.com"
}
}
}
}Claude Desktop
{
"mcpServers": {
"postifys": {
"command": "npx",
"args": ["-y", "postifys-mcp"],
"env": {
"POSTIFYS_API_KEY": "pfs_..."
}
}
}
}Env
Variable | Required | Default |
| yes | — |
| no |
|
| no |
|
| no |
|
| no |
|
Retries apply to 429/5xx/network errors on safe requests only. postifys_publish always sends an Idempotency-Key (auto-generated unless you pass idempotencyKey), so a retried publish is not duplicated. Other non-idempotent calls (media upload, retry post) are never auto-retried.
Tools
Discovery: postifys_ping, postifys_list_connections, postifys_list_pinterest_boards, postifys_tiktok_creator_info
Media: postifys_media_upload (queues + polls for serve_url), postifys_media_status
Publish: postifys_publish (Facebook, Instagram, YouTube, Pinterest, LinkedIn, TikTok; async by default), postifys_get_post_status, postifys_list_post_history, postifys_retry_post
accountId is optional: when omitted, Postifys uses your default/first connected account for that platform (Pinterest still needs boardId). Default type: Facebook IMAGE with media / FEED without; Instagram IMAGE. Pass REEL for video.
Content Queue: postifys_cq_overview, postifys_cq_list_tables, postifys_cq_create_table, postifys_cq_list_jobs, postifys_cq_create_or_update_job, postifys_cq_run_job_now, postifys_cq_list_items, postifys_cq_add_item, postifys_cq_import_rows
Honest limits
TikTok may land in the creator inbox; Direct Post needs approval, consent, and music confirmation.
LinkedIn: member profiles only (no Company Pages).
Pinterest: image Pins;
boardIdrequired.Prefer media upload →
serve_url→ publish. Do not pass raw Drive/Dropbox URLs to publish.Content Queue job intervals are at least 15 minutes on production.
Sample prompts
“List my Instagram connections, upload this Drive MP4 via Postifys media, then publish a Reel.”
“Create a Content Queue table named smoke-mcp and add one pending row (do not run the job).”
Local develop
npm install
npm run build
POSTIFYS_API_KEY=pfs_... npm start
POSTIFYS_API_KEY=pfs_... npm run smoke
npm run test:mcp # offline tests against a local mock API
POSTIFYS_API_KEY=pfs_... npm run test:live # full stdio run against productionLinks
Product page: https://postifys.com/mcp
API docs: https://postifys.com/api-docs
n8n node: https://postifys.com/n8n
License
MIT
Available Tools
17 toolspostifys_cq_add_itemB
Native Postifys Content Queue (scheduler without n8n). Requires CONTENT_QUEUE_ENABLED on the server and publish entitlement. Add a pending row. path may be a Drive share URL (resolved at publish time).
Inputs: path (required), title (required), tableId (required), status, +3 more.
postifys_cq_create_or_update_jobA
Native Postifys Content Queue (scheduler without n8n). Requires CONTENT_QUEUE_ENABLED on the server and publish entitlement. Create a job (omit jobId) or update (pass jobId). Interval must be ≥ 15 minutes. Keep schedule.enabled false until destinations are ready.
Inputs: name, jobId, defaults, schedule, +3 more.
postifys_cq_create_tableB
Native Postifys Content Queue (scheduler without n8n). Requires CONTENT_QUEUE_ENABLED on the server and publish entitlement. Create a data table for queue rows.
Inputs: name (required).
postifys_cq_import_rowsA
Native Postifys Content Queue (scheduler without n8n). Requires CONTENT_QUEUE_ENABLED on the server and publish entitlement. Bulk-import pending rows into a table (JSON rows, not multipart CSV).
Inputs: rows (required), tableId (required).
postifys_cq_list_itemsB
Native Postifys Content Queue (scheduler without n8n). Requires CONTENT_QUEUE_ENABLED on the server and publish entitlement. List rows in a data table.
Inputs: tableId (required), limit, status.
postifys_cq_list_jobsA
Native Postifys Content Queue (scheduler without n8n). Requires CONTENT_QUEUE_ENABLED on the server and publish entitlement. List publishing jobs (one job per table).
Inputs: no named parameters.
postifys_cq_list_tablesA
Native Postifys Content Queue (scheduler without n8n). Requires CONTENT_QUEUE_ENABLED on the server and publish entitlement. List data tables.
Inputs: no named parameters.
postifys_cq_overviewB
Native Postifys Content Queue (scheduler without n8n). Requires CONTENT_QUEUE_ENABLED on the server and publish entitlement. Returns tables, jobs, and next-run hints. TikTok may post to the creator inbox unless Direct Post is approved; Direct Post requires privacy from creator_info, consent, and music usage confirmation. LinkedIn supports member profiles only (no Company Pages). Pinterest supports image Pins; boardId is required. Video Pins are not claimed. Prefer Media upload → serve_url → Publish. Do not pass raw Google Drive or Dropbox URLs directly to publish tools. Publishing requires an entitled Postifys account ($4 for the first seat, then $2 per extra seat per month after trial). The MCP package itself is free.
Inputs: no named parameters.
postifys_cq_run_job_nowA
Native Postifys Content Queue (scheduler without n8n). Requires CONTENT_QUEUE_ENABLED on the server and publish entitlement. Trigger the next eligible pending row for a job immediately.
Inputs: jobId (required).
postifys_get_post_statusB
Poll async publish status by postId until published/failed/partial.
Inputs: postId (required), platform.
postifys_list_connectionsA
List connected social accounts for publishing. Use returned id fields as account targets (pageId, instagramAccountId, channelId, etc.). Filter with platform when helpful. TikTok may post to the creator inbox unless Direct Post is approved; Direct Post requires privacy from creator_info, consent, and music usage confirmation. LinkedIn supports member profiles only (no Company Pages). Pinterest supports image Pins; boardId is required. Video Pins are not claimed. Prefer Media upload → serve_url → Publish. Do not pass raw Google Drive or Dropbox URLs directly to publish tools. Publishing requires an entitled Postifys account ($4 for the first seat, then $2 per extra seat per month after trial). The MCP package itself is free.
Inputs: platform.
postifys_list_pinterest_boardsA
List Pinterest boards for a connected Pinterest account. boardId is required when publishing image Pins.
Inputs: pinterestUserId (required).
postifys_media_statusB
Poll a Postifys media job by mediaJobId.
Inputs: mediaJobId (required).
postifys_media_uploadA
Queue a source URL for download/proxy on Postifys and poll until a public serve_url is ready. Use this before publish for Google Drive, Dropbox, or any non-CDN URL. TikTok may post to the creator inbox unless Direct Post is approved; Direct Post requires privacy from creator_info, consent, and music usage confirmation. LinkedIn supports member profiles only (no Company Pages). Pinterest supports image Pins; boardId is required. Video Pins are not claimed. Prefer Media upload → serve_url → Publish. Do not pass raw Google Drive or Dropbox URLs directly to publish tools. Publishing requires an entitled Postifys account ($4 for the first seat, then $2 per extra seat per month after trial). The MCP package itself is free.
Inputs: url (required), type, waitMs, filename.
postifys_pingB
Test the Postifys API key against the configured server. TikTok may post to the creator inbox unless Direct Post is approved; Direct Post requires privacy from creator_info, consent, and music usage confirmation. LinkedIn supports member profiles only (no Company Pages). Pinterest supports image Pins; boardId is required. Video Pins are not claimed. Prefer Media upload → serve_url → Publish. Do not pass raw Google Drive or Dropbox URLs directly to publish tools. Publishing requires an entitled Postifys account ($4 for the first seat, then $2 per extra seat per month after trial). The MCP package itself is free.
Inputs: no named parameters.
postifys_publishA
Publish asynchronously to one platform. Always returns a postId to poll with postifys_get_post_status. Prefer Postifys serve_url media. TikTok may post to the creator inbox unless Direct Post is approved; Direct Post requires privacy from creator_info, consent, and music usage confirmation. LinkedIn supports member profiles only (no Company Pages). Pinterest supports image Pins; boardId is required. Video Pins are not claimed. Prefer Media upload → serve_url → Publish. Do not pass raw Google Drive or Dropbox URLs directly to publish tools. Publishing requires an entitled Postifys account ($4 for the first seat, then $2 per extra seat per month after trial). The MCP package itself is free.
Inputs: platform (required), accountId (required), link, tags, +27 more.
postifys_tiktok_creator_infoA
Fetch TikTok creator publish options (privacy levels, interactions). Call before Direct Post.
Inputs: tiktokAccountId (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 17 tools
Most tools pair a specific action with a distinct resource, so post status vs media status and publish vs upload are clear. The main ambiguity is cq_overview overlapping with cq_list_tables and cq_list_jobs, but names and descriptions mostly keep boundaries clear.
All tools share the postifys_ prefix and snake_case, with a mostly consistent verb_noun pattern. Minor deviations like postifys_ping, postifys_media_upload, postifys_cq_overview, and create_or_update_job do not seriously hurt readability.
17 tools is slightly above the ideal range but justified by two clear subdomains: direct publishing/media preparation and content queue management. Each tool has a concrete purpose, though the count feels a bit heavy overall.
The core publish flow is well covered with connections, media upload, publish, and status polling. Content queue coverage is notably incomplete: items can be added, imported, and listed but not updated or deleted, and tables/jobs lack delete operations.
Maintenance
Related MCP Connectors
Publish, schedule, and manage social media posts across major platforms via the Postproxy API.
Publish and schedule social posts, upload media, and review analytics through OAuth.
Publish and schedule social media posts and read analytics across 12 networks through one API.
Manage social publishing workflows through OpenPost
Related MCP Servers
AlicenseNot gradedqualityDmaintenanceEnables comprehensive social media management through Oktopost's REST API, including campaign creation, content scheduling, post management, workflow approvals, employee advocacy, and media asset handling across connected social profiles.MIT- FlicenseNot gradedqualityDmaintenanceEnables interaction with the Postiz social media management platform through MCP tools. Supports creating and managing posts, retrieving integrations, and accessing account information through multiple transport protocols.2-
- FlicenseNot gradedqualityDmaintenanceEnables AI agents to create, schedule, and manage social media posts across 10 platforms via a unified API.-

@posteahora/mcpofficial
AlicenseAqualityCmaintenanceEnables AI agents to create, schedule, and publish social media posts across Instagram, X/Twitter, LinkedIn, Threads, Facebook, and other platforms via the PosteAhora API.1510 npmMIT