MCP Radar
MCP Server

Prowlo — Reddit & X for AI agents

com.prowlo/reddit-x
Marketing & Advertising Search & Research Social Media Public & reachable MCP 2025-11-25

What this MCP does

Indexes and searches Reddit and X-related social data, discovers communities, monitors keywords, finds engagement opportunities, drafts and humanizes replies, and delivers alerts.

Capabilities

Tools

49 tools
alert_create
Create an Alert. It fires when newly-ingested records match `query`. REQUIRED: `query.any` must have at least one mention term (brand/product/domain) — an alert with no mentions would match every record and is rejected. Per-match by default (one notification per new match, batched); provide `threshold` for volume/spike firing. Delivers to Slack and/or the given webhooks. Not metered. (requires a free Prowlo account — call it to get a signup link)
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['name', 'query', 'destination'], 'properties': {'name': {'type': 'string', 'minLength': 1, 'description': 'Human-readable alert name'}, 'query': {'type': 'object', 'properties': {'to': {'type': 'string', 'description': 'ISO date upper bound (created on platform)'}, 'any': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Match if title/body contains ANY of these terms (brand monitoring â\x86\x92 your brand + variants)'}, 'from': {'type': 'string', 'description': 'ISO date lower bound (created on platform)'}, 'tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Restrict to records carrying any of these rule tags'}, 'intent': {'type': 'array', 'items': {'enum': ['BUYING', 'SELLING', 'DISCUSSING'], 'type': 'string'}, 'description': '(COMING SOON â\x80\x94 not yet available) Filter by author intent: BUYING, SELLING, or DISCUSSING. Posts are not intent-classified yet, so this filter currently returns no matches.'}, 'exclude': {'type': 'array', 'items': {'type': 'string'}, 'description': 'None of these may appear in title/body'}, 'include': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Stricter: EVERY term must appear in title/body'}, 'keyword': {'type': 'string', 'description': 'Single free-text term in title/body'}, 'minScore': {'type': 'integer', 'description': 'Minimum post score (platform upvotes/points)'}, 'platforms': {'type': 'array', 'items': {'type': 'string'}, 'description': 'e.g. ["reddit","hackernews"]'}, 'watcherId': {'type': 'string', 'description': 'Restrict to records from one of your Watchers (by id)'}, 'subreddits': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Restrict to these subreddits/channels (no r/ prefix)'}, 'minComments': {'type': 'integer', 'description': 'Minimum number of comments'}}, 'description': 'Record match filter (same shape as search_dataset / list_records filters)', 'additionalProperties': False}, 'status': {'enum': ['active', 'paused'], 'type': 'string', 'description': 'Initial status: "active" (default) or "paused"'}, 'threshold': {'type': 'object', 'required': ['count', 'window'], 'properties': {'count': {'type': 'integer', 'description': 'Fire when at least this many matches occur', 'exclusiveMinimum': 0}, 'window': {'type': 'string', 'description': 'Look-back window, e.g. "1h", "24h"'}}, 'description': 'Omit for per-match firing; provide for volume/spike firing', 'additionalProperties': False}, 'destination': {'type': 'object', 'properties': {'slack': {'type': 'boolean', 'description': "Post to the org's connected Slack (verify via get_account â\x86\x92 integrations.slack.connected)"}, 'webhookIds': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Ids of existing webhooks to deliver to (listed in get_account â\x86\x92 integrations.webhooks)'}}, 'description': 'At least one of slack=true or a non-empty webhookIds is required', 'additionalProperties': False}}, 'additionalProperties': False}
alert_delete
Delete an Alert by id. Not metered. (requires a free Prowlo account — call it to get a signup link)
Destructive Idempotent
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'minLength': 1, 'description': 'Alert id to delete (from alert_list)'}}, 'additionalProperties': False}
alert_get_deliveries
List recent deliveries (fires) for one Alert — what was matched and where it was sent. Not metered. (requires a free Prowlo account — call it to get a signup link)
Read only Idempotent
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'minLength': 1, 'description': 'Alert id whose deliveries to list (from alert_list)'}, 'limit': {'type': 'integer', 'default': 50, 'maximum': 200, 'minimum': 1, 'description': 'Max deliveries to return, 1-200 (default 50)'}}, 'additionalProperties': False}
alert_list
List your organization’s Alerts (persistent rules that fire to Slack/webhooks when records match). Includes last-delivered time and total deliveries. Not metered. (requires a free Prowlo account — call it to get a signup link)
Read only Idempotent
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
alert_update
Update an Alert (name, query, destination, threshold, or status). Only provided fields change. If `query` is provided it must still include at least one `query.any` mention term. Not metered. (requires a free Prowlo account — call it to get a signup link)
Idempotent
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'minLength': 1, 'description': 'Alert id to update (from alert_list)'}, 'name': {'type': 'string', 'minLength': 1, 'description': 'New alert name (rename)'}, 'query': {'type': 'object', 'properties': {'to': {'type': 'string', 'description': 'ISO date upper bound (created on platform)'}, 'any': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Match if title/body contains ANY of these terms (brand monitoring â\x86\x92 your brand + variants)'}, 'from': {'type': 'string', 'description': 'ISO date lower bound (created on platform)'}, 'tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Restrict to records carrying any of these rule tags'}, 'intent': {'type': 'array', 'items': {'enum': ['BUYING', 'SELLING', 'DISCUSSING'], 'type': 'string'}, 'description': '(COMING SOON â\x80\x94 not yet available) Filter by author intent: BUYING, SELLING, or DISCUSSING. Posts are not intent-classified yet, so this filter currently returns no matches.'}, 'exclude': {'type': 'array', 'items': {'type': 'string'}, 'description': 'None of these may appear in title/body'}, 'include': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Stricter: EVERY term must appear in title/body'}, 'keyword': {'type': 'string', 'description': 'Single free-text term in title/body'}, 'minScore': {'type': 'integer', 'description': 'Minimum post score (platform upvotes/points)'}, 'platforms': {'type': 'array', 'items': {'type': 'string'}, 'description': 'e.g. ["reddit","hackernews"]'}, 'watcherId': {'type': 'string', 'description': 'Restrict to records from one of your Watchers (by id)'}, 'subreddits': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Restrict to these subreddits/channels (no r/ prefix)'}, 'minComments': {'type': 'integer', 'description': 'Minimum number of comments'}}, 'description': 'Record match filter (same shape as search_dataset / list_records filters)', 'additionalProperties': False}, 'status': {'enum': ['active', 'paused'], 'type': 'string', 'description': 'Set status to "active" or "paused"'}, 'threshold': {'type': 'object', 'required': ['count', 'window'], 'properties': {'count': {'type': 'integer', 'description': 'Fire when at least this many matches occur', 'exclusiveMinimum': 0}, 'window': {'type': 'string', 'description': 'Look-back window, e.g. "1h", "24h"'}}, 'description': 'Omit for per-match firing; provide for volume/spike firing', 'additionalProperties': False}, 'destination': {'type': 'object', 'properties': {'slack': {'type': 'boolean', 'description': "Post to the org's connected Slack (verify via get_account â\x86\x92 integrations.slack.connected)"}, 'webhookIds': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Ids of existing webhooks to deliver to (listed in get_account â\x86\x92 integrations.webhooks)'}}, 'description': 'At least one of slack=true or a non-empty webhookIds is required', 'additionalProperties': False}}, 'additionalProperties': False}
catalog_get_subreddit
One subreddit's card from Prowlo's tracked catalog — NOT a live Reddit call. view="stats" (default): subscribers, posts/day, comments/post, postsPerDay is sampled from the subreddit's own newest-100 /new feed (postsPerDaySpanHours = the real span those posts cover; postsPerDaySampleSize; null = not sampled in the last 14 days or fewer than 10 posts), plus activeUsers (online now at the last snapshot), title, subredditType, createdUtc (ISO), lastPostAt (ISO, newest sampled post), distinctPosterRatio (unique posters / sampled posts, 0..1) and sampleSize, growth7d + growth30d (null = not enough tracking history for that window, NOT zero growth), promoTolerance, trackingSince, plus a 5-each preview of similarByContent/similarByAudience. Set includeSeries=true only if you need the raw daily snapshot series (up to 90 points) — the growth fields already summarize it. view="similar": deeper neighbor lists only, up to `limit` each (similarByAudience empty = author overlap not computed yet for this sub — normal, not an error). "Not tracked" does NOT mean unwatchable — watcher_create accepts any subreddit. Free, NOT metered. (requires a free Prowlo account — call it to get a signup link)
Read only Idempotent
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['name'], 'properties': {'name': {'type': 'string', 'maxLength': 100, 'minLength': 1, 'description': 'Subreddit name, with or without r/ prefix'}, 'view': {'enum': ['stats', 'similar'], 'type': 'string', 'default': 'stats', 'description': '"stats": full stat card + a 5-each similar preview. "similar": deeper similar-community lists only.'}, 'limit': {'type': 'integer', 'default': 10, 'maximum': 20, 'minimum': 1, 'description': '(view="similar" only) max neighbors per list; ignored for view="stats" (preview fixed at 5 each)'}, 'includeSeries': {'type': 'boolean', 'default': False, 'description': '(view="stats" only) include the daily snapshot series'}}, 'additionalProperties': False}
catalog_search_subreddits
Semantic + keyword search over Prowlo's own pre-crawled subreddit catalog (~1,200 tracked, active, non-NSFW communities) — NOT a live Reddit call and NOT your org's Dataset. The same index behind prowlo.com's public Subreddit Finder. Use this FIRST when discovering candidate communities for a product or niche; describe the audience or problem, not just keywords. Returns ranked cards with subscribers, posts/day, 30-day growth, and promoTolerance (low/medium/high; null = not yet profiled, NOT "no restrictions"). Free, cached, NOT metered. Next steps: catalog_get_subreddit for the full stat card, catalog_top_subreddits to browse rankings, watcher_create to start watching. For a LIVE Reddit subreddit search (subs outside this catalog), use social_find_channels (1 credit). For an evidence-backed, ranked report with rules and an engagement plan, use research_run / research_get. (requires a free Prowlo account — call it to get a signup link)
Read only Idempotent
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['query'], 'properties': {'limit': {'type': 'integer', 'default': 10, 'maximum': 10, 'minimum': 1, 'description': 'Max subreddits to return, 1-10 (default 10)'}, 'query': {'type': 'string', 'maxLength': 500, 'minLength': 2, 'description': 'Product/niche/topic to match â\x80\x94 a sentence beats a keyword'}}, 'additionalProperties': False}
catalog_top_subreddits
Ranked lists from Prowlo's tracked catalog — NOT a live Reddit call. metric: largest (subscribers), most-active (posts/day sampled from each sub's own /new feed within the last 14 days; unsampled subs sort last), fastest-growing (30-day % — needs ≥30 days of snapshot history; until enough exists the response is available:false with trackingSince — a SUCCESS shape, don't retry; size=all applies a 10,000-member floor and every band requires ≥50 members gained, so tiny denominators can't top the list). Optional size band filters by subscriber count. Cached ~5 min. Free, NOT metered. Good for browsing a category cold or benchmarking a candidate's growth30d against the field; vet picks with catalog_get_subreddit, then watcher_create. (requires a free Prowlo account — call it to get a signup link)
Read only Idempotent
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'size': {'enum': ['all', '1m+', '100k-1m', '10k-100k', 'under-10k'], 'type': 'string', 'default': 'all', 'description': 'Subscriber-count band filter'}, 'limit': {'type': 'integer', 'default': 25, 'maximum': 50, 'minimum': 1}, 'metric': {'enum': ['largest', 'most-active', 'fastest-growing'], 'type': 'string', 'default': 'largest'}}, 'additionalProperties': False}
get_account
Get your Prowlo account details: organization ID + name, your user ID, email, role, plan, account status, and integration state (connected Slack channels, webhook endpoints). Check `integrations` before setting an Alert destination — `destination.slack` only delivers if Slack is connected, and `destination.webhookIds` must reference the webhook ids listed here. Use this to identify your account when contacting support — quote the organizationId so we can find you quickly. (requires a free Prowlo account — call it to get a signup link)
Read only Idempotent
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
get_alerts
(Legacy alias for get_operational_alerts.) Read recent OPERATIONAL alerts — Prowlo's own failures: errored crawl runs (critical) and failed webhook deliveries (warning), merged and time-sorted. NOT the user's configured Alerts: for those, use alert_list. NOT metered. (requires a free Prowlo account — call it to get a signup link)
Read only Idempotent
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'default': 20, 'maximum': 50, 'minimum': 1, 'description': 'Max operational alerts to return, 1-50 (default 20)'}}, 'additionalProperties': False}
get_crawl_activity
Read crawl-run activity: a summary (total runs, errored runs, new posts, matched, stored bytes) plus a paginated list of recent runs with per-run fetched/matched/new/duration and any error. NOT metered. (requires a free Prowlo account — call it to get a signup link)
Read only Idempotent
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'default': 30, 'maximum': 100, 'minimum': 1, 'description': 'Max crawl runs to return, 1-100 (default 30)'}, 'cursor': {'type': 'string', 'description': 'Pagination cursor from a previous response'}}, 'additionalProperties': False}
get_dataset_summary
High-level summary of your Dataset: record count, last ingest time, number of watchers/sources, busiest channels, plus your daily live-read usage and reset time. NOT a live Reddit call — free, rate-limited only. Use this first to understand the size and shape of your archive before querying it. (requires a free Prowlo account — call it to get a signup link)
Read only Idempotent
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
get_operational_alerts
Read recent OPERATIONAL alerts — Prowlo's own failures: errored crawl runs (critical) and failed webhook deliveries (warning), merged and time-sorted. NOT the user's configured Alerts: for those, use alert_list. NOT metered. (requires a free Prowlo account — call it to get a signup link)
Read only Idempotent
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'default': 20, 'maximum': 50, 'minimum': 1, 'description': 'Max operational alerts to return, 1-50 (default 20)'}}, 'additionalProperties': False}
get_product_profile
Get your organization's product profile: name, description, audience, value propositions, tone, reply guidelines, confirmed discovery keywords, and competitors. Useful context for crafting relevant replies. (requires a free Prowlo account — call it to get a signup link)
Read only Idempotent
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
get_record
Fetch one Dataset record by id (full body + intent/embedding signals + tags). NOT a live Reddit call — free, rate-limited only. (requires a free Prowlo account — call it to get a signup link)
Read only Idempotent
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'minLength': 1, 'description': 'The record id (from list_records / search_dataset)'}}, 'additionalProperties': False}
get_usage
Get your daily live-read usage: today's passthrough count, your daily cap, and reset time. Live-Reddit reads (social_search, social_list_posts, social_get_post, social_get_user, social_get_user_activity, social_find_channels) count toward a daily cap, charged on success. research_run draws from the AI-credit pool (first run per org free; later runs use credits — the balance is in aiCredits). Internal-data reads (list_records, search_dataset, get_record, list_watchers, get_dataset_summary, get_crawl_activity, get_alerts, get_account), catalog reads (catalog_search_subreddits, catalog_get_subreddit, catalog_top_subreddits) and research_get are NOT metered — only rate-limited. (requires a free Prowlo account — call it to get a signup link)
Read only Idempotent
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
humanize_comment
Rewrite YOUR drafted comment so it reads like a real person typed it, not an AI: strips AI tells, compresses to the 1-2 points that matter, varies rhythm, and lightly "dirties" it (lowercase sentence starts, no markdown). Best AFTER you draft a reply — write the real substance, then humanize it. INPUT RULES for best results: (1) put every fact/number/name you want kept IN the text — it never invents any; (2) keep it to ONE or TWO points — it cuts hard and drops the rest; (3) plain text only — markdown, bullet lists, and em-dashes are stripped; (4) shorter is better, ≤2000 chars; (5) one comment per call, do NOT include the post you are replying to. Pick `character` for the voice. Returns the rewrite, the AI "tells" found in your draft (so you can draft cleaner next time), and remaining daily quota. Output is intentionally imperfect + non-deterministic — do NOT "fix" it or retry for a cleaner version. Free · daily-capped · no Reddit credits. (usable right now without an account, daily-capped per IP)
Read only
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['text'], 'properties': {'text': {'type': 'string', 'maxLength': 2000, 'minLength': 1, 'description': 'The drafted comment to humanize, as ONE plain-text comment (no markdown, â\x89¤2000 chars). Every fact you want kept must be in here â\x80\x94 it will not invent any.'}, 'character': {'enum': ['straight', 'understated', 'hottake', 'dryexpert', 'punchy'], 'type': 'string', 'default': 'straight', 'description': 'Voice: straight (plain/direct, default), understated (say less), hottake (opinionated stance), dryexpert (terse expert), punchy (tweet-length).'}}, 'additionalProperties': False}
keyword_create
[DEPRECATED — renamed tag_rule_create. Will be removed after 2026-10-07.] Create TAGGING RULES (the dashboard's 'Tagging rules') — org-wide labels for posts your Watchers already ingest. This does NOT search Reddit: to add a Keyword Monitor entry that searches all of Reddit daily, use keyword_monitor_create instead. Each rule tags records across all your Watchers where the title or body mentions its term as a whole word — "f5bot" matches "f5bot." but not "f5bots". All languages are tagged by default; if the term is also an ordinary word in another language (the Swedish word "syften" means "purposes") and you only care about English posts, pass `languageMode: "non-other"` to skip records confidently detected as non-English. Pass one term as `keyword` or several at once as `keywords`. If you have no Watchers yet, create one first (with at least one subreddit) and then add rules. Changes take effect on the next scheduled processing cycle. Existing opportunity scores and matches are not retroactively updated. (requires a free Prowlo account — call it to get a signup link)
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'keyword': {'type': 'string', 'maxLength': 100, 'minLength': 2, 'description': 'A single term or phrase to tag (2-100 characters)'}, 'keywords': {'type': 'array', 'items': {'type': 'string', 'maxLength': 100, 'minLength': 2}, 'maxItems': 50, 'minItems': 1, 'description': 'Several terms to add in one call (2-100 characters each)'}, 'description': {'type': 'string', 'maxLength': 120, 'description': 'What this term refers to, e.g. "Syften is a Reddit monitoring SaaS, a competitor". Strongly recommended: matches are verified against this to weed out coincidental hits (the word "syften" also means "purposes" in Swedish). Applies to every term in this call, so pass terms with different meanings separately.'}, 'languageMode': {'enum': ['non-other', 'any'], 'type': 'string', 'description': 'Language policy, applied to every term in this call. "any" (default) tags matches in every language. "non-other" skips records confidently detected as non-English â\x80\x94 use it when the term is also a common word in another language; posts too short to detect a language are still tagged either way.'}}, 'additionalProperties': False}
keyword_delete
[DEPRECATED — renamed tag_rule_delete. Will be removed after 2026-10-07.] Remove a TAGGING RULE (dashboard: 'Tagging rules') and stop it from tagging posts — not a Keyword Monitor entry (those are Watchers; see watcher_delete). This action cannot be undone. Changes take effect on the next scheduled processing cycle. Existing opportunity scores and matches are not retroactively updated. (requires a free Prowlo account — call it to get a signup link)
Destructive Idempotent
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'The term to delete (the id returned by tag_rule_list)'}}, 'additionalProperties': False}
keyword_list
[DEPRECATED — renamed tag_rule_list. Will be removed after 2026-10-07.] List your org's TAGGING RULES (the dashboard's 'Tagging rules') — labels applied to posts your Watchers already ingest. NOT the dashboard's Keyword Monitor: for the keywords that search all of Reddit daily, use keyword_monitor_list. Each rule tags matching Dataset records whose title or body mentions its term as a whole word. Returns the term, active status, and match statistics. Changes take effect on the next scheduled processing cycle. Existing opportunity scores and matches are not retroactively updated. (requires a free Prowlo account — call it to get a signup link)
Read only Idempotent
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
keyword_monitor_create
Add a Keyword Monitor entry — searches all of Reddit daily for this query and ingests matches into your Dataset. This is the tool for "track keyword X on Reddit". Draws from your plan's keyword limit (see keyword_monitor_list). Creates a Watcher with platform "reddit_search" under the hood, so watcher_update/watcher_delete manage it afterwards. Not metered. (requires a free Prowlo account — call it to get a signup link)
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['query'], 'properties': {'tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Tags applied to every record this entry ingests (shown as chips in the dashboard)'}, 'query': {'type': 'string', 'maxLength': 100, 'minLength': 2, 'description': 'The search query to monitor across all of Reddit (2-100 characters), e.g. a brand or competitor name'}, 'description': {'type': 'string', 'maxLength': 120, 'description': 'What this query refers to, e.g. "Syften is a Reddit monitoring SaaS, a competitor". Strongly recommended: mention verification reads it to weed out coincidental matches.'}}, 'additionalProperties': False}
keyword_monitor_list
List your Keyword Monitor entries (the dashboard's "Keywords" page): each searches all of Reddit once a day for its query and ingests matches into your Dataset. Returns your keyword quota (used/max; max -1 = unlimited). Add via keyword_monitor_create; pause via watcher_update; delete via watcher_delete (ids are Watcher ids). NOT the tagging rules — see tag_rule_list. Not a live Reddit call — free, rate-limited only. (requires a free Prowlo account — call it to get a signup link)
Read only Idempotent
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
keyword_update
[DEPRECATED — renamed tag_rule_update. Will be removed after 2026-10-07.] Update a TAGGING RULE (dashboard: 'Tagging rules') — not a Keyword Monitor entry (those are Watchers; see watcher_update). Rename its term (pass `keyword`), set what it refers to (pass `description`), and/or pause/resume it (pass `active`). Renaming keeps already-tagged records on the old tag; new matches use the new term. Changes take effect on the next scheduled processing cycle. Existing opportunity scores and matches are not retroactively updated. (requires a free Prowlo account — call it to get a signup link)
Idempotent
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'The current term to update (the id returned by tag_rule_list)'}, 'active': {'type': 'boolean', 'description': 'Whether the rule should be active (true) or paused (false)'}, 'keyword': {'type': 'string', 'maxLength': 100, 'minLength': 2, 'description': 'New term to rename this rule to (2-100 characters)'}, 'description': {'type': 'string', 'maxLength': 120, 'description': 'What this term refers to, used to verify that matches are genuinely about it. Pass an empty string to clear it.'}}, 'additionalProperties': False}
list_records
List records in your Dataset (Prowlo’s indexed posts from crawled sources). NOT a live Reddit call — free, rate-limited only. Filter by view (all/matched), subreddits, platforms, tags, keyword, `any` (brand-variant OR-group), include/exclude, intent, score/comments, date range, watcherId. Paginated via cursor. Note: tags / watcherId are record-level, so passing either uses the "matched" view automatically. Records whose keyword match was AI-judged coincidental are hidden by default (pass includeSuppressed:true to see them; each record carries a `verification` field). A filtered page can hold fewer than `limit` items — page until nextCursor is null. Long record bodies are trimmed to keep the page scannable — use get_record for a record’s full body. (requires a free Prowlo account — call it to get a signup link)
Read only Idempotent
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'to': {'type': 'string', 'description': 'ISO date upper bound (created on platform)'}, 'any': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Match if title/body contains ANY of these terms (brand monitoring â\x86\x92 your brand + variants)'}, 'from': {'type': 'string', 'description': 'ISO date lower bound (created on platform)'}, 'tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Restrict to records carrying any of these rule tags'}, 'view': {'enum': ['all', 'matched'], 'type': 'string', 'default': 'all', 'description': '"matched" = only records that matched a Watcher rule'}, 'limit': {'type': 'integer', 'default': 25, 'maximum': 40, 'minimum': 1, 'description': 'Max records to return, 1-40 (default 25); page with cursor for more'}, 'cursor': {'type': 'string', 'description': 'Pagination cursor from a previous response'}, 'intent': {'type': 'array', 'items': {'enum': ['BUYING', 'SELLING', 'DISCUSSING'], 'type': 'string'}, 'description': '(COMING SOON â\x80\x94 not yet available) Filter by author intent: BUYING, SELLING, or DISCUSSING. Posts are not intent-classified yet, so this filter currently returns no matches.'}, 'exclude': {'type': 'array', 'items': {'type': 'string'}, 'description': 'None of these may appear in title/body'}, 'include': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Stricter: EVERY term must appear in title/body'}, 'keyword': {'type': 'string', 'description': 'Single free-text term in title/body'}, 'minScore': {'type': 'integer', 'description': 'Minimum post score (platform upvotes/points)'}, 'platforms': {'type': 'array', 'items': {'type': 'string'}, 'description': 'e.g. ["reddit","hackernews"]'}, 'watcherId': {'type': 'string', 'description': 'Restrict to records from one of your Watchers (by id)'}, 'subreddits': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Restrict to these subreddits/channels (no r/ prefix)'}, 'minComments': {'type': 'integer', 'description': 'Minimum number of comments'}, 'includeSuppressed': {'type': 'boolean', 'default': False, 'description': 'Include records whose keyword match was judged "coincidental" by AI mention verification (the term appeared but the post is not about it). Default false â\x80\x94 such records are hidden. Every returned record carries a `verification` field (confirmed | coincidental | pending | clear) either way.'}}, 'additionalProperties': False}
list_watchers
List the Watchers configured for your organization (the same ones the dashboard manages). Each Watcher shows its sources (platform + channel), paused state, tags (including ones set in the dashboard), record counts, and how many records arrived today. Watchers with platform "reddit_search" are the dashboard's Keyword Monitor entries — for those, the subreddit field holds the search query, not a subreddit. NOT a live Reddit call — free, rate-limited only. (requires a free Prowlo account — call it to get a signup link)
Read only Idempotent
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
research_get
Read the latest Community research report for a product (or a specific runId), or its progress while running. `section` = summary (default: brief, highlights, tiers, evidence counts, other runs) | communities (paginated by `tier`) | content | competitors | voice | plan (threads carry live score/comments/removed state when available) | markdown. Read this BEFORE recommending subreddits or drafting posts/comments for the user. (requires a free Prowlo account — call it to get a signup link)
Read only Idempotent
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'tier': {'type': 'integer', 'default': 1, 'maximum': 3, 'minimum': 0, 'description': '(section="communities" only) which tier to return: 1 (best fit, default), 2, 3, or 0 = considered but not recommended'}, 'limit': {'type': 'integer', 'default': 3, 'maximum': 10, 'minimum': 1, 'description': '(section="communities" only) communities per page, 1-10 (default 3 â\x80\x94 each carries its full verified analysis)'}, 'runId': {'type': 'string', 'description': 'A specific run; omit for the latest run of the product'}, 'offset': {'type': 'integer', 'default': 0, 'minimum': 0, 'description': '(section="communities" only) page offset within the tier'}, 'section': {'enum': ['summary', 'communities', 'content', 'competitors', 'voice', 'plan', 'markdown'], 'type': 'string', 'default': 'summary'}, 'productId': {'type': 'string', 'description': "(when runId is omitted) which product's latest run; defaults to the primary product"}}, 'additionalProperties': False}
search_dataset
Semantic or keyword search across your Dataset (vector + full-text over your indexed corpus). NOT a live Reddit call — free, rate-limited only. Supports the full record filter: subreddits, platforms, `any` (brand-variant OR-group), include/exclude, intent, score/comments, date range, tags, watcherId. Records whose keyword match was AI-judged coincidental are hidden by default (pass includeSuppressed:true to see them; each record carries a `verification` field). Long record bodies are trimmed to keep results scannable — use get_record for a match’s full body. (requires a free Prowlo account — call it to get a signup link)
Read only Idempotent
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['query'], 'properties': {'to': {'type': 'string', 'description': 'ISO date upper bound (created on platform)'}, 'any': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Match if title/body contains ANY of these terms (brand monitoring â\x86\x92 your brand + variants)'}, 'from': {'type': 'string', 'description': 'ISO date lower bound (created on platform)'}, 'mode': {'enum': ['semantic', 'keyword'], 'type': 'string', 'default': 'semantic', 'description': 'Search mode: "semantic" (vector) or "keyword" (full-text) (default semantic)'}, 'tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Restrict to records carrying any of these rule tags'}, 'tier': {'enum': ['quick', 'deep'], 'type': 'string', 'description': 'Semantic only: "deep" reranks (slower, sharper)'}, 'limit': {'type': 'integer', 'default': 25, 'maximum': 40, 'minimum': 1, 'description': 'Max results to return, 1-40 (default 25); page with cursor for more'}, 'query': {'type': 'string', 'minLength': 1, 'description': 'The search query'}, 'cursor': {'type': 'string', 'description': 'Pagination cursor from a previous response'}, 'intent': {'type': 'array', 'items': {'enum': ['BUYING', 'SELLING', 'DISCUSSING'], 'type': 'string'}, 'description': '(COMING SOON â\x80\x94 not yet available) Filter by author intent: BUYING, SELLING, or DISCUSSING. Posts are not intent-classified yet, so this filter currently returns no matches.'}, 'exclude': {'type': 'array', 'items': {'type': 'string'}, 'description': 'None of these may appear in title/body'}, 'include': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Stricter: EVERY term must appear in title/body'}, 'minScore': {'type': 'integer', 'description': 'Minimum post score (platform upvotes/points)'}, 'platforms': {'type': 'array', 'items': {'type': 'string'}, 'description': 'e.g. ["reddit","hackernews"]'}, 'watcherId': {'type': 'string', 'description': 'Restrict to records from one of your Watchers (by id)'}, 'subreddits': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Restrict to these subreddits/channels (no r/ prefix)'}, 'minComments': {'type': 'integer', 'description': 'Minimum number of comments'}, 'includeSuppressed': {'type': 'boolean', 'default': False, 'description': 'Include records whose keyword match was judged "coincidental" by AI mention verification (the term appeared but the post is not about it). Default false â\x80\x94 such records are hidden. Every returned record carries a `verification` field (confirmed | coincidental | pending | clear) either way.'}}, 'additionalProperties': False}
social_find_channels
Discover or inspect channels (Reddit subreddits) LIVE. Pass `query` to search, or an exact `channel` for its metadata (+ rules via include:["rules"]). Reddit only — hackernews has no channels. 1 credit · read-only. For cached stats, growth history, promo tolerance, and similar-community lists on the ~1,200 subs Prowlo already tracks, use catalog_search_subreddits / catalog_get_subreddit instead — free, no credit; this tool is for live metadata/rules or subreddits outside that catalog. For an evidence-backed, ranked report with rules and an engagement plan, use research_run / research_get. (requires a free Prowlo account — call it to get a signup link)
Read only
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['platform'], 'properties': {'query': {'type': 'string', 'description': 'Search subreddits by name/topic'}, 'channel': {'type': 'string', 'description': 'Exact subreddit name for metadata'}, 'include': {'type': 'array', 'items': {'enum': ['rules'], 'type': 'string'}, 'description': '(reddit, channel mode) extras: "rules"'}, 'platform': {'enum': ['reddit', 'hackernews'], 'type': 'string', 'description': 'Which source to read live: "reddit" or "hackernews".'}}, 'additionalProperties': False}
social_get_post
Fetch one post/story with its comment thread. id: reddit permalink URL / t3_xxx / bare id; hackernews numeric item id. includeComments (default true), commentLimit≤20. 1 credit · read-only. Reddit comments via RSS are flat/unscored. (requires a free Prowlo account — call it to get a signup link)
Read only
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['platform', 'id'], 'properties': {'id': {'type': 'string', 'minLength': 1, 'description': 'reddit: permalink URL, t3_xxx, or bare id. hackernews: numeric item id.'}, 'platform': {'enum': ['reddit', 'hackernews'], 'type': 'string', 'description': 'Which source to read live: "reddit" or "hackernews".'}, 'commentLimit': {'type': 'integer', 'default': 20, 'maximum': 20, 'minimum': 0}, 'includeComments': {'type': 'boolean', 'default': True}}, 'additionalProperties': False}
social_get_user
Fetch a user profile. reddit: account age, karma, verified-email. hackernews: karma, about, created, submission count. 1 credit · read-only. (requires a free Prowlo account — call it to get a signup link)
Read only
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['platform', 'username'], 'properties': {'platform': {'enum': ['reddit', 'hackernews'], 'type': 'string', 'description': 'Which source to read live: "reddit" or "hackernews".'}, 'username': {'type': 'string', 'minLength': 1, 'description': 'Username, no u/ prefix'}}, 'additionalProperties': False}
social_get_user_activity
Fetch a user's recent submissions or comments. kind=submissions|comments (default submissions). reddit via RSS (newest-first, ~20). 1 credit · read-only. (requires a free Prowlo account — call it to get a signup link)
Read only
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['platform', 'username'], 'properties': {'kind': {'enum': ['submissions', 'comments'], 'type': 'string', 'default': 'submissions'}, 'limit': {'type': 'integer', 'default': 20, 'maximum': 20, 'minimum': 1}, 'platform': {'enum': ['reddit', 'hackernews'], 'type': 'string', 'description': 'Which source to read live: "reddit" or "hackernews".'}, 'username': {'type': 'string', 'minLength': 1, 'description': 'Username, no u/ prefix'}}, 'additionalProperties': False}
social_list_posts
List posts/stories. platform="reddit": REQUIRES channel (subreddit); sort? hot|new|top|rising|controversial; time? for top/controversial; limit≤20. platform="hackernews": sort carries the ranking top|new|best|ask|show|job (default top); channel ignored; limit≤30. 1 credit · read-only. (requires a free Prowlo account — call it to get a signup link)
Read only
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['platform'], 'properties': {'sort': {'type': 'string', 'description': 'reddit: hot|new|top|rising|controversial; hackernews: top|new|best|ask|show|job'}, 'time': {'type': 'string', 'description': '(reddit) for top/controversial'}, 'limit': {'type': 'integer', 'default': 20, 'maximum': 30, 'minimum': 1, 'description': 'Max items (default 20)'}, 'channel': {'type': 'string', 'description': '(reddit, required) subreddit without r/. Ignored for hackernews.'}, 'platform': {'enum': ['reddit', 'hackernews'], 'type': 'string', 'description': 'Which source to read live: "reddit" or "hackernews".'}}, 'additionalProperties': False}
social_search
Live full-text search of a source. platform="reddit": params query, subreddit? (restrict), sort? (relevance/hot/new/top/comments), time?, limit≤20. platform="hackernews": params query, sort? (relevance/new), tags? (story/ask_hn/show_hn), minPoints?, author?, since? (unix), limit≤20. 1 credit · read-only. Reddit results come via RSS (score/comments may be 0). Long bodies are truncated; fetch a single post for the full text. (requires a free Prowlo account — call it to get a signup link)
Read only
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['platform', 'query'], 'properties': {'sort': {'type': 'string', 'description': 'reddit: relevance|hot|new|top|comments; hackernews: relevance|new'}, 'tags': {'type': 'string', 'description': '(hackernews) story|ask_hn|show_hn'}, 'time': {'type': 'string', 'description': '(reddit) hour|day|week|month|year|all'}, 'limit': {'type': 'integer', 'default': 20, 'maximum': 20, 'minimum': 1, 'description': 'Max results, 1-20 (default 20)'}, 'query': {'type': 'string', 'minLength': 1, 'description': 'Search query'}, 'since': {'type': 'integer', 'description': '(hackernews) only items after this unix ts'}, 'author': {'type': 'string', 'description': '(hackernews) author username'}, 'platform': {'enum': ['reddit', 'hackernews'], 'type': 'string', 'description': 'Which source to read live: "reddit" or "hackernews".'}, 'minPoints': {'type': 'integer', 'minimum': 0, 'description': '(hackernews) minimum points'}, 'subreddit': {'type': 'string', 'description': '(reddit) restrict to this subreddit'}}, 'additionalProperties': False}
tag_record
Add tags to ONE record in your Dataset — the same hand-applied tag the dashboard's "+ Tag" action writes. This tags only the record you name; it does NOT create a rule and has no effect on future posts — for "tag everything matching a term", use tag_rule_create instead. `id` is the record id returned by list_records / search_dataset / get_record (a source-item id), not a tagging-rule id. Manual tags are stored separately from crawl-applied tags, so a re-crawl never overwrites them, and they come back in the `tags` field of every read tool and are filterable via the `tags` filter. A manual tag is never AI mention-verified and never fires an Alert — it is your assertion about the post, not a match Prowlo found. Terms are trimmed and lowercased. (requires a free Prowlo account — call it to get a signup link)
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id', 'tags'], 'properties': {'id': {'type': 'string', 'minLength': 1, 'description': 'The record id (from list_records / search_dataset / get_record)'}, 'tags': {'type': 'array', 'items': {'type': 'string', 'maxLength': 100, 'minLength': 1}, 'maxItems': 10, 'minItems': 1, 'description': 'Tags to add, 1-10. Tags already on the record are kept.'}}, 'additionalProperties': False}
tag_rule_create
Create TAGGING RULES (the dashboard's 'Tagging rules') — org-wide labels for posts your Watchers already ingest. This does NOT search Reddit: to add a Keyword Monitor entry that searches all of Reddit daily, use keyword_monitor_create instead. Each rule tags records across all your Watchers where the title or body mentions its term as a whole word — "f5bot" matches "f5bot." but not "f5bots". All languages are tagged by default; if the term is also an ordinary word in another language (the Swedish word "syften" means "purposes") and you only care about English posts, pass `languageMode: "non-other"` to skip records confidently detected as non-English. Pass one term as `keyword` or several at once as `keywords`. If you have no Watchers yet, create one first (with at least one subreddit) and then add rules. Changes take effect on the next scheduled processing cycle. Existing opportunity scores and matches are not retroactively updated. (requires a free Prowlo account — call it to get a signup link)
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'keyword': {'type': 'string', 'maxLength': 100, 'minLength': 2, 'description': 'A single term or phrase to tag (2-100 characters)'}, 'keywords': {'type': 'array', 'items': {'type': 'string', 'maxLength': 100, 'minLength': 2}, 'maxItems': 50, 'minItems': 1, 'description': 'Several terms to add in one call (2-100 characters each)'}, 'description': {'type': 'string', 'maxLength': 120, 'description': 'What this term refers to, e.g. "Syften is a Reddit monitoring SaaS, a competitor". Strongly recommended: matches are verified against this to weed out coincidental hits (the word "syften" also means "purposes" in Swedish). Applies to every term in this call, so pass terms with different meanings separately.'}, 'languageMode': {'enum': ['non-other', 'any'], 'type': 'string', 'description': 'Language policy, applied to every term in this call. "any" (default) tags matches in every language. "non-other" skips records confidently detected as non-English â\x80\x94 use it when the term is also a common word in another language; posts too short to detect a language are still tagged either way.'}}, 'additionalProperties': False}
tag_rule_delete
Remove a TAGGING RULE (dashboard: 'Tagging rules') and stop it from tagging posts — not a Keyword Monitor entry (those are Watchers; see watcher_delete). This action cannot be undone. Changes take effect on the next scheduled processing cycle. Existing opportunity scores and matches are not retroactively updated. (requires a free Prowlo account — call it to get a signup link)
Destructive Idempotent
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'The term to delete (the id returned by tag_rule_list)'}}, 'additionalProperties': False}
tag_rule_list
List your org's TAGGING RULES (the dashboard's 'Tagging rules') — labels applied to posts your Watchers already ingest. NOT the dashboard's Keyword Monitor: for the keywords that search all of Reddit daily, use keyword_monitor_list. Each rule tags matching Dataset records whose title or body mentions its term as a whole word. Returns the term, active status, and match statistics. Changes take effect on the next scheduled processing cycle. Existing opportunity scores and matches are not retroactively updated. (requires a free Prowlo account — call it to get a signup link)
Read only Idempotent
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
tag_rule_update
Update a TAGGING RULE (dashboard: 'Tagging rules') — not a Keyword Monitor entry (those are Watchers; see watcher_update). Rename its term (pass `keyword`), set what it refers to (pass `description`), and/or pause/resume it (pass `active`). Renaming keeps already-tagged records on the old tag; new matches use the new term. Changes take effect on the next scheduled processing cycle. Existing opportunity scores and matches are not retroactively updated. (requires a free Prowlo account — call it to get a signup link)
Idempotent
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'The current term to update (the id returned by tag_rule_list)'}, 'active': {'type': 'boolean', 'description': 'Whether the rule should be active (true) or paused (false)'}, 'keyword': {'type': 'string', 'maxLength': 100, 'minLength': 2, 'description': 'New term to rename this rule to (2-100 characters)'}, 'description': {'type': 'string', 'maxLength': 120, 'description': 'What this term refers to, used to verify that matches are genuinely about it. Pass an empty string to clear it.'}}, 'additionalProperties': False}
trend_create
Create a Trend: a saved match query bucketed over time. `interval` is "hour" or "day"; `window` is how far back to compute (e.g. "30d"). Points recompute periodically. Not metered. (requires a free Prowlo account — call it to get a signup link)
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['name', 'query'], 'properties': {'name': {'type': 'string', 'minLength': 1, 'description': 'Human-readable trend name'}, 'query': {'type': 'object', 'properties': {'to': {'type': 'string', 'description': 'ISO date upper bound (created on platform)'}, 'any': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Match if title/body contains ANY of these terms (brand monitoring â\x86\x92 your brand + variants)'}, 'from': {'type': 'string', 'description': 'ISO date lower bound (created on platform)'}, 'tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Restrict to records carrying any of these rule tags'}, 'intent': {'type': 'array', 'items': {'enum': ['BUYING', 'SELLING', 'DISCUSSING'], 'type': 'string'}, 'description': '(COMING SOON â\x80\x94 not yet available) Filter by author intent: BUYING, SELLING, or DISCUSSING. Posts are not intent-classified yet, so this filter currently returns no matches.'}, 'exclude': {'type': 'array', 'items': {'type': 'string'}, 'description': 'None of these may appear in title/body'}, 'include': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Stricter: EVERY term must appear in title/body'}, 'keyword': {'type': 'string', 'description': 'Single free-text term in title/body'}, 'minScore': {'type': 'integer', 'description': 'Minimum post score (platform upvotes/points)'}, 'platforms': {'type': 'array', 'items': {'type': 'string'}, 'description': 'e.g. ["reddit","hackernews"]'}, 'watcherId': {'type': 'string', 'description': 'Restrict to records from one of your Watchers (by id)'}, 'subreddits': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Restrict to these subreddits/channels (no r/ prefix)'}, 'minComments': {'type': 'integer', 'description': 'Minimum number of comments'}}, 'description': 'Record match filter (same shape as search_dataset / list_records filters)', 'additionalProperties': False}, 'window': {'type': 'string', 'default': '30d', 'description': 'Look-back window, e.g. "7d", "30d", "90d"'}, 'interval': {'enum': ['hour', 'day'], 'type': 'string', 'default': 'day', 'description': 'Time bucket size: "hour" or "day" (default day)'}}, 'additionalProperties': False}
trend_delete
Delete a Trend by id. Not metered. (requires a free Prowlo account — call it to get a signup link)
Destructive Idempotent
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'minLength': 1, 'description': 'Trend id to delete (from trend_list)'}}, 'additionalProperties': False}
trend_get
Get one Trend with its computed time-series points (count + per-intent breakdown per interval bucket). Points are sparse: interval buckets with zero matches are omitted, not stored as 0 — treat missing buckets as zero when charting. Not metered. (requires a free Prowlo account — call it to get a signup link)
Read only Idempotent
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'minLength': 1, 'description': 'Trend id to fetch (from trend_list)'}}, 'additionalProperties': False}
trend_list
List your organization’s Trends (saved queries that produce a time-series, e.g. brand-mention counts over time). Includes computed point counts. Points are sparse: only interval buckets with at least one matching record are stored, so pointCount can be far below window÷interval — a 30d daily trend with matches on one day has pointCount 1. Not metered. (requires a free Prowlo account — call it to get a signup link)
Read only Idempotent
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
trend_update
Update a Trend (name, query, interval, or window). Only provided fields change. Not metered. (requires a free Prowlo account — call it to get a signup link)
Idempotent
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'minLength': 1, 'description': 'Trend id to update (from trend_list)'}, 'name': {'type': 'string', 'minLength': 1, 'description': 'New trend name (rename)'}, 'query': {'type': 'object', 'properties': {'to': {'type': 'string', 'description': 'ISO date upper bound (created on platform)'}, 'any': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Match if title/body contains ANY of these terms (brand monitoring â\x86\x92 your brand + variants)'}, 'from': {'type': 'string', 'description': 'ISO date lower bound (created on platform)'}, 'tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Restrict to records carrying any of these rule tags'}, 'intent': {'type': 'array', 'items': {'enum': ['BUYING', 'SELLING', 'DISCUSSING'], 'type': 'string'}, 'description': '(COMING SOON â\x80\x94 not yet available) Filter by author intent: BUYING, SELLING, or DISCUSSING. Posts are not intent-classified yet, so this filter currently returns no matches.'}, 'exclude': {'type': 'array', 'items': {'type': 'string'}, 'description': 'None of these may appear in title/body'}, 'include': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Stricter: EVERY term must appear in title/body'}, 'keyword': {'type': 'string', 'description': 'Single free-text term in title/body'}, 'minScore': {'type': 'integer', 'description': 'Minimum post score (platform upvotes/points)'}, 'platforms': {'type': 'array', 'items': {'type': 'string'}, 'description': 'e.g. ["reddit","hackernews"]'}, 'watcherId': {'type': 'string', 'description': 'Restrict to records from one of your Watchers (by id)'}, 'subreddits': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Restrict to these subreddits/channels (no r/ prefix)'}, 'minComments': {'type': 'integer', 'description': 'Minimum number of comments'}}, 'description': 'Record match filter (same shape as search_dataset / list_records filters)', 'additionalProperties': False}, 'window': {'type': 'string', 'description': 'Look-back window, e.g. "7d", "30d", "90d"'}, 'interval': {'enum': ['hour', 'day'], 'type': 'string', 'description': 'Time bucket size: "hour" or "day"'}}, 'additionalProperties': False}
update_product_profile
Update your organization's product profile — the context get_product_profile returns and Prowlo's research and reply features build on. Partial patch: only the fields you pass change; arrays replace the stored list; nullable string fields accept null to clear. Owner/admin API keys only. Saving recomputes the product embedding. Not metered. (requires a free Prowlo account — call it to get a signup link)
Idempotent
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'toneCustom': {'anyOf': [{'type': 'string', 'maxLength': 1000}, {'type': 'null'}], 'description': 'Pro-only. Custom tone guidance for replies (max 1000).'}, 'competitors': {'type': 'array', 'items': {'type': 'object', 'required': ['name'], 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'name': {'type': 'string', 'maxLength': 255, 'minLength': 1}, 'comparison': {'anyOf': [{'type': 'string', 'maxLength': 1000}, {'type': 'null'}]}, 'description': {'anyOf': [{'type': 'string', 'maxLength': 1000}, {'type': 'null'}]}}, 'additionalProperties': False}, 'maxItems': 10, 'description': 'REPLACES the competitor set when provided: entries with an id (from get_product_profile) are updated, entries without are created, and existing competitors missing from the list are DELETED. Omit to leave competitors unchanged.'}, 'productName': {'anyOf': [{'type': 'string', 'maxLength': 255}, {'type': 'null'}], 'description': 'Product name (max 255). Nullable string fields accept null to clear.'}, 'tonePresets': {'type': 'array', 'items': {'type': 'string', 'maxLength': 50}, 'maxItems': 10, 'description': 'Pro-only. Replaces the list when provided (max 10 Ã\x97 50 chars).'}, 'personalStory': {'anyOf': [{'type': 'string', 'maxLength': 3000}, {'type': 'null'}], 'description': 'Pro-only. Personal story behind the product, used to ground replies (max 3000).'}, 'problemsSolved': {'anyOf': [{'type': 'string', 'maxLength': 2000}, {'type': 'null'}], 'description': 'The problems the product solves (max 2000).'}, 'productWebsite': {'anyOf': [{'type': 'string', 'maxLength': 500}, {'type': 'null'}], 'description': 'Product website URL, starting with http:// or https:// (max 500).'}, 'targetAudience': {'anyOf': [{'type': 'string', 'maxLength': 1000}, {'type': 'null'}], 'description': 'Who the product is for (max 1000).'}, 'targetUseCases': {'anyOf': [{'type': 'string', 'maxLength': 2000}, {'type': 'null'}], 'description': 'The use cases the product targets (max 2000).'}, 'differentiators': {'anyOf': [{'type': 'string', 'maxLength': 1000}, {'type': 'null'}], 'description': 'What sets the product apart from alternatives (max 1000).'}, 'productOneLiner': {'anyOf': [{'type': 'string', 'maxLength': 300}, {'type': 'null'}], 'description': 'One-sentence pitch (max 300).'}, 'replyStyleRules': {'anyOf': [{'type': 'string', 'maxLength': 3000}, {'type': 'null'}], 'description': 'Pro-only. Style rules for drafting replies (max 3000).'}, 'confirmedKeywords': {'type': 'array', 'items': {'type': 'string', 'maxLength': 40, 'minLength': 1}, 'maxItems': 12, 'description': 'Replaces the confirmed discovery-keyword list (max 12 Ã\x97 40 chars) and stamps the confirmation time.'}, 'replyContentRules': {'anyOf': [{'type': 'string', 'maxLength': 3000}, {'type': 'null'}], 'description': 'Pro-only. Content rules for drafting replies (max 3000).'}, 'valuePropositions': {'type': 'array', 'items': {'type': 'string', 'maxLength': 500}, 'maxItems': 10, 'description': 'Replaces the full list when provided (max 10 Ã\x97 500 chars). Omit to leave unchanged.'}, 'productDescription': {'anyOf': [{'type': 'string', 'maxLength': 2000}, {'type': 'null'}], 'description': 'What the product does (max 2000).'}}, 'additionalProperties': False}
watcher_add_source
Deprecated: a Watcher watches exactly one community/query. Use watcher_create to watch another community (one Watcher is created per source). Not metered. (requires a free Prowlo account — call it to get a signup link)
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['watcherId'], 'properties': {'channel': {'type': 'string', 'minLength': 1, 'description': 'The source channel: subreddit name (no r/), HN query, etc.'}, 'platform': {'type': 'string', 'description': 'Defaults to "reddit". One of the supported platforms.'}, 'subreddit': {'type': 'string', 'minLength': 1, 'description': 'Alias of `channel` (historical name).'}, 'watcherId': {'type': 'string', 'minLength': 1, 'description': 'Watcher id (from list_watchers)'}}, 'additionalProperties': False}
watcher_create
Create Watchers — including KEYWORD MONITOR entries (the dashboard's "Keywords" page): pass platform "reddit_search" with the search query as `channel`; each searches all of Reddit daily and draws from its own per-plan keyword limit (keyword_monitor_create is the one-query shortcut). Community watchers (a subreddit or HN feed) are the default platform. A Watcher watches exactly ONE community/query, so each `sources` entry creates its own Watcher (its name is derived from the source, e.g. "r/saas"). Subject to your plan's Watcher limits. Not metered. (requires a free Prowlo account — call it to get a signup link)
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['sources'], 'properties': {'tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Tags applied to every record each created Watcher ingests (shown as chips in the dashboard). Applied to all Watchers created by this call.'}, 'sources': {'type': 'array', 'items': {'type': 'object', 'properties': {'channel': {'type': 'string', 'minLength': 1, 'description': 'The source channel: subreddit name (no r/), HN query, reddit_search query, etc.'}, 'platform': {'type': 'string', 'description': 'Defaults to "reddit". One of the supported platforms.'}, 'subreddit': {'type': 'string', 'minLength': 1, 'description': 'Alias of `channel` (historical name â\x80\x94 non-Reddit platforms pass their query here too). Provide one of the two.'}}, 'additionalProperties': False}, 'minItems': 1, 'description': 'One Watcher is created per entry. Each entry needs `channel` (or its alias `subreddit`).'}}, 'additionalProperties': False}
watcher_delete
Delete a Watcher by id (also removes its source and records). Not metered. (requires a free Prowlo account — call it to get a signup link)
Destructive Idempotent
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'minLength': 1, 'description': 'Watcher id to delete (from list_watchers)'}}, 'additionalProperties': False}
watcher_remove_source
Remove a source from a Watcher by source id. (A source-less Watcher ingests nothing — usually you want watcher_delete.) Not metered. (requires a free Prowlo account — call it to get a signup link)
Destructive Idempotent
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['watcherId', 'sourceId'], 'properties': {'sourceId': {'type': 'string', 'minLength': 1, 'description': 'Source id to remove (from the Watcherâ\x80\x99s sources list)'}, 'watcherId': {'type': 'string', 'minLength': 1, 'description': 'Watcher id the source belongs to (from list_watchers)'}}, 'additionalProperties': False}
watcher_update
Pause/resume a Watcher and/or replace its tags. (Names are derived from the source and cannot be changed.) `tags` replaces the Watcher's plain tags — tags added by conditional tagging rules in the dashboard are unaffected. Not metered. (requires a free Prowlo account — call it to get a signup link)
Idempotent
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'minLength': 1, 'description': 'Watcher id to update (from list_watchers)'}, 'tags': {'type': 'array', 'items': {'type': 'string'}, 'description': "Replace this Watcher's tags (shown as chips in the dashboard). Pass [] to clear them."}, 'paused': {'type': 'boolean', 'description': 'Pause (true) or resume (false) this Watcher'}}, 'additionalProperties': False}
History

