Herramientas
Herramientas disponibles mediante el servidor MCP de dopost.
Herramientas disponibles mediante el servidor MCP de dopost.
El servidor MCP de dopost ofrece herramientas específicas para publicar, programar, consultar analíticas y cuentas, gestionar media y preparar descargas públicas.
| Herramienta | Qué hace |
|---|---|
publish_post | Guarda borradores, publica o programa grupos, responde o crea un hilo. |
list_posts | Lista posts con filtros de estado y paginación. |
get_post | Obtiene todos los detalles de un post. |
reschedule_post | Cambia la fecha de un post programado. |
delete_post | Elimina un post o cancela su programación. |
Antes de publicar o programar con publish_post, llama a get_platform_limits para cada plataforma de destino distinta. Comprueba el texto y los requisitos del tipo de publicación elegido, incluidas las entradas del hilo y el contenido específico de cada cuenta en los grupos. Si se supera un límite conocido, explica el campo afectado, el valor real y el límite permitido antes de intentar publicar.
Compara las propiedades del archivo solo cuando dispongas de metadatos verificados; no deduzcas dimensiones, duración o códecs del nombre o de la URL. Una llamada correcta a upload_media confirma la recepción del archivo y las comprobaciones de subida, pero no su compatibilidad con un destino. El servidor inspecciona los archivos recibidos y aplica la validación del compositor web antes de crear los posts, devolviendo errores detallados si falla alguna comprobación. Los borradores admiten contenido pendiente de completar para la plataforma.
Estas instrucciones orientan al agente MCP; el servidor no llama automáticamente a get_platform_limits por él. Tras desplegar, actualiza las herramientas cacheadas del cliente para cargar las nuevas instrucciones.
Llama una sola vez a publish_post con posts: [{ accountId, ... }, ...] en lugar de accountId para crear un grupo de hasta 20 cuentas del mismo workspace. El contenido del nivel superior se comparte por defecto; cada elemento puede sustituir text, media, platformOptions, replyTo o thread. draft, publishAt y timezone van en el nivel superior. Las URLs de media compartidas se importan una sola vez. Consulta cada postId devuelto para conocer el resultado; groupId identifica el grupo en la web. Un fallo de validación no crea posts e identifica la cuenta y el campo afectados. Consulta Publicar en grupo. delete_post sobre un miembro elimina todo el grupo; reprogramar solo cambia el miembro indicado.
Llama a publish_post con draft: true, un accountId y, opcionalmente, text, media, thread y platformOptions. Omite publishAt. La herramienta devuelve status: "draft" y un postId sin publicar ni programar. Usa get_post o list_posts con status: "DRAFT" para consultarlo y ábrelo en el dashboard de dopost para seguir editándolo o publicarlo. Se admite contenido pendiente de completar para la plataforma; los adjuntos mantienen las comprobaciones de tamaño, formato e integridad. Consulta Guardar un borrador.
| Tool | Qué hace |
|---|---|
create_recurring_post | Crea una serie recurrente diaria, semanal o mensual. |
list_recurring_posts | Lista las series, próxima ejecución, cuentas y último resultado. |
update_recurring_post | Actualiza contenido futuro, media, cadencia o la próxima ejecución. |
| Herramienta | Qué hace |
|---|---|
list_workspaces | Lista los workspaces disponibles para la conexión MCP actual. |
list_accounts | Lista cuentas sociales de todos los workspaces accesibles. |
list_x_communities | Lista las Comunidades guardadas de una cuenta de X conectada. |
add_x_community | Valida y guarda una Comunidad para una cuenta de X. |
remove_x_community | Elimina una Comunidad del catálogo guardado de una cuenta X. |
get_platform_limits | Devuelve los límites de contenido y media de una plataforma. |
Las conexiones OAuth alojadas solo pueden acceder a los workspaces autorizados a los que el usuario sigue teniendo acceso. Los nuevos workspaces permanecen deshabilitados hasta habilitarlos en Ajustes → Conexiones MCP. Las tools de listado devuelven los datos del workspace y aceptan workspaceId cuando es necesario acotar la consulta. Las acciones basadas en recursos, como publicar, deducen el workspace desde la cuenta o el recurso seleccionado. Las API keys locales siguen limitadas al workspace que las creó.
Llama a list_x_communities con el accountId de X, muestra al usuario los nombres de las Comunidades y pasa el nombre seleccionado a publish_post. El servidor MCP resuelve el ID internamente:
{
"accountId": "<xAccountId>",
"text": "Actualización para la Comunidad",
"platformOptions": {
"communityName": "Builders Community",
"shareWithFollowers": false
}
}{
"accountId": "<xAccountId>",
"text": "Actualización para la Comunidad",
"platformOptions": {
"communityName": "Builders Community",
"shareWithFollowers": false
}
}shareWithFollowers usa true por defecto. Usa communityId solo como fallback técnico cuando haya varias Comunidades guardadas con el mismo nombre. La cuenta de X seleccionada debe pertenecer a la Comunidad y tener permiso para publicar en ella.
Si list_x_communities no devuelve resultados, pide al usuario una URL de Comunidad y llama a add_x_community. Cuando devuelva el nombre validado, usa ese nombre como publish_post.platformOptions.communityName.
Antes de llamar a remove_x_community, confirma la eliminación con el usuario. Usa preferentemente communityName; el communityId técnico solo hace falta cuando hay nombres duplicados.
| Herramienta | Qué hace |
|---|---|
get_analytics_overview | Consulta KPIs, rankings, comparaciones y disponibilidad de los datos. |
list_post_performance | Lista posts publicados por dopost ordenados por rendimiento. |
get_post_performance | Consulta el historial y el progreso de recopilación de un post. |
get_content_insights | Consulta Mejor Hora, Mejor Día, Oportunidad de Formato y Pulso de Plataforma. |
get_audience_analytics | Consulta los desgloses de audiencia disponibles para una cuenta. |
Estas herramientas requieren analytics:read y un plan de pago activo. Las series diarias se omiten por defecto; usa includeSeries: true en rangos de hasta 90 días. Las listas de posts devuelven como máximo 20 elementos.
Las analíticas de audiencia están disponibles actualmente para Facebook e Instagram. Las analíticas de TikTok permanecerán desactivadas hasta que se habilite la integración y la cuenta autorice los permisos necesarios.
No aparecen las herramientas de Analíticas
Las claves y autorizaciones OAuth existentes no incluyen automáticamente el nuevo permiso analytics:read. Crea una clave con ese permiso o reconecta el cliente MCP y apruébalo. Si el permiso ya está concedido, reconecta el cliente para volver a cargar las herramientas disponibles.
| Herramienta | Qué hace |
|---|---|
list_media | Lista archivos de la biblioteca Media de dopost. |
delete_media | Elimina un archivo de la biblioteca Media. |
upload_media | Sube un archivo local. Solo está disponible en el servidor stdio local. |
| Herramienta | Qué hace |
|---|---|
get_social_media_download_options | Consulta los formatos MP4 y MP3 disponibles para una URL pública. |
prepare_social_media_download | Devuelve una URL temporal para el formato elegido. |
El servidor alojado no expone upload_media porque un proceso remoto no puede leer una ruta de tu ordenador. Pasa una URL HTTPS pública a publish_post o utiliza el flujo REST de subida prefirmada con purpose: "post". Los adjuntos externos se copian al almacenamiento de dopost antes de aceptar la publicación o programación. La herramienta local upload_media usa purpose: "library" por defecto; utiliza purpose: "post" para un adjunto de post. Los errores de subida se devuelven al agente y deben resolverse antes de publicar.
publish_post acepta dos campos opcionales:
thread: posts consecutivos para X, Threads y Mastodon. dopost los publica como una cadena de respuestas en una sola petición de publicación.replyTo: ID externo del post al que quieres responder en X o Threads. No es un ID interno de dopost.Para crear un hilo nuevo, usa una sola llamada a publish_post: text contiene el primer post y thread los siguientes. Así no es necesario esperar al ID de plataforma del primer post para continuar la cadena.
{
"accountId": "<xAccountId>",
"text": "Primer post",
"thread": [
{ "text": "Segundo post" },
{ "text": "Tercer post", "media": ["<publicMediaUrl>"] }
]
}{
"accountId": "<xAccountId>",
"text": "Primer post",
"thread": [
{ "text": "Segundo post" },
{ "text": "Tercer post", "media": ["<publicMediaUrl>"] }
]
}thread admite entre 1 y 20 posts consecutivos y hasta cuatro URLs públicas de media por elemento. En X y Threads puedes incluir replyTo junto con thread para iniciar la cadena como respuesta a un post existente de la plataforma.
Tu cliente de IA no muestra estos campos
El servidor MCP actual incluye list_x_communities, y el schema de publish_post incluye replyTo, thread y platformOptions.communityName. Si no aparecen, refresca las tools MCP o vuelve a conectar dopost para limpiar el schema cacheado.
Una petición inmediata devuelve processing cuando dopost acepta el post para publicar. Los posts programados devuelven scheduled. La publicación se confirma cuando get_post devuelve PUBLISHED. Usa get_post con el postId devuelto para consultar el resultado final.
Si una llamada no devuelve resultado y desaparece temporalmente todo el namespace de tools de dopost, lo más probable es que el cliente esté refrescando la conexión MCP o la sesión OAuth. Eso por sí solo no demuestra que dopost haya rechazado el post. Cuando vuelvan las tools, consulta primero las publicaciones recientes con list_posts: la solicitud original podría haberse aceptado aunque se perdiera su respuesta, y reintentar a ciegas puede crear un duplicado. Los rechazos de la API o del MCP incluyen un error explícito; conserva ese mensaje y el request ID para soporte.
publish_post acepta los cuatro tipos y sus opciones. get_analytics_overview admite GOOGLE_BUSINESS y las métricas de Search/Maps y acciones; get_google_business_search_terms devuelve términos mensuales paginados con umbrales de privacidad. Las fechas sin zona usan el workspace; puedes indicar timezone opcionalmente al publicar o reprogramar. Actualiza las tools cacheadas tras desplegar esta versión.
La publicación utiliza las mismas reglas de validación que el compositor web después de inspeccionar el archivo recibido. Los errores bloqueantes devuelven isError: true, una explicación legible en content y el error de la API en structuredContent, incluidos httpStatus, errorCode, stage, issues y retryable. Revisa el nombre del archivo, el valor detectado y el límite esperado de cada problema; corrige el adjunto antes de reintentar un fallo de validación no reintentable. Las recomendaciones permiten continuar y aparecen en warnings en las respuestas aceptadas. Si un post aceptado falla después, consulta get_post para conocer el error registrado.
Los errores de importación de adjuntos también conservan fileName, field, threadIndex, mediaIndex, stage y retryable. Consulta Integridad del archivo y fallos de importación para conocer los códigos de errores de origen, almacenamiento e integridad del vídeo.