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 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:

• Profile — a tool aceita um argumento profileKey para direcionar a um sub-profile.
• Account — a tool não aceita profileKey; ela opera no nível da conta.

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