Tools Reference
Every tool the SnitchFeed MCP server exposes, with descriptions and use cases.
The MCP server exposes 20 tools across four categories: mentions, listeners, feeds, and analytics. All tools operate on your workspace and respect your plan limits.
If you are unfamiliar with terms like listener, query, fit score, or intent tags, see the Concepts page first.
Mentions
snitchfeed_list_mentions
Fetches brand mentions from your feed with rich filtering. You can filter by platform, date range, sentiment, AI fit score, intent tags, keywords, subreddit, and seen/unseen status. Results are paginated at 50 per page.
Use when: You want to read, summarize, or triage recent mentions. Pair filters with snitchfeed_list_listeners to scope to a specific topic.
Listeners
snitchfeed_list_listeners
Returns all active and paused listeners in your workspace, including each listener's ID, name, status, intent description, and platform configuration.
Use when: You need listener IDs to pass into other tools, or want to review what your workspace is currently monitoring.
snitchfeed_list_queries
Lists all keyword queries across your listeners. Each query includes the raw query text, which platforms it runs on, and any platform-specific filters (subreddits, LinkedIn author filters, Twitter minimum likes).
Use when: You want to audit or modify specific keyword rules, or filter mentions by the query that triggered them.
snitchfeed_create_listener
Creates a new listener with one or more keyword queries. You provide a name, at least one query string (supports boolean syntax: AND, OR, NOT, parentheses), the platforms to monitor, and optionally an intent description that tunes the AI fit score.
Use when: You want to start monitoring a new brand, competitor, or topic from scratch.
snitchfeed_update_listener
Updates a listener's name, intent description, status (active or paused), or color. Queries are not affected.
Use when: You want to rename a listener, update what the AI considers "relevant" for fit scoring, or pause monitoring temporarily.
snitchfeed_create_listener_query
Adds a new keyword query to an existing listener. Triggers a historical backfill for the new query automatically.
Use when: You want to expand an existing listener to watch for additional keywords without creating a new listener.
snitchfeed_update_listener_query
Updates the query text, platform scope, or filter settings of an existing keyword query. If the query text changes, irrelevant existing mentions may be archived and new keywords are backfilled.
Use when: You want to refine a keyword rule, change which platforms it runs on, or adjust LinkedIn/Twitter filters.
snitchfeed_delete_listener
Permanently deletes a listener and all its keyword queries. The AI client will always ask for explicit confirmation before calling this tool.
Use when: You want to remove a listener and stop monitoring its topic entirely. This cannot be undone — historical mentions are preserved, but the listener and its queries are gone.
snitchfeed_delete_listener_query
Permanently removes a single keyword query from a listener. The AI client will always ask for explicit confirmation before calling this tool. A listener must retain at least one query — to delete the last one, delete the listener itself.
Use when: You want to narrow an existing listener's scope by removing one of its keyword rules without affecting the others.
snitchfeed_get_query_grammar
Returns the full boolean query syntax reference: supported operators, term limits, and platform-specific constraints.
Use when: You are constructing a query string and need to check the syntax or limits before passing it to a create or update tool.
Feeds
snitchfeed_create_feed
Creates a saved feed, which is a named filtered view of your mentions. You can scope it to specific listeners, platforms, sentiment, fit score buckets, intent tags, keywords, subreddits, date range, and seen status.
Use when: You want to build a persistent view in the SnitchFeed dashboard, such as "High-fit Buyer Signals" or "Competitor Complaints."
snitchfeed_update_feed
Updates a saved feed's name, sort order, or any of its filter settings. Providing a filter array fully replaces the existing value for that field.
Use when: You want to adjust the scope of an existing saved view without recreating it.
Analytics
snitchfeed_query_analytics
Runs an ad-hoc analytics query against your mention data. You choose a metric (mention count, unique authors, average sentiment, average fit score), a grouping dimension (day, platform, sentiment, fit score, keyword, subreddit, language, or listener), and an optional second breakdown dimension. Results include the resolved date range.
Use when: You want a one-off data question answered: "Which platform drove the most mentions last month?" or "How is sentiment trending day by day?"
snitchfeed_list_analytics_reports
Lists all saved analytics reports in your workspace, including each report's ID, name, a human-readable description of its query, and when its cached data was last refreshed.
Use when: You want to find an existing report before creating a new one (to avoid duplicates), or to get a report ID for updating.
snitchfeed_create_analytics_report
Saves a named analytics query as a reusable report visible in the SnitchFeed dashboard. The query runs immediately on creation and results are cached for 15 minutes.
Use when: You want a recurring view of a specific analytics breakdown to persist in the dashboard across sessions.
snitchfeed_update_analytics_report
Updates a saved report's name or query configuration. If any query parameter changes, unspecified parameters reset to their defaults. If only the name changes, the existing query is preserved.
Use when: You want to rename a report or change what it measures without deleting and recreating it.
Workspace
snitchfeed_get_concepts
Returns a full explanation of SnitchFeed concepts: listeners, queries, mentions, fit score, intent, negative intent, intent tags, sentiment, platforms, analytics, and analytics reports.
Use when: You are unfamiliar with SnitchFeed terminology, or an AI client needs orientation before helping with a complex task. The same content is available in the Concepts page.
snitchfeed_get_org_context
Returns your organization'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 brand before interpreting mention relevance, drafting reply suggestions, or generating a report.
snitchfeed_get_usage
Returns current billing period usage against your plan limits: keywords used, listener count, and AI processing credits consumed.
Use when: You want to check headroom before creating new listeners or queries.