El MCP Server de Ayrshare expone 27 herramientas, agrupadas a continuación por dominio. Cada herramienta se despacha en proceso a través de la cadena real de la API de Ayrshare.
Alcance
Cada herramienta es de alcance Profile o Account:
- Profile — la herramienta acepta un argumento
profileKey para apuntar a un sub-perfil. - Account — la herramienta no toma
profileKey; opera a nivel de cuenta.
Las seis herramientas que no toman un argumento profileKey son: create_profile, list_profiles, explain_error, validate_media, generate_post y recommend_hashtags. Todas las demás herramientas aceptan un profileKey; generate_jwt_social_linking_url lo requiere. Nota: recommend_hashtags no toma un argumento profileKey pero sí lee la cabecera Profile-Key de la conexión para determinar sobre qué cuenta de TikTok vinculada trabaja, por lo que sus resultados son específicos del perfil.
Cuando están presentes tanto un argumento profileKey por llamada como una cabecera Profile-Key, gana el argumento. Consulta Conexión y configuración para las reglas de precedencia.
Publicaciones
| Herramienta | Alcance | Propósito |
|---|
create_post | Profile | Publicar en una o más plataformas vinculadas. |
validate_post | Profile | Validación en simulacro (dry-run), misma entrada que create_post. |
get_post | Profile | Obtener un post por Ayrshare Post ID. |
update_post | Profile | Actualizar un post programado o pendiente de aprobación. |
retry_post | Profile | Reenviar un post fallido. |
Historial
| Herramienta | Alcance | Propósito |
|---|
get_post_history | Profile | Publicaciones enviadas a través de Ayrshare. |
get_platform_history | Profile | Publicaciones y analíticas directamente desde la red, incluidas las que no son de Ayrshare. Para una consulta por userId/userName de X/Twitter, usa únicamente la API key de la cuenta; un argumento profileKey o una cabecera Profile-Key allí devuelven Error 400. |
Analíticas
| Herramienta | Alcance | Propósito |
|---|
get_post_analytics | Profile | Métricas por post según Ayrshare Post ID. |
get_post_analytics_by_social_id | Profile | Métricas por post según el Social Post ID nativo. |
get_social_network_analytics | Profile | Analíticas y datos demográficos a nivel de cuenta para una cuenta social conectada. Para una consulta por userId/userName de X/Twitter, usa únicamente la API key de la cuenta; un argumento profileKey o una cabecera Profile-Key allí devuelven Error 400. |
Comentarios
| Herramienta | Alcance | Propósito |
|---|
get_comments | Profile | Leer comentarios en un post. |
add_comment | Profile | Comentario de nivel superior. |
reply_comment | Profile | Responder a un comentario. |
Mensajes / DMs
| Herramienta | Alcance | Propósito |
|---|
get_messages | Profile | Obtener DMs de una plataforma. |
send_message | Profile | Enviar un DM. |
get_auto_response | Profile | Leer la configuración de auto-respuesta de DMs. |
set_auto_response | Profile | Configurar la auto-respuesta de DMs. |
Perfiles
| Herramienta | Alcance | Propósito |
|---|
list_profiles | Account | Listar sub-perfiles. |
create_profile | Account | Crear un sub-perfil. |
generate_jwt_social_linking_url | Profile | Generar una URL de vinculación social JWT (requiere profileKey). |
Medios
| Herramienta | Alcance | Propósito |
|---|
validate_media | Account | Verificar mediante HEAD que una URL de medio es accesible; devuelve contentType. |
Generación
| Herramienta | Alcance | Propósito |
|---|
generate_post | Account | Redactar con IA el texto de un post. |
recommend_hashtags | Account | Sugerencias de hashtags a partir de datos de visualizaciones de TikTok. Usa la cuenta de TikTok vinculada al perfil establecido por la cabecera Profile-Key; no acepta un profileKey por llamada. |
Webhooks
| Herramienta | Alcance | Propósito |
|---|
register_webhook | Profile | Registrar un webhook. |
unregister_webhook | Profile | Cancelar el registro de un webhook. |
list_webhooks | Profile | Listar webhooks registrados. |
Errores
| Herramienta | Alcance | Propósito |
|---|
explain_error | Account | Decodificar un código de error de Ayrshare en causa, clasificación y solución. |
Este catálogo se verifica contra el tools/list del servidor en vivo. Se planean más herramientas (por ejemplo, herramientas de Links). Ante la duda, consulta tools/list para el conjunto autoritativo. El catálogo lo mantiene el equipo del MCP server.
