Skip to main content
Glama
postfast-mcp

postfast-mcp

MCP-сервер PostFast

MCP-сервер для API PostFast — планируйте и управляйте публикациями в социальных сетях с помощью ИИ-инструментов, таких как Claude, Cursor, VS Code и других.

Быстрый старт

1. Получите ваш API-ключ

Войдите в PostFast, перейдите в раздел API на боковой панели и создайте ключ.

2. Установка

Выберите предпочтительный метод:

Claude Desktop (рекомендуется)

Загрузите расширение из каталога расширений Claude Desktop или установите вручную:

  1. Добавьте в claude_desktop_config.json:

{
  "mcpServers": {
    "postfast": {
      "command": "npx",
      "args": ["-y", "postfast-mcp"],
      "env": {
        "POSTFAST_API_KEY": "your-api-key-here"
      }
    }
  }
}
  1. Перезапустите Claude Desktop.

Claude Code

Через плагин (ожидает одобрения в маркетплейсе):

/plugin install postfast@claude-plugins-official

После установки задайте свой API-ключ — выберите один из вариантов:

# Option A: Add to your shell profile (~/.zshrc or ~/.bashrc)
export POSTFAST_API_KEY="your-api-key-here"

# Option B: Add to ~/.claude/settings.local.json
# { "env": { "POSTFAST_API_KEY": "your-api-key-here" } }

Затем перезапустите Claude Code.

Через ручную настройку:

Добавьте в .mcp.json вашего проекта или в ~/.claude/.mcp.json (глобально):

{
  "mcpServers": {
    "postfast": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "postfast-mcp"],
      "env": {
        "POSTFAST_API_KEY": "your-api-key-here"
      }
    }
  }
}

Cursor / VS Code / Windsurf / Другие MCP-клиенты

Добавьте в конфигурацию MCP (.mcp.json, mcp.json или в интерфейс настроек инструмента):

{
  "mcpServers": {
    "postfast": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "postfast-mcp"],
      "env": {
        "POSTFAST_API_KEY": "your-api-key-here"
      }
    }
  }
}

3. Использование

Задавайте своему ИИ-ассистенту вопросы, например:

  • "List my connected social accounts"

  • "Schedule a post to Instagram for tomorrow at 9am"

  • "Show me all scheduled posts for this week"

  • "Upload this image and create a LinkedIn post with it"

  • "Create a Facebook reel with this video"

  • "Show me analytics for my Instagram posts this month"

Related MCP server: kadenzo-mcp

Доступные инструменты

Инструмент

Описание

list_accounts

Список подключенных аккаунтов социальных сетей

list_posts

Список публикаций с фильтрами (платформа, статус, диапазон дат)

create_posts

Создание и планирование публикаций (пакетно, до 15)

delete_post

Удаление публикации по ID

upload_media

Загрузка локального файла и получение медиа-ключа (выполняет весь процесс)

get_upload_urls

Получение подписанных URL для загрузки медиафайлов

list_pinterest_boards

Получение досок Pinterest для аккаунта

list_youtube_playlists

Получение плейлистов YouTube для аккаунта

list_gbp_locations

Получение локаций Google Business Profile для аккаунта

generate_connect_link

Генерация ссылки для подключения аккаунтов клиентами

get_post_analytics

Получение опубликованных постов с метриками эффективности — Instagram, Facebook, TikTok, Threads, YouTube, LinkedIn (страницы компаний), Pinterest (бизнес-аккаунты)

Поддерживаемые платформы

Facebook, Instagram, X (Twitter), TikTok, LinkedIn, YouTube, BlueSky, Threads, Pinterest, Telegram, Google Business Profile

Специфические настройки платформ

При создании публикаций вы можете передавать специфические настройки платформы через параметр controls:

Платформа

Настройки

X (Twitter)

xRetweetUrl

Instagram

instagramPublishType (TIMELINE/STORY/REEL), instagramPostToGrid, instagramCollaborators

Facebook

facebookContentType (POST/REEL/STORY), facebookAllowComments, facebookPrivacy, facebookReelsCollaborators

TikTok

tiktokPrivacy (PUBLIC/MUTUAL_FRIENDS/FOLLOWER_OF_CREATOR/ONLY_ME), tiktokIsDraft, tiktokAllowComments, tiktokAllowDuet, tiktokAllowStitch, tiktokBrandOrganic, tiktokBrandContent, tiktokAutoAddMusic, tiktokIsAigc

YouTube

youtubeTitle, youtubePrivacy (PUBLIC/PRIVATE/UNLISTED), youtubeTags, youtubeCategoryId, youtubeIsShort, youtubeMadeForKids, youtubePlaylistId, youtubeThumbnailKey

Pinterest

pinterestBoardId (обязательно), pinterestLink

LinkedIn

linkedinAttachmentKey, linkedinAttachmentTitle

Google Business Profile

