Catálogo de herramientas MCP

Las 27 herramientas expuestas por el MCP Server de Ayrshare — publicaciones, historial, analíticas, comentarios, mensajes directos, perfiles, medios, generación, webhooks y errores — agrupadas por dominio, con alcance y propósito.

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.