Сервер Welder MCP

Идентифицирует рабочую область Welder, к которой принадлежат эти учетные данные, поэтому хост, поддерживающий несколько учетных записей, может отличить их друг от друга.

Нет ввода.

Возврат

{ id }

• id — это стабильный, непрозрачный идентификатор рабочей области, разрешенный только на основе проверенных учетных данных. Он никогда не содержит адрес электронной почты, имя рабочей области или учетные данные.
• Помечен как инструмент аутентифицированного профиля (_meta["openai/profile"]: true). Текстовое содержимое содержит тот же JSON, что и структурированный результат.

get_connected_profile({})

{ "id": "7c1e2a9d-…" }

Начните здесь. Рабочее пространство, открыта ли публикация прямо сейчас, лимиты и использование в этом месяце, подключенные учетные записи, что принимает каждая сеть и как передавать файлы.

Нет ввода.

Возврат

{ workspace: { id, name, plan_status, limits: { posts, x_credits }, usage: { posts, x_credits }, can_publish }, accounts: Account[], capabilities: { tiktok, instagram, youtube, threads, bluesky, x }, media_hint, links: { app, connect_accounts }, server: { version }, next_step? }

• When can_publish is false, next_step says so: “Publishing is unavailable under this account's current entitlement. Account setup, uploads и validation remain available.” Subscriptions are managed on the Welder website, never through an assistant.
• определяются сетью с теми же ограничениями, что и get_capabilities.
• В моделируемой рабочей области просмотра результат также содержит review_demo: true и строку data_source, а media_hint объясняет образец носителя. См. рабочую область проверки ниже.

get_context({})

{
  "workspace": {
    "id": "7c1e2a9d-…",
    "name": "Nightshift Studio",
    "plan_status": "active",
    "limits": { "posts": 1500, "x_credits": 100 },
    "usage": { "posts": 3, "x_credits": 8 },
    "can_publish": true
  },
  "accounts": [{ "id": "b2d4…", "provider": "x", "username": "nightshiftHQ", "status": "active", … }],
  "capabilities": { "tiktok": { … }, "instagram": { … }, … },
  "media_hint": "In chat apps without a shell, use create_upload_link and show its URL to the person; then get_upload_link for media ids. With a shell, use create_upload and finalize_upload.",
  "links": {
    "app": "https://weldergtm.com/app",
    "connect_accounts": "https://weldergtm.com/app/accounts"
  },
  "server": { "version": "0.1.0" }
}

Подключенные аккаунты с указанием их статуса и того, что каждый может публиковать. Используйте идентификаторы в качестве целей create_post.

Нет ввода.

Возврат

{ accounts: [{ id, provider, username, display_name, avatar_url, profile_url, status: 'active' | 'reauth_required' | 'disconnected', capabilities, connected_at, expires_at, defaults, last_error }] }

• по умолчанию содержит информацию о поставщике, которая может понадобиться агенту, например, уровни конфиденциальности TikTok, предлагаемые учетной записью, или тип учетной записи Instagram.

Кратковременная ссылка (10 минут), открывающая поток подключения к сети в браузере пользователя. Покажите это, а затем позвоните list_accounts, как только они закончат.

Возврат

{ provider, url, expires_in }

• Человек входит в систему на собственном экране сети; помощник никогда не видит пароль. Для Bluesky ссылка открывает форму пароля приложения.
• Отказано в запрете на участие в моделируемой рабочей области проверки, образцы учетных записей которой предоставлены Welder.

Пробный запуск create_post: доступ к публикации и разрешения, учетные записи, медиа в каждой сети, длина подписей, количество изображений и известные ограничения. Ничего не публикуется и ничего не израсходовано.

Возврат

{ ok, issues, targets: [{ account_id, provider, username, ok, issues, resolved }], cost: { posts, x_credits } }

• Проблемы с предупреждением о коде – это совет, например, что Instagram не показывает подписи в историях. Они никогда не блокируют публикацию.

Публикует одну подпись и набор мультимедиа для одной или нескольких учетных записей сейчас или на schedule_at. Возвращается сразу с сообщением или ждет результата до wait_seconds.

