RedReplier MCP

npx add-mcp 'https://mcp.redreplier.com/mcp'

For AI agents: the full index of these docs is at https://redreplier.com/docs/llms.txt. Every docs page is also available as Markdown: append .md to its URL or request it with the header Accept: text/markdown.

API reference

Connect the RedReplier 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, workspaces, and alert settings directly.

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

Authentication

Point your MCP client at the URL and sign in when the browser opens. The server answers unauthenticated requests with a 401 and a WWW-Authenticate header, and OAuth-capable clients (Claude Code, Claude Desktop, ChatGPT, Cursor) open the RedReplier sign-in on their own. No API key to paste.

Prefer a key? Headless agents and clients without OAuth can send a RedReplier API token in the Authorization header instead. The server resolves the account from that token.

Client configuration

One-liner for Claude Code:

claude mcp add --transport http redreplier https://mcp.redreplier.com/mcp

Full config for any MCP client:

{
  "mcpServers": {
    "redreplier": {
      "type": "http",
      "url": "https://mcp.redreplier.com/mcp"
    }
  }
}

API key alternative, for headless agents and clients without OAuth:

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

Tools

Tool	Arguments	Returns
list_workspaces	No arguments	{ workspaces: Workspace[] }
list_websites	No arguments	{ websites: Website[] }
get_website	websiteId	Website
create_website	url, optional name, keywords, description	Website
update_website	websiteId, optional name, description	Website
delete_website	websiteId	{ deleted: true }
analyze_website	url	{ description: string }
add_keywords	websiteId, keywords	Website
edit_keyword	keywordId, value	Keyword
disable_keyword	keywordId	Keyword
enable_keyword	keywordId	Keyword
delete_keyword	keywordId	{ deleted: true }
keyword_change_usage	No arguments	keyword edit usage
list_mentions	optional websiteId, statuses, scoreBuckets, includeLowRelevance, minScore, keywords, sources, sort, from, to, limit, offset	paginated Mention[]
count_mentions	optional websiteId, statuses, scoreBuckets, includeLowRelevance, minScore, keywords, sources, from, to	{ total: number }
update_mention_status	mentionId, status	Mention
explain_mention	mentionId	Mention | null
get_alert_settings	No arguments	alert settings
update_alert_settings	enabled, optional cadenceMinutes	alert settings

Notes

An OAuth sign-in can reach several workspaces. Call list_workspaces to list them, then pass the id as the optional workspaceId argument that every other tool takes. Without workspaceId, tools act in the default workspace.

Start with list_websites so the client knows the available websiteId and keywordId values. Keywords beyond the plan limit stay PENDING until a slot frees up. Disabling or deleting an active keyword, or deleting a website, frees a slot, and the oldest pending keyword that fits takes it. Only the user can change the plan, in the RedReplier app. delete_keyword works on a keyword in any status and also deletes its mentions, so confirm with the user first.

Troubleshooting

• A 401 on a request without a token is the OAuth challenge and is expected. Your client should open a sign-in window. A 401 with a token means the Bearer token is malformed, expired, revoked, or does not start with redreplier_.
• A 403 with code: workspace_access_denied means the workspaceId is not one this sign-in can reach; pick one from list_workspaces. A 403 with code: subscription_required means the workspace plan does not include API access. A 403 with code: permission_denied means your role in that workspace does not hold redreplier.write, which Admin and Editor hold; ask a workspace admin for a role that does.
• 404 errors usually mean the ID belongs to a different account group or was deleted.
• A keyword stuck in PENDING means the plan has no room for it. Ask the user to change the plan in the RedReplier app, or disable or delete another keyword.

Back to getting started