Tools reference
Tools reference
Every tool the Linkeddit connector exposes, grouped by capability: competitor intelligence, leads, keyword research, content, outreach, Reddit market signal, and Answer Radar. The connector is a superset of the legacy Reddit MCP — the Legacy column marks the tools the legacy server does not have.
The full toolset
The connector exposes all 42 tools in one keyless server: competitor intelligence, lead generation, keyword research, content, outreach, Reddit market signal, and Answer Radar. Every tool below is available over a single OAuth connection on the Compete plan.
It is a superset of the legacy Reddit MCP (API-key). The business tools (leads, keywords, competitive intelligence, subreddits, content, outreach) exist on both surfaces under the same names; the Reddit tools exist on both but under different names; the Answer Radar tools are connector-only.
— means the tool is connector-only — the legacy server does not have it. The business tool groups further down are identical on both surfaces (same names), so they omit the column.Output modes: where supported, a tool accepts an optional mode parameter controlling detail — summary (default), evidence, raw, and reference. raw output is scrubbed of any credentials or infrastructure details.
Answer Radar — gaps & fixes
| Tool | Scope | What it does | Key parameters | Legacy |
|---|---|---|---|---|
| answer_projects_list | answer:read | List your Answer Radar projects (tracked domains) and their configuration state. | limit, offset | — |
| answer_gaps_list | answer:read | List a project's recommendation gaps ranked by intent, evidence, and confidence. | project_id (required), status, limit, offset | — |
| answer_gap_get | answer:read | Get one gap: observations, citations, hypotheses, and recommended actions — kept strictly separate. | gap_id (required) | — |
| answer_fix_draft | answer:write | Draft a fix (brief, article, or response) for a gap from the run's recorded evidence. | gap_id (required), type (brief/article/response), idempotency_key (required) | — |
| answer_fix_save | answer:write | Save a drafted fix to your Linkeddit review workspace and return the deep link. | fix_id (required), idempotency_key (required) | — |
Answer Radar — projects & prompts
| Tool | Scope | What it does | Key parameters | Legacy |
|---|---|---|---|---|
| answer_project_create | answer:write | Create a project from a domain and commercial context (brand, competitors, buyer segment, category, geography, language). | domain (required), brand_name, competitors[], buyer_segment, category, geography, language, idempotency_key (required) | — |
| answer_project_get | answer:read | Get a project's configuration: brand, competitors, commercial context, and prompt counts by status. | project_id (required) | — |
| answer_prompts_propose | answer:run | Generate commercial-intent buying questions for a project (a draft set for you to approve). | project_id (required), count (default 8), idempotency_key (required) | — |
| answer_prompts_update | answer:write | Approve, remove, add, and reprioritize a project's buying questions. Only approved prompts are audited. | approve[], remove[], add[], prompt_set_id (required with add), reprioritize[], idempotency_key (required) | — |
| answer_prompts_list | answer:read | List a project's buying questions and their approval status. | project_id (required), status | — |
Answer Radar — managed audits
| Tool | Scope | What it does | Key parameters | Legacy |
|---|---|---|---|---|
| answer_audit_estimate | answer:read | Estimate the cost of an audit before starting it (no spend). | project_id (required), prompts[], samples_per_prompt (default 1) | — |
| answer_audit_start | answer:run | Start a managed audit: reserve budget, fan out provider measurements, aggregate into gaps. | project_id (required), prompts[], samples_per_prompt (default 1), geography, language, idempotency_key (required) | — |
| answer_audit_launch | answer:run | Launch a pre-created (pending) run asynchronously and return immediately; poll answer_run_get. | run_id (required), idempotency_key (required) | — |
| answer_run_get | answer:read | Poll an audit run: status, sample outcomes, costs, and (raw mode) normalized samples with citations. | run_id (required) | — |
| answer_runs_list | answer:read | List a project's audit runs, most recent first. | project_id (required), limit, offset | — |
Reddit — market signal
The connector's Reddit tools mirror the legacy Reddit MCP's, under connector-native names (the legacy name is shown in the Legacy column).
| Tool | Scope | What it does | Key parameters | Legacy |
|---|---|---|---|---|
| reddit_search | reddit:read | Search Reddit posts across all subreddits. Returns titles, scores, comment counts, and content. | query (required), sort, time_filter, limit (default 25) | search_reddit |
| reddit_fetch_subreddit | reddit:read | Fetch posts from a specific subreddit sorted by hot, new, top, or rising. | subreddit (required), sort, time_filter, limit (default 25) | fetch_subreddit |
| reddit_fetch_post_comments | reddit:read | Fetch a Reddit post and its top-level comments given a post URL. | post_url (required), comment_limit (default 10) | fetch_post_comments |
| reddit_fetch_json | reddit:read | Fetch any Reddit JSON endpoint, e.g. /r/SaaS/top.json?t=week. | reddit_path (required) | fetch_reddit_json |
Leads, keywords, competitor intelligence, content & outreach
These tools are the same on the connector and the legacy Reddit MCP — identical names and behavior. Each is listed below with its full parameter set, generated from the live tool definitions so it never drifts. On the connector they are reached over OAuth (scopes granted at authorize time); competitive-intelligence tools additionally require the Compete plan.
Competitive intelligence
Competitive-intelligence briefs, switching signals, and page-change detection (Compete plan).
list_competitor_monitors
compete:readCompete planList your competitor monitors (Compete tier) and their configuration.
get_competitor_brief
compete:readCompete planGet the latest deep competitor brief: complaint themes, feature gaps, pricing signals, churn drivers, switch triggers, recommended actions, and a battlecard.
| Parameter | Type | Required | Description |
|---|---|---|---|
| competitor | yes | Competitor name to filter by | |
| monitor_id | yes | Specific competitor monitor id |
get_weekly_brief
compete:readCompete planGet your latest weekly competitive-intelligence brief, including the switching/market signals that fed it.
| Parameter | Type | Required | Description |
|---|---|---|---|
| week_of | yes | Filter to a specific week start date (YYYY-MM-DD) |
get_switching_signals
compete:readCompete planList individual switching / buying-intent / market signals detected for your competitors, with why-it-matters and sources.
| Parameter | Type | Required | Description |
|---|---|---|---|
| competitor | yes | Competitor name to filter by | |
| priority | yes | Filter by priority (e.g. high, medium, low) | |
| week_of | yes | Filter to a specific week (YYYY-MM-DD) | |
| limit | yes | Max results |
get_competitor_changes
compete:readCompete planGet recent competitor page snapshots (pricing / landing pages) for change detection. Compare content_hash and scraped_at across snapshots of the same URL.
| Parameter | Type | Required | Description |
|---|---|---|---|
| competitor | yes | Competitor name to filter by | |
| monitor_id | yes | Specific competitor monitor id | |
| limit | yes | Max snapshots |
Leads & pipelines
Query your leads database, pipelines, projects, and stats — and queue new lead-gen pipelines.
search_leads
leads:readSearch your Linkeddit leads database for Reddit users identified as potential leads based on buying intent, niche, and engagement scores.
| Parameter | Type | Required | Description |
|---|---|---|---|
| query | yes | Search query to match against username, bio, niches, tags, or industry | |
| subreddit | yes | Filter by target subreddit | |
| status | yes | Filter by lead status | |
| min_score | yes | Minimum contactability score (0-100) | |
| limit | yes | Max results |
get_user_profile
leads:readGet a detailed Reddit user profile from the Linkeddit database including karma, post/comment counts, niches, tags, and contactability score.
| Parameter | Type | Required | Description |
|---|---|---|---|
| username | yes | Reddit username to look up |
get_user_posts
leads:readGet Reddit posts by a specific user from the Linkeddit database.
| Parameter | Type | Required | Description |
|---|---|---|---|
| username | yes | Reddit username | |
| subreddit | yes | Filter posts by subreddit | |
| limit | yes | Max results |
get_user_comments
leads:readGet Reddit comments by a specific user from the Linkeddit database.
| Parameter | Type | Required | Description |
|---|---|---|---|
| username | yes | Reddit username | |
| subreddit | yes | Filter comments by subreddit | |
| limit | yes | Max results |
get_lead_insights
leads:readGet AI-generated insights about a Reddit user including their expertise level, niches, tags, and a description derived from their Reddit activity.
| Parameter | Type | Required | Description |
|---|---|---|---|
| username | yes | Reddit username to get insights for |
list_pipelines
leads:readList your Linkeddit lead-gen pipelines (search requests) with their current processing status.
| Parameter | Type | Required | Description |
|---|---|---|---|
| limit | yes | Max results |
get_pipeline_results
leads:readGet a specific lead-gen pipeline's request details and result records (status + result file).
| Parameter | Type | Required | Description |
|---|---|---|---|
| request_id | yes | The pipeline (user_request) id |
get_lead_stats
leads:readAggregate stats across your leads: counts by status and reach-out status, and average contactability score.
list_projects
leads:readList your Linkeddit lead projects (product overview, goals, audience, brand voice) used to personalize outreach.
create_lead_pipeline
leads:writeuses quotaCreate and queue a new lead-generation pipeline. Linkeddit scrapes and scores Reddit users (or review-site reviewers) matching your keywords, then writes them to your leads database. Consumes your execution quota; runs asynchronously (poll with get_pipeline_results).
| Parameter | Type | Required | Description |
|---|---|---|---|
| name | yes | A name for this pipeline | |
| purpose | yes | What you are looking for / the product context | |
| keywords | yes | Search keywords (1-50) | |
| source | yes | Lead source: reddit (needs exactly 1 subreddit) or review_sites | |
| subreddit | yes | Target subreddit (required for reddit source) | |
| competitors | yes | Competitor names (review_sites source) | |
| target_urls | yes | Review URLs (review_sites source) | |
| category | yes | Optional category | |
| duration | yes | Look-back window for posts/reviews |
Keyword research
Discover and score keywords with Google autocomplete and SERP research.
keyword_autocomplete
keywords:readGet Google autocomplete suggestions for a seed query. Useful for discovering long-tail keyword variations people actually search.
| Parameter | Type | Required | Description |
|---|---|---|---|
| query | yes | Seed keyword or phrase |
keyword_serp
keywords:readFetch Google SERP research for a query: People Also Ask questions, related searches, and top organic result titles.
| Parameter | Type | Required | Description |
|---|---|---|---|
| query | yes | Keyword or phrase to research |
list_keyword_jobs
keywords:readList your Linkeddit keyword-research jobs and their status.
| Parameter | Type | Required | Description |
|---|---|---|---|
| status | yes | Filter by job status (e.g. completed, processing, failed) | |
| limit | yes | Max results |
get_keyword_results
keywords:readGet scored keyword results for one of your keyword-research jobs, ranked by priority score (specificity, relevance, conversion potential).
| Parameter | Type | Required | Description |
|---|---|---|---|
| job_id | yes | Keyword research job id | |
| min_score | yes | Minimum priority score | |
| include_filtered | yes | Include keywords that were filtered out | |
| limit | yes | Max results |
Subreddit discovery
Find and compare subreddits from the Linkeddit directory.
suggest_subreddits
reddit:readLook up a subreddit in the Linkeddit directory and suggest similar communities (by size) to target. Pass a subreddit name; returns the community plus neighbors.
| Parameter | Type | Required | Description |
|---|---|---|---|
| subreddit | yes | Subreddit name (with or without r/) | |
| limit | yes | Max similar communities |
Content writer
Generate contextual content ideas grounded in real discussions, and read the results.
generate_content_topics
content:writeuses quotaQueue the AI content writer to generate contextual Reddit content ideas for a subreddit and intent, grounded in real recent discussions. Consumes your content-writer quota; runs asynchronously (poll with get_content_topics).
| Parameter | Type | Required | Description |
|---|---|---|---|
| subreddit | yes | Subreddit to mine (with or without r/) | |
| intent | yes | What you want to write about / your goal (min 10 chars) | |
| time_window_input | yes | How far back to look (e.g. 'past week', 'past month') | |
| name | yes | Optional name for this request | |
| ignore_keywords | yes | Keywords to exclude (max 50) |
get_content_topics
content:writeGet generated topic suggestions for one of your content-writer requests (poll after generate_content_topics).
| Parameter | Type | Required | Description |
|---|---|---|---|
| request_id | yes | The content-writer request (topic_request_id) | |
| limit | yes | Max suggestions |
Outreach
Draft personalized outreach messages for your leads.
generate_dm_draft
content:writeGenerate a personalized outreach DM draft for one of your leads, using the lead's Reddit context and your project's product knowledge and brand voice.
| Parameter | Type | Required | Description |
|---|---|---|---|
| lead_id | yes | The lead id to draft a DM for |