# MCP 工具参考

- [MCP 工具参考](https://sosoapi.ai/zh-hans/docs/mcp)：寻找工具输入、输出、配置，以及本地或托管环境的可用性。
- [获取用户资料](https://sosoapi.ai/zh-hans/docs/mcp/get-user-profile)：MCP：获取用户个人资料。读取已登录用户本人的个人资料（显示名称、时区、头像、主题）；尚未创建时 profile 为 null。
- [更新用户资料](https://sosoapi.ai/zh-hans/docs/mcp/update-user-profile)：MCP：更新用户资料。更改已登录用户自己的资料（display_name、timezone、avatar_url、theme）。仅发送需要更改的字段。
- [生成头像上传签名](https://sosoapi.ai/zh-hans/docs/mcp/sign-avatar-upload)：MCP：生成头像上传签名。获取用于上传已登录用户新头像图片的已签名 URL（需要 filename 和 content_type）。本身不会更改资料。
- [列出 API keys](https://sosoapi.ai/zh-hans/docs/mcp/list-api-keys)：MCP：列出 API keys。列出用户 API keys（名称、末 4 码、状态、到期时间、接替关系）；设置 include_authority 可同时获取各 key 的能力与 工作区 限制。绝不返回密钥。需要「管理 API keys」授权；PAT 无法使用。
- [创建 API key](https://sosoapi.ai/zh-hans/docs/mcp/create-api-key)：MCP：创建 API key。使用选定能力（agent:operate、agent:publish、agent:engage）、可选的 workspace_ids 限制及最长 365 天有效期创建个人访问 key；密钥只返回一次，之后无法再次读取。agent 只能授予自己已有的授权，最长 30 天，该授权结束时 key 也会失效。需要「管理 API keys」授权；PAT 无法使用。
- [延长 API key 有效期](https://sosoapi.ai/zh-hans/docs/mcp/extend-api-key)：MCP：延长 API key。为通过 id 指定的 API key 设置更晚的到期时间（expires_at）：从现在起最多 365 天，agent 创建的 key 为 30 天。agent 只能延长由其自身授权创建的 key。需要管理 API keys 授权。
- [换发 API key](https://sosoapi.ai/zh-hans/docs/mcp/renew-api-key)：MCP：换发 API key。为 API key（id）创建接替 key，使用相同能力及 工作区 限制，新密钥仅返回一次，可选择新名称或有效期（最长 365 天，agent 创建的 key 最长 30 天）。不会撤销原 key。需要「管理 API keys」授权。
- [撤销 API key](https://sosoapi.ai/zh-hans/docs/mcp/revoke-api-key)：MCP：撤销 API key。依 id 撤销 API key，使其立即失效；已撤销的 key 会报告 already_revoked。agent 只能撤销由自己授权创建的 keys。需要「管理 API keys」授权。
- [获取计费状态](https://sosoapi.ai/zh-hans/docs/mcp/get-billing-status)：MCP：获取计费状态。读取用户的计费套餐、付款状态、当前周期日期及配额用量（成功发布、待处理排程帖子、已连接账号）。大量排程前请先检查。
- [获取商业访问权限](https://sosoapi.ai/zh-hans/docs/mcp/get-commercial-access)：MCP：获取商业访问资格。读取单个 工作区 计费账号的套餐与配额信息，以及 commercial_access_mode（off、shadow 或 enforce）。
- [获取 组织 信息](https://sosoapi.ai/zh-hans/docs/mcp/get-organization-context)：MCP：获取组织上下文。读取组织、所属工作区和频道的实时映射，含 id 和角色。需要组织或频道 id 时使用。对工作区发帖，复用返回的工作区 id；不必另读工作区上下文。
- [创建 工作区](https://sosoapi.ai/zh-hans/docs/mcp/create-workspace)：MCP：创建工作区。在你拥有或管理的组织中创建工作区。属于多个组织时，传入 organization_id。后续调用使用返回的 id：不要假定新工作区会成为活动工作区。
- [获取工作区上下文](https://sosoapi.ai/zh-hans/docs/mcp/get-workspace-context)：MCP：获取工作区上下文。列出已登录用户所属的工作区及当前活动工作区。在 workspace_id 未知时使用；复用实时上下文，不必重复执行两个上下文读取操作。其报告的活动工作区是当事人在 Web 应用中所作的选择，并非调用的默认值：请明确传入 workspace_id。它并非纯读取操作：如果账号没有工作区，会创建第一个工作区。
- [更新 工作区](https://sosoapi.ai/zh-hans/docs/mcp/update-workspace)：MCP：更新 工作区。重新命名 工作区 或变更其代称。仅限 工作区 所有者。
- [列出组织](https://sosoapi.ai/zh-hans/docs/mcp/list-organizations)：MCP：列出组织。列出已登录用户所属的 组织，以及 组织 范围工具用作 organization_id 的 ID。
- [列出组织连接](https://sosoapi.ai/zh-hans/docs/mcp/list-organization-connections)：MCP：列出组织连接。列出组织的平台连接（Meta、Instagram、Threads、YouTube）及其状态。需要 organization_id。
- [审核组织连接](https://sosoapi.ai/zh-hans/docs/mcp/review-organization-connection)：MCP：审核组织连接。读取一个待处理连接操作（operation_id）发现的平台账号和页面，供审核。只读：由用户在 Web 应用中确认连接。
- [列出组织频道](https://sosoapi.ai/zh-hans/docs/mcp/list-organization-channels)：MCP：列出组织频道。列出 组织 的频道（已链接的平台账号），以及各频道所属的 工作区。
- [预览频道移动](https://sosoapi.ai/zh-hans/docs/mcp/preview-organization-channel-move)：MCP：预览频道移动。试行：检查频道能否移至其他 工作区，并列出阻碍事项。不变更任何内容。
- [列出工作区成员](https://sosoapi.ai/zh-hans/docs/mcp/list-workspace-members)：MCP：列出 工作区 成员。列出 工作区 成员与待处理邀请。
- [提交反馈](https://sosoapi.ai/zh-hans/docs/mcp/submit-feedback)：MCP：提交反馈。代表用户向 SosoAPI 团队发送产品反馈（type 为 bug、feature 或 general；最多 4,000 个字符）。仅在用户要求时使用。
- [获取通知偏好](https://sosoapi.ai/zh-hans/docs/mcp/get-notification-preferences)：MCP：获取通知偏好。读取用户通知设置（当前为帖子失败时是否发送邮件）。
- [更新通知偏好](https://sosoapi.ai/zh-hans/docs/mcp/update-notification-preferences)：MCP：更新通知偏好。更改用户通知设置（email_post_failed 开启或关闭）。
- [列出收件匣通知](https://sosoapi.ai/zh-hans/docs/mcp/list-inbox-notifications)：MCP：列出收件箱通知。读取用户的应用内收件箱，最新优先（最多 50 条），可选择仅未读或某一种类型。
- [列出已连接账号](https://sosoapi.ai/zh-hans/docs/mcp/list-connected-accounts)：MCP：列出已连接账号。列出链接至 工作区 的社交账号（Instagram、Threads、Facebook、YouTube），包含连接健康状态与能力信息。排程或留言时，将其 id 用作 social_account_id。请传入 workspace_id：强制明确指定目标后，未提供即拒绝。
- [断开社交账号连接](https://sosoapi.ai/zh-hans/docs/mcp/disconnect-social-account)：MCP：中断社交账号链接。中断社交账号与 工作区 的链接（仅限 工作区 所有者）。在本人通过以下方式重新链接前，将停止向该账号发布 `sosoapi connect`.
- [设置社交账号自动同步](https://sosoapi.ai/zh-hans/docs/mcp/set-social-account-auto-sync)：MCP：设置社交账号自动同步。开启或关闭单个已连接社交账号的自动同步（editor 角色）。不会发布任何内容。
- [解除社交账号封锁](https://sosoapi.ai/zh-hans/docs/mcp/clear-social-account-block)：MCP：解除社交账号封锁。解除账号的平台冷却状态，让发布可恢复。不会重试任何失败帖子；请使用 sosoapi_retry_scheduled_post 重试。
- [查询素材](https://sosoapi.ai/zh-hans/docs/mcp/query-assets)：MCP：查询素材。按 asset_type、source 或 tag 查找工作区素材；返回分页结果（limit 最大 100，加上 offset）和总数。明确传入 workspace_id。
- [获取素材](https://sosoapi.ai/zh-hans/docs/mcp/get-asset)：MCP：获取素材。依 id 读取单个素材：元数据与短期有效的预览 URL。
- [创建素材](https://sosoapi.ai/zh-hans/docs/mcp/create-asset)：MCP：创建素材。为已由你托管的媒体或文字登记素材记录（asset_url、asset_type）。此操作不会上传任何内容：本地文件请使用 sosoapi_upload_asset；若要由 SosoAPI 获取公开 URL，请使用 sosoapi_import_asset_url。请传入 workspace_id（强制明确指定目标后，未提供即拒绝）。idempotency_key 为可选。
- [更新素材](https://sosoapi.ai/zh-hans/docs/mcp/update-asset)：MCP：更新素材。更改素材的标题、描述或标签（editor 角色）。
- [删除素材](https://sosoapi.ai/zh-hans/docs/mcp/delete-asset)：MCP：删除素材。依 id 从 工作区 素材库删除单个素材。仅限 工作区 所有者。
- [列出素材](https://sosoapi.ai/zh-hans/docs/mcp/list-assets)：MCP：列出素材。列出工作区素材，可按 kind（video、image、audio、cover、thumbnail、frame、video-source、branding）或 customer_ready_only 筛选，以 next_offset 分页。需要 workspace_id。
- [导入素材 URL](https://sosoapi.ai/zh-hans/docs/mcp/import-asset-url)：MCP：导入素材 URL。让 SosoAPI 将公共 http(s) 图片或视频 URL 下载为私有工作区存储中的新素材。返回 import_id；轮询 sosoapi_get_asset_import_status。需要 idempotency_key 和 editor 角色。
- [获取素材导入状态](https://sosoapi.ai/zh-hans/docs/mcp/get-asset-import-status)：MCP：获取素材导入状态。通过 import_id 读取导入。发帖时传入 include_asset=true：ready 结果包含已登记素材 id、kind 和稳定的 asset_url，无需单独调用 get_asset。待处理或缺失的素材不可排程。绝不使用来源或预览 URL 作为媒体标识。如停滞，使用 job_id 读取 sosoapi_job_status；绝不启动重复导入。
- [列出孤立素材](https://sosoapi.ai/zh-hans/docs/mcp/list-orphan-assets)：MCP：列出孤立素材。列出 工作区 中没有素材记录指向的存储对象（存储空间清理），以延续令牌分页。仅限 工作区 所有者。
- [删除孤立素材](https://sosoapi.ai/zh-hans/docs/mcp/delete-orphan-assets)：MCP：删除孤立素材。按 key 删除所选未登记存储对象。仅限工作区所有者；请先用 sosoapi_list_orphan_assets 列出。
- [获取素材存储清单](https://sosoapi.ai/zh-hans/docs/mcp/get-asset-storage-inventory)：MCP：获取素材存储清单。读取工作区已登记素材和已存储对象的分页清单，以审计存储。
- [创建素材导出](https://sosoapi.ai/zh-hans/docs/mcp/create-asset-export)：MCP：创建素材导出。将所选素材（asset_ids）导出为清单。export_verify_then_purge 模式会为后续清除预作准备。idempotency_key 为可选。
- [验证素材导出](https://sosoapi.ai/zh-hans/docs/mcp/verify-asset-export)：MCP：验证素材导出。开始验证素材导出（export_id）。必须先验证导出，才能请求清除。
- [获取素材导出状态](https://sosoapi.ai/zh-hans/docs/mcp/get-asset-export-status)：MCP：获取素材导出状态。读取素材导出的状态：exported、verification_required、verifying、verified 或 failed。
- [请求彻底删除素材](https://sosoapi.ai/zh-hans/docs/mcp/request-asset-purge)：MCP：请求彻底删除素材。请求永久删除已验证导出所涵盖素材的存储字节（export_id、asset_ids；可能需要 confirm_history_loss）。仅限工作区所有者；删除后不可撤销。
- [重试彻底删除素材](https://sosoapi.ai/zh-hans/docs/mcp/retry-asset-purge)：MCP：重试素材清除。重试已停止的清除请求（purge_request_id）。仅限 工作区 所有者。
- [列出项目](https://sosoapi.ai/zh-hans/docs/mcp/list-projects)：MCP：列出项目。列出 工作区 项目（用于来源与账号默认值的可选层），以及当前使用中的项目。
- [获取项目](https://sosoapi.ai/zh-hans/docs/mcp/get-project)：MCP：获取项目。通过 id 读取单个项目：名称、生命周期状态，以及后续写入所需的生命周期和默认值版本。
- [创建项目](https://sosoapi.ai/zh-hans/docs/mcp/create-project)：MCP：创建项目。在工作区中创建项目。仅限工作区所有者；可选 idempotency_key。
- [更新项目](https://sosoapi.ai/zh-hans/docs/mcp/update-project)：MCP：更新项目。重新命名项目（名称是唯一可编辑字段）。仅限 工作区 所有者。
- [设置使用中项目](https://sosoapi.ai/zh-hans/docs/mcp/set-active-project)：MCP：设置活动项目。设置用户的活动项目（服务端默认值）。
- [获取项目账号默认值](https://sosoapi.ai/zh-hans/docs/mcp/get-project-account-defaults)：MCP：获取项目账号默认值。读取项目的默认社交账号及各账号覆盖设置，以及下次替换时需要的 defaults_version。
- [替换项目账号默认值](https://sosoapi.ai/zh-hans/docs/mcp/replace-project-account-defaults)：MCP：替换项目账号默认值。一次替换项目默认账号和覆盖设置。需要最新读取中的 expected_defaults_version 和 idempotency_key（editor 角色）。
- [归档项目](https://sosoapi.ai/zh-hans/docs/mcp/archive-project)：MCP：归档项目。归档项目但不变更其排程帖子。如需停止帖子，请另行取消该排程帖子。仅限 工作区 所有者；请传入 expected_lifecycle_version 及 idempotency_key。
- [取消归档项目](https://sosoapi.ai/zh-hans/docs/mcp/unarchive-project)：MCP：取消归档项目。重新启用已归档项目。不会恢复或重新排程帖子；请通过排程帖子另行管理。仅限 工作区 所有者；请传入 expected_lifecycle_version 及 idempotency_key。
- [获取项目生命周期历史](https://sosoapi.ai/zh-hans/docs/mcp/get-project-lifecycle-history)：MCP：获取项目生命周期历史。读取项目生命周期事件（如归档和取消归档），最多 200 条。
- [获取项目资料](https://sosoapi.ai/zh-hans/docs/mcp/get-project-profile)：MCP：获取项目资料。读取项目品牌资料（标语、语气、目标受众、目标、色盘等）；不存在时 profile 为 null。
- [更新项目资料](https://sosoapi.ai/zh-hans/docs/mcp/update-project-profile)：MCP：更新项目资料。修补项目品牌资料字段。省略的字段保持不变。需要最新读取中的 expected_profile_version 和 idempotency_key（editor 角色）。
- [列出项目素材](https://sosoapi.ai/zh-hans/docs/mcp/list-project-assets)：MCP：列出项目素材。列出关联到项目的素材，并显示每个链接的关系（identity、source 或 reference），使用游标分页。
- [关联项目素材](https://sosoapi.ai/zh-hans/docs/mcp/link-project-asset)：MCP：关联项目素材。将现有素材以 identity、source 或 reference 关系关联到项目。需要 editor 角色及 idempotency_key。
- [取消关联项目素材](https://sosoapi.ai/zh-hans/docs/mcp/unlink-project-asset)：MCP：取消关联项目素材。移除素材与项目的关联；素材本身保留。需要 idempotency_key。
- [列出项目账号](https://sosoapi.ai/zh-hans/docs/mcp/list-project-accounts)：MCP：列出项目账号。列出项目关联的社交账号，采用游标分页。
- [关联项目账号](https://sosoapi.ai/zh-hans/docs/mcp/link-project-account)：MCP：关联项目账号。将已连接社交账号关联到项目。需要 editor 角色及 idempotency_key。
- [取消关联项目账号](https://sosoapi.ai/zh-hans/docs/mcp/unlink-project-account)：MCP：取消关联项目账号。移除社交账号与项目的关联；账号保持连接。需要 idempotency_key。
- [创建项目导出](https://sosoapi.ai/zh-hans/docs/mcp/create-project-export)：MCP：创建项目导出。开始导出项目（仅限 工作区 所有者）；请轮询 sosoapi_get_project_export_status 以获取下载 URL。需要 idempotency_key。
- [获取项目导出状态](https://sosoapi.ai/zh-hans/docs/mcp/get-project-export-status)：MCP：获取项目导出状态。读取项目导出（export_id）：queued、processing、completed（附短期有效的下载 URL）或 failed。仅限工作区所有者。
- [列出待处理发布事项](https://sosoapi.ai/zh-hans/docs/mcp/list-publication-attentions)：MCP：列出待处理发布事项。列出 工作区 中需要注意的发布事项，可依 status（open 或 resolved）或 scheduled_post_id 筛选，并以位移分页。
- [获取 X 发布积分](https://sosoapi.ai/zh-hans/docs/mcp/get-x-usage)：MCP：获取 X 发布积分。读取此工作区共享的组织 X 发布积分。需要 workspace_id。Free 一次性获得 10；Pro 每个计费周期获得 100。纯文字消耗 1，含 URL 文字消耗 10。可选 text 可估算其成本。此操作读取已存储额度，不调用 X API。
- [列出排程帖子](https://sosoapi.ai/zh-hans/docs/mcp/list-scheduled-posts)：MCP：列出排程帖子。列出工作区排程帖子，可按项目、状态（scheduled、publishing、published、failed、expired、needs_reschedule、cancelled、deleted）及时间范围筛选，采用游标分页。
- [获取排程帖子](https://sosoapi.ai/zh-hans/docs/mcp/get-scheduled-post)：MCP：获取排程帖子。通过 id 读取单个排程帖子：内容、状态、交付状态和结果。其 version 是 update、publish、retry 和 cancel 操作所需的 expected_version。
- [获取排程帖子资格](https://sosoapi.ai/zh-hans/docs/mcp/get-scheduled-post-eligibility)：MCP：获取排程帖子资格。每个目标的只读预检。包含 draft（caption、hashtags、scheduled_at、display_timezone、可选当地时间/DST）以检查内容/时间；include_quota=true 添加参考性周期快照。先上传/导入媒体并等待就绪。不含 draft 时，仅检查账号/媒体。不预留任何资源；create/dispatch 会重新检查限制和权限。
- [创建排程帖子](https://sosoapi.ai/zh-hans/docs/mcp/create-scheduled-post)：MCP：创建排程帖子。使用 provider_payload 在 scheduled_at 为一个账号排程。媒体需要已就绪 asset_id 和规范 URL；单张来源图片请使用 sosoapi_post_image_url。local_scheduled_at 与 schedule_dst_disambiguation 必须配对或都省略。需要 publish、editor 角色及 idempotency_key。Scheduled 不等于已发布：请读取结果。
- [批次创建排程帖子](https://sosoapi.ai/zh-hans/docs/mcp/bulk-create-scheduled-posts)：MCP：批次创建排程帖子。一次调用为多个账号排程帖子（targets）。媒体需要已上传／导入且已就绪的 asset_ids 及其标准 URL。每个目标独立成功或失败，并列于 successes 或 failures。需要 publish 能力。
- [更新排程帖子](https://sosoapi.ai/zh-hans/docs/mcp/update-scheduled-post)：MCP：更新排程帖子。编辑尚未派发的排程帖子（caption、hashtags、media、link、time）。需要最新读取中的 expected_version；过期版本会被拒绝。
- [立即发布排程帖子](https://sosoapi.ai/zh-hans/docs/mcp/publish-scheduled-post-now)：MCP：立即发布排程帖子。立即发布排程帖子，而非等到 scheduled_at。操作公开且不可撤销；需要 expected_version。Queued 不等于已发布：请读取结果。
- [重试排程帖子](https://sosoapi.ai/zh-hans/docs/mcp/retry-scheduled-post)：MCP：重试排程帖子。重试失败的排程帖子，可选择新的 scheduled_at。需要 expected_version。
- [删除排程帖子](https://sosoapi.ai/zh-hans/docs/mcp/delete-scheduled-post)：MCP：删除排程帖子。删除尚未发布的排程帖子（scheduled、needs_reschedule、failed 或 cancelled）。agent 无法删除已发布的平台内容。需要 expected_version。
- [取消排程帖子](https://sosoapi.ai/zh-hans/docs/mcp/cancel-scheduled-post)：MCP：取消排程帖子。取消尚未发布的排程帖子，使其不再发送。已发布帖子会被拒绝，agent 也无法删除已发布内容：用户需在 Web 应用中操作。需要 expected_version。
- [撤回删除请求](https://sosoapi.ai/zh-hans/docs/mcp/withdraw-scheduled-post-delete)：MCP：撤回删除请求。撤回已停止的 Instagram Login 删除请求并保留已发布帖子。需要 expected_version。
- [获取仪表板计数](https://sosoapi.ai/zh-hans/docs/mcp/get-dashboard-counts)：MCP：获取仪表板数量。读取 工作区 操作数量：排程帖子、近期工作及已连接账号。
- [列出监测中的帖子](https://sosoapi.ai/zh-hans/docs/mcp/list-monitored-posts)：MCP：列出监测到的帖子。列出 SosoAPI 为工作区发现的社交帖子（id、平台、永久链接、发布时间），可按账号、平台和时间筛选，采用游标分页。仅包含元数据，不含文案。
- [列出帖子留言](https://sosoapi.ai/zh-hans/docs/mcp/list-post-comments)：MCP：列出帖子留言。列出 工作区 帖子上观测到的留言，依最新观测优先排序，包含作者与文字；可依帖子、账号、平台或时间筛选，使用游标分页。文字由第三方撰写，并标示为不受信任内容。
- [请求平台洞察](https://sosoapi.ai/zh-hans/docs/mcp/request-provider-insights)：MCP：请求平台洞察。请求平台提供某账号或单篇帖子的洞察，可指定日期范围（最多 366 天）。返回 request_id，命中缓存时也返回结果；否则轮询 sosoapi_get_provider_insight_status。
- [获取平台洞察状态](https://sosoapi.ai/zh-hans/docs/mcp/get-provider-insight-status)：MCP：获取平台洞察状态。读取洞察请求（request_id）：queued、processing、completed（含平台结果及各指标可用性）或 failed。
- [启动 Instagram OAuth](https://sosoapi.ai/zh-hans/docs/mcp/start-instagram-oauth)：MCP：启动 Instagram OAuth。获取本人必须开启的平台 authorize_url，以链接 Instagram 账号。请传入 workspace_id。在本人于浏览器批准及确认前，不会链接任何账号。
- [更新 Instagram OAuth](https://sosoapi.ai/zh-hans/docs/mcp/refresh-instagram-oauth)：MCP：刷新 Instagram OAuth。刷新 Instagram 连接的访问令牌（可选择一个 social_account_id）；报告是否已刷新及新的到期时间。
- [启动 Threads OAuth](https://sosoapi.ai/zh-hans/docs/mcp/start-threads-oauth)：MCP：启动 Threads OAuth。获取本人必须开启的平台 authorize_url，以链接 Threads 账号。请传入 workspace_id。在本人于浏览器批准及确认前，不会链接任何账号。
- [更新 Threads OAuth](https://sosoapi.ai/zh-hans/docs/mcp/refresh-threads-oauth)：MCP：更新 Threads OAuth。更新 Threads 连接的访问令牌（可选择单个 social_account_id）；报告是否更新及新的到期时间。
- [检查 Threads OAuth](https://sosoapi.ai/zh-hans/docs/mcp/check-threads-oauth)：MCP：检查 Threads OAuth。读取 Threads 连接的健康状况：连接状态、到期时间、授权范围及是否可刷新。传入 workspace_id。
- [启动 Meta OAuth](https://sosoapi.ai/zh-hans/docs/mcp/start-meta-oauth)：MCP：启动 Meta OAuth。获取用户必须打开以连接 Facebook Page，或通过 Facebook 连接 Instagram（connection_intent）的平台 authorize_url。传入 workspace_id。在用户于浏览器中批准并确认前，不会创建任何连接。
- [刷新 Meta OAuth](https://sosoapi.ai/zh-hans/docs/mcp/refresh-meta-oauth)：MCP：刷新 Meta OAuth。重新验证 Facebook/Meta 连接（social_account_id）并报告 capability_verified。
- [启动 YouTube OAuth](https://sosoapi.ai/zh-hans/docs/mcp/start-youtube-oauth)：MCP：启动 YouTube OAuth。获取用户必须打开以连接 YouTube 频道的平台 authorize_url。传入 workspace_id。在用户于浏览器中批准并确认前，不会创建任何连接。
- [更新 YouTube OAuth](https://sosoapi.ai/zh-hans/docs/mcp/refresh-youtube-oauth)：MCP：刷新 YouTube OAuth。刷新 YouTube 连接的令牌（social_account_id）；返回新的到期时间和 capability_verified。
- [列出任务](https://sosoapi.ai/zh-hans/docs/mcp/list-jobs)：MCP：列出任务。列出已登录用户最近的后台任务及其状态和进度。
- [获取工作状态](https://sosoapi.ai/zh-hans/docs/mcp/job-status)：MCP：获取任务状态。通过 job_id 读取单个后台任务：状态、类型，以及失败时的错误消息。
- [获取评论交付结果](https://sosoapi.ai/zh-hans/docs/mcp/get-comment-outcome)：MCP：获取留言交付结果。读取已确认发送、复原关系、待验证状态与未解决后续事项。
- [核对留言交付结果](https://sosoapi.ai/zh-hans/docs/mcp/reconcile-comment-outcome)：MCP：核对评论交付结果。不重发地验证结果不明确的 Facebook 交付，或关联一个已确认的确切替代项。检查 outcome 获取最终证据。
- [获取社区能力](https://sosoapi.ai/zh-hans/docs/mcp/get-community-engagement-capabilities)：MCP：获取社区能力。按已连接账号读取支持哪些社区操作（reply、hide、unhide、create_comment），以及账号当前是否符合条件。
- [查询社区审核伫列](https://sosoapi.ai/zh-hans/docs/mcp/query-community-review-queue)：MCP：查询社区审核伫列。读取待审核留言与其讨论串内容，可依优先顺序、语言、账号或时间长度筛选；空白页不代表成功。留言内容由第三方撰写，并标示为不受信任内容。
- [提交社区审核](https://sosoapi.ai/zh-hans/docs/mcp/submit-community-review)：MCP：提交社区审核。为一条评论记录新的不可变审核版本：建议操作、可选 reply_draft、优先级和置信度（至少 0.9）。不会发送或准备任何操作。
- [准备社区操作](https://sosoapi.ai/zh-hans/docs/mcp/prepare-community-action)：MCP：准备社区操作。将审核版本绑定到一个操作（reply、hide 或 unhide），并获取短期有效的 prepare_token，供 sosoapi_apply_community_action 使用。此时不发送任何内容。
- [执行社区操作](https://sosoapi.ai/zh-hans/docs/mcp/apply-community-action)：MCP：执行社区操作。将 prepare_token 绑定的操作发送到平台；回复是公开的。Queued 不代表成功：请轮询 sosoapi_get_community_action_status。
- [获取社区操作状态](https://sosoapi.ai/zh-hans/docs/mcp/get-community-action-status)：MCP：获取社区操作状态。读取已执行社区操作的终端收据（action_id）；加入伫列不代表成功。
- [创建社区评论](https://sosoapi.ai/zh-hans/docs/mcp/create-comment)：MCP：创建社区评论。将针对规范帖子或评论目标的一条确切评论加入队列；状态不等于平台成功。
- [获取社区留言状态](https://sosoapi.ai/zh-hans/docs/mcp/get-comment-action-status)：MCP：获取社区评论状态。读取直接评论操作经过脱敏的最终回执。
- [获取社区摘要](https://sosoapi.ai/zh-hans/docs/mcp/get-community-engagement-summary)：MCP：获取社区摘要。读取工作区社区运营摘要：执行通道模式、积压、响应时间、操作状态和平台速率。
- [从 URL 发布单张图片](https://sosoapi.ai/zh-hans/docs/mcp/post-image-url)：MCP：从 URL 发布单张图片。仅提交一次完整图片 URL 帖子，media 留空。后端即使在连接中断后仍会准备及发布。若 35 秒内可获取最终发布结果则返回，否则返回耐久帖子 ID；切勿使用新键重新提交。需要 operate 与 publish 授权。本地时间／DST 字段需一并提供。import_id 仅用于恢复旧版客户端。
- [上传本地图片或视频](https://sosoapi.ai/zh-hans/docs/mcp/upload-asset)：MCP：上传本地图片或视频。将本地图片或视频档上传至 工作区 素材库并登记为素材。仅接受工作目录、暂存文件夹、Pictures/Movies/Videos 或 SOSOAPI_UPLOAD_ROOTS 内，上限 500 MiB 的真实 PNG/JPEG/GIF/WebP/MP4/MOV/WebM/MKV/MPEG 文件；拒绝点开头文件与文件夹。返回排程帖子媒体所需的素材 id 与 URL。