Возврат

{ post: { id, status, source, client, caption, title, media, media_count, targets: [{ id, account_id, provider, username, status, attempt, url, platform_post_id, error_code, error_message, ambiguous, published_at, updated_at, kind }], scheduled_at, created_at, updated_at, completed_at } }

• Запрос с указанием точной подписи, аккаунтов и времени уже подтверждает публикацию; второе подтверждение не требуется. Спрашивайте только об отсутствующих или противоречивых деталях, таких как отсутствие подписи, имя учетной записи, которое соответствует двум профилям или двум разным временам: опубликованное сообщение не всегда можно вернуть.
• Конфиденциальность TikTok и видимость YouTube по умолчанию соответствуют настройкам рабочей области (публично, если пользователь их не изменит). Ярлык, созданный искусственным интеллектом, включен по умолчанию для TikTok и YouTube.
• options.instagram.kind = "story" posts an Instagram Story; a reply option (threads.reply_to_id, x.reply_to_post_id, bluesky.reply_to) answers a comment from list_comments.
• Если цель возвращается неоднозначной, возможно, сеть опубликовала ее: проверьте учетную запись вместо повторной публикации с новым ключом.

create_post({
  idempotency_key: "cold-brew-launch",
  caption: "Cold brew season is open. Twelve hours, zero heat.",
  media: ["3ed1…"],
  targets: [{ provider: "tiktok" }, { provider: "youtube" }],
  wait_seconds: 30
})

Текущее состояние публикации и каждой из ее целей с активной ссылкой после ее подтверждения сетью.

Возврат

{ post: Post }

• needs_attention имеет значение true, если неудавшаяся или частично опубликованная публикация содержит предупреждение, которое никто не отклонил; attention_dismissed_at говорит, когда один был уволен.
• Цель TikTok с url_pending была опубликована, но TikTok еще не предоставил свою общедоступную ссылку (она все еще может находиться в модерации). Позвоните позже; частная публикация может никогда не получить общедоступную ссылку, и ни одна из них никогда не будет выдумана.
• Для ожидающей ссылки на TikTok get_post может запросить у TikTok статус этой публикации и сохранить ссылку, как только она появится. Это единственное изменение, которое он может внести: он никогда не публикует, не повторяет попытки и не меняет использование, поэтому ему нужна только область чтения. Чтение провайдера делает его открытым, а сохранение ссылки означает, что она не доступна только для чтения. Имитируемое рабочее пространство обзора никогда не запрашивает TikTok.

Последние и запланированные публикации, сначала самые новые.

Возврат

{ posts: Post[], next_cursor }

Отклоняет предупреждение о неудачной или частично опубликованной публикации. Пост сохраняет результаты в истории и покидает список needs_attention.

Возврат

{ post: Post }

• Ничего не повторяет, не публикует, не удаляет и не отменяет и не связывается ни с одной сетью. Исходные ошибки, носители и использование остаются прежними.
• Можно позвонить еще раз. Пост без неразрешенного предупреждения отвечает на конфликт. Более поздняя явная повторная попытка отменяет увольнение, поэтому новые ошибки появляются снова.

dismiss_post_attention({ post_id: "8c1f…" })

Останавливает поставленные в очередь и запланированные цели до того, как они погаснут. Публикация целей уже завершена.

Возврат

{ post: Post }

• Отмена не может быть отменена; запланируйте публикацию еще раз, чтобы вернуть ее.

Удаляет опубликованное сообщение. Удаляет его из X и Bluesky; для других сетей в результате говорится, что нужно удалить его в своем приложении. Это невозможно отменить: четкий запрос на удаление этого сообщения — это добро, а неясное сообщение или учетная запись стоят одного вопроса в первую очередь.

Возврат

{ post: Post, results: [{ target_id, account_id, provider, result: 'deleted' | 'already_deleted' | 'unsupported' | 'not_published' | 'failed', message }] }

• Удаленная копия сохраняет статус публикации удаленным, и ее номера перестают обновляться. Удаление никогда не возвращает использованные сообщения или X-кредиты.
• Отказано в запрете на работу в моделируемой рабочей области проверки: его сообщения никогда не доходили до сети.

