> ## 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 Tools do MCP > As 27 tools expostas pelo MCP Server da Ayrshare — publicações, histórico, análises, comentários, mensagens diretas, profiles, mídia, geração, webhooks e erros — agrupadas por domínio, com escopo e propósito. O [MCP Server](/additional/mcp-action-server) da Ayrshare expõe **27 tools**, agrupadas abaixo por domínio. Cada tool é despachada in-process pela cadeia real da API da Ayrshare. ## Escopo Toda tool tem escopo **Profile** ou **Account**: As seis tools que **não** aceitam o argumento `profileKey` são: `create_profile`, `list_profiles`, `explain_error`, `validate_media`, `generate_post` e `recommend_hashtags`. Todas as demais tools aceitam um `profileKey`; `generate_jwt_social_linking_url` **exige** um. Observação: `recommend_hashtags` não aceita argumento `profileKey`, mas ainda lê o header `Profile-Key` da conexão para escolher de qual conta TikTok vinculada ela recorre, então seus resultados são específicos do profile. Quando tanto um argumento `profileKey` por chamada quanto um header `Profile-Key` estão presentes, o argumento vence. Veja [Conectar e Configurar](/additional/mcp-action-connect#precedence-argument-wins-over-header) para as regras de precedência. ## Publicações | Tool | Escopo | Propósito | | --------------- | ------- | ---------------------------------------------------------- | | `create_post` | Profile | Publicar em uma ou mais plataformas vinculadas. | | `validate_post` | Profile | Validação em dry-run, mesma entrada de `create_post`. | | `get_post` | Profile | Obter uma publicação por Ayrshare Post ID. | | `update_post` | Profile | Atualizar uma publicação agendada ou aguardando aprovação. | | `retry_post` | Profile | Reenviar uma publicação que falhou. | ## Histórico | Tool | Escopo | Propósito | | ---------------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `get_post_history` | Profile | Publicações enviadas via Ayrshare. | | `get_platform_history` | Profile | Publicações e análises direto da rede, incluindo publicações que não foram feitas via Ayrshare. Para uma busca por `userId`/`userName` do X/Twitter, use somente a API Key da conta; um argumento `profileKey` ou header `Profile-Key` retorna Erro 400. | ## Análises | Tool | Escopo | Propósito | | --------------------------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `get_post_analytics` | Profile | Métricas por publicação, por Ayrshare Post ID. | | `get_post_analytics_by_social_id` | Profile | Métricas por publicação, por Social Post ID nativo. | | `get_social_network_analytics` | Profile | Análises e dados demográficos no nível da conta para uma conta social conectada. Para uma busca por `userId`/`userName` do X/Twitter, use somente a API Key da conta; um argumento `profileKey` ou header `Profile-Key` retorna Erro 400. | ## Comentários | Tool | Escopo | Propósito | | --------------- | ------- | ---------------------------------- | | `get_comments` | Profile | Ler comentários de uma publicação. | | `add_comment` | Profile | Comentário de nível superior. | | `reply_comment` | Profile | Responder a um comentário. | ## Mensagens / DMs | Tool | Escopo | Propósito | | ------------------- | ------- | ----------------------------------------------- | | `get_messages` | Profile | Obter DMs de uma plataforma. | | `send_message` | Profile | Enviar uma DM. | | `get_auto_response` | Profile | Ler configurações de resposta automática de DM. | | `set_auto_response` | Profile | Configurar resposta automática de DM. | ## Profiles | Tool | Escopo | Propósito | | --------------------------------- | ------- | ------------------------------------------------------------- | | `list_profiles` | Account | Listar sub-profiles. | | `create_profile` | Account | Criar um sub-profile. | | `generate_jwt_social_linking_url` | Profile | Gerar uma URL de vinculação social JWT (requer `profileKey`). | ## Mídia | Tool | Escopo | Propósito | | ---------------- | ------- | -------------------------------------------------------------------------- | | `validate_media` | Account | Verificar via HEAD se uma URL de mídia é acessível; retorna `contentType`. | ## Geração | Tool | Escopo | Propósito | | -------------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `generate_post` | Account | Rascunho de texto de publicação com IA. | | `recommend_hashtags` | Account | Sugestões de hashtags a partir de dados de visualização do TikTok. Usa a conta TikTok vinculada ao profile definido pelo header `Profile-Key`; não aceita `profileKey` por chamada. | ## Webhooks | Tool | Escopo | Propósito | | -------------------- | ------- | ---------------------------------- | | `register_webhook` | Profile | Registrar um webhook. | | `unregister_webhook` | Profile | Cancelar o registro de um webhook. | | `list_webhooks` | Profile | Listar webhooks registrados. | ## Erros | Tool | Escopo | Propósito | | --------------- | ------- | ----------------------------------------------------------------------------- | | `explain_error` | Account | Decodificar um código de erro da Ayrshare em causa, classificação e correção. | Este catálogo é verificado com o `tools/list` do servidor em produção. Mais tools estão planejadas (por exemplo, tools de Links). Em caso de dúvida, consulte `tools/list` para o conjunto autoritativo. O catálogo é mantido pela equipe do MCP Server.