Recent tool changes

Added
humanize_comment
Sept. 17, 2026, 12:37 p.m.
Added
research_get
Sept. 17, 2026, 12:37 p.m.
Added
keyword_monitor_create
Sept. 17, 2026, 12:37 p.m.
Added
keyword_monitor_list
Sept. 17, 2026, 12:37 p.m.
Added
watcher_remove_source
Sept. 17, 2026, 12:37 p.m.
Added
watcher_add_source
Sept. 17, 2026, 12:37 p.m.
Added
watcher_delete
Sept. 17, 2026, 12:37 p.m.
Added
watcher_update
Sept. 17, 2026, 12:37 p.m.
Added
watcher_create
Sept. 17, 2026, 12:37 p.m.
Added
get_account
Sept. 17, 2026, 12:37 p.m.
Added
get_usage
Sept. 17, 2026, 12:37 p.m.
Added
trend_delete
Sept. 17, 2026, 12:37 p.m.
Added
trend_update
Sept. 17, 2026, 12:37 p.m.
Added
trend_create
Sept. 17, 2026, 12:37 p.m.
Added
trend_get
Sept. 17, 2026, 12:37 p.m.
Added
trend_list
Sept. 17, 2026, 12:37 p.m.
Added
alert_get_deliveries
Sept. 17, 2026, 12:37 p.m.
Added
alert_delete
Sept. 17, 2026, 12:37 p.m.
Added
alert_update
Sept. 17, 2026, 12:37 p.m.
Added
alert_create
Sept. 17, 2026, 12:37 p.m.
Added
alert_list
Sept. 17, 2026, 12:37 p.m.
Added
catalog_top_subreddits
Sept. 17, 2026, 12:37 p.m.
Added
catalog_get_subreddit
Sept. 17, 2026, 12:37 p.m.
Added
catalog_search_subreddits
Sept. 17, 2026, 12:37 p.m.
Added
get_alerts
Sept. 17, 2026, 12:37 p.m.
Added
get_operational_alerts
Sept. 17, 2026, 12:37 p.m.
Added
get_crawl_activity
Sept. 17, 2026, 12:37 p.m.
Added
list_watchers
Sept. 17, 2026, 12:37 p.m.
Added
get_dataset_summary
Sept. 17, 2026, 12:37 p.m.
Added
get_record
Sept. 17, 2026, 12:37 p.m.
Discover

