# MCP tools reference: all tools and parameters (https://snitchfeed.com/docs/mcp/tools)

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](/docs/mcp/concepts) first.

## Mentions [#mentions]

### List 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.

| Parameter | Description |
|-----------|-------------|
| `page` | Page number, starting at 0 |
| `order` | `newest` (by publish date, the default) or `fit_score_desc` (highest Fit Score first) |
| `platforms` | Only these platforms |
| `sentiment` | `positive`, `negative` or `neutral` |
| `fit_score` | Fit Score buckets: `high`, `medium`, `low` |
| `include_listener_ids`, `exclude_listener_ids` | Scope to or exclude listeners |
| `include_intents`, `exclude_intents` | Intent tag slugs |
| `date_from`, `date_to` | ISO 8601 dates, on the publish date |
| `languages` | ISO 639-1 codes, for example `["en", "es"]` |
| `include_subreddits`, `exclude_subreddits` | Reddit only |
| `include_keywords`, `exclude_keywords` | Matched keywords |
| `seen` | `true` for seen only, `false` for unseen only |
| `collections` | Only 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 [#listeners]

### List 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 [#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 [#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](#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 [#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 [#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](/docs/mcp/concepts#tracked-profile-tracked-author) and the product guide [Track LinkedIn and X profiles](/docs/listeners/tracked-profiles).

### Create listener query [#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 [#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 [#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 [#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 [#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 [#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 [#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 [#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 [#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 [#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 [#search]

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

### Search X posts [#search-x-posts]

`snitchfeed_search_tweets`

Live search of X for posts matching a keyword query, with optional language and minimum-likes filters. Costs {CREDIT_COSTS.MCP_SEARCH_TWEETS} 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 [#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 {CREDIT_COSTS.MCP_SEARCH_LINKEDIN_POSTS} 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 [#get-linkedin-profile-posts]

`snitchfeed_get_linkedin_profile_posts`

Fetches recent public posts from one LinkedIn person's profile (`linkedin.com/in/...`). Costs {CREDIT_COSTS.MCP_GET_LINKEDIN_PROFILE_POSTS} 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 [#get-linkedin-company-posts]

`snitchfeed_get_linkedin_company_posts`

Fetches recent public posts from one LinkedIn company page (`linkedin.com/company/...`). Costs {CREDIT_COSTS.MCP_GET_LINKEDIN_COMPANY_POSTS} 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 [#get-linkedin-profile-comments]

`snitchfeed_get_linkedin_profile_comments`

Fetches recent public comments **written by** a LinkedIn person on other people's posts. Costs {CREDIT_COSTS.MCP_GET_LINKEDIN_PROFILE_COMMENTS} 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 [#search-hacker-news-posts]

`snitchfeed_search_hn_posts`

Live search of Hacker News stories and comments. Costs {CREDIT_COSTS.MCP_SEARCH_HACKERNEWS_POSTS} 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 [#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 {CREDIT_COSTS.MCP_SEARCH_REDDIT_POSTS} credits per call, or {CREDIT_COSTS.MCP_SEARCH_REDDIT_POSTS} 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 [#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, {CREDIT_COSTS.MCP_SEARCH_REDDIT_COMMENTS} credits per call.

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

### Extract LinkedIn post comments [#extract-linkedin-post-comments]

`snitchfeed_extract_linkedin_post_comments`

Scrapes commenters from a public LinkedIn post into a CSV. Costs {CREDIT_COSTS.LINKEDIN_POST_COMMENTS} credit per comment scraped, minimum {CREDIT_COSTS.LINKEDIN_POST_ENGAGEMENT_MIN} 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 [#extract-linkedin-post-reactions]

`snitchfeed_extract_linkedin_post_reactions`

Scrapes people who reacted to a public LinkedIn post into a CSV. Costs {CREDIT_COSTS.LINKEDIN_POST_REACTIONS} credit per reaction scraped, minimum {CREDIT_COSTS.LINKEDIN_POST_ENGAGEMENT_MIN} 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 [#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 [#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 [#feeds]

### List 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 [#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 [#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 [#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 [#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 [#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 [#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](/docs/api/webhooks).

### List webhook destinations [#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 [#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 [#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 [#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 [#analytics]

### Query 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 [#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 [#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 [#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 [#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 [#workspace]

### Get concepts [#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](/docs/mcp/concepts).

### Get organization context [#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 [#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 [#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.

## Related [#related]

- [Connect the MCP server](/docs/mcp/setup): add SnitchFeed to your AI client
- [MCP concepts](/docs/mcp/concepts): the terms these tools use
- [MCP use cases](/docs/mcp/use-cases): prompts that combine several tools
- [Credits and usage](/docs/credits): how credits work across the product
- [SnitchFeed API](/docs/api/introduction): the REST API for your own integrations
