---
title: "RedReplier MCP Server & Agent Setup Docs"
description: "Connect your AI agent to RedReplier in minutes. MCP config for Claude Code, Claude Desktop, and Cursor, plus the full RedReplier tool reference."
url: "https://redreplier.com/features/agents/docs"
---

[Back to Agents](https://redreplier.com/features/agents)

# Connect Your AI Agent to RedReplier

Set up the RedReplier MCP server with Claude Code, Claude Desktop, Cursor, or any MCP client, then call the tools to search threads, score relevance, and inspect matches.

## Before You Start

* A RedReplier account. [Sign up](https://redreplier.com/signup)
* At least one keyword set up so there are threads to search. [Add keywords](https://redreplier.com/keywords)
* An API key to authenticate your agent. [Create one here](https://redreplier.com/api-tokens)

## Claude Code & Cursor

Add RedReplier as an HTTP MCP server. Paste the config into your client's MCP settings and replace the placeholder with your API key.

MCP config

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

Create an API key in [API tokens](https://redreplier.com/api-tokens). Keys start with `redreplier_`.

Claude Code CLI

```
claude mcp add --transport http --scope project --header "Authorization: Bearer redreplier_your_api_key_here" -- redreplier https://mcp.redreplier.com/mcp
```

Prefer the CLI? Run this one-liner to add RedReplier to the current project.

## Claude Desktop

Claude Desktop connects through mcp-remote. Add this to your claude\_desktop\_config.json and restart the app.

claude\_desktop\_config.json

```
{
  "mcpServers": {
    "redreplier": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.redreplier.com/mcp",
        "--header",
        "Authorization: Bearer redreplier_your_api_key_here"
      ]
    }
  }
}
```

## Other MCP Clients

Any MCP-compatible client can connect with these details.

Endpoint

https://mcp.redreplier.com/mcp

Auth header

Authorization: Bearer redreplier\_your\_api\_key\_here

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](https://github.com/redreplier/agent)

## Tool Reference

The tools your agent can call once RedReplier is connected.

| Tool                  | What it does                                                                                 | Parameters                                                |
| --------------------- | -------------------------------------------------------------------------------------------- | --------------------------------------------------------- |
| list\_keywords        | List the keywords RedReplier is tracking for you.                                            | None                                                      |
| add\_keyword          | Start tracking a new keyword, optionally scoped to specific subreddits.                      | keyword, subreddits?                                      |
| search\_threads       | Find Reddit threads matching your keywords, filtered by subreddit, score, and recency.       | keyword?, subreddits?, minScore?, since?, limit?, offset? |
| get\_thread           | Fetch the full details and comments of a single thread.                                      | id                                                        |
| get\_relevance\_score | Return the relevance score for a thread so you can prioritize which opportunities to review. | threadId                                                  |
| list\_subreddits      | List the subreddits available for tracking and filtering.                                    | None                                                      |

## Managing Access

Create and revoke API keys anytime from [API tokens](https://redreplier.com/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, generate an API key, and have your agent working Reddit in minutes.

[Find my customers](https://redreplier.com/signup)[Get an API key](https://redreplier.com/api-tokens)