# Referencia de herramientas MCP

- [Referencia de herramientas MCP](https://sosoapi.ai/es/docs/mcp): Encuentra entradas, salidas, perfiles y disponibilidad local o alojada de las herramientas.
- [Obtener perfil de usuario](https://sosoapi.ai/es/docs/mcp/get-user-profile): MCP: Obtener perfil de usuario. Consulta el perfil del usuario que ha iniciado sesión (nombre visible, zona horaria, avatar, tema); profile es null hasta que exista uno.
- [Actualizar perfil de usuario](https://sosoapi.ai/es/docs/mcp/update-user-profile): MCP: Actualizar perfil de usuario. Cambia el perfil del usuario que ha iniciado sesión (display_name, timezone, avatar_url, theme). Envía solo los campos que deban cambiarse.
- [Firmar carga de avatar](https://sosoapi.ai/es/docs/mcp/sign-avatar-upload): MCP: Firmar carga de avatar. Obtiene una URL firmada para cargar una nueva imagen de avatar del usuario que ha iniciado sesión (requiere filename y content_type). Por sí sola no cambia el perfil.
- [Listar claves API](https://sosoapi.ai/es/docs/mcp/list-api-keys): MCP: Listar claves API. Lista las claves API del usuario (nombre, últimos 4 caracteres, estado, vencimiento, historial); establece include_authority para obtener también las capacidades y el límite de espacios de trabajo de cada clave. Nunca se devuelven secretos. Requiere el permiso para administrar claves API; un PAT no puede usarlo.
- [Crear clave API](https://sosoapi.ai/es/docs/mcp/create-api-key): MCP: Crear clave API. Crea una clave de acceso personal con las capacidades elegidas (agent:operate, agent:publish, agent:engage), un límite opcional workspace_ids y una vigencia de hasta 365 días; el secreto se devuelve una sola vez y no puede volver a consultarse. Un agente solo puede conceder lo que permite su propia autorización, durante un máximo de 30 días, y la clave deja de funcionar cuando termina esa concesión. Requiere el permiso para administrar claves API; un PAT no puede usarlo.
- [Ampliar vigencia de clave API](https://sosoapi.ai/es/docs/mcp/extend-api-key): MCP: Ampliar vigencia de clave API. Establece un vencimiento posterior (expires_at) para una clave API identificada por id: como máximo 365 días desde ahora, o 30 para una clave creada por un agente. Un agente solo puede ampliar claves creadas por su propia concesión. Requiere el permiso para administrar claves API.
- [Renovar clave API](https://sosoapi.ai/es/docs/mcp/renew-api-key): MCP: Renovar clave API. Crea una clave sucesora de una clave API (id), con un secreto nuevo que se devuelve una sola vez y las mismas capacidades y límite de espacios de trabajo; permite un nombre o una vigencia nuevos (máximo 365 días, o 30 para una clave creada por un agente). La clave original no se revoca. Requiere el permiso para administrar claves API.
- [Revocar clave API](https://sosoapi.ai/es/docs/mcp/revoke-api-key): MCP: Revocar clave API. Revoca una clave API por id para que deje de funcionar inmediatamente; una clave ya revocada devuelve already_revoked. Un agente solo puede revocar claves creadas por su propia concesión. Requiere el permiso para administrar claves API.
- [Obtener estado de facturación](https://sosoapi.ai/es/docs/mcp/get-billing-status): MCP: Obtener estado de facturación. Consulta el plan de facturación del usuario, el estado del pago, las fechas del ciclo actual y el uso de cuotas (publicaciones exitosas, publicaciones programadas pendientes, cuentas conectadas). Compruébalo antes de programar grandes lotes.
- [Obtener acceso comercial](https://sosoapi.ai/es/docs/mcp/get-commercial-access): MCP: Obtener acceso comercial. Consulta los datos de plan y cuotas de la cuenta de facturación de un espacio de trabajo, junto con su commercial_access_mode (off, shadow o enforce).
- [Obtener contexto de la organización](https://sosoapi.ai/es/docs/mcp/get-organization-context): MCP: Obtener contexto de la organización. Consulta el mapa actual de tus organizaciones, sus espacios de trabajo y canales, con sus ids y roles. Úsalo cuando necesites ids de organización o canal. Para publicar en un espacio de trabajo, reutiliza un id de espacio de trabajo devuelto; no leas además su contexto.
- [Crear espacio de trabajo](https://sosoapi.ai/es/docs/mcp/create-workspace): MCP: Crear espacio de trabajo. Crea un espacio de trabajo en una organización de la que eres propietario o administrador. Proporciona organization_id si perteneces a varias organizaciones. Usa el id devuelto en las siguientes llamadas: no supongas que el nuevo espacio de trabajo pasa a ser el activo.
- [Obtener contexto del espacio de trabajo](https://sosoapi.ai/es/docs/mcp/get-workspace-context): MCP: Obtener contexto del espacio de trabajo. Lista los espacios de trabajo a los que pertenece el usuario que ha iniciado sesión e indica cuál está activo. Úsalo si no conoces workspace_id; reutiliza el contexto actual en vez de repetir ambas lecturas de contexto. El espacio de trabajo activo que indica es el elegido por una persona en la aplicación web, no un valor predeterminado para tus llamadas: proporciona workspace_id explícitamente. No es solo una lectura: para una cuenta sin espacio de trabajo, crea el primero.
- [Actualizar espacio de trabajo](https://sosoapi.ai/es/docs/mcp/update-workspace): MCP: Actualizar espacio de trabajo. Cambia el nombre o slug de un espacio de trabajo. Solo el propietario del espacio de trabajo.
- [Listar organizaciones](https://sosoapi.ai/es/docs/mcp/list-organizations): MCP: Listar organizaciones. Lista las organizaciones a las que pertenece el usuario que ha iniciado sesión, con los ids que las herramientas de alcance organizativo reciben como organization_id.
- [Listar conexiones de la organización](https://sosoapi.ai/es/docs/mcp/list-organization-connections): MCP: Listar conexiones de la organización. Lista las conexiones de proveedores de una organización (Meta, Instagram, Threads, YouTube) y su estado. Requiere organization_id.
- [Revisar conexión de organización](https://sosoapi.ai/es/docs/mcp/review-organization-connection): MCP: Revisar conexión de organización. Consulta las cuentas y páginas del proveedor detectadas por una operación de conexión pendiente (operation_id) para revisarlas. Solo lectura: una persona confirma la conexión en la aplicación web.
- [Listar canales de la organización](https://sosoapi.ai/es/docs/mcp/list-organization-channels): MCP: Listar canales de la organización. Lista los canales de una organización (cuentas conectadas de proveedores) y el espacio de trabajo al que pertenece cada uno.
- [Previsualizar traslado de canal](https://sosoapi.ai/es/docs/mcp/preview-organization-channel-move): MCP: Previsualizar traslado de canal. Simulación: comprueba si un canal puede trasladarse a otro espacio de trabajo y enumera los impedimentos. No cambia nada.
- [Listar miembros del espacio de trabajo](https://sosoapi.ai/es/docs/mcp/list-workspace-members): MCP: Listar miembros del espacio de trabajo. Lista los miembros de un espacio de trabajo y sus invitaciones pendientes.
- [Enviar comentarios sobre el producto](https://sosoapi.ai/es/docs/mcp/submit-feedback): MCP: Enviar comentarios sobre el producto. Envía comentarios sobre el producto (tipo bug, feature o general; hasta 4,000 caracteres) al equipo de SosoAPI en nombre del usuario. Úsalo solo si el usuario lo pide.
- [Obtener preferencias de notificación](https://sosoapi.ai/es/docs/mcp/get-notification-preferences): MCP: Obtener preferencias de notificación. Consulta la configuración de notificaciones del usuario (actualmente, si se envía un correo cuando falla una publicación).
- [Actualizar preferencias de notificación](https://sosoapi.ai/es/docs/mcp/update-notification-preferences): MCP: Actualizar preferencias de notificación. Cambia la configuración de notificaciones del usuario (email_post_failed activado o desactivado).
- [Listar notificaciones de la bandeja de entrada](https://sosoapi.ai/es/docs/mcp/list-inbox-notifications): MCP: Listar notificaciones de la bandeja de entrada. Consulta la bandeja de entrada del usuario en la aplicación, de más reciente a más antigua (hasta 50), opcionalmente solo elementos sin leer o de un tipo.
- [Listar cuentas conectadas](https://sosoapi.ai/es/docs/mcp/list-connected-accounts): MCP: Listar cuentas conectadas. Lista las cuentas sociales (Instagram, Threads, Facebook, YouTube) conectadas a un espacio de trabajo, con datos del estado de conexión y las capacidades. Usa sus ids como social_account_id al programar o comentar. Proporciona workspace_id: una solicitud sin él se rechaza cuando se exige un destino explícito.
- [Desconectar cuenta social](https://sosoapi.ai/es/docs/mcp/disconnect-social-account): MCP: Desconectar cuenta social. Desconecta una cuenta social de su espacio de trabajo (solo el propietario). La publicación en ella se detiene hasta que una persona vuelva a conectarla con `sosoapi connect`.
- [Configurar sincronización automática de cuenta social](https://sosoapi.ai/es/docs/mcp/set-social-account-auto-sync): MCP: Configurar sincronización automática de cuenta social. Activa o desactiva la sincronización automática de una cuenta social conectada (rol editor). No publica nada.
- [Quitar bloqueo de cuenta social](https://sosoapi.ai/es/docs/mcp/clear-social-account-block): MCP: Quitar bloqueo de cuenta social. Quita el período de espera impuesto por el proveedor a una cuenta para reanudar la publicación. No reintenta publicaciones fallidas; para ello usa sosoapi_retry_scheduled_post.
- [Buscar recursos](https://sosoapi.ai/es/docs/mcp/query-assets): MCP: Buscar recursos. Busca recursos de un espacio de trabajo por asset_type, source o tag; devuelve una página (limit hasta 100, más offset) y el total. Proporciona workspace_id explícitamente.
- [Obtener recurso](https://sosoapi.ai/es/docs/mcp/get-asset): MCP: Obtener recurso. Consulta un recurso por id: metadatos y una URL de vista previa de corta duración.
- [Crear recurso](https://sosoapi.ai/es/docs/mcp/create-asset): MCP: Crear recurso. Registra un recurso para archivos multimedia o texto que ya alojas (asset_url, asset_type). No carga nada: usa sosoapi_upload_asset para un archivo local o sosoapi_import_asset_url para que SosoAPI obtenga una URL pública. Proporciona workspace_id (se rechaza sin él cuando se exige un destino explícito). idempotency_key opcional.
- [Actualizar recurso](https://sosoapi.ai/es/docs/mcp/update-asset): MCP: Actualizar recurso. Cambia el título, la descripción o las etiquetas de un recurso (rol editor).
- [Eliminar recurso](https://sosoapi.ai/es/docs/mcp/delete-asset): MCP: Eliminar recurso. Elimina un recurso de la biblioteca del espacio de trabajo por id. Solo el propietario del espacio de trabajo.
- [Listar recursos](https://sosoapi.ai/es/docs/mcp/list-assets): MCP: Listar recursos. Lista los recursos de un espacio de trabajo filtrados por tipo (video, image, audio, cover, thumbnail, frame, video-source, branding) o customer_ready_only, con paginación next_offset. Requiere workspace_id.
- [Importar URL de recurso](https://sosoapi.ai/es/docs/mcp/import-asset-url): MCP: Importar URL de recurso. Solicita a SosoAPI descargar una imagen o un video desde una URL http(s) pública al almacenamiento privado del espacio de trabajo como recurso nuevo. Devuelve un import_id; consulta sosoapi_get_asset_import_status. Requiere un idempotency_key y el rol editor.
- [Obtener estado de importación de recursos](https://sosoapi.ai/es/docs/mcp/get-asset-import-status): MCP: Obtener estado de importación de recursos. Consulta una importación por import_id. Para publicar, proporciona include_asset=true: un resultado ready incluye el id del recurso registrado, su tipo y una asset_url estable, evitando un get_asset adicional. No se pueden programar recursos pendientes o ausentes. Nunca uses la URL de origen o vista previa como identidad del archivo multimedia. Si se bloquea, consulta sosoapi_job_status con job_id; nunca inicies una importación duplicada.
- [Listar recursos huérfanos](https://sosoapi.ai/es/docs/mcp/list-orphan-assets): MCP: Listar recursos huérfanos. Lista los objetos almacenados en un espacio de trabajo a los que no apunta ningún registro de recurso (limpieza de almacenamiento), con paginación por token de continuación. Solo el propietario del espacio de trabajo.
- [Eliminar recursos huérfanos](https://sosoapi.ai/es/docs/mcp/delete-orphan-assets): MCP: Eliminar recursos huérfanos. Elimina por clave los objetos de almacenamiento seleccionados que no están registrados. Solo el propietario del espacio de trabajo; primero enuméralos con sosoapi_list_orphan_assets.
- [Obtener inventario de almacenamiento de recursos](https://sosoapi.ai/es/docs/mcp/get-asset-storage-inventory): MCP: Obtener inventario de almacenamiento de recursos. Consulta un inventario paginado de los recursos registrados y los objetos almacenados de un espacio de trabajo para auditar el almacenamiento.
- [Crear exportación de recursos](https://sosoapi.ai/es/docs/mcp/create-asset-export): MCP: Crear exportación de recursos. Exporta los recursos seleccionados (asset_ids) como manifiesto. El modo export_verify_then_purge los prepara para un borrado definitivo posterior. idempotency_key opcional.
- [Verificar exportación de recursos](https://sosoapi.ai/es/docs/mcp/verify-asset-export): MCP: Verificar exportación de recursos. Inicia la verificación de una exportación de recursos (export_id). Debe verificarse la exportación antes de solicitar un borrado definitivo.
- [Obtener estado de exportación de recursos](https://sosoapi.ai/es/docs/mcp/get-asset-export-status): MCP: Obtener estado de exportación de recursos. Consulta el estado de una exportación de recursos: exported, verification_required, verifying, verified o failed.
- [Solicitar borrado definitivo de recursos](https://sosoapi.ai/es/docs/mcp/request-asset-purge): MCP: Solicitar borrado definitivo de recursos. Solicita la eliminación permanente de los bytes almacenados de los recursos incluidos en una exportación verificada (export_id, asset_ids; puede requerirse confirm_history_loss). Solo el propietario del espacio de trabajo; irreversible una vez eliminados.
- [Reintentar borrado definitivo de recursos](https://sosoapi.ai/es/docs/mcp/retry-asset-purge): MCP: Reintentar borrado definitivo de recursos. Reintenta una solicitud de borrado definitivo detenida (purge_request_id). Solo el propietario del espacio de trabajo.
- [Listar proyectos](https://sosoapi.ai/es/docs/mcp/list-projects): MCP: Listar proyectos. Lista los proyectos de un espacio de trabajo (una capa opcional de procedencia y cuentas predeterminadas) e indica cuál está activo.
- [Obtener proyecto](https://sosoapi.ai/es/docs/mcp/get-project): MCP: Obtener proyecto. Consulta un proyecto por id: nombre, estado del ciclo de vida y las versiones de ciclo de vida y valores predeterminados necesarias para escrituras posteriores.
- [Crear proyecto](https://sosoapi.ai/es/docs/mcp/create-project): MCP: Crear proyecto. Crea un proyecto en un espacio de trabajo. Solo el propietario del espacio de trabajo; idempotency_key opcional.
- [Actualizar proyecto](https://sosoapi.ai/es/docs/mcp/update-project): MCP: Actualizar proyecto. Cambia el nombre de un proyecto (es el único campo editable). Solo el propietario del espacio de trabajo.
- [Establecer proyecto activo](https://sosoapi.ai/es/docs/mcp/set-active-project): MCP: Establecer proyecto activo. Establece el proyecto activo del usuario (un valor predeterminado del servidor).
- [Obtener cuentas predeterminadas del proyecto](https://sosoapi.ai/es/docs/mcp/get-project-account-defaults): MCP: Obtener cuentas predeterminadas del proyecto. Consulta las cuentas sociales predeterminadas de un proyecto y los ajustes específicos por cuenta, junto con el defaults_version necesario para el próximo reemplazo.
- [Reemplazar cuentas predeterminadas del proyecto](https://sosoapi.ai/es/docs/mcp/replace-project-account-defaults): MCP: Reemplazar cuentas predeterminadas del proyecto. Reemplaza en un paso las cuentas predeterminadas y los ajustes específicos de un proyecto. Requiere expected_defaults_version de la lectura más reciente y un idempotency_key (rol editor).
- [Archivar proyecto](https://sosoapi.ai/es/docs/mcp/archive-project): MCP: Archivar proyecto. Archiva un proyecto sin cambiar sus publicaciones programadas. Para detener una publicación, cancélala por separado. Solo el propietario del espacio de trabajo; proporciona expected_lifecycle_version y un idempotency_key.
- [Desarchivar proyecto](https://sosoapi.ai/es/docs/mcp/unarchive-project): MCP: Desarchivar proyecto. Reactiva un proyecto archivado. No reanuda ni vuelve a programar publicaciones; gestiónalas mediante las publicaciones programadas. Solo el propietario del espacio de trabajo; proporciona expected_lifecycle_version y un idempotency_key.
- [Obtener historial del ciclo de vida del proyecto](https://sosoapi.ai/es/docs/mcp/get-project-lifecycle-history): MCP: Obtener historial del ciclo de vida del proyecto. Consulta los eventos del ciclo de vida de un proyecto (como archivar y desarchivar), hasta 200.
- [Obtener perfil del proyecto](https://sosoapi.ai/es/docs/mcp/get-project-profile): MCP: Obtener perfil del proyecto. Consulta el perfil de marca de un proyecto (eslogan, voz, público objetivo, objetivos, paleta y más); profile es null si no existe ninguno.
- [Actualizar perfil del proyecto](https://sosoapi.ai/es/docs/mcp/update-project-profile): MCP: Actualizar perfil del proyecto. Modifica los campos del perfil de marca de un proyecto. Los campos omitidos no cambian. Requiere expected_profile_version de la lectura más reciente y un idempotency_key (rol editor).
- [Listar recursos del proyecto](https://sosoapi.ai/es/docs/mcp/list-project-assets): MCP: Listar recursos del proyecto. Lista los recursos vinculados a un proyecto, con la relación de cada vínculo (identity, source o reference) y paginación por cursor.
- [Vincular recurso al proyecto](https://sosoapi.ai/es/docs/mcp/link-project-asset): MCP: Vincular recurso al proyecto. Vincula un recurso existente a un proyecto como identidad, origen o referencia. Rol editor; requiere idempotency_key.
- [Desvincular recurso del proyecto](https://sosoapi.ai/es/docs/mcp/unlink-project-asset): MCP: Desvincular recurso del proyecto. Elimina el vínculo de un recurso con un proyecto; el recurso se conserva. Requiere idempotency_key.
- [Listar cuentas del proyecto](https://sosoapi.ai/es/docs/mcp/list-project-accounts): MCP: Listar cuentas del proyecto. Lista las cuentas sociales vinculadas a un proyecto, con paginación por cursor.
- [Vincular cuenta al proyecto](https://sosoapi.ai/es/docs/mcp/link-project-account): MCP: Vincular cuenta al proyecto. Vincula una cuenta social conectada a un proyecto. Rol editor; requiere idempotency_key.
- [Desvincular cuenta del proyecto](https://sosoapi.ai/es/docs/mcp/unlink-project-account): MCP: Desvincular cuenta del proyecto. Elimina el vínculo de una cuenta social con un proyecto; la cuenta sigue conectada. Requiere idempotency_key.
- [Crear exportación de proyecto](https://sosoapi.ai/es/docs/mcp/create-project-export): MCP: Crear exportación de proyecto. Inicia la exportación de un proyecto (solo el propietario del espacio de trabajo); consulta sosoapi_get_project_export_status para obtener la URL de descarga. Requiere idempotency_key.
- [Obtener estado de exportación del proyecto](https://sosoapi.ai/es/docs/mcp/get-project-export-status): MCP: Obtener estado de exportación del proyecto. Consulta una exportación de proyecto (export_id): queued, processing, completed (con una URL de descarga de corta duración) o failed. Solo el propietario del espacio de trabajo.
- [Listar publicaciones que requieren atención](https://sosoapi.ai/es/docs/mcp/list-publication-attentions): MCP: Listar publicaciones que requieren atención. Lista las publicaciones de un espacio de trabajo que requieren atención, filtradas por estado (open o resolved) o scheduled_post_id, con paginación por offset.
- [Obtener créditos de publicación en X](https://sosoapi.ai/es/docs/mcp/get-x-usage): MCP: Obtener créditos de publicación en X. Consulta los créditos de publicación en X de la organización compartidos por este espacio de trabajo. Requiere workspace_id. Free recibe 10 una sola vez; Pro recibe 100 por período de facturación. Un texto cuesta 1; un texto con URL cuesta 10. El texto opcional permite calcular su costo. Solo lee la asignación almacenada, sin llamar a la API de X.
- [Listar publicaciones programadas](https://sosoapi.ai/es/docs/mcp/list-scheduled-posts): MCP: Listar publicaciones programadas. Lista las publicaciones programadas de un espacio de trabajo, con filtros por proyecto, estado (scheduled, publishing, published, failed, expired, needs_reschedule, cancelled, deleted) e intervalo de tiempo, y paginación por cursor.
- [Obtener publicación programada](https://sosoapi.ai/es/docs/mcp/get-scheduled-post): MCP: Obtener publicación programada. Consulta una publicación programada por id: contenido, estado, estado de entrega y resultados. Su versión es el valor expected_version que necesitan las operaciones de actualización, publicación, reintento y cancelación.
- [Obtener elegibilidad de publicación programada](https://sosoapi.ai/es/docs/mcp/get-scheduled-post-eligibility): MCP: Obtener elegibilidad de publicación programada. Comprobación previa de solo lectura por destino. Incluye draft (caption, hashtags, scheduled_at, display_timezone, hora local/DST opcional) para comprobar contenido y horarios; include_quota=true añade una instantánea orientativa del período. Primero carga o importa los archivos multimedia y espera a que estén listos. Sin draft, solo se comprueban la cuenta y los archivos. No reserva nada; la creación y el despacho vuelven a comprobar límites y autoridad.
- [Crear publicación programada](https://sosoapi.ai/es/docs/mcp/create-scheduled-post): MCP: Crear publicación programada. Programa una cuenta en scheduled_at con provider_payload. Los archivos multimedia requieren un asset_id listo y una URL canónica; para una imagen de origen usa sosoapi_post_image_url. Incluye juntos local_scheduled_at y schedule_dst_disambiguation, u omite ambos. Requiere publish, el rol editor e idempotency_key. Programado no significa publicado: consulta el resultado.
- [Crear publicaciones programadas en lote](https://sosoapi.ai/es/docs/mcp/bulk-create-scheduled-posts): MCP: Crear publicaciones programadas en lote. Programa publicaciones para varias cuentas en una llamada (targets). Los archivos multimedia requieren asset_ids cargados o importados y listos, con sus URL canónicas. Cada destino tiene éxito o falla de forma independiente y aparece en successes o failures. Requiere la capacidad publish.
- [Actualizar publicación programada](https://sosoapi.ai/es/docs/mcp/update-scheduled-post): MCP: Actualizar publicación programada. Edita una publicación programada que aún no se ha despachado (texto, hashtags, archivos multimedia, enlace, hora). Requiere expected_version de la lectura más reciente; se rechaza una versión desactualizada.
- [Publicar ahora una publicación programada](https://sosoapi.ai/es/docs/mcp/publish-scheduled-post-now): MCP: Publicar ahora una publicación programada. Publica una publicación programada de inmediato en lugar de hacerlo en scheduled_at. Es público y no se puede deshacer; requiere expected_version. Estar en cola no significa estar publicado: consulta el resultado.
- [Reintentar publicación programada](https://sosoapi.ai/es/docs/mcp/retry-scheduled-post): MCP: Reintentar publicación programada. Reintenta una publicación programada fallida, opcionalmente con un nuevo scheduled_at. Requiere expected_version.
- [Eliminar publicación programada](https://sosoapi.ai/es/docs/mcp/delete-scheduled-post): MCP: Eliminar publicación programada. Elimina una publicación programada que no está publicada (scheduled, needs_reschedule, failed o cancelled). Los agentes no pueden eliminar contenido del proveedor una vez publicado. Requiere expected_version.
- [Cancelar publicación programada](https://sosoapi.ai/es/docs/mcp/cancel-scheduled-post): MCP: Cancelar publicación programada. Cancela una publicación programada que aún no se ha publicado para evitar su envío. Se rechazan las publicaciones ya publicadas y un agente tampoco puede eliminar contenido publicado: el usuario debe hacerlo en la aplicación web. Requiere expected_version.
- [Retirar solicitud de eliminación](https://sosoapi.ai/es/docs/mcp/withdraw-scheduled-post-delete): MCP: Retirar solicitud de eliminación. Retira una solicitud de eliminación de Instagram Login detenida y conserva la publicación publicada. Requiere expected_version.
- [Obtener recuentos del panel](https://sosoapi.ai/es/docs/mcp/get-dashboard-counts): MCP: Obtener recuentos del panel. Consulta los recuentos operativos de un espacio de trabajo: publicaciones programadas, tareas recientes y cuentas conectadas.
- [Listar publicaciones supervisadas](https://sosoapi.ai/es/docs/mcp/list-monitored-posts): MCP: Listar publicaciones supervisadas. Lista las publicaciones sociales que SosoAPI ha detectado en un espacio de trabajo (id, plataforma, enlace permanente, hora de publicación), con filtros por cuenta, plataforma y hora, y paginación por cursor. Solo metadatos, sin textos de publicación.
- [Listar comentarios de publicaciones](https://sosoapi.ai/es/docs/mcp/list-post-comments): MCP: Listar comentarios de publicaciones. Lista los comentarios observados en las publicaciones del espacio de trabajo, con las observaciones más recientes primero, autor y texto; permite filtrar por publicación, cuenta, plataforma u hora, con paginación por cursor. El texto lo escriben terceros y se etiqueta como no confiable.
- [Solicitar estadísticas del proveedor](https://sosoapi.ai/es/docs/mcp/request-provider-insights): MCP: Solicitar estadísticas del proveedor. Solicita al proveedor estadísticas de una cuenta o una publicación para un intervalo opcional de fechas (hasta 366 días). Devuelve un request_id y, si está en caché, el resultado; de lo contrario, consulta sosoapi_get_provider_insight_status.
- [Obtener estado de estadísticas del proveedor](https://sosoapi.ai/es/docs/mcp/get-provider-insight-status): MCP: Obtener estado de estadísticas del proveedor. Consulta una solicitud de estadísticas (request_id): queued, processing, completed (con el resultado del proveedor y la disponibilidad por métrica) o failed.
- [Iniciar OAuth de Instagram](https://sosoapi.ai/es/docs/mcp/start-instagram-oauth): MCP: Iniciar OAuth de Instagram. Obtiene la authorize_url del proveedor que una persona debe abrir para conectar una cuenta de Instagram. Proporciona workspace_id. No se conecta nada hasta que la persona lo aprueba y confirma en el navegador.
- [Renovar OAuth de Instagram](https://sosoapi.ai/es/docs/mcp/refresh-instagram-oauth): MCP: Renovar OAuth de Instagram. Renueva el token de acceso de una conexión de Instagram (opcionalmente un social_account_id); indica si se renovó y el nuevo vencimiento.
- [Iniciar OAuth de Threads](https://sosoapi.ai/es/docs/mcp/start-threads-oauth): MCP: Iniciar OAuth de Threads. Obtiene la authorize_url del proveedor que una persona debe abrir para conectar una cuenta de Threads. Proporciona workspace_id. No se conecta nada hasta que la persona lo aprueba y confirma en el navegador.
- [Renovar OAuth de Threads](https://sosoapi.ai/es/docs/mcp/refresh-threads-oauth): MCP: Renovar OAuth de Threads. Renueva el token de acceso de una conexión de Threads (opcionalmente un social_account_id); indica si se renovó y el nuevo vencimiento.
- [Comprobar OAuth de Threads](https://sosoapi.ai/es/docs/mcp/check-threads-oauth): MCP: Comprobar OAuth de Threads. Consulta el estado de la conexión de Threads: conexión, vencimiento, alcance y posibilidad de renovación. Proporciona workspace_id.
- [Iniciar OAuth de Meta](https://sosoapi.ai/es/docs/mcp/start-meta-oauth): MCP: Iniciar OAuth de Meta. Obtiene la authorize_url del proveedor que una persona debe abrir para conectar una página de Facebook, o Instagram a través de Facebook (connection_intent). Proporciona workspace_id. No se conecta nada hasta que la persona lo aprueba y confirma en el navegador.
- [Renovar OAuth de Meta](https://sosoapi.ai/es/docs/mcp/refresh-meta-oauth): MCP: Renovar OAuth de Meta. Vuelve a verificar una conexión de Facebook/Meta (social_account_id) e informa capability_verified.
- [Iniciar OAuth de YouTube](https://sosoapi.ai/es/docs/mcp/start-youtube-oauth): MCP: Iniciar OAuth de YouTube. Obtiene la authorize_url del proveedor que una persona debe abrir para conectar un canal de YouTube. Proporciona workspace_id. No se conecta nada hasta que la persona lo aprueba y confirma en el navegador.
- [Renovar OAuth de YouTube](https://sosoapi.ai/es/docs/mcp/refresh-youtube-oauth): MCP: Renovar OAuth de YouTube. Renueva el token de una conexión de YouTube (social_account_id); devuelve el nuevo vencimiento y capability_verified.
- [Listar tareas](https://sosoapi.ai/es/docs/mcp/list-jobs): MCP: Listar tareas. Lista las tareas recientes en segundo plano del usuario que ha iniciado sesión, con su estado y progreso.
- [Obtener estado de tarea](https://sosoapi.ai/es/docs/mcp/job-status): MCP: Obtener estado de tarea. Consulta una tarea en segundo plano por job_id: estado, tipo y mensaje de error si falló.
- [Obtener resultado de entrega del comentario](https://sosoapi.ai/es/docs/mcp/get-comment-outcome): MCP: Obtener resultado de entrega del comentario. Consulta la entrega confirmada, el historial de recuperación, la verificación pendiente y el seguimiento sin resolver.
- [Conciliar resultado de entrega del comentario](https://sosoapi.ai/es/docs/mcp/reconcile-comment-outcome): MCP: Conciliar resultado de entrega del comentario. Verifica una entrega ambigua de Facebook sin reenviar, o vincula un reemplazo exacto confirmado. Consulta el resultado para obtener evidencia definitiva.
- [Obtener capacidades de comunidad](https://sosoapi.ai/es/docs/mcp/get-community-engagement-capabilities): MCP: Obtener capacidades de comunidad. Consulta, para cada cuenta conectada, las acciones de comunidad admitidas (reply, hide, unhide, create_comment) y si la cuenta reúne los requisitos en este momento.
- [Consultar cola de revisión de comunidad](https://sosoapi.ai/es/docs/mcp/query-community-review-queue): MCP: Consultar cola de revisión de comunidad. Consulta los comentarios pendientes de revisión con el contexto del hilo, filtrados por prioridad, idioma, cuenta o antigüedad; una página vacía no significa éxito. Los textos de los comentarios los escriben terceros y se etiquetan como no confiables.
- [Enviar revisión de comunidad](https://sosoapi.ai/es/docs/mcp/submit-community-review): MCP: Enviar revisión de comunidad. Registra una nueva versión inmutable de revisión de un comentario: acción recomendada, reply_draft opcional, prioridad y confianza (al menos 0.9). No envía ni prepara nada.
- [Preparar acción de comunidad](https://sosoapi.ai/es/docs/mcp/prepare-community-action): MCP: Preparar acción de comunidad. Vincula una versión de revisión a una acción (reply, hide o unhide) y obtiene un prepare_token de corta duración para sosoapi_apply_community_action. Todavía no envía nada.
- [Aplicar acción de comunidad](https://sosoapi.ai/es/docs/mcp/apply-community-action): MCP: Aplicar acción de comunidad. Envía al proveedor la acción vinculada a un prepare_token; las respuestas son públicas. Estar en cola no significa éxito: consulta sosoapi_get_community_action_status.
- [Obtener estado de acción de comunidad](https://sosoapi.ai/es/docs/mcp/get-community-action-status): MCP: Obtener estado de acción de comunidad. Consulta el comprobante definitivo de una acción de comunidad aplicada (action_id); ponerla en cola no significa éxito.
- [Crear comentario de comunidad](https://sosoapi.ai/es/docs/mcp/create-comment): MCP: Crear comentario de comunidad. Pone en cola un comentario exacto dirigido a una publicación o un comentario canónicos; el estado no implica éxito en el proveedor.
- [Obtener estado de comentario de comunidad](https://sosoapi.ai/es/docs/mcp/get-comment-action-status): MCP: Obtener estado de comentario de comunidad. Consulta el comprobante definitivo depurado de una acción directa de comentario.
- [Obtener resumen de comunidad](https://sosoapi.ai/es/docs/mcp/get-community-engagement-summary): MCP: Obtener resumen de comunidad. Consulta el resumen de operaciones de comunidad de un espacio de trabajo: modo del canal de ejecución, trabajo pendiente, tiempos de respuesta, estados de acciones y tasas del proveedor.
- [Publicar una imagen desde una URL](https://sosoapi.ai/es/docs/mcp/post-image-url): MCP: Publicar una imagen desde una URL. Envía una sola vez la publicación completa con imagen por URL, con media vacío. El backend la prepara y publica incluso tras la desconexión. Devuelve la publicación definitiva si está disponible en 35 segundos; en caso contrario, un ID persistente de publicación. Nunca vuelvas a enviarla con otra clave. Requiere permisos operate y publish. Los campos de hora local/DST van juntos. import_id solo sirve para reanudar clientes antiguos.
- [Cargar imagen o video local](https://sosoapi.ai/es/docs/mcp/upload-asset): MCP: Cargar imagen o video local. Carga un archivo local de imagen o video en la biblioteca de recursos de un espacio de trabajo y lo registra como recurso. Solo se aceptan archivos reales PNG/JPEG/GIF/WebP/MP4/MOV/WebM/MKV/MPEG de hasta 500 MiB del directorio de trabajo, la carpeta temporal, Pictures/Movies/Videos o SOSOAPI_UPLOAD_ROOTS; se rechazan los archivos y carpetas cuyo nombre empieza por punto. Devuelve el id y la URL del recurso para los archivos multimedia de las publicaciones programadas.