CrowdReply · MCP

CrowdReply MCP documentation

Connect Claude, Cursor, and other MCP clients to your CrowdReply account to research brands, manage Reddit tasks, track AI visibility, and place backlink orders through natural language.

Last updated: 15 July 2026

Overview

The CrowdReply MCP server exposes CrowdReply's first-party product APIs over the Model Context Protocol. It is intended for marketers and growth teams who already use CrowdReply for Reddit engagement, AI visibility (GEO), social listening, competitor analysis, and backlinks.

Endpoint: https://mcp.crowdreply.io/mcp/client
Transport: Streamable HTTP
Authentication: OAuth 2.1 with PKCE (recommended for Claude and Cursor), or an API key from Account settings

Requirements & billing

An active CrowdReply subscription with MCP + API access on your plan.
Accounts without access receive a 403 with error code E_PLAN_GATE and a dashboard upgrade link.
Credits are a prepaid in-app wallet balance. Tools marked Write · credits hold or spend credits only after a confirmed write (see two-step confirm below).
Tools marked Write · slots consume plan quotas (prompts or keywords), not wallet credits.
CrowdReply does not post to Reddit from the MCP server itself. Task and upvote tools create work that is fulfilled by human workers or vendor partners inside the CrowdReply product.

How to connect

Most clients use OAuth. When you add the CrowdReply connector, the client redirects you to CrowdReply to sign in and approve access.

Add a custom MCP connector pointing at https://mcp.crowdreply.io/mcp/client.
Sign in at crowdreply.io/login if you are not already authenticated.
Review the client name and requested access on the consent screen, then choose Allow.
You are redirected back to the client. The connector should show as connected.

Alternatively, create an API key under Account → API settings and send it as the x-api-key header. Prefer OAuth for Claude and Cursor.

Step-by-step client setup: Help Center guide.

Two-step confirm

Mutating tools use a two-step confirm pattern so a single accidental call cannot spend credits or change data:

Estimate (safe): call with confirm: false (or omit confirm). You receive a summary, cost or slot estimate when applicable, a confirmToken, and an expiry. Nothing is charged or mutated.
Execute: call again with confirm: true and the matching confirm token.

Confirm tokens expire after about 15 minutes. An optional idempotencyKey makes confirmed retries safe.

Tools reference

Tools are purpose-built and split into read versus write operations. Read tools are safe to call freely. Write tools always require confirmation in Claude when annotated as destructive. Below is the full public surface, grouped by capability.

Brands & account

Discover accessible brands, resolve names or domains to IDs, and inspect subscription, balance, and team context.

Tool	Description	Access
`list_brands` List accessible brands	Returns every brand the authenticated user can act on through MCP.	Read
`get_brand` Get brand details	Returns the lean brand document for one accessible brand.	Read
`resolve_brand` Resolve a brand name or domain	Resolves a brand name or domain (for example acme.com) to a brandId.	Read
`list_projects` List Reddit-research projects	Returns Reddit-research projects (tags), optionally narrowed to a brand.	Read
`create_tag` Create a tag (project)	Creates a tag (project) under a brand to group Reddit research.	Write
`list_team_members` List team members	Returns the authenticated user's team roster.	Read
`get_subscription` Get subscription and plan details	Returns subscription, plan name, and MCP/API entitlement status.	Read
`get_balance` Get account balance	Returns the current CrowdReply credit wallet balance.	Read
`get_usage_metrics` Get usage versus plan limits	Returns account-wide usage against plan limits (prompts, keywords, and related quotas).	Read

Tasks & Reddit engagement

Create and manage Reddit comment, reply, and post tasks. CrowdReply fulfills tasks through human workers; credits are held or charged on confirm.

Tool	Description	Access
`list_tasks` List recent tasks	Returns the user's CrowdReply tasks, newest first.	Read
`get_task` Get one task	Returns a single task the user owns, including status and content.	Read
`create_task` Create a Reddit task	Creates a comment, reply, or post task. Two-step confirm; holds credits on confirm.	Write · credits
`cancel_task` Cancel a CrowdReply task	Cancels a task still in a cancellable state and releases any credit hold.	Write
`list_group_tasks` List Reddit task groups	Returns Reddit task groups (thread plus nested comments/replies).	Read
`get_group_task` Get one Reddit task group	Returns a single task group the caller can access.	Read
`create_group_task` Create a task group	Creates a thread with nested comments/replies as a group. Two-step confirm; holds credits on confirm.	Write · credits
`cancel_group_task` Cancel a task group	Cancels a task group still in a cancellable state.	Write
`send_upvotes` Send upvotes for a published task	Orders upvotes for a published task. Two-step confirm; charges credits on confirm.	Write · credits
`list_standalone_upvote_orders` List standalone upvote orders	Returns the user's most recent standalone upvote orders.	Read
`list_edit_requests` List edit requests	Returns recent edit requests on the user's published tasks.	Read
`create_edit_request` Create an edit request	Requests an edit to published task content. Two-step confirm; charges credits on confirm.	Write · credits

AI visibility & prompts

Inspect LLM visibility analytics and manage tracked AI-search prompts for a brand.

