Skip to Content

MCP tools reference: all tools and parameters

All 46 SnitchFeed MCP tools for mentions, listeners, search, feeds, webhooks, analytics and workspace, with key parameters, credit costs and when to use each.

Last updated

The MCP server exposes 51 tools, grouped below by area: mentions, listeners, search, feeds, webhooks, analytics and workspace. Every tool name starts with snitchfeed_. All tools act on the workspace you authorized and respect your plan limits.

If terms like listener, query, Fit Score or intent tags are new to you, read MCP concepts first.

Mentions

List mentions

snitchfeed_list_mentions

Fetches unarchived mentions from your workspace with filtering. Returns up to 50 mentions per page; total is only filled in on page 0. Each mention includes a snitchfeed_url that opens it in the app.

ParameterDescription
pagePage number, starting at 0
ordernewest (by publish date, the default) or fit_score_desc (highest Fit Score first)
platformsOnly these platforms
sentimentpositive, negative or neutral
fit_scoreFit Score buckets: high, medium, low
include_listener_ids, exclude_listener_idsScope to or exclude listeners
include_intents, exclude_intentsIntent tag slugs
date_from, date_toISO 8601 dates, on the publish date
languagesISO 639-1 codes, for example ["en", "es"]
include_subreddits, exclude_subredditsReddit only
include_keywords, exclude_keywordsMatched keywords
seentrue for seen only, false for unseen only
collectionsOnly mentions saved to these collection IDs. No tool lists collections, so give the client the IDs

Use when: You want to read, summarize or triage recent mentions. Pair it with snitchfeed_list_listeners to scope to one topic.

Listeners

List listeners

snitchfeed_list_listeners

Returns all active and paused listeners in your workspace, with each listener's ID, name, status, intent signal, platform configuration and tracked profiles.

Use when: You need listener IDs for other tools, or want to review what your workspace monitors.

List queries

snitchfeed_list_queries

Lists keyword queries across your listeners, optionally for one listener_id. Each query includes its text, the platforms it runs on and its platform-specific filters (subreddits, LinkedIn author filters, X minimum likes).

Use when: You want to audit or change specific keyword rules.

Create listener

snitchfeed_create_listener

Creates a listener with keyword queries, tracked LinkedIn or X profiles, or both. Provide at least one query (boolean syntax: AND, OR, NOT, parentheses) or at least one tracked_authors entry, resolved first with Resolve tracked author profile. The intent signal (intent) is required, 200 to 500 characters. You can set scan intervals for LinkedIn, X and Hacker News (linkedin_interval, twitter_interval, hackernews_interval). A historical backfill is queued for keyword queries, and the response links to the new listener and its auto-created feed.

Use when: You want to start monitoring a new brand, competitor, topic or specific accounts.

Update listener

snitchfeed_update_listener

Updates a listener's name, intent signal, noisy signals, status (active or paused), color, scan intervals, subreddit and author lists, or tracked profiles. Changing the intent signal regenerates its signal priorities. Queries are not affected. Add profiles with tracked_authors (after resolving each URL) and remove them with remove_tracked_authors (by platform and profile URL, never by internal ID).

Use when: You want to rename a listener, sharpen what counts as relevant, pause monitoring, change how often it scans, or change which accounts it follows.

Resolve tracked author profile

snitchfeed_resolve_tracked_author_profile

Resolves a LinkedIn or X profile URL to the account it points to (display name, platform, profile type and related fields). Confirm the account with the user, then pass the output unchanged into create or update listener as tracked_authors.

Use when: The user wants a listener to follow a specific person or company page. See Tracked profile and the product guide Track LinkedIn and X profiles.

Create listener query

snitchfeed_create_listener_query

Adds a keyword query to an existing listener and queues a historical backfill for it.

Use when: You want an existing listener to watch more keywords without creating a new listener.

Update listener query

snitchfeed_update_listener_query

Updates a query's text, platforms or filters. If the text changes, existing mentions that no longer match may be archived and the new keywords are backfilled.

Use when: You want to refine a keyword rule, change its platforms or adjust LinkedIn or X filters.

Delete listener

snitchfeed_delete_listener

Permanently deletes a listener and all its queries. The client asks for explicit confirmation first. Mentions already collected are kept.

Use when: You want to stop monitoring a topic entirely. This cannot be undone.

Delete listener query

snitchfeed_delete_listener_query

Permanently removes one query from a listener. The client asks for explicit confirmation first. A listener must keep at least one query or tracked profile, so the last query can only be deleted when tracked profiles remain; otherwise delete the listener.

