> ## Documentation Index
> Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 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](/additional/mcp-action-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**:

<ul class="custom-bullets">
  <li>**Profile** — la herramienta acepta un argumento `profileKey` para apuntar a un sub-perfil.</li>
  <li>**Account** — la herramienta **no** toma `profileKey`; opera a nivel de cuenta.</li>
</ul>

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](/additional/mcp-action-connect#precedence-argument-wins-over-header) 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. |

<Info>
  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.
</Info>