Connect Your AI Agent to RedReplier
Point Claude Code, Claude Desktop, Cursor, or any MCP client at the RedReplier MCP server, sign in when prompted, then call the tools to search threads, score relevance, and inspect matches.
Before You Start
A RedReplier account. Sign up
At least one keyword set up so there are threads to search. Add keywords
Optional: an API key, only for headless agents or clients without OAuth. Create one here
Claude Code & Cursor
Add RedReplier as an HTTP MCP server. Paste the config into your client's MCP settings. The first time a tool runs, your client opens a browser window and you sign in with your RedReplier account.
mcp.json
{
"mcpServers": {
"redreplier": {
"type": "http",
"url": "https://mcp.redreplier.com/mcp"
}
}
}No key to paste. Sign in when the browser opens.
Claude Code
claude mcp add --transport http redreplier https://mcp.redreplier.com/mcpPrefer the CLI? Run this one-liner, then approve the sign-in in your browser.
mcp.json (API key)
{
"mcpServers": {
"redreplier": {
"type": "http",
"url": "https://mcp.redreplier.com/mcp",
"headers": {
"Authorization": "Bearer redreplier_your_api_key_here"
}
}
}
}Prefer a key? Use this config instead, with a token created in API tokens. Use it for headless agents and clients without OAuth. Keys start with redreplier_.
Claude Desktop
Claude Desktop connects through mcp-remote, which opens the sign-in for you. Add this to your claude_desktop_config.json and restart the app. To use an API key instead, append "--header" and "Authorization: Bearer redreplier_your_key" to the args.
claude_desktop_config.json
{
"mcpServers": {
"redreplier": {
"command": "npx",
"args": ["mcp-remote", "https://mcp.redreplier.com/mcp"]
}
}
}Other MCP Clients
Any MCP-compatible client can connect with these details.
Endpoint
https://mcp.redreplier.com/mcp
Auth
Sign in when prompted (OAuth), or send Authorization: Bearer redreplier_your_key
Transport
Streamable HTTP
For clients that only support stdio, wrap the endpoint with mcp-remote as shown in the Claude Desktop example above.
Agent Skill
Install the packaged skill to configure the MCP server and tool instructions in one command.
npx skills add redreplier/agentRead the source and instructions on GitHub. View on GitHub
Tool Reference
The tools your agent can call once RedReplier is connected.
| Tool | What it does | Parameters |
|---|---|---|
| list_workspaces | List the workspaces your sign-in can act in. Pass an id as workspaceId to any other tool to work in that workspace. | None |
| list_websites | List your monitored websites with their keywords and each keyword's status. | None |
| get_website | Read one monitored website and its keywords. | websiteId |
| create_website | Start monitoring a website, optionally with a description and starting keywords. | url, name?, keywords?, description? |
| update_website | Rename a website or change the description its mentions are scored against. | websiteId, name?, description? |
| delete_website | Stop monitoring a website. | websiteId |
| analyze_website | Scrape a URL and draft a description before you add the website. | url |
| add_keywords | Add keywords to a monitored website. | websiteId, keywords |
| edit_keyword | Change a keyword's text. | keywordId, value |
| disable_keyword | Pause a keyword and keep the mentions it found. | keywordId |
| enable_keyword | Resume a paused keyword. | keywordId |
| delete_keyword | Delete a keyword and the mentions it found. | keywordId |
| keyword_change_usage | Report the keyword edit allowance. Every current plan allows unlimited edits. | None |
| list_mentions | List scored mentions, filtered by website, status, score bucket, minimum score, keyword, source and date. | websiteId?, statuses?, scoreBuckets?, includeLowRelevance?, minScore?, keywords?, sources?, sort?, from?, to?, limit?, offset? |
| count_mentions | Count the mentions that match the same filters as list_mentions. | websiteId?, statuses?, scoreBuckets?, includeLowRelevance?, minScore?, keywords?, sources?, from?, to? |
| update_mention_status | Mark a mention NEW, APPROVED or REJECTED. | mentionId, status |
| explain_mention | Explain why a mention got its score and draft a reply. | mentionId |
| get_alert_settings | Read your email alert settings. | None |
| update_alert_settings | Turn email alerts on or off and set how often they arrive. | enabled, cadenceMinutes? |
Managing Access
Sign-ins are revoked by removing RedReplier from your client's connectors. Create and revoke API keys anytime from API tokens. Each key carries a role and never more than your own permissions in its workspace, so treat it like a password and rotate it if it leaks.
Ready to Connect Your Agent?
Create your account, point your agent at the MCP URL, and have it working Reddit in minutes.