Similar MCP servers

Influship

io.github.Influship/influship-mcp

Discovers, profiles, compares, and evaluates social-media creators, and retrieves their posts, engagement data, captions, and vid…

tiktok

com.scraptik/tiktok

Provides TikTok creator, video, hashtag, sound, comment, audience, analytics, search, and watermark-free download data.

MentionForge

io.github.EnkiduHub/MentionForge

Performs cited social listening for brands, products, and competitors, including mention research, sentiment and risk analysis, s…

mentiondrop

com.mentiondrop/mentiondrop

Monitors brand, competitor, and industry mentions from Reddit, Google News, and search, then provides sentiment and relevance ana…

Creator SKILL — Influencer Discovery

ai.deinai/creator-skill

Finds and analyzes influencers across TikTok, Instagram, and YouTube.

KOLens

ai.kolens/kolens-mcp

Searches TikTok KOLs, retrieves profiles, manages lists, and provides alerts for influencer intelligence.

Creator SKILL v2 — Influencer Discovery

ai.deinai/creator-skill-v2

Provides influencer discovery across TikTok, Instagram, and YouTube.

Social Fetch

io.github.social-freak-ltd/socialfetch

Retrieves public content and metadata from social networks, music services, Facebook Marketplace, events, profiles, posts, commen…