ReddGrow MCP Server

Connect any MCP-compatible AI client to ReddGrow — manage campaigns, drafts, subreddits, advocates, brand monitoring, and AEO visibility directly from Claude, Cursor, VS Code, or any MCP client.

The ReddGrow MCP server is a remote, hosted server that exposes all ReddGrow functionality as MCP tools. Any client that supports remote MCP over HTTP can connect to it, including Claude.ai, Cursor, VS Code extensions, and MCP Inspector.

Endpoint: https://mcp.reddgrow.ai/mcp Transport: Streamable HTTP Auth: OAuth 2.1 with PKCE

Prerequisites

An active ReddGrow subscription
A ReddGrow organization (your API key is minted per-org during the OAuth flow)

Connect in Claude.ai

Add as a custom connector

Go to claude.ai/settings/integrations
Click Add custom connector
Enter the server URL: https://mcp.reddgrow.ai/mcp
Click Connect and complete the OAuth flow on app.reddgrow.ai

Once connected, all ReddGrow tools are available in your Claude conversations. Custom connectors require Claude Pro, Max, Team, or Enterprise (the Free plan supports 1 custom connector).

Connect in Cursor

In your Cursor settings, add a remote MCP server:

{
  "mcpServers": {
    "reddgrow": {
      "url": "https://mcp.reddgrow.ai/mcp"
    }
  }
}

Cursor will prompt you to complete the OAuth flow on first use.

Connect in VS Code

Install an MCP extension that supports remote servers, then add:

{
  "mcp.servers": {
    "reddgrow": {
      "url": "https://mcp.reddgrow.ai/mcp"
    }
  }
}

Test with MCP Inspector

npx @modelcontextprotocol/inspector https://mcp.reddgrow.ai/mcp

The inspector will open a browser OAuth flow for authentication, then list all available tools.

When you connect for the first time, the server redirects you to app.reddgrow.ai/oauth/consent. Here you:

Sign in to your ReddGrow account
Select which organization to grant access to
Approve — a scoped API key is minted for that org

The key is stored in the MCP server's token store and refreshed automatically. To revoke access, go to Settings → Connected Apps in app.reddgrow.ai and click Revoke next to the connected client.

Example prompts

Once connected, you can talk to Claude naturally:

"List my pending drafts and approve the top 3 by score."

"Show brand mentions from the last 7 days with negative sentiment."

"Add r/SaaS to my campaign and set min_karma to 100."

"How many drafts were posted this week across all my campaigns?"

"Show me all subreddits in my main campaign that are currently inactive."

"Create a new brand monitor domain for competitor.com."

"What's my AEO visibility score for my main brand this week?"

Available tools (29 total)

Each area has a read tool and a _manage tool that changes things. You pass an action, and each tool lists its actions. Claude picks the right one from your request.

