# MCP 工具參考

- [MCP 工具參考](https://sosoapi.ai/zh-tw/docs/mcp)：尋找工具輸入、輸出、設定檔，以及本機或託管環境的可用性。
- [取得使用者資料](https://sosoapi.ai/zh-tw/docs/mcp/get-user-profile)：MCP：取得使用者個人資料。讀取已登入使用者本人的個人資料（顯示名稱、時區、頭像、佈景主題）；尚未建立時 profile 為 null。
- [更新使用者資料](https://sosoapi.ai/zh-tw/docs/mcp/update-user-profile)：MCP：更新使用者資料。更改已登入使用者自己的資料（display_name、timezone、avatar_url、theme）。僅傳送需要更改的欄位。
- [產生頭像上傳簽名](https://sosoapi.ai/zh-tw/docs/mcp/sign-avatar-upload)：MCP：產生頭像上傳簽名。取得用於上傳已登入使用者新頭像圖片的已簽名 URL（需要 filename 和 content_type）。本身不會更改資料。
- [列出 API keys](https://sosoapi.ai/zh-tw/docs/mcp/list-api-keys)：MCP：列出 API keys。列出使用者 API keys（名稱、末 4 碼、狀態、到期時間、接替關係）；設定 include_authority 可同時取得各 key 的能力與 Workspace 限制。絕不回傳機密值。需要「管理 API keys」授權；PAT 無法使用。
- [建立 API key](https://sosoapi.ai/zh-tw/docs/mcp/create-api-key)：MCP：建立 API key。使用選定能力（agent:operate、agent:publish、agent:engage）、選用的 workspace_ids 限制及最長 365 天有效期建立個人存取 key；機密值只回傳一次，之後無法再次讀取。代理程式只能授予自己已有的授權，最長 30 天，該授權結束時 key 也會失效。需要「管理 API keys」授權；PAT 無法使用。
- [延長 API key 有效期](https://sosoapi.ai/zh-tw/docs/mcp/extend-api-key)：MCP：延長 API key 有效期。為透過 id 指定的 API key 設定更晚的到期時間（expires_at）：從現在起最多 365 天，代理程式建立的 key 為 30 天。代理程式只能延長由其自身授權建立的 key。需要管理 API keys 授權。
- [換發 API key](https://sosoapi.ai/zh-tw/docs/mcp/renew-api-key)：MCP：換發 API key。為 API key（id）建立接替 key，使用相同能力及 Workspace 限制，新機密值僅回傳一次，可選擇新名稱或有效期（最長 365 天，代理程式建立的 key 最長 30 天）。不會撤銷原 key。需要「管理 API keys」授權。
- [撤銷 API key](https://sosoapi.ai/zh-tw/docs/mcp/revoke-api-key)：MCP：撤銷 API key。依 id 撤銷 API key，使其立即失效；已撤銷的 key 會回報 already_revoked。代理程式只能撤銷由自己授權建立的 keys。需要「管理 API keys」授權。
- [取得帳務狀態](https://sosoapi.ai/zh-tw/docs/mcp/get-billing-status)：MCP：取得帳務狀態。讀取使用者的帳務方案、付款狀態、目前週期日期及配額用量（成功發布、待處理排程貼文、已連結帳號）。大量排程前請先檢查。
- [取得商業存取權限](https://sosoapi.ai/zh-tw/docs/mcp/get-commercial-access)：MCP：取得商業存取資格。讀取單一 Workspace 帳務帳戶的方案與配額資訊，以及 commercial_access_mode（off、shadow 或 enforce）。
- [取得 Organization 資訊](https://sosoapi.ai/zh-tw/docs/mcp/get-organization-context)：MCP：取得組織資訊。讀取組織、所屬工作空間和頻道的即時映射，含 id 和角色。需要組織或頻道 id 時使用。對工作空間發布貼文，重複使用回傳的工作空間 id；不必另讀工作空間資訊。
- [建立 Workspace](https://sosoapi.ai/zh-tw/docs/mcp/create-workspace)：MCP：建立工作空間。在您擁有或管理的組織中建立工作空間。屬於多個組織時，傳入 organization_id。後續呼叫使用回傳的 id：不要假定新工作空間會成為使用中的工作空間。
- [取得工作空間資訊](https://sosoapi.ai/zh-tw/docs/mcp/get-workspace-context)：MCP：取得工作空間資訊。列出已登入使用者所屬的工作空間及目前使用中的工作空間。在 workspace_id 未知時使用；重複使用即時資訊，不必重複執行兩個資訊讀取操作。其回報的使用中的工作空間是本人在網頁應用程式中所作的選擇，並非呼叫的預設值：請明確傳入 workspace_id。它並非純讀取操作：如果帳號沒有工作空間，會建立第一個工作空間。
- [更新 Workspace](https://sosoapi.ai/zh-tw/docs/mcp/update-workspace)：MCP：更新 Workspace。重新命名 Workspace 或變更其代稱。僅限 Workspace 擁有者。
- [列出組織](https://sosoapi.ai/zh-tw/docs/mcp/list-organizations)：MCP：列出組織。列出已登入使用者所屬的 Organizations，以及 Organization 範圍工具用作 organization_id 的 ID。
- [列出組織連結](https://sosoapi.ai/zh-tw/docs/mcp/list-organization-connections)：MCP：列出組織連結。列出組織的平台連結（Meta、Instagram、Threads、YouTube）及其狀態。需要 organization_id。
- [審核組織連結](https://sosoapi.ai/zh-tw/docs/mcp/review-organization-connection)：MCP：審核組織連結。讀取一個待處理連結操作（operation_id）發現的平台帳號和頁面，供審核。唯讀：由使用者在網頁應用程式中確認連結。
- [列出組織頻道](https://sosoapi.ai/zh-tw/docs/mcp/list-organization-channels)：MCP：列出組織頻道。列出 Organization 的頻道（已連結的平台帳號），以及各頻道所屬的 Workspace。
- [預覽頻道移動](https://sosoapi.ai/zh-tw/docs/mcp/preview-organization-channel-move)：MCP：預覽頻道移動。試行：檢查頻道能否移至其他 Workspace，並列出阻礙事項。不變更任何內容。
- [列出工作空間成員](https://sosoapi.ai/zh-tw/docs/mcp/list-workspace-members)：MCP：列出 Workspace 成員。列出 Workspace 成員與待處理邀請。
- [提交回饋](https://sosoapi.ai/zh-tw/docs/mcp/submit-feedback)：MCP：提交回饋。代表使用者向 SosoAPI 團隊傳送產品回饋（type 為 bug、feature 或 general；最多 4,000 個字元）。僅在使用者要求時使用。
- [取得通知偏好](https://sosoapi.ai/zh-tw/docs/mcp/get-notification-preferences)：MCP：取得通知偏好。讀取使用者通知設定（目前為貼文失敗時是否傳送電子郵件）。
- [更新通知偏好](https://sosoapi.ai/zh-tw/docs/mcp/update-notification-preferences)：MCP：更新通知偏好。更改使用者通知設定（email_post_failed 開啟或關閉）。
- [列出收件匣通知](https://sosoapi.ai/zh-tw/docs/mcp/list-inbox-notifications)：MCP：列出收件匣通知。讀取使用者的應用程式內收件匣，最新優先（最多 50 筆），可選擇僅未讀或某一種類型。
- [列出已連結帳號](https://sosoapi.ai/zh-tw/docs/mcp/list-connected-accounts)：MCP：列出已連結帳號。列出連結至 Workspace 的社群帳號（Instagram、Threads、Facebook、YouTube），包含連線健康狀態與能力資訊。排程或留言時，將其 id 用作 social_account_id。請傳入 workspace_id：強制明確指定目標後，未提供即拒絕。
- [斷開社群帳號連結](https://sosoapi.ai/zh-tw/docs/mcp/disconnect-social-account)：MCP：中斷社群帳號連結。中斷社群帳號與 Workspace 的連結（僅限 Workspace 擁有者）。在本人透過以下方式重新連結前，將停止向該帳號發布 `sosoapi connect`.
- [設定社群帳號自動同步](https://sosoapi.ai/zh-tw/docs/mcp/set-social-account-auto-sync)：MCP：設定社群帳號自動同步。開啟或關閉單一已連結社群帳號的自動同步（editor 角色）。不會發布任何內容。
- [解除社群帳號封鎖](https://sosoapi.ai/zh-tw/docs/mcp/clear-social-account-block)：MCP：解除社群帳號封鎖。解除帳號的平台冷卻狀態，讓發布可恢復。不會重試任何失敗貼文；請使用 sosoapi_retry_scheduled_post 重試。
- [查詢素材](https://sosoapi.ai/zh-tw/docs/mcp/query-assets)：MCP：查詢素材。按 asset_type、source 或 tag 查找工作空間素材；回傳分頁結果（limit 最大 100，加上 offset）和總數。明確傳入 workspace_id。
- [取得素材](https://sosoapi.ai/zh-tw/docs/mcp/get-asset)：MCP：取得素材。依 id 讀取單一素材：中繼資料與短效預覽 URL。
- [建立素材](https://sosoapi.ai/zh-tw/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-tw/docs/mcp/update-asset)：MCP：更新素材。更改素材的標題、描述或標籤（editor 角色）。
- [刪除素材](https://sosoapi.ai/zh-tw/docs/mcp/delete-asset)：MCP：刪除素材。依 id 從 Workspace 素材庫刪除單一素材。僅限 Workspace 擁有者。
- [列出素材](https://sosoapi.ai/zh-tw/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-tw/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-tw/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-tw/docs/mcp/list-orphan-assets)：MCP：列出孤立素材。列出 Workspace 中沒有素材記錄指向的儲存物件（儲存空間清理），以接續權杖分頁。僅限 Workspace 擁有者。
- [刪除孤立素材](https://sosoapi.ai/zh-tw/docs/mcp/delete-orphan-assets)：MCP：刪除孤立素材。按 key 刪除所選未登記儲存物件。僅限工作空間擁有者；請先用 sosoapi_list_orphan_assets 列出。
- [取得素材儲存清單](https://sosoapi.ai/zh-tw/docs/mcp/get-asset-storage-inventory)：MCP：取得素材儲存清單。讀取工作空間已登記素材和已儲存物件的分頁清單，以稽核儲存。
- [建立素材匯出](https://sosoapi.ai/zh-tw/docs/mcp/create-asset-export)：MCP：建立素材匯出。將所選素材（asset_ids）匯出為清單。export_verify_then_purge 模式會為後續清除預作準備。idempotency_key 為選填。
- [驗證素材匯出](https://sosoapi.ai/zh-tw/docs/mcp/verify-asset-export)：MCP：驗證素材匯出。開始驗證素材匯出（export_id）。必須先驗證匯出，才能請求清除。
- [取得素材匯出狀態](https://sosoapi.ai/zh-tw/docs/mcp/get-asset-export-status)：MCP：取得素材匯出狀態。讀取素材匯出的狀態：exported、verification_required、verifying、verified 或 failed。
- [請求清除素材](https://sosoapi.ai/zh-tw/docs/mcp/request-asset-purge)：MCP：請求清除素材。請求永久刪除已驗證匯出所涵蓋素材的儲存位元組（export_id、asset_ids；可能需要 confirm_history_loss）。僅限工作空間擁有者；刪除後不可撤銷。
- [重試素材清除](https://sosoapi.ai/zh-tw/docs/mcp/retry-asset-purge)：MCP：重試素材清除。重試已停止的清除請求（purge_request_id）。僅限 Workspace 擁有者。
- [列出專案](https://sosoapi.ai/zh-tw/docs/mcp/list-projects)：MCP：列出專案。列出 Workspace 專案（用於來源與帳號預設值的選用層），以及目前使用中的專案。
- [取得專案](https://sosoapi.ai/zh-tw/docs/mcp/get-project)：MCP：取得專案。透過 id 讀取單一專案：名稱、生命週期狀態，以及後續寫入所需的生命週期和預設值版本。
- [建立專案](https://sosoapi.ai/zh-tw/docs/mcp/create-project)：MCP：建立專案。在工作空間中建立專案。僅限工作空間擁有者；選填 idempotency_key。
- [更新專案](https://sosoapi.ai/zh-tw/docs/mcp/update-project)：MCP：更新專案。重新命名專案（名稱是唯一可編輯欄位）。僅限 Workspace 擁有者。
- [設定使用中專案](https://sosoapi.ai/zh-tw/docs/mcp/set-active-project)：MCP：設定使用中專案。設定使用者的使用中專案（伺服器端預設值）。
- [取得專案帳號預設值](https://sosoapi.ai/zh-tw/docs/mcp/get-project-account-defaults)：MCP：取得專案帳號預設值。讀取專案的預設社群帳號及各帳號覆寫值，以及下次取代時需要的 defaults_version。
- [取代專案帳號預設值](https://sosoapi.ai/zh-tw/docs/mcp/replace-project-account-defaults)：MCP：替換專案帳號預設值。一次替換專案預設帳號和覆寫設定。需要最新讀取中的 expected_defaults_version 和 idempotency_key（editor 角色）。
- [封存專案](https://sosoapi.ai/zh-tw/docs/mcp/archive-project)：MCP：封存專案。封存專案但不變更其排程貼文。如需停止貼文，請另行取消該排程貼文。僅限 Workspace 擁有者；請傳入 expected_lifecycle_version 及 idempotency_key。
- [取消封存專案](https://sosoapi.ai/zh-tw/docs/mcp/unarchive-project)：MCP：取消封存專案。重新啟用已封存專案。不會恢復或重新排程貼文；請透過排程貼文另行管理。僅限 Workspace 擁有者；請傳入 expected_lifecycle_version 及 idempotency_key。
- [取得專案生命週期歷程](https://sosoapi.ai/zh-tw/docs/mcp/get-project-lifecycle-history)：MCP：取得專案生命週期歷程。讀取專案生命週期事件（如封存和取消封存），最多 200 筆。
- [取得專案資料](https://sosoapi.ai/zh-tw/docs/mcp/get-project-profile)：MCP：取得專案設定檔。讀取專案品牌設定檔（標語、語氣、目標受眾、目標、色盤等）；不存在時 profile 為 null。
- [更新專案設定檔](https://sosoapi.ai/zh-tw/docs/mcp/update-project-profile)：MCP：更新專案資料。局部更新專案品牌資料欄位。省略的欄位保持不變。需要最新讀取中的 expected_profile_version 和 idempotency_key（editor 角色）。
- [列出專案素材](https://sosoapi.ai/zh-tw/docs/mcp/list-project-assets)：MCP：列出專案素材。列出連結至專案的素材，並顯示每個連結的關係（identity、source 或 reference），使用游標分頁。
- [關聯專案素材](https://sosoapi.ai/zh-tw/docs/mcp/link-project-asset)：MCP：連結專案素材。將既有素材以 identity、source 或 reference 關係連結至專案。需要 editor 角色及 idempotency_key。
- [解除專案素材連結](https://sosoapi.ai/zh-tw/docs/mcp/unlink-project-asset)：MCP：解除專案素材連結。移除素材與專案的關聯；素材本身保留。需要 idempotency_key。
- [列出專案帳號](https://sosoapi.ai/zh-tw/docs/mcp/list-project-accounts)：MCP：列出專案帳號。列出專案關聯的社群帳號，採用游標分頁。
- [關聯專案帳號](https://sosoapi.ai/zh-tw/docs/mcp/link-project-account)：MCP：關聯專案帳號。將已連結社群帳號關聯到專案。需要 editor 角色及 idempotency_key。
- [解除專案帳號連結](https://sosoapi.ai/zh-tw/docs/mcp/unlink-project-account)：MCP：解除專案帳號連結。移除社群帳號與專案的關聯；帳號保持連結。需要 idempotency_key。
- [建立專案匯出](https://sosoapi.ai/zh-tw/docs/mcp/create-project-export)：MCP：建立專案匯出。開始匯出專案（僅限 Workspace 擁有者）；請輪詢 sosoapi_get_project_export_status 以取得下載 URL。需要 idempotency_key。
- [取得專案匯出狀態](https://sosoapi.ai/zh-tw/docs/mcp/get-project-export-status)：MCP：取得專案匯出狀態。讀取專案匯出（export_id）：queued、processing、completed（附短效的下載 URL）或 failed。僅限工作空間擁有者。
- [列出待處理發布事項](https://sosoapi.ai/zh-tw/docs/mcp/list-publication-attentions)：MCP：列出待處理發布事項。列出 Workspace 中需要注意的發布事項，可依 status（open 或 resolved）或 scheduled_post_id 篩選，並以位移分頁。
- [取得 X 發布額度](https://sosoapi.ai/zh-tw/docs/mcp/get-x-usage)：MCP：取得 X 發布額度。讀取此工作空間共享的組織 X 發布額度。需要 workspace_id。Free 一次性獲得 10；Pro 每個帳務週期獲得 100。純文字消耗 1，含 URL 文字消耗 10。選填 text 可估算其成本。此操作讀取已儲存額度，不呼叫 X API。
- [列出排程貼文](https://sosoapi.ai/zh-tw/docs/mcp/list-scheduled-posts)：MCP：列出排程貼文。列出工作空間排程貼文，可按專案、狀態（scheduled、publishing、published、failed、expired、needs_reschedule、cancelled、deleted）及時間範圍篩選，採用游標分頁。
- [取得排程貼文](https://sosoapi.ai/zh-tw/docs/mcp/get-scheduled-post)：MCP：取得排程貼文。透過 id 讀取單一排程貼文：內容、狀態、傳送狀態和結果。其 version 是 update、publish、retry 和 cancel 操作所需的 expected_version。
- [取得排程貼文資格](https://sosoapi.ai/zh-tw/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-tw/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-tw/docs/mcp/bulk-create-scheduled-posts)：MCP：批次建立排程貼文。一次呼叫為多個帳號排程貼文（targets）。媒體需要已上傳／匯入且已就緒的 asset_ids 及其標準 URL。每個目標獨立成功或失敗，並列於 successes 或 failures。需要 publish 能力。
- [更新排程貼文](https://sosoapi.ai/zh-tw/docs/mcp/update-scheduled-post)：MCP：更新排程貼文。編輯尚未派送的排程貼文（caption、hashtags、media、link、time）。需要最新讀取中的 expected_version；過期版本會被拒絕。
- [立即發布排程貼文](https://sosoapi.ai/zh-tw/docs/mcp/publish-scheduled-post-now)：MCP：立即發布排程貼文。立即發布排程貼文，而非等到 scheduled_at。操作公開且不可撤銷；需要 expected_version。Queued 不等於已發布：請讀取結果。
- [重試排程貼文](https://sosoapi.ai/zh-tw/docs/mcp/retry-scheduled-post)：MCP：重試排程貼文。重試失敗的排程貼文，可選擇新的 scheduled_at。需要 expected_version。
- [刪除排程貼文](https://sosoapi.ai/zh-tw/docs/mcp/delete-scheduled-post)：MCP：刪除排程貼文。刪除尚未發布的排程貼文（scheduled、needs_reschedule、failed 或 cancelled）。代理程式無法刪除已發布的平台內容。需要 expected_version。
- [取消排程貼文](https://sosoapi.ai/zh-tw/docs/mcp/cancel-scheduled-post)：MCP：取消排程貼文。取消尚未發布的排程貼文，使其不再傳送。已發布貼文會被拒絕，代理程式也無法刪除已發布內容：使用者需在網頁應用程式中操作。需要 expected_version。
- [撤回刪除請求](https://sosoapi.ai/zh-tw/docs/mcp/withdraw-scheduled-post-delete)：MCP：撤回刪除請求。撤回已停止的 Instagram Login 刪除請求並保留已發布貼文。需要 expected_version。
- [取得儀表板計數](https://sosoapi.ai/zh-tw/docs/mcp/get-dashboard-counts)：MCP：取得儀表板數量。讀取 Workspace 操作數量：排程貼文、近期工作及已連結帳號。
- [列出監測中的貼文](https://sosoapi.ai/zh-tw/docs/mcp/list-monitored-posts)：MCP：列出監測到的貼文。列出 SosoAPI 為工作空間發現的社群貼文（id、平台、永久連結、發布時間），可按帳號、平台和時間篩選，採用游標分頁。僅包含中繼資料，不含文案。
- [列出貼文留言](https://sosoapi.ai/zh-tw/docs/mcp/list-post-comments)：MCP：列出貼文留言。列出 Workspace 貼文上觀測到的留言，依最新觀測優先排序，包含作者與文字；可依貼文、帳號、平台或時間篩選，使用游標分頁。文字由第三方撰寫，並標示為不受信任內容。
- [請求平台洞察](https://sosoapi.ai/zh-tw/docs/mcp/request-provider-insights)：MCP：請求平台洞察。請求平台提供某帳號或單則貼文的洞察，可指定日期範圍（最多 366 天）。回傳 request_id，命中快取時也回傳結果；否則輪詢 sosoapi_get_provider_insight_status。
- [取得平台洞察狀態](https://sosoapi.ai/zh-tw/docs/mcp/get-provider-insight-status)：MCP：取得平台洞察狀態。讀取洞察請求（request_id）：queued、processing、completed（含平台結果及各指標可用性）或 failed。
- [啟動 Instagram OAuth](https://sosoapi.ai/zh-tw/docs/mcp/start-instagram-oauth)：MCP：啟動 Instagram OAuth。取得本人必須開啟的平台 authorize_url，以連結 Instagram 帳號。請傳入 workspace_id。在本人於瀏覽器核准及確認前，不會連結任何帳號。
- [更新 Instagram OAuth](https://sosoapi.ai/zh-tw/docs/mcp/refresh-instagram-oauth)：MCP：更新 Instagram OAuth。更新 Instagram 連結的存取權杖（可選擇一個 social_account_id）；回報是否已更新及新的到期時間。
- [啟動 Threads OAuth](https://sosoapi.ai/zh-tw/docs/mcp/start-threads-oauth)：MCP：啟動 Threads OAuth。取得本人必須開啟的平台 authorize_url，以連結 Threads 帳號。請傳入 workspace_id。在本人於瀏覽器核准及確認前，不會連結任何帳號。
- [更新 Threads OAuth](https://sosoapi.ai/zh-tw/docs/mcp/refresh-threads-oauth)：MCP：更新 Threads OAuth。更新 Threads 連線的存取權杖（可選擇單一 social_account_id）；回報是否更新及新的到期時間。
- [檢查 Threads OAuth](https://sosoapi.ai/zh-tw/docs/mcp/check-threads-oauth)：MCP：檢查 Threads OAuth。讀取 Threads 連結的健康狀態：連結狀態、到期時間、授權範圍及是否可更新。傳入 workspace_id。
- [啟動 Meta OAuth](https://sosoapi.ai/zh-tw/docs/mcp/start-meta-oauth)：MCP：啟動 Meta OAuth。取得使用者必須開啟以連結 Facebook Page，或透過 Facebook 連結 Instagram（connection_intent）的平台 authorize_url。傳入 workspace_id。在使用者於瀏覽器中核准並確認前，不會建立任何連結。
- [更新 Meta OAuth](https://sosoapi.ai/zh-tw/docs/mcp/refresh-meta-oauth)：MCP：更新 Meta OAuth。重新驗證 Facebook/Meta 連結（social_account_id）並回報 capability_verified。
- [啟動 YouTube OAuth](https://sosoapi.ai/zh-tw/docs/mcp/start-youtube-oauth)：MCP：啟動 YouTube OAuth。取得使用者必須開啟以連結 YouTube 頻道的平台 authorize_url。傳入 workspace_id。在使用者於瀏覽器中核准並確認前，不會建立任何連結。
- [更新 YouTube OAuth](https://sosoapi.ai/zh-tw/docs/mcp/refresh-youtube-oauth)：MCP：更新 YouTube OAuth。更新 YouTube 連結的權杖（social_account_id）；回傳新的到期時間和 capability_verified。
- [列出工作](https://sosoapi.ai/zh-tw/docs/mcp/list-jobs)：MCP：列出工作。列出已登入使用者最近的背景工作及其狀態和進度。
- [取得工作狀態](https://sosoapi.ai/zh-tw/docs/mcp/job-status)：MCP：取得工作狀態。透過 job_id 讀取單一背景工作：狀態、類型，以及失敗時的錯誤訊息。
- [取得留言傳送結果](https://sosoapi.ai/zh-tw/docs/mcp/get-comment-outcome)：MCP：取得留言傳送結果。讀取已確認傳送、復原關係、待驗證狀態與未解決後續事項。
- [核對留言傳送結果](https://sosoapi.ai/zh-tw/docs/mcp/reconcile-comment-outcome)：MCP：核對留言傳送結果。不重送地驗證結果不明確的 Facebook 傳送，或關聯一個已確認的確切替代項。檢查 outcome 取得最終證據。
- [取得社群能力](https://sosoapi.ai/zh-tw/docs/mcp/get-community-engagement-capabilities)：MCP：取得社群能力。按已連結帳號讀取支援哪些社群操作（reply、hide、unhide、create_comment），以及帳號目前是否符合資格。
- [查詢社群審核佇列](https://sosoapi.ai/zh-tw/docs/mcp/query-community-review-queue)：MCP：查詢社群審核佇列。讀取待審核留言與其討論串內容，可依優先順序、語言、帳號或時間長度篩選；空白頁不代表成功。留言內容由第三方撰寫，並標示為不受信任內容。
- [提交社群審核](https://sosoapi.ai/zh-tw/docs/mcp/submit-community-review)：MCP：提交社群審核。為一則留言記錄新的不可變更的審核版本：建議操作、選填 reply_draft、優先順序和信心分數（至少 0.9）。不會傳送或準備任何操作。
- [準備社群操作](https://sosoapi.ai/zh-tw/docs/mcp/prepare-community-action)：MCP：準備社群操作。將審核版本繫結到一個操作（reply、hide 或 unhide），並取得短效的 prepare_token，供 sosoapi_apply_community_action 使用。此時不傳送任何內容。
- [執行社群操作](https://sosoapi.ai/zh-tw/docs/mcp/apply-community-action)：MCP：執行社群操作。將 prepare_token 繫結的操作傳送到平台；回覆是公開的。Queued 不代表成功：請輪詢 sosoapi_get_community_action_status。
- [取得社群操作狀態](https://sosoapi.ai/zh-tw/docs/mcp/get-community-action-status)：MCP：取得社群操作狀態。讀取已執行社群操作的終端收據（action_id）；加入佇列不代表成功。
- [建立社群留言](https://sosoapi.ai/zh-tw/docs/mcp/create-comment)：MCP：建立社群留言。將針對標準貼文或留言目標的一則確切留言加入佇列；狀態不等於平台成功。
- [取得社群留言狀態](https://sosoapi.ai/zh-tw/docs/mcp/get-comment-action-status)：MCP：取得社群留言狀態。讀取直接留言操作經過遮蔽敏感內容的最終收據。
- [取得社群摘要](https://sosoapi.ai/zh-tw/docs/mcp/get-community-engagement-summary)：MCP：取得社群摘要。讀取工作空間社群營運摘要：執行通道模式、待辦量、回應時間、操作狀態和平台速率。
- [從 URL 發布單張圖片](https://sosoapi.ai/zh-tw/docs/mcp/post-image-url)：MCP：從 URL 發布單張圖片。僅提交一次完整圖片 URL 貼文，media 留空。後端即使在連線中斷後仍會準備及發布。若 35 秒內可取得終端發布結果則回傳，否則回傳耐久貼文 ID；切勿使用新鍵重新提交。需要 operate 與 publish 授權。本地時間／DST 欄位需一併提供。import_id 僅用於恢復舊版用戶端。
- [上傳本機圖片或影片](https://sosoapi.ai/zh-tw/docs/mcp/upload-asset)：MCP：上傳本機圖片或影片。將本機圖片或影片檔上傳至 Workspace 素材庫並登記為素材。僅接受工作目錄、暫存資料夾、Pictures/Movies/Videos 或 SOSOAPI_UPLOAD_ROOTS 內，上限 500 MiB 的真實 PNG/JPEG/GIF/WebP/MP4/MOV/WebM/MKV/MPEG 檔案；拒絕點開頭檔案與資料夾。回傳排程貼文媒體所需的素材 id 與 URL。