delete_post({ post_id: "8c1f…", account_ids: ["e7a9…"] })

Как продвигаются публикации на основе сохраненных номеров: просмотры, лайки, комментарии, репосты и подписчики для каждой сети и учетной записи, а также самые популярные публикации. Отсутствующий номер означает, что сеть не разделяет его; в записке написано почему.

Возврат

{ period: { since, until }, as_of, posts, measured, totals, interactions, engagement_rate, by_provider: [{ provider, posts, measured, totals, note }], accounts: [{ account_id, provider, username, status, note, metrics, change, captured_at, history }], top_posts: TargetAnalytics[] }

• Период выбирает сообщения по времени публикации; каждое число — это последнее общее количество постов, а не рост за период.
• Счетчики: просмотры, охваты, лайки, комментарии, репосты, репосты, цитаты, сохранения, link_clicks, profile_visits, подписки, вовлеченность, video_views, watch_time_s, avg_watch_time_s. Счетчик, о котором сеть не сообщает, отсутствует и никогда не равен 0.
• статус для каждого сообщения и аккаунта: доступно, в ожидании, permission_required, не поддерживается, недоступно или ошибка.

get_analytics({ дней: 28, сортировка: "просмотры", лимит: 5 })

Номера одного поста в каждой сети с указанием причины отсутствия некоторых из них. обновить запрашивает сети сейчас; история показывает, как росли цифры.

Возврат

{ post_id, caption, created_at, targets: [{ target_id, account_id, provider, username, url, status, note, metrics, extra, interactions, engagement_rate, captured_at, next_refresh_at, history? }], totals, as_of }

• Требуется область публикации, поскольку обновление: true считывает сети и сохраняет новые номера; эти чтения провайдера делают его открытым миром.
• Числа собираются примерно через 1 час, 6 часов, 1 день, 3 дня, 7 дней, 30 дней и 90 дней после публикации (Истории Instagram: 1, 6 и 20 часов; X: 1 час, 1, 7, 29 и 90 дней).
• При слишком частом обновлении возвращается rate_limited с подробностями.retry_after_seconds. В моделируемом обзоре обновление рабочего пространства игнорируется и возвращаются фиксированные номера образцов.

get_post_analytics({ post_id: "8c1f…", обновление: true, история: true })

Ответы под опубликованным постом, сеть за сетью. Чтобы ответить на один из них, вызовите create_post, указав эту учетную запись в качестве цели и идентификатор комментария в опции, названной reply_option.

Возврат

{ post_id, targets: [{ target_id, account_id, provider, username, status, note, reply_option, comments: [{ id, author: { username, display_name, avatar_url }, text, created_at, likes, replies, url, parent_id, is_own, hidden }] }] }

• Требуется область публикации: каждое чтение X ответов использует 1 X кредит, а сетевое чтение может обновить вход в учетную запись. Чтение комментариев из сетей делает мир открытым.
• Доступно для чтения сегодня: Bluesky, YouTube (только чтение), X с правом X учетной записи (последние 7 дней) и темы, в которых соединение имеет разрешение на ответы. Instagram отвечает на permission_required, а TikTok не поддерживается.
• reply_option — это потоки.reply_to_id, x.reply_to_post_id или bluesky.reply_to; null, когда Welder не может ответить (YouTube). Отправить ответ, когда человек просит об этом своими словами; когда просят черновик, напишите его в чате и ничего не отправляйте.

list_comments({ post_id: "8c1f…", account_id: "b2d4…" })
create_post({
  caption: "Not yet, but it’s on the list!",
  targets: [{ account_id: "b2d4…" }],
  options: { threads: { reply_to_id: "17890…" } }
})

Что принимает каждая сеть: типы мультимедиа, размеры, продолжительность, количество изображений и ограничения на подписи. Статический, одинаковый для каждого рабочего пространства.

Нет ввода.

Возврат

{ providers: { tiktok: { text_only, video: { max_bytes, min_duration_s, max_duration_s, mimes }, images: { max_bytes, min_count, max_count, mimes }, mixed_carousel, caption_max, title_max, story?, notes }, … } }