API-Referenz

MCP-Server

RedReplier stellt einen gehosteten MCP-Server bereit, der dieselbe öffentliche REST-API kapselt. Nutze ihn, wenn ein KI-Client Websites, Keywords, Mentions, Abrechnungsvorschauen und Alert-Einstellungen direkt verwalten soll.

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

Authentifizierung

Übergib dasselbe RedReplier-API-Token im Authorization-Header. Der Server ermittelt das Konto aus diesem Token.

Client-Konfiguration

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

Tools

ToolArgumenteGibt zurück
list_websitesKeine Argumente{ websites: Website[] }
get_websitewebsiteIdWebsite
create_websiteurl, optional name, keywords, descriptionWebsite
update_websitewebsiteId, optional 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_keywordsKeine Argumente{ websites: Website[] }
preview_activate_pendingKeine ArgumenteKeyword-Abrechnungsvorschau
preview_keyword_billingdesiredKeywordCountKeyword-Abrechnungsvorschau
keyword_change_usageKeine ArgumenteKeyword-Edit-Nutzung
list_mentionsoptional websiteId, statuses, scoreBuckets, includeLowRelevance, keywords, sources, sort, from, to, limit, offsetpaginierte Mention[]
count_mentionsoptional websiteId, statuses, scoreBuckets, includeLowRelevance, keywords, sources, sort, from, to{ total: number }
update_mention_statusmentionId, statusMention
explain_mentionmentionIdMention | null
get_alert_settingsKeine ArgumenteAlert-Einstellungen
update_alert_settingsenabled, optional cadenceMinutesAlert-Einstellungen

Hinweise

Beginne mit list_websites, damit der Client die verfügbaren websiteId- und keywordId-Werte kennt. Rufe preview_activate_pending vor activate_pending_keywords auf, da die Aktivierung ein kostenpflichtiges Tarif-Upgrade auslösen kann.

Fehlerbehebung

  • 401-Fehler bedeuten, dass das Bearer-Token fehlt, falsch formatiert ist, abgelaufen ist oder nicht mit redreplier_ beginnt.
  • 404-Fehler bedeuten meist, dass die ID zu einer anderen Account-Gruppe gehört oder gelöscht wurde.
  • Bei kostenpflichtigen Aktionen zuerst vorab prüfen und vor der Aktivierung ausstehender Keywords die Kosten bestätigen lassen.