Tool	Read/Write	What it covers	Actions
`health_check`	Read	Check the health status of the ReddGrow API.	-
`comments`	Read	Reddit comments ReddGrow drafts and posts for the user (called drafts in the API). Look one up by Reddit URL with list+search.	`list`, `get`, `engagement_history`, `replies`, `reply_inbox`, `suggestions`, `status_counts`
`comments_manage`	Write	Reddit comments ReddGrow drafts and posts for the user (called drafts in the API). Look one up by Reddit URL with list+search.	`approve`, `skip`, `edit_text`, `regenerate`, `mark_posted`, `delete`, `skip_reply`, `mute_reply_thread`
`advocates`	Read	AI personas that write Reddit comments for a brand: role, tone, background, voice, linked campaigns and Reddit account.	`list`, `get`, `campaign_settings`, `campaign_mappings`, `for_campaign`
`advocates_manage`	Write	AI personas that write Reddit comments for a brand: role, tone, background, voice, linked campaigns and Reddit account.	`create`, `generate`, `generate_from_campaign`, `update`, `set_campaigns`, `assign_to_campaign`, `unassign_from_campaign`, `set_campaign_settings`, `refine_from_examples`, `apply_guidelines`, `refine_skip`, `delete`
`campaigns`	Read	A campaign is a product or brand being promoted on Reddit: product info, subreddits, advocates, competitors and knowledge base.	`list`, `get`, `stats`, `subreddits`, `competitors`, `fit_pairs`, `assignments`, `knowledge_sources`, `knowledge_search`
`campaigns_manage`	Write	A campaign is a product or brand being promoted on Reddit: product info, subreddits, advocates, competitors and knowledge base.	`create`, `extract_from_url`, `create_from_extracted`, `update`, `set_active`, `delete`, `link_subreddits`, `unlink_subreddit`, `add_competitor`, `remove_competitor`, `evaluate_fit`, `kb_add_text`, `kb_crawl_url`, `kb_delete`, `assign_members`, `unassign_member`
`subreddits`	Read	Reddit communities ReddGrow tracks and scans for campaigns, plus AI discovery of new ones.	`list`, `list_with_stats`, `get`, `get_by_name`, `campaigns`, `discover_queries`, `discover_search`, `discover_ai_research`
`subreddits_manage`	Write	Reddit communities ReddGrow tracks and scans for campaigns, plus AI discovery of new ones.	`quick_add`, `create`, `update`, `set_active`, `delete`, `link_campaign`, `unlink_campaign`, `assign_discovered`, `auto_assign`, `refresh_enrichment`, `enrich_all_pending`
`brands`	Read	The Brands page: your brand and competitors, and Reddit brand monitoring. Reddit keywords for a brand live here: use brands_manage action set_keywords. A brand id is the same as a brand-monitor domain id.	`list`, `get_monitor_settings`, `mentions`, `mention`, `stats`, `timeline`, `compare`, `compare_timeline`, `compare_sentiment`, `subreddit_stats`, `insights_digest`, `competitor_digests`, `author`
`brands_manage`	Write	The Brands page: your brand and competitors, and Reddit brand monitoring. Reddit keywords for a brand live here: use brands_manage action set_keywords. A brand id is the same as a brand-monitor domain id.	`create`, `add_competitor`, `update`, `delete`, `set_monitoring`, `set_keywords`, `set_monitor_settings`, `update_mention`, `reanalyze_mention`, `draft_reply`, `update_reply_draft`, `scan_now`, `scan_brand`, `enrich`, `set_primary`, `track_subreddit`
`scanner`	Read	The Reddit scanner that finds posts to comment on in tracked subreddits.	`status`, `history`
`scanner_manage`	Write	The Reddit scanner that finds posts to comment on in tracked subreddits.	`trigger`, `trigger_subreddit`
`aeo`	Read	AI search visibility (AEO): how often ChatGPT, Gemini, Perplexity and others mention the brand for tracked prompts. Dates are ISO (YYYY-MM-DD). engine is one of chatgpt, gemini, perplexity, google_ai_summary, grok, copilot.	`config`, `me`, `engines`, `countries`, `score_methodology`, `overview`, `prompts`, `prompt`, `prompt_results`, `queries`, `top_prompts`, `topics`, `brands`, `tracked_brands`, `our_cited`, `timeline`, `scan_answer`, `sources`, `source_detail`, `sentiment`, `sentiment_digest`, `sentiment_topic`, `sentiment_answers`, `scan_status`, `batch_status`, `explain_run`, `explain_visibility`
`aeo_manage`	Write	AI search visibility (AEO): how often ChatGPT, Gemini, Perplexity and others mention the brand for tracked prompts. Dates are ISO (YYYY-MM-DD). engine is one of chatgpt, gemini, perplexity, google_ai_summary, grok, copilot.	`config_create`, `config_update`, `setup`, `analyze_domain`, `suggest_prompts`, `scrape_context`, `prompt_create`, `prompts_batch`, `prompt_update`, `prompt_delete`, `topic_create`, `topics_batch`, `topic_update`, `topic_delete`, `brand_create`, `brand_update`, `brand_delete`, `add_competitor`, `auto_setup_brand`, `auto_select_priority_prompts`, `scan_now`
`aeo_reddit_citations`	Read	Reddit threads that AI engines cite when answering our tracked prompts. Commenting well on these is the fastest way to get cited. url must be a full https Reddit URL.	`list`, `threads`
`aeo_reddit_citations_manage`	Write	Reddit threads that AI engines cite when answering our tracked prompts. Commenting well on these is the fastest way to get cited. url must be a full https Reddit URL.	`retry`, `generate_now`, `mark_ours`, `unmark_ours`
`reddit_search`	Read	Live Reddit data. Costs agent-API credits per call (polling a job and kind=me are cheap or free). Waits up to ~25s for results, otherwise returns a job_id for kind=job_status.	`posts_search`, `subreddit_posts`, `subreddit_comments`, `thread_comments`, `user_posts`, `domain_mentions`, `job_status`, `me`
`reddit_posts`	Read	Original Reddit posts (not comments) that ReddGrow drafts and tracks. Comments live in the comments tool.	`list`, `get`, `eligibility`, `brand_subreddit`
`reddit_posts_manage`	Write	Original Reddit posts (not comments) that ReddGrow drafts and tracks. Comments live in the comments tool.	`research_topics`, `score`, `generate`, `create`, `update`, `mark_published`, `dismiss_promo_hint`, `set_brand_subreddit`, `delete`
`reddit_accounts`	Read	Reddit accounts used to post (warmup, health, rentals). Adding accounts and changing posting mode are done in the web app.	`list`, `list_refreshed`, `stats`, `activity`, `health`, `rental_state`
`reddit_accounts_manage`	Write	Reddit accounts used to post (warmup, health, rentals). Adding accounts and changing posting mode are done in the web app.	`request_rental`, `cancel_rental_request`
`website_content`	Read	The agent that writes and publishes web pages to win AI answers. Targets are pages AI cites; drafts are the pages it writes. CMS connections are not available here.	`status`, `targets`, `target`, `prompt_sources`, `prompt_drafts`, `prompt_strategies`, `drafts`, `draft`, `escalations`
`website_content_manage`	Write	The agent that writes and publishes web pages to win AI answers. Targets are pages AI cites; drafts are the pages it writes. CMS connections are not available here.	`set_agent`, `sample`, `write_for_prompt`, `attack_target`, `claim_target`, `dismiss_target`, `restore_target`, `update_draft`, `publish_now`, `mark_published`, `request_changes`, `unpublish`, `mark_wrong`, `write_draft`, `cancel_draft`, `skip_draft`, `answer_escalation`
`performance`	Read	Reddit performance, Google Search Console and Analytics, traffic attribution, activity log and reports. Connecting Google is done in the app.	`overview`, `timeline`, `by_campaign`, `by_subreddit`, `top_comments`, `campaign`, `gsc_overview`, `gsc_timeline`, `gsc_top_queries`, `gsc_top_pages`, `gsc_keyword_opportunities`, `ga4_overview`, `ga4_timeline`, `ga4_by_source`, `ga4_top_landing_pages`, `attribution_traffic_lift`, `attribution_top_sources`, `attribution_brand_search_lift`, `attribution_llm_traffic`, `dashboard_today`, `activity`, `google_status`, `reports`, `report`
`performance_manage`	Write	Reddit performance, Google Search Console and Analytics, traffic attribution, activity log and reports. Connecting Google is done in the app.	`sync_google`
`reddgrow_request`	Write	Escape hatch: call any ReddGrow app API route directly (same routes the web app uses, e.g. GET /campaigns). Use only when no dedicated tool covers the task. Admin, billing and credential routes are blocked server-side. Prefer the dedicated tools first.	-
`search_docs`	Read	Search the ReddGrow product docs (docs.reddgrow.ai) and return the best matching pages with their URLs. Use for how-to questions about the app, plans, limits, integrations or the API.	-
`get_skill`	Read	Load a step-by-step ReddGrow workflow guide. Call this before multi-step tasks. Skills:	`setup`, `campaign`, `reddit`, `aeo`, `aeo`, `website`, `reporting`

Skills, docs and instructions

The server sends Claude a short product map (what brands, campaigns, advocates, comments and AEO are, and where Reddit keywords live).
get_skill loads step-by-step guides. The same guides are available as MCP resources (skill://reddgrow/<name>), and three appear as prompts.
search_docs searches this documentation.
reddgrow_request is an escape hatch for app routes no dedicated tool covers. Admin, billing and credential routes are blocked.
reddit_search reads live Reddit and uses your API credits.

Disconnecting

To revoke a client's access to your ReddGrow account:

Go to app.reddgrow.ai → Settings → Connected Apps
Find the client in the list
Click Revoke

Troubleshooting

"Subscription required" error — Renew at app.reddgrow.ai/billing.

"Not a member of this organization" — Disconnect and reconnect, selecting the correct org during approval.

Connection expired / tools return auth error — Disconnect the integration from your client and reconnect to go through the OAuth flow again.

Data looks stale — Drafts and stats update in near real-time. If data appears outdated, check that your campaign is active and that the integration is still connected.

Tools not appearing — Verify the URL is exactly https://mcp.reddgrow.ai/mcp (with /mcp path). Check that your client supports remote MCP over HTTP (not stdio-only).

Support

reddgrow.ai/support

ReddGrow MCP Server

On this page