Tool	Description	Access
`get_visibility_overview` Get LLM visibility overview	Returns the analytics overview for one accessible brand.	Read
`get_visibility_trend` Get LLM visibility trend	Returns the daily LLM-visibility trend series for a brand.	Read
`list_llm_mentions` List LLM mention responses	Returns the LLM response feed for one accessible brand.	Read
`get_llm_response` Get one LLM response in full	Returns a single captured LLM response in full.	Read
`list_llm_citations` List LLM citation URLs	Returns URLs that LLM answers cited as sources, with competitor context.	Read
`list_llm_models` List tracked LLM models	Returns the LLM models GEO visibility is tracked against.	Read
`get_brand_report` Get brand AI-visibility report	Returns the stored onboarding AI-visibility (GEO) report for a brand.	Read
`list_prompts` List brand prompts	Returns the paginated tracked-prompt list for a brand.	Read
`list_prompt_geolocations` List supported prompt target locations	Returns allowlisted target-location codes for AI-search prompts.	Read
`add_prompts` Add AI-search prompts	Adds prompts to a brand. Two-step confirm; consumes prompt slots on confirm.	Write · slots
`update_prompt_content` Edit a single prompt	Updates one prompt's text and target location.	Write
`set_prompt_active` Pause or unpause a prompt	Sets a single prompt active or paused.	Write
`set_prompts_active_bulk` Pause or unpause many prompts	Bulk pause or unpause for multiple prompts.	Write
`update_prompts_location_bulk` Bulk edit prompt target location	Changes geolocation on two or more prompts.	Write
`delete_prompts` Delete AI-search prompts	Soft-deletes one or many prompts.	Write

Social listening

Track Reddit keywords and browse the mention feed for an accessible brand.

Tool	Description	Access
`list_tracked_keywords` List tracked Reddit keywords	Returns the social-listening keyword list for a brand.	Read
`add_tracked_keywords` Add tracked Reddit keywords	Adds keywords for a brand. Two-step confirm; consumes keyword slots on confirm.	Write · slots
`delete_tracked_keywords` Delete tracked Reddit keywords	Hard-deletes tracked keywords and their associated Reddit mentions.	Write
`list_mentions` List Reddit mentions	Returns the social-listening Reddit mention feed.	Read

Competitors

Inspect competitor analysis KPIs and manage the tracked competitor set for a brand.

Tool	Description	Access
`list_tracked_competitors` List tracked competitors	Returns the brand's tracked competitor set.	Read
`update_tracked_competitors` Update tracked competitors	Replaces the brand's tracked competitor set (maximum 10 entities).	Write
`get_competitor_leaderboard` Get competitor leaderboard	Returns Competitor Analysis KPIs and leaderboard rows for a brand.	Read
`compare_competitors` Compare tracked competitors	Side-by-side metric matrix for the brand versus up to five tracked competitors.	Read
`get_competitor_detail` Get competitor detail	Hero stats, top citation sources, and prompt-level comparison for one competitor.	Read

Backlinks

Browse the backlink marketplace, manage the cart, and place credit-based orders.

Tool	Description	Access
`search_backlink_listings` Search backlink marketplace listings	Searches the live Backlinks marketplace catalog.	Read
`get_backlink_listing` Get one backlink listing	Returns one marketplace listing by backlinkId (DR, traffic, pricing).	Read
`get_backlink_cart` Get backlink cart	Returns the account owner's current Backlinks cart.	Read
`add_to_backlink_cart` Add listing to backlink cart	Adds a marketplace listing to the cart. No credits are charged until checkout.	Write
`get_backlink_checkout_preview` Get backlink checkout preview	Returns cart totals, wallet balance, and whether checkout can proceed.	Read
`place_backlink_order` Place backlink order	Places the cart as a credits order. Two-step confirm; charges credits on confirm.	Write · credits
`list_backlink_orders` List backlink orders	Lists the account owner's Backlink marketplace orders.	Read
`get_backlink_order` Get one backlink order	Returns one Backlink order in detail, including items and briefs.	Read
`get_backlink_coverage` Get CrowdReply backlink coverage	Summarizes CrowdReply-acquired backlink coverage for one brand.	Read

Billing & refunds

Inspect refund history and check or request refunds for eligible published tasks. Credits are an in-app prepaid balance, not an external money transfer.

Tool	Description	Access
`get_refunds` Get account refunds	Returns the user's recent refunds (amount, date, reason).	Read
`check_refund_eligibility` Check task refund eligibility	Read-only check of whether a specific published task is refundable.	Read
`refund_task` Refund an eligible published task	Refunds an eligible published task; credits return to the wallet balance.	Write

Help

Search CrowdReply's product help and SOP knowledge base.

Tool	Description	Access
`search_knowledge` Search the CrowdReply knowledge base	Semantically searches CrowdReply help and SOP articles for product guidance.	Read

Data handling & privacy

The MCP connector operates on your CrowdReply account data only. It does not collect Claude conversation history, chat memory, or local files beyond the tool arguments you (or the client) send for a given call.

What it can access: brands and projects you can already see in the dashboard; tasks, prompts, mentions, visibility metrics, competitors, backlink cart and orders; subscription, balance, and refund records for your account.
What it does not do: query Claude's memory or chat history; scrape arbitrary third-party APIs; transfer money or cryptocurrency outside the CrowdReply credit wallet; generate AI images, video, or audio.
Authentication tokens and API keys must never be pasted into tool arguments. OAuth tokens are handled by the client; API keys belong only in the x-api-key header.
Team members with read-only roles cannot run write tools (E_TEAM_READ_ONLY).

For the full privacy policy and terms, see Privacy Policy and Terms of Service.

Support

Questions about connecting or using the MCP connector: [email protected].

Product help and setup articles: help.crowdreply.io.