Use when: You want to narrow a listener by removing one keyword rule.

Get query grammar

snitchfeed_get_query_grammar

Returns the boolean query syntax reference: operators, term limits and platform-specific constraints.

Use when: You are writing a query and need to check syntax or limits before saving it.

Search LinkedIn industries

snitchfeed_search_linkedin_industries

Searches LinkedIn industry codes by name or category and returns each match's numeric ID, label and hierarchy path. Omit the search term to browse. Returns at most 25 results.

Use when: You want to scope a LinkedIn query to industries. Pass the returned id as linkedin_author_industry.

Test X query

snitchfeed_test_twitter_query

Validates an X keyword query and runs a live search to preview matching posts, with optional language and minimum-likes filters. The first 50 tests per platform each day are free for your organization, then each test search costs the normal search price (2 credits per X search).

Use when: Required before saving any query that runs on X. Review the samples and confirm relevance with the user first.

Test LinkedIn query

snitchfeed_test_linkedin_query

Validates a LinkedIn keyword query and runs a live search to preview matching posts, with optional job title, company, industry and post type filters. The first 50 tests per platform each day are free for your organization, then each test search costs the normal search price (4 credits per LinkedIn search). Comma-separated job titles run one search per title (max 3), each counting as one test, and once saved each title is billed at 4 credits on every scan.

Use when: Required before saving any query that runs on LinkedIn. Industry filtering is strongly recommended; look up IDs with snitchfeed_search_linkedin_industries.

Test Hacker News query

snitchfeed_test_hackernews_query

