Back to Agents

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/mcp

Prefer 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/agent

Read the source and instructions on GitHub. View on GitHub

Tool Reference

The tools your agent can call once RedReplier is connected.

ToolWhat it doesParameters
list_keywordsList the keywords RedReplier is tracking for you.None
add_keywordStart tracking a new keyword, optionally scoped to specific subreddits.keyword, subreddits?
search_threadsFind Reddit threads matching your keywords, filtered by subreddit, score, and recency.keyword?, subreddits?, minScore?, since?, limit?, offset?
get_threadFetch the full details and comments of a single thread.id
get_relevance_scoreReturn the relevance score for a thread so you can prioritize which opportunities to review.threadId
list_subredditsList the subreddits available for tracking and filtering.None

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 your account's permissions, 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.