Справочник по инструментам
Полный список инструментов сервера MCP PostNext с описанием входных параметров, структуры ответа и готовым примером для каждого.
https://mcp.postnext.io/apiPOST https://mcp.postnext.io/apiАутентификация
Каждый запрос к https://mcp.postnext.io/api требует заголовок Authorization с Bearer-токеном. Получить токен можно двумя способами.
OAuth (рекомендуется для ИИ-клиентов)
ИИ-клиенты при первом подключении выполняют Dynamic Client Registration и проводят пользователя через экран согласия OAuth. Страница /mcp/connect делает это автоматически, и клиент получает токен доступа на 30 дней.
API-ключ
Для скриптов и CI создайте персональный API-ключ в приложении PostNext в разделе Аккаунт → API-ключи. Ключ начинается с apikey_ и передаётся как обычный Bearer-токен.
Эндпоинт
Все вызовы инструментов идут на один эндпоинт JSON-RPC 2.0 по HTTPS POST.
Инструменты
list_scheduled_posts
Список ваших запланированных публикаций (поставленных в очередь на публикацию, но ещё не отправленных).
Аргументы
limitfromВозвращает
Объект с posts: [{id, platform, content, scheduledAt, status}]. До limit результатов.
Пример
curl -X POST https://mcp.postnext.io/api \
-H "Authorization: Bearer apikey_xxx" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","method":"tools/call","id":1,
"params":{"name":"list_scheduled_posts",
"arguments":{"limit":5}}}'
list_drafts
Список ваших черновиков (ещё не запланированных).
Аргументы
limitВозвращает
Объект с drafts: [{id, platform, content, updatedAt}]. До limit результатов.
Пример
{"jsonrpc":"2.0","method":"tools/call","id":2,
"params":{"name":"list_drafts","arguments":{"limit":10}}}
list_connected_accounts
Список социальных аккаунтов, подключённых к вашей команде.
Аргументы
Без аргументов.
Возвращает
Объект с accounts: [{platform, handle, providerId, connected, lastSyncAt}].
Пример
{"jsonrpc":"2.0","method":"tools/call","id":3,
"params":{"name":"list_connected_accounts","arguments":{}}}
get_account_healthПлатный тариф
Сводка состояния по всем подключённым платформам.
Аргументы
platformwindowDaysВозвращает
Объект с windowDays, postsScheduled, postsPublished, postsFailed, разбивкой byPlatform и topErrors[].
Пример
{"jsonrpc":"2.0","method":"tools/call","id":4,
"params":{"name":"get_account_health",
"arguments":{"windowDays":30}}}
create_post_draft
Создание нового черновика публикации. Черновики не публикуются автоматически.
Аргументы
platformcontentchannelNameproviderIdmediaUrlsclientRequestIdВозвращает
Объект с новым черновиком: {id, platform, content, status: "DRAFT", createdAt}.
Пример
{"jsonrpc":"2.0","method":"tools/call","id":5,
"params":{"name":"create_post_draft",
"arguments":{"platform":"twitter",
"content":"Hello from MCP"}}}
update_post_draft Платный тариф
Обновление существующего черновика. Необходимо указать хотя бы одно из полей: content или mediaUrls.
Аргументы
postIdcontentmediaUrlsclientRequestIdВозвращает
Объект с обновлённым черновиком: {id, platform, content, mediaUrls, status, updatedAt}.
Пример
{"jsonrpc":"2.0","method":"tools/call","id":6,
"params":{"name":"update_post_draft",
"arguments":{"postId":"",
"content":"Updated copy"}}}
connect_channel
Генерация одноразового URL, который пользователь может открыть для авторизации подключения новой платформы.
Аргументы
platformВозвращает
Объект с authUrl (одноразовая ссылка, которую пользователь открывает для авторизации), expiresAt и platform.
Пример
{"jsonrpc":"2.0","method":"tools/call","id":7,
"params":{"name":"connect_channel",
"arguments":{"platform":"linkedin"}}}
schedule_post
Перемещает черновик (статус DRAFT) в очередь публикации на будущее время. Идемпотентен в пределах дрейфа ±60 секунд; отклоняет попытки перепланирования на другое время без явной отмены. Учитывается в месячном лимите постов тарифа (Free: 10, общий с приложением); каждый пост учитывается один раз, поэтому повторное планирование после отмены или неудачной публикации не считается заново.
Аргументы
postIdscheduledAtВозвращает
Объект с postId, scheduledAt (ISO), status: SCHEDULED.
Пример
{"jsonrpc":"2.0","method":"tools/call","id":8,
"params":{"name":"schedule_post",
"arguments":{"postId":"",
"scheduledAt":"2026-05-10T09:00:00Z"}}}
cancel_scheduled_post
Отменяет запланированный пост и удаляет его из очереди публикации. Базовый черновик сохраняется.
Аргументы
postIdВозвращает
Объект с postId и status: CANCELLED.
Пример
{"jsonrpc":"2.0","method":"tools/call","id":9,
"params":{"name":"cancel_scheduled_post",
"arguments":{"postId":""}}}
delete_draft
Окончательно удаляет черновик. Отклоняет посты не в статусе DRAFT (используйте cancel_scheduled_post для SCHEDULED).
Аргументы
postIdВозвращает
Объект с postId и deleted: true.
Пример
{"jsonrpc":"2.0","method":"tools/call","id":10,
"params":{"name":"delete_draft",
"arguments":{"postId":""}}}
get_post
Возвращает полный PostGroup для postId: контент по платформам, статус и временные метки.
Аргументы
postIdВозвращает
Объект с postId, status, scheduledAt, createdAt, updatedAt и providers (карта платформа → контент).
Пример
{"jsonrpc":"2.0","method":"tools/call","id":11,
"params":{"name":"get_post",
"arguments":{"postId":""}}}
search_posts
Подстрочный поиск (без учёта регистра) по контенту постов активной команды. Фильтры: status, platform, limit (1-100, по умолчанию 20).
Аргументы
querystatusplatformlimitВозвращает
Объект с posts: [{postId, status, platforms, snippet, scheduledAt, updatedAt}]. Snippet содержит совпадающий контекст с многоточием с обеих сторон.
Пример
{"jsonrpc":"2.0","method":"tools/call","id":12,
"params":{"name":"search_posts",
"arguments":{"query":"launch","limit":10}}}
list_teams
Возвращает команды, которыми владеет или администрирует аутентифицированный пользователь, с пометкой активной команды.
Аргументы
Без аргументов.
Возвращает
Объект с currentTeamId и teams: [{teamId, teamName, isCurrent}].
Пример
{"jsonrpc":"2.0","method":"tools/call","id":13,
"params":{"name":"list_teams","arguments":{}}}
set_current_team
Переключает активную команду для этого Bearer-токена. Пользователь должен быть участником команды. Сохраняется в OAuth-токене; изменение сразу действует для следующих инструментов в той же беседе.
Аргументы
teamIdВозвращает
Объект с teamId, teamName, persisted (true для OAuth, false для API-ключа) и опциональным note.
Пример
{"jsonrpc":"2.0","method":"tools/call","id":14,
"params":{"name":"set_current_team",
"arguments":{"teamId":"team_xxxxx"}}}
get_plan_limits
Возвращает текущий тариф пользователя и квоты по тарифу (каналы, хранилище, ИИ-кредиты, публикация). Доступен на любом тарифе. Полезен перед изменяющими инструментами, чтобы предсказать, будет ли вызов заблокирован.
Аргументы
Без аргументов.
Возвращает
Объект с tier, tierDisplayName, isPaid, isTrial, limits (channels/storage/aiCalls каждое как {limit, current, exceeded}; posts как {limit, allowed, current}, где current означает число за текущий месяц или null, если его не удалось прочитать) и creditsAvailable ({total, subscriptionRemaining, purchasedBalance} или null).
Пример
{"jsonrpc":"2.0","method":"tools/call","id":15,
"params":{"name":"get_plan_limits","arguments":{}}}
get_post_metrics
Получает метрики вовлечённости опубликованного поста по каждой платформе, куда он был отправлен. Twitter возвращает лайки, ретвиты, ответы и показы; Instagram возвращает лайки и комментарии. LinkedIn, Threads и TikTok возвращают только статус публикации и URL (сбор вовлечённости появится в следующей версии). Нормализованный итог суммирует метрики по платформам, которые их вернули.
Аргументы
postId Идентификатор публикации PostNext из результатов запроса списка.
Возвращает
Объект с postId, status, providers: [{platform, publishedPostId, publishedUrl, publishedAt, status, metrics}] и totals: {likes, comments, shares, impressions}. metrics представляет собой объект числовых счётчиков по платформе или null, если платформа пока не собирает данные вовлечённости.
Пример
{"jsonrpc":"2.0","method":"tools/call","id":16,
"params":{"name":"get_post_metrics",
"arguments":{"postId":""}}}
get_publish_status
Диагностирует запланированную публикацию: статус очереди, успех/ошибка по платформам, время обработки и jobId воркера. Возвращает isScheduled=false для публикаций, которые существуют как черновики, но не были перемещены в очередь публикации, с подсказкой на schedule_post.
Аргументы
postId Идентификатор публикации PostNext из результатов запроса списка.
Возвращает
Объект с postId, isScheduled, status, scheduledAt, publishedAt, platforms, processingTimeMs, jobId, topLevelError и results: [{platform, success, publishedPostId, publishedAt, error}]. Содержит hint, когда isScheduled равно false.
Пример
{"jsonrpc":"2.0","method":"tools/call","id":17,
"params":{"name":"get_publish_status",
"arguments":{"postId":""}}}
update_brand_profile Платный тариф
Обновляет активный профиль бренда пользователя. Разрешённые поля: bio, brandVoice, personalityTraits, mainThemes, expertiseAreas, preferredHashtags, audienceSize. Всё остальное молча отбрасывается. «Активный» профиль ищется так: сначала профиль команды по умолчанию, затем первый собственный активный профиль пользователя.
Аргументы
brandVoice Массив дескрипторов голоса бренда (например, ["профессиональный", "краткий"]).
Other patchable fields: bio, personalityTraits, mainThemes, expertiseAreas, preferredHashtags, audienceSize.
Возвращает
Объект с profileId, name, updated: [имена полей, которые были изменены] и текущими значениями bio, brandVoice, personalityTraits, mainThemes, expertiseAreas, preferredHashtags, audienceSize после изменения.
Пример
{"jsonrpc":"2.0","method":"tools/call","id":18,
"params":{"name":"update_brand_profile",
"arguments":{"brandVoice":["professional","concise"]}}}
get_best_time_to_post Платный тариф
Рекомендует N лучших слотов (день недели, час) для следующего поста на платформе по данным за 90 дней. Twitter и Instagram ранжируются по вовлечённости на пост; LinkedIn, Threads и TikTok только по частоте публикаций. Время в указанном часовом поясе IANA (по умолчанию UTC). Нужен платный тариф.
Аргументы
platform Социальная платформа: twitter, instagram, linkedin, threads или tiktok.
timezone Название IANA-таймзоны (например, Europe/Moscow, America/New_York). По умолчанию UTC.
topN Количество рекомендаций слотов (1-24, по умолчанию 5).
Возвращает
Объект с platform, timezone, sampleWindowDays, sampleSize, metricsAvailable и recommendations: [{dayOfWeek (1-7, Пн=1), dayLabel, hour (0-23), score, basedOn: {posts, avgEngagement}}]. Содержит hint для случаев cold-start или недоступных метрик.
Пример
{"jsonrpc":"2.0","method":"tools/call","id":19,
"params":{"name":"get_best_time_to_post",
"arguments":{"platform":"twitter","timezone":"Europe/Berlin","topN":5}}}
get_channel_analytics
Сводная статистика одного подключённого канала или сразу всех. Возвращает показы, охват, лайки, комментарии и вовлечённость за период, изменение к предыдущему периоду такой же длины и динамику подписчиков. Без platform приходит итог по всей команде. Для одной публикации используйте get_post_metrics, для планирования используйте get_best_time_to_post.
Аргументы
platform Социальная платформа: twitter, instagram, linkedin, threads или tiktok.
channelName Какой подключённый аккаунт, если на площадке их несколько.
providerId providerId аккаунта из list_connected_accounts. Он не меняется при смене имени пользователя, поэтому передавайте его вместе с channelName или вместо него.
period Период отчёта: 7d, 30d, 90d или all (по умолчанию 30d).
Возвращает
Объект с scope, period, totals, vsPrevious, coverage, dataThrough и followers, где есть trackingSince, current, change и сам ряд.
Пример
{"jsonrpc":"2.0","method":"tools/call","id":34,
"params":{"name":"get_channel_analytics",
"arguments":{"platform":"linkedin","period":"30d"}}}search_tools
Ищет в каталоге инструментов MCP по тексту, категории или намерению. Возвращает категории, requiresScope, однострочные описания и теги вариантов использования, которые совпали. Доступно на любом тарифе (это инструмент для поиска).
Аргументы
Все необязательные. Вызовите без аргументов, чтобы получить список всех доступных инструментов.
query Свободный поиск по именам, описаниям и тегам использования инструментов.
category Фильтр по одной категории: posts, accounts, analytics, brand, teams, discovery, other.
Возвращает
Объект с totalTools, matchCount, categories: [string[]] и tools: [{name, category, requiresScope, description, useCases, matchedOn: [name|category|description|use_case]}]. Содержит hint, когда нет совпадений или нет фильтра.
Пример
{"jsonrpc":"2.0","method":"tools/call","id":20,
"params":{"name":"search_tools",
"arguments":{"query":"why did my post fail"}}}
get_plan
Тариф и даты оплаты: уровень, дата продления, окончание пробного периода и признак отмены подписки в конце периода. За лимитами и расходом обращайтесь к get_plan_limits.
Аргументы
Без аргументов.
Возвращает
Объект с полями tier, tierDisplayName, isPaid, isTrial, gated, subscriptionStatus, renewsAt, trialEndsAt, cancelAtPeriodEnd и currency.
Пример
{"jsonrpc":"2.0","method":"tools/call","id":21,
"params":{"name":"get_plan",
"arguments":{}}}
upload_asset
Загрузка изображения или видео в медиатеку прямо в base64. Надёжно работает только для очень маленьких файлов, примерно до 8 КБ: всё, что больше, молча обрезается в аргументах инструмента и сохраняется повреждённым. Для файлов побольше используйте request_asset_upload.
Аргументы
filename Имя файла вместе с расширением, до 255 символов.
contentType MIME-тип файла из разрешённого списка изображений и видео.
base64 Содержимое файла в кодировке base64. Держите его очень маленьким и сначала прочитайте предупреждение выше.
Возвращает
Объект с assetId, url, sizeBytes и mimeType. Передайте url в create_post_draft как mediaUrls.
Пример
{"jsonrpc":"2.0","method":"tools/call","id":22,
"params":{"name":"upload_asset",
"arguments":{"filename":"logo.png","contentType":"image/png","base64":"iVBORw0KGgo..."}}}
request_asset_upload
Рекомендуемый способ загрузки, для изображений и видео любого размера. Два шага: вызываете инструмент и получаете подписанную ссылку и готовую команду curl, затем отправляете файл методом PUT по этой ссылке. В ответе на PUT приходит итоговый адрес файла.
Аргументы
filename Имя файла вместе с расширением, до 255 символов.
contentType MIME-тип файла из разрешённого списка изображений и видео.
sizeBytes Точный размер файла в байтах, нужен для подписи загрузки.
Возвращает
Объект с uploadId, uploadUrl, uploadToken, expiresInSeconds и instructions, где лежит точная команда PUT.
Пример
{"jsonrpc":"2.0","method":"tools/call","id":23,
"params":{"name":"request_asset_upload",
"arguments":{"filename":"clip.mp4","contentType":"video/mp4","sizeBytes":4194304}}}
import_chat_file
Только для ChatGPT. Сохраняет в медиатеку изображения и видео, прикреплённые в чате, чтобы использовать их в create_post_draft. ChatGPT передаёт каждый файл временной ссылкой; PostNext скачивает его один раз по HTTPS и по самому файлу проверяет, что это изображение или видео. До 10 файлов за вызов, до 50 МБ каждый, в счёт хранилища вашего тарифа (на Free всего 10 МБ).
Аргументы
files Заполняет ChatGPT по файлам, прикреплённым в чате: download_url и file_id, по желанию mime_type и file_name. До 10. Другие клиенты загружают файлы через request_asset_upload.
Возвращает
Объект с files (assetId, url, sizeBytes, mimeType и fileName для каждого сохранённого файла) и failed (fileName и reason для каждого файла, который не удалось сохранить). Если не удалось сохранить ни одного файла, вызов вместо этого возвращает ошибку первого.
Пример
{"jsonrpc":"2.0","method":"tools/call","id":35,
"params":{"name":"import_chat_file",
"arguments":{"files":[{"download_url":"https://files.oaiusercontent.com/...","file_id":"file_abc123"}]}}}
MCP-ресурсы
Ресурсы представляют собой контекст только для чтения, который клиент может получить через MCP-метод resources/read. Claude загружает их в начале каждой беседы, поэтому имеет контекст аккаунта/команды/бренда без необходимости каждый раз объяснять заново.
postnext://account/summary
E-mail и имя пользователя аккаунта (чтобы Claude мог подтвердить, с каким аккаунтом он работает), тариф, использованные ИИ-кредиты / лимит, количество черновиков, количество запланированных постов, количество подключённых каналов. Каждый счётчик ограничен 100, чтобы данные загружались быстро.
postnext://channels/connected
Та же структура, что у результата list_connected_accounts; доступна как ресурс, чтобы Claude загрузил её один раз в начале беседы (без отдельного вызова инструмента).
postnext://brand-profiles/active
Активный профиль бренда пользователя (профиль команды по умолчанию, а если его нет, первый собственный профиль). Возвращает только поля, нужные LLM: bio, expertiseAreas, personalityTraits, brandVoice, mainThemes, audienceSize, preferredHashtags.
postnext://teams/current
Метаданные текущей команды (teamId, teamName) плюс totalTeamsAvailable. Используйте вместе с list_teams + set_current_team для переключения.
Готовые сценарии
Команды из меню (/), которые объединяют несколько инструментов. Выберите сценарий, и ИИ-ассистент проведёт вас через многошаговую задачу, спрашивая подтверждение перед каждым изменением.
/weekly-plan
Анализирует профиль бренда, подключённые каналы и очередь публикаций, затем предлагает 5-10 черновиков, распределённых с понедельника по пятницу.
/draft-thread
Создаёт тред из 5-10 постов для Twitter или Threads по заданной теме или ссылке голосом вашего бренда.
/audit-queue
Проверяет запланированные публикации на ближайшие 7 дней и отмечает дубликаты, перегруз платформ и пробелы в расписании.
/channel-sweep
Сравнивает подключённые каналы с поддерживаемым набором и предлагает, какие из них стоит подключить или обновить.
Эндпоинты обнаружения и OAuth
Метаданные по стандартам, чтобы любой MCP-клиент мог настроиться автоматически.
GET /.well-known/oauth-protected-resource/api— RFC 9728GET /.well-known/oauth-authorization-server— RFC 8414GET /oauth/.well-known/openid-configuration— OIDCPOST /oauth/reg— Dynamic Client Registration (RFC 7591)GET /oauth/auth— Authorize (PKCE-S256 required)POST /oauth/token— Token exchange
Открытый исходный код
Готовые рецепты и справочник для разработчиков размещены в нашем публичном репозитории документации. Лицензия MIT; pull-запросы приветствуются. github.com/postnextio/postnext-mcp
MCP для соцсетей: Claude, ChatGPT и любой ИИ-агент
MCP-сервер PostNext для соцсетей позволяет Claude, ChatGPT и любому ИИ-агенту планировать посты, готовить черновики и ставить их в расписание. Черновики ждут в вашем календаре, пока вы их не запланируете.