Validates a Hacker News keyword query and runs a live search (through Algolia's Hacker News index) to preview matching stories and comments. Supports boolean syntax plus Hacker News qualifiers (author: or by:, story:, points> and points<, comments> and comments<, exact phrases and -exclude). The first 50 tests per platform each day are free for your organization, then each test search costs the normal search price (2 credits per Hacker News search).

Use when: Required before saving any query that runs on Hacker News.

Test Reddit query

snitchfeed_test_reddit_query

Validates a Reddit keyword query and previews matching posts from the past week of Reddit, with the same matching logic as a saved Reddit listener (saved listeners scan posts only). Supports subreddit and username filters plus whole-word and case-sensitive matching. Each page returns every match on one page of Reddit results (up to 100 posts); with included subreddits it reads each subreddit's newest posts from the past week and matches them the way a saved listener does, merged newest first. has_more: true means there are more pages. The first 50 tests per platform each day are free for your organization, then each test search costs the normal search price (2 credits per Reddit search; each included subreddit counts as one search).

Use when: Required before saving any query that runs on Reddit. To see more, pass next_cursor as cursor, or use Search Reddit posts for a longer window.

Search tools return ad hoc results. Nothing is saved, and results have no snitchfeed_url.

Search X posts

snitchfeed_search_tweets

Live search of X for posts matching a keyword query, with optional language and minimum-likes filters. Costs 2 credits per call. Cursor pagination: cursor in, next_cursor and has_more out.

Use when: You want to see what is being said on X right now without creating a listener.

Search LinkedIn posts

snitchfeed_search_linkedin_posts

Live search of LinkedIn for posts matching a keyword query, with optional job title, company, industry and post type filters. Costs 4 credits per job-title search. Page pagination with page.

Use when: You want to explore a topic on LinkedIn without creating a listener.

Get LinkedIn profile posts

snitchfeed_get_linkedin_profile_posts

Fetches recent public posts from one LinkedIn person's profile (linkedin.com/in/...). Costs 10 credits per page. Pagination with page and pagination_token.

Use when: You want to see what a specific person has posted recently. For ongoing monitoring, add them as a tracked profile on a listener instead.

Get LinkedIn company posts

snitchfeed_get_linkedin_company_posts

Fetches recent public posts from one LinkedIn company page (linkedin.com/company/...). Costs 10 credits per page. Pagination with page and pagination_token.

Use when: You want to see what a company, such as a competitor or a target account, has posted recently. For posts by a person, use Get LinkedIn profile posts.

Get LinkedIn profile comments

snitchfeed_get_linkedin_profile_comments

Fetches recent public comments written by a LinkedIn person on other people's posts. Costs 10 credits per page. Pagination with page and pagination_token. Each result includes the parent post_url, and a comment_url when one is available.

Use when: You want to see what a person has been commenting on. To scrape the comments on one post, use Extract LinkedIn post comments.

Search Hacker News posts

snitchfeed_search_hn_posts

Live search of Hacker News stories and comments. Costs 2 credits per call. Same syntax and qualifiers as Test Hacker News query, plus an optional story or comment scope and page pagination.

Use when: You want to explore Hacker News discussion without creating a listener.

Search Reddit posts

snitchfeed_search_reddit_posts

Live search of Reddit posts, covering the past month by default. Pass the optional timeframe parameter (hour, day, week, month, year or all) to change the window. Each page returns every match on one page of Reddit results (up to 100 posts). With included subreddits, it reads each subreddit's newest posts in the window (up to 300 per subreddit), matches them the way a saved listener does and merges them newest first; each page returns the next 100 matches. Costs 2 credits per call, or 2 per included subreddit per call when subreddits are set, including later pages. Supports subreddit and username filters, whole-word and case-sensitive matching, and cursor pagination.

Use when: You want to explore Reddit posts on a topic without creating a listener.

Search Reddit comments

snitchfeed_search_reddit_comments

Reddit comment search is paused for now while comment tracking is unavailable; the tool returns a message saying so and charges nothing. When it is back it works like Search Reddit posts, for comments: live search, past month by default, optional timeframe, up to 100 comments per page, 2 credits per call.

Use when: You want to explore Reddit comments on a topic without creating a listener.

Extract LinkedIn post comments

snitchfeed_extract_linkedin_post_comments

Scrapes commenters from a public LinkedIn post into a CSV. Costs 1 credit per comment scraped, minimum 50 credits per run. Requires post_url and max_comments (100 to 1,000); the client should ask you for both. Returns download_url for the CSV and links.past_runs for the tool's Past runs tab in the app.

Use when: You want the commenters or comment text of one LinkedIn post.

Extract LinkedIn post reactions

snitchfeed_extract_linkedin_post_reactions

Scrapes people who reacted to a public LinkedIn post into a CSV. Costs 1 credit per reaction scraped, minimum 50 credits per run. Requires post_url and max_reactions (100 to 1,000). Returns download_url and links.past_runs.

Use when: You want the people who reacted to one LinkedIn post and their reaction types.

List LinkedIn comments scrapes

snitchfeed_list_linkedin_comments_scrapes

Lists past comment scrape runs, newest first, each with its post URL, comment count, download_url and links.past_runs.

Use when: You want to find or re-download an earlier comment scrape.

List LinkedIn reactions scrapes

snitchfeed_list_linkedin_reactions_scrapes

Lists past reaction scrape runs, newest first, each with its post URL, reaction count, download_url and links.past_runs.

Use when: You want to find or re-download an earlier reaction scrape.

Feeds

List feeds

snitchfeed_list_feeds

Lists saved feeds with their filters, a dashboard url, and a notifications object: enabled status, Slack channel names (never IDs), Discord webhook URLs, email digest settings and attached webhook destinations. Top-level slack_connected and org_webhooks help with notification changes.

Use when: You need feed IDs or names, or want to see where each feed's alerts go.

Create feed

snitchfeed_create_feed

Creates a saved feed: a named, filtered view of your mentions. Scope it by listeners, platforms, sentiment, Fit Score buckets, intent tags, keywords, subreddits, date range and seen status.

Use when: You want a lasting view in the dashboard, such as "High-fit buyer signals" or "Competitor complaints".

Update feed

snitchfeed_update_feed

Updates a feed's name, sort order or filters. A filter array you pass replaces the current value for that field. Does not change alert destinations; use Update feed notifications for that.

Use when: You want to change a feed's scope without recreating it.

Update feed notifications

snitchfeed_update_feed_notifications

Sets a feed's alert destinations: Slack channels, Discord webhook URLs, email digests and webhook destinations, plus on or off. It is a partial update: omit a field to leave it, pass an empty array to clear that destination type, or pass email: null to remove email digests. A feed can post to several Slack channels. Call Get Slack channels first for Slack.

Use when: You want to route a feed's new mentions to Slack, Discord, email or a webhook.

Get Slack channels

snitchfeed_get_slack_channels

Lists public channels in the connected Slack workspace (id and name). Private channels are not included. If Slack is not connected, it returns an error with a link to the Slack integration page.

Use when: You need channels before setting Slack destinations with Update feed notifications.

Delete feed

snitchfeed_delete_feed

Permanently deletes a saved feed. Its alert routes stop; mentions are not affected. The client asks for explicit confirmation first.

Use when: You want to remove a view you no longer use. This cannot be undone.

Webhooks

Webhook destinations are named HTTPS endpoints that receive a JSON POST for each new mention routed to them. Creating a destination does not send anything by itself: attach it to a feed with Update feed notifications (or in the feed's notification settings in the app). Delivery format and retries are on Webhook events, retries and delivery limits.

List webhook destinations

snitchfeed_list_webhook_destinations

Lists the workspace's webhook destinations with ID, name, URL, active status and timestamps, plus a links.webhooks link to Integrations → Webhooks.

Use when: You need destination IDs, or want to see what endpoints exist.

Create webhook destination

snitchfeed_create_webhook_destination

Creates a destination from a name, an HTTPS url and an optional is_active (default true). It starts with the default delivery limits. Needs a plan that includes webhooks; otherwise the tool returns an upgrade error.

Use when: You want to send mentions to a CRM, Zapier, n8n or your own endpoint.

Update webhook destination

snitchfeed_update_webhook_destination

Changes a destination's name, url or is_active. At least one is required; omitted fields stay as they are. Delivery limits are kept.

Use when: You want to rename, repoint, pause or resume a destination.

Delete webhook destination

snitchfeed_delete_webhook_destination

Deletes a destination and removes it from every feed that used it. Delivery history is kept and mentions are not affected. The client asks for explicit confirmation first.

Use when: An endpoint is no longer used. This cannot be undone.

Analytics

Query analytics

snitchfeed_query_analytics

Runs an ad hoc analytics query. Choose a metric (mentions, unique_authors, avg_sentiment, avg_fit_score), a group_by dimension (day, platform, sentiment, fitScore, keyword, subreddit, language or listener; default day) and an optional breakdown_by (platform, sentiment, fitScore, language, listener or intent). Intent tags are a breakdown only, not a group by. Filters match List mentions, and the date range defaults to the past 14 days. Results include the resolved date range.

Use when: You want a one-off answer: "Which platform brought the most mentions last month?" or "How is sentiment trending by day?"

List analytics reports

snitchfeed_list_analytics_reports

Lists saved analytics reports with each report's ID, name, a readable description of its query and when its cached data was last refreshed.

Use when: You want to find a report before creating a duplicate, or need a report ID to update it.

Create analytics report

snitchfeed_create_analytics_report

Saves a named analytics query as a report in the dashboard. It runs on creation and caches results for 15 minutes.

Use when: You want a recurring breakdown to stay in the dashboard across sessions.

Update analytics report

snitchfeed_update_analytics_report

Updates a report's name or query. If any query parameter changes, the ones you leave out reset to their defaults. If only the name changes, the query is kept.

Use when: You want to rename a report or change what it measures.

Audit query noise

snitchfeed_audit_query_noise

Audits saved queries for noise and cost in one call. It estimates monthly credit cost, poll efficiency (scans that returned no new mentions) and mention quality (Fit Score distribution, exclusion-archive rate, thumbs up and down feedback), then combines them into a noise score and a suggested action: keep, narrow, increase_interval or kill.

Use when: You want to find noisy or wasteful queries. It does not change queries; use Get query grammar and Update listener query to apply fixes.

Workspace

Get concepts

snitchfeed_get_concepts

Returns an explanation of SnitchFeed concepts: listeners, queries, tracked profiles, mentions, Fit Score, intent, intent tags, sentiment, platforms, analytics, reports and integrations.

Use when: An AI client needs orientation before a complex task. The same content is on MCP concepts.

Get organization context

snitchfeed_get_org_context

Returns your workspace's Brand Context: company name, website, product description, positioning, target audience, use cases, competitors and differentiators.

Use when: You want the AI to understand your business before judging relevance, drafting replies or writing a report.

Update organization context

snitchfeed_update_org_context

Updates your Brand Context: brand name, website, description, product summary, positioning, target audiences, ideal customer profiles, use cases and case studies. Only the fields you pass change. Ideal customer profiles, use cases and case studies replace the whole list. Each field must meet the same minimum lengths as onboarding. Changing the website stores the new domain without re-analyzing the site, and updates are refused while a website analysis is running. The client shows you the changes and asks before saving.

Use when: You want to refine your Brand Context, for example after reviewing low-fit mentions, so scoring and reply drafts improve for new mentions.

Get usage

snitchfeed_get_usage

Returns usage against plan limits for the current billing period: keywords used and limit, listeners (active and paused) and limit, and credits used and limit.

Use when: You want to check headroom before adding listeners or queries.

On this page