Referência da API

Servidor MCP

O RedReplier expõe um servidor MCP hospedado que envolve a mesma API REST pública. Use-o quando um cliente de IA precisar gerenciar sites, palavras-chave, menções, prévias de cobrança e configurações de alerta diretamente.

URL MCP: https://mcp.redreplier.com/mcp

Autenticação

Envie o mesmo token de API do RedReplier no cabeçalho Authorization. O servidor resolve a conta a partir desse token.

Configuração do cliente

{
  "mcpServers": {
    "redreplier": {
      "type": "http",
      "url": "https://mcp.redreplier.com/mcp",
      "headers": {
        "Authorization": "Bearer redreplier_test_1234567890"
      }
    }
  }
}

Ferramentas

FerramentaArgumentosRetorna
list_websitesSem argumentos{ websites: Website[] }
get_websitewebsiteIdWebsite
create_websiteurl, opcional name, keywords, descriptionWebsite
update_websitewebsiteId, opcional name, descriptionWebsite
delete_websitewebsiteId{ deleted: true }
analyze_websiteurl{ description: string }
add_keywordswebsiteId, keywordsWebsite
edit_keywordkeywordId, valueKeyword
disable_keywordkeywordIdKeyword
enable_keywordkeywordIdKeyword
delete_keywordkeywordId{ deleted: true }
activate_pending_keywordsSem argumentos{ websites: Website[] }
preview_activate_pendingSem argumentosprévia de cobrança de palavras-chave
preview_keyword_billingdesiredKeywordCountprévia de cobrança de palavras-chave
keyword_change_usageSem argumentosuso de edição de palavras-chave
list_mentionsopcional websiteId, statuses, scoreBuckets, includeLowRelevance, keywords, sources, sort, from, to, limit, offsetMention[] paginado
count_mentionsopcional websiteId, statuses, scoreBuckets, includeLowRelevance, keywords, sources, sort, from, to{ total: number }
update_mention_statusmentionId, statusMention
explain_mentionmentionIdMention | null
get_alert_settingsSem argumentosconfigurações de alerta
update_alert_settingsenabled, opcional cadenceMinutesconfigurações de alerta

Notas

Comece com list_websites para que o cliente conheça os valores disponíveis de websiteId e keywordId. Chame preview_activate_pending antes de activate_pending_keywords, porque a ativação pode acionar um upgrade pago do plano.

Solução de problemas

  • Erros 401 significam que o Bearer token está ausente, malformado, expirado ou não começa com redreplier_.
  • Erros 404 geralmente significam que o ID pertence a outro grupo de conta ou foi excluído.
  • Para ações pagas, pré-visualize primeiro e peça confirmação da cobrança antes de ativar palavras-chave pendentes.