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.