gbpLocationId (обязательно), gbpTopicType (STANDARD/EVENT/OFFER), gbpCallToActionType, gbpCallToActionUrl, gbpEventTitle, gbpEventStartDate, gbpEventEndDate, gbpOfferCouponCode, gbpOfferRedeemUrl, gbpOfferTerms

Загрузка медиафайлов

Инструмент upload_media выполняет весь процесс за один вызов:

  1. Определяет тип контента по расширению файла

  2. Получает подписанный URL для загрузки от PostFast

  3. Загружает файл

  4. Возвращает key и type, готовые к использованию в create_posts

Поддерживаемые форматы: JPEG, PNG, GIF, WebP, MP4, WebM, MOV

Вы также можете использовать get_upload_urls напрямую, если вам нужно больше контроля над процессом загрузки.

Переменные окружения

Переменная

Обязательно

Описание

POSTFAST_API_KEY

Да

Ваш API-ключ рабочего пространства

POSTFAST_API_URL

Нет

Базовый URL API (по умолчанию: https://api.postfa.st)

Тестирование

Проверьте работоспособность с помощью MCP Inspector:

POSTFAST_API_KEY=your-key npx @modelcontextprotocol/inspector npx postfast-mcp

Документация API

Полная документация REST API: postfa.st/docs

Разработка

npm install
npm run build
node dist/index.js

Значки

peturgeorgievv-factory/postfast-mcp MCP server

Лицензия

MIT

Available Tools

11 tools
create_postsBInspect

Create and schedule social media posts. Supports batch creation (up to 15 posts). Each post targets a specific social account.

Inputs: posts (required), controls (required), status, approvalStatus.

delete_postBInspect

Delete a social media post by ID

Inputs: id (required).

get_post_analyticsAInspect

Fetch published posts with their latest performance metrics (impressions, reach, likes, comments, shares). Only returns published posts that have a platform post ID. LinkedIn personal accounts are excluded. Supported: Instagram, Facebook, TikTok, Threads, YouTube, LinkedIn (company pages), Pinterest (Business accounts). Pinterest extras include pin_clicks, outbound_clicks, saves_90d, save_rate_90d (saves are 90-day rolling because Pinterest API does not expose lifetime totals); video pins additionally surface mrc_views, views_10s, avg_watch_time, v50_watch_time, video_starts, quartile_95_views.

Inputs: startDate (required), endDate (required), platforms, socialMediaIds.

get_upload_urlsAInspect

Get signed upload URLs for media files. Upload your file to the returned URL via PUT, then use the key in create_posts mediaItems.

Inputs: contentType (required), count.

list_accountsAInspect

List all social media accounts connected to the workspace

Inputs: no named parameters.

list_gbp_locationsAInspect

List Google Business Profile locations for a connected GBP account

Inputs: socialMediaId (required).

list_pinterest_boardsAInspect

List Pinterest boards for a connected Pinterest account

Inputs: socialMediaId (required).

list_postsAInspect

List social media posts with optional filters for platform, status, and date range

Inputs: page, limit, platforms, statuses, +2 more.

list_youtube_playlistsBInspect

List YouTube playlists for a connected YouTube account

Inputs: socialMediaId (required).

upload_mediaAInspect

Upload a local file to PostFast and get back a media key for use in create_posts. Handles the full flow: detects content type, gets a signed URL, uploads the file, and returns the key and type.

Inputs: filePath (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 11 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: create, delete, list posts; upload media; get analytics; list accounts and platform-specific resources (GBP, Pinterest, YouTube). No overlapping functionality.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern in snake_case (e.g., create_posts, list_accounts, get_upload_urls), with no mixing of conventions.

    Tool Count5/5

    11 tools is well-scoped for a social media posting server, covering account listing, post management, media upload, analytics, and platform-specific queries without unnecessary bloat.

    Completeness2/5

    Missing essential operations: no update_post tool to modify existing posts, and no get_post by ID (only list). This creates a significant gap for agents needing to edit posts.

    Maintenance

    ActivityActive
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      A full social media management MCP server enabling post, read, schedule, and analyze across Facebook, Instagram, LinkedIn, X/Twitter, Pinterest, and YouTube from any MCP-compatible AI client.
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Schedule, manage, generate, and analyze social posts across 11 networks (Instagram, TikTok, X, LinkedIn, YouTube, Facebook, Pinterest, Threads, Bluesky, Mastodon, Telegram) from any AI agent — 13 tools covering scheduling, media upload, AI caption generation, best-times, analytics, listening, and comments.
      13
      54 npm
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Gives AI agents the ability to schedule and publish social media posts to Instagram, TikTok, YouTube, X, LinkedIn, Facebook, Pinterest, Threads, and Bluesky. Create, schedule, and bulk-plan posts with per-platform captions, then check per-platform results and retry failures.
      82
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI agents to post, schedule, thread, delete, and analyze social media posts across platforms like X, Bluesky, LinkedIn, and Instagram through a single MCP interface.
      MIT