Skip to main content
Glama
postifys-mcp

postifys-mcp

by mfarooqone

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_history and postifys_retry_post.

  • accountId is optional (Postifys uses your default account per platform).

  • Default type now matches the API docs: Facebook IMAGE with media / FEED without; Instagram IMAGE (pass REEL for video).

  • Automatic retries with backoff for 429/5xx; publishes always send an Idempotency-Key so retries never double-post.

  • Configurable POSTIFYS_TIMEOUT_MS, POSTIFYS_MAX_RETRIES, POSTIFYS_RETRY_BASE_MS.

  • Handles a missing postId safely; 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 with npx -y postifys-mcp@latest and passes POSTIFYS_API_KEY in.

  • skills/postifys/SKILL.md: tells the agent how to publish with these tools.

  • assets/logo.png: the plugin logo.

To set it up:

  1. Install Postifys from the Cursor Marketplace.

  2. Open Plugins → Postifys → Configure.

  3. 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)

  1. Create an API key in Postifys → Settings (scopes: connections, media, publish, status).

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

POSTIFYS_API_KEY

yes

—

POSTIFYS_SERVER_URL

no

https://postifys.com

POSTIFYS_TIMEOUT_MS

no

60000 (per attempt)

POSTIFYS_MAX_RETRIES

no

3

POSTIFYS_RETRY_BASE_MS

no

500 (exponential backoff + jitter; honours Retry-After)

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; boardId required.

  • 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 production

License

MIT

Available Tools

17 tools
postifys_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

    A3.6/5.0

    Scored across 17 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count4/5

    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.

    Completeness3/5

    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

    ActivitySlowing
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables 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
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables 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
      -
    • A
      license
      A
      quality
      C
      maintenance
      Enables AI agents to create, schedule, and publish social media posts across Instagram, X/Twitter, LinkedIn, Threads, Facebook, and other platforms via the PosteAhora API.
      15
      10 npm
      MIT