API reference

MCP server

RedReplier exposes a hosted MCP server that wraps the same public REST API. Use it when an AI client should manage websites, keywords, mentions, billing previews, and alert settings directly.

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

Authentication

Pass the same RedReplier API token in the Authorization header. The server resolves the account from that token.

Client configuration

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

Tools

ToolArgumentsReturns
list_websitesNo arguments{ 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_keywordsNo arguments{ websites: Website[] }
preview_activate_pendingNo argumentskeyword billing preview
preview_keyword_billingdesiredKeywordCountkeyword billing preview
keyword_change_usageNo argumentskeyword edit usage
list_mentionsoptional websiteId, statuses, scoreBuckets, includeLowRelevance, keywords, sources, sort, from, to, limit, offsetpaginated Mention[]
count_mentionsoptional websiteId, statuses, scoreBuckets, includeLowRelevance, keywords, sources, sort, from, to{ total: number }
update_mention_statusmentionId, statusMention
explain_mentionmentionIdMention | null
get_alert_settingsNo argumentsalert settings
update_alert_settingsenabled, optional cadenceMinutesalert settings

Notes

Start with list_websites so the client knows the available websiteId and keywordId values. Call preview_activate_pending before activate_pending_keywords because activation can trigger a paid plan upgrade.

Troubleshooting

  • 401 errors mean the Bearer token is missing, malformed, expired, or does not start with redreplier_.
  • 404 errors usually mean the ID belongs to a different account group or was deleted.
  • For paid actions, preview first and ask the user to confirm the charge before activating pending keywords.

Back to getting started