# mcp-reddit-brand-presence-mapper [Health: Active]

**Category:** 🌐 Social Media  
**Repository:** https://github.com/mambalabsdev/mcp-reddit-brand-presence-mapper  
**GitHub Stars:** 0  
**npm Downloads (last month):** 193  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/mcp-reddit-brand-presence-mapper

## Description
Resolve a company domain to its subreddit and sample public mentions of the brand.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "mcp-reddit-brand-presence-mapper": {
    "command": "npx",
    "args": ["-y","@mambalabsdev/mcp-reddit-brand-presence-mapper"],
    "env": {
      "APIFY_TOKEN": ""
    }
  }
}
```

**Requires environment variables:** `APIFY_TOKEN` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What mcp-reddit-brand-presence-mapper MCP server does

The mcp-reddit-brand-presence-mapper MCP server accepts either a company domain or a subreddit handle. With a domain, it discovers a likely official or community subreddit; with a handle, it skips discovery and fetches the specified profile. The result is one flat row containing company identity, subreddit details, activity indicators, mention data, statuses, and the run date.

Subreddit data can include the profile URL and title, recent post count, latest post time, days since the latest post, and the number of distinct recent authors. The mention portion reports the query used, sample size, number of distinct subreddits, top subreddit, and latest mention time. The actor returns 26 snake_case fields without nested objects, which can fit a flat table workflow.

## How it works

The package is a thin client for the Mamba Labs Reddit Brand Presence and Mention Monitor actor on Apify. Lookup and collection run on Apify; the MCP package does not implement the discovery logic locally. Successful lookups are cached for seven days by default. Set `skipCache` to true when a fresh fetch is needed.

The default mention query uses the company domain in quotes, which is intended to avoid confusing a brand with an ordinary word. You can provide `mentionQuery` to search for a different term. Mention collection is enabled by default, while `includeMentions: false` limits the run to the subreddit lookup. `includeFollowerCounts` controls whether the profile is fetched for count extraction.

Reddit availability is a material constraint. Public `.rss` feeds are the open route described by the project, while unauthenticated JSON routes return 403. A refused request appears as `blocked`, not as a zero, and separate status fields distinguish blocked reads from empty results. Supplying a Reddit app client ID and secret is the documented way to obtain subscriber counts.

## Setup and configuration

Run the package with Node.js 18 or newer, an Apify account, and an Apify API token. A Claude Desktop configuration uses `npx -y @mambalabsdev/mcp-reddit-brand-presence-mapper` and passes `APIFY_TOKEN` in the server environment. After adding the configuration, restart Claude Desktop so the `map_reddit_brand_presence` tool becomes available.

The input must contain either `company_domain` or `handle`. `company_name` is optional and can improve identity matching. `redditClientId` and `redditClientSecret` are optional; the secret is used for the run and is not stored. The README directs users to the Apify account integrations page for the API token and to Reddit’s app settings for Reddit credentials.

## Tools and capabilities

The mcp-reddit-brand-presence-mapper exposes the `map_reddit_brand_presence` tool. Its supported inputs allow callers to:

- Resolve a subreddit from a company domain.
- Fetch a subreddit directly by handle.
- Change the Reddit query used for mention sampling.
- Include or omit the site-wide mention sample.
- Include or omit follower-count extraction.
- Reuse the seven-day cache or request a fresh lookup.

The output is designed as a single company row, with fields such as `subreddit_status`, `subreddit_subscribers_status`, and `mentions_status` available for interpreting partial or blocked results.

## Limitations and notes

Subscriber counts require the caller’s own Reddit app credentials; the rest of the lookup can still run without them. Reddit may refuse subreddit or mention reads, and those refusals should be retried rather than interpreted as no activity. For the actor’s complete schema, pricing, and run history, consult the linked Apify Store documentation. The project is released under the MIT license.

_Full upstream README: https://allmcps.com/mcp/mcp-reddit-brand-presence-mapper/readme_