ReddGrowReddGrow Docs
Integrations

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

  1. Go to claude.ai/settings/integrations
  2. Click Add custom connector
  3. Enter the server URL: https://mcp.reddgrow.ai/mcp
  4. 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:

  1. Sign in to your ReddGrow account
  2. Select which organization to grant access to
  3. 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 (71 total)

Health (1)

ToolRead/WriteDescription
health_checkReadCheck API connectivity

Campaigns (5)

ToolRead/WriteDescription
list_campaignsReadList campaigns (paginated)
get_campaignReadGet campaign by ID
create_campaignWriteCreate a campaign
update_campaignWriteUpdate a campaign
delete_campaignWriteDelete a campaign

Subreddits (7)

ToolRead/WriteDescription
list_subredditsReadList tracked subreddits (paginated)
get_subredditReadGet subreddit by ID
quick_add_subredditWriteQuick-add by name
create_subredditWriteCreate with full config
update_subredditWriteUpdate settings
toggle_subreddit_activeWriteEnable/disable monitoring
delete_subredditWriteRemove from tracking

Advocates (5)

ToolRead/WriteDescription
list_advocatesReadList AI advocate personas (paginated)
get_advocateReadGet advocate by ID
create_advocateWriteCreate an advocate
update_advocateWriteUpdate an advocate
delete_advocateWriteDelete an advocate

Brand Monitor (9)

ToolRead/WriteDescription
list_brand_domainsReadList monitored domains (paginated)
get_brand_domainReadGet domain by ID
create_brand_domainWriteAdd a domain to monitor
update_brand_domainWriteUpdate domain settings
delete_brand_domainWriteRemove a monitored domain
list_brand_mentionsReadList Reddit mentions (paginated)
get_brand_mentionReadGet mention by ID
update_brand_mentionWriteUpdate mention status/sentiment
get_brand_monitor_statsReadGet monitoring statistics

Drafts (6)

ToolRead/WriteDescription
list_draftsReadList AI-generated drafts (paginated)
get_draftReadGet draft by ID
approve_draftWriteApprove for posting
skip_draftWriteSkip a draft
get_draft_engagement_historyReadDaily views/upvotes/replies series for one draft (paginated)
get_draft_repliesReadList Reddit replies received on a posted draft (paginated)

Engagement (1)

ToolRead/WriteDescription
list_engagement_snapshotsReadOrg-wide draft performance history, for incremental sync (paginated)

Stats (4)

ToolRead/WriteDescription
get_stats_summaryReadCampaign and draft summary
get_drafts_dailyReadDaily draft volume time series
get_drafts_dashboardReadDraft pipeline counts by status
get_posting_statsReadPosting activity and cooldown status

AEO / AI Visibility (33)

Tools for tracking your brand's visibility across AI engines (ChatGPT, Perplexity, Gemini, etc.).

Account and reference

ToolRead/WriteDescription
aeo_meReadAccount info, plan, limits
aeo_list_enginesReadSupported AI engines
aeo_list_countriesReadSupported scan countries
aeo_score_methodologyReadHow scores are calculated

Prompts (tracked queries)

ToolRead/WriteDescription
aeo_list_promptsReadList tracked prompts
aeo_get_promptReadGet prompt with stats
aeo_list_prompt_runsReadScan runs for a prompt (paginated)
aeo_create_promptWriteCreate a prompt to track
aeo_batch_create_promptsWriteBulk create (async)
aeo_get_batch_jobReadPoll bulk creation status
aeo_update_promptWriteUpdate topic/tags/active
aeo_delete_promptWriteDelete a prompt

Scan runs

ToolRead/WriteDescription
aeo_get_runReadGet a single scan run
aeo_explain_runReadScoring explanation for a run

Visibility

ToolRead/WriteDescription
aeo_visibility_timelineReadVisibility score over time
aeo_visibility_explainReadWhat's driving your visibility

Brands

ToolRead/WriteDescription
aeo_list_brandsReadList tracked brands
aeo_brands_rankingReadRanked brand comparison
aeo_create_brandWriteTrack a new brand or competitor
aeo_update_brandWriteUpdate brand name
aeo_delete_brandWriteDelete a brand

Topics

ToolRead/WriteDescription
aeo_list_topicsReadList prompt topics
aeo_create_topicWriteCreate a topic
aeo_batch_create_topicsWriteBulk create topics
aeo_update_topicWriteUpdate topic
aeo_delete_topicWriteDelete topic

Sources and citations

ToolRead/WriteDescription
aeo_list_source_domainsReadSource domains by citation count (paginated)
aeo_list_source_urlsReadSource URLs by citation count (paginated)
aeo_top_domainsReadTop cited domains
aeo_domain_typesReadDomain type distribution
aeo_source_detailReadDrill into a domain/URL/query
aeo_list_citationsReadAll citation events (paginated)

Sentiment

ToolRead/WriteDescription
aeo_sentiment_explainReadBrand sentiment across AI engines

Disconnecting

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

  1. Go to app.reddgrow.aiSettingsConnected Apps
  2. Find the client in the list
  3. 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