dev.mentio/mcp

Est-ce que dev.mentio/mcp est sûr ?

Au dernier audit MCP Hub, le serveur MCP « dev.mentio/mcp » est classé « Non encore testé ». Référencé dans l'annuaire. Seul le pentest comportemental fait foi, et il n'a pas encore été exécuté sur ce serveur. Le verdict est réévalué en continu ; consultez la fiche pour l'état à jour.

Méthode : MCP Hub analyse la description de chaque outil (couche 1) et, pour le verdict fort, exécute le serveur dans une micro-VM isolée avec leurres et réseau bloqué (couche 2). On publie des noms et des compteurs, jamais le contenu brut renvoyé par un outil.

Les 61 outils

• add_feeds≈ 686 tokens

  Connect RSS or Atom feeds to the workspace, up to 100 at a time (the workspace reads at most 500): each url is a feed's address, or a page's (a forum, a community, a blog) whose advertised feed is used. Every keyword reading workspace feeds then gets the feed's items holding its term, polled every hour; reading a feed is free, its matches bill like any mention. Each { url } is checked on its own and reported added, already (the workspace reads it) or failed with an error code: feed_unreadable (no feed found, or the site blocks automated readers), feed_login_required (a members-only forum: send it again as { url, auth: { type: "cookie", value } } with the person's own sign-in, stored encrypted and read for this workspace alone), feed_login_expired, feed_limit_reached. The first 8 added bring each keyword the newest 10 matching items of the last 30 days.

  Paramètres, retour & exemple (1)

  Paramètres

  • feeds · array · requis
    Up to 100 feeds, each { url } or { url, auth } for a members-only one. Each is checked on its own: one that fails never stops the others.

  Exemple d'appel

  {"name": "add_feeds", "arguments": {"feeds": []}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• add_keyword≈ 3909 tokens

  Start tracking a keyword. kind is "brand" (default), "competitor" or "topic". platforms optionally restricts it to some platforms (default: every platform). New mentions containing the term will be matched, classified and delivered. A multi-word term also matches a post holding its words close together (any order, plurals and spellings like non-profit/nonprofit); such a post is kept and billed only when the classifier scores it relevant. Wrap the term in double quotes, or set matching.exactPhrase, for the exact phrase only. Prefer short terms people actually write ("fundraising agency") over sentences ("looking for a fundraising agency"). For a common word, narrow it with `matching` (requiredTerms with requiredMode any|all, requiredGroups: combinations where the post must hold every term of at least one, as [["weather","alert*"],["tsunami"]], so one keyword replaces a search per line, excludedTerms, a `*` wildcard at an end of any rule term, excludedAuthors, caseSensitive, exactPhrase, subreddits: { only, excluded } to keep its Reddit posts to some subreddits or out of some): a post the rules reject is never stored or billed. `context` is one sentence the classifier reads for this keyword only ("Arc is our browser; ignore the geometry word"). `cap` ({ mentions: N, per: "day" | "week" | "month" }, per defaults to month) is a ceiling on its matched mentions per UTC day, week (from Monday) or month: at the cap it stops matching until the next period starts or until the cap is raised, while its daily keyword charge continues. A daily cap keeps mentions coming every day with a fixed ceiling on spend (N × $0.008 a day at most, plus the keyword). `groupId` puts it in a keyword group (list_groups; default: the workspace's default group); a term may be tracked once per group, so two groups may track the same term as two keywords. `reviewSources` collects reviews: pass each page's link (url: an App Store or Google Play app, a Trustpilot page, a Google Maps place or its maps.app.goo.gl share link) or platform (appstore|googleplay|trustpilot|googlemaps) and id; the app stores also take countries (two-letter codes, default us) and Google Play a language (default en). Every review of the page becomes a mention of this keyword, polled daily, and the last 30 days (newest 100) come in free at once. `feeds` reads RSS or Atom feeds: pass each as { url }, a feed's URL or a page's (a forum, a community, a blog) whose advertised feed is used; a URL with no feed is refused. An item of a feed is a mention of this keyword when it holds the term, polled every hour, and the newest 10 matching items of the last 30 days come in at once (billed like any mention). `platforms: []` makes a reviews-only or feeds-only keyword. `comments` ({ enabled: true, maxPerPost: N }, off by default) reads the comments under its relevant mentions from 30 minutes after each post, as long as its platform's conversations last (a day on Reddit, Hacker News and Bluesky, a week on GitHub, Stack Overflow and DEV, a month on YouTube), $0.008 per comment delivered (comments of fewer than three words are skipped), at most maxPerPost (default 20) per mention; list them with list_mention_comments. On GitHub a keyword also gets events about repositories naming it; matching.repositories chooses them: events (traction: a repository under 30 days old reached 10 stars; stars: a star milestone from 100 up; growth: fast growth in a week; new: every repository created, even with no stars, off by default), minStars and minWeeklyStars (stars gained in 7 days, 25 or more). An event outside the rule is dropped before it is stored, so it is never billed: "repositories about X with 200+ stars gaining 100 a week" is { events: ["stars","growth"], minStars: 200, minWeeklyStars: 100 }.

  Paramètres, retour & exemple (11)

  Paramètres

  • cap · ? · optionnel
    A mention cap per day, week or month (per, default month); omit or null for none.
  • kind · string · optionnel · brand | competitor | topic
    brand: your own names. competitor: theirs. topic: the space. Drives share of voice and segments.
  • term · string · requis
    The word or phrase to track, case-insensitive. A multi-word term matches as the phrase or as its words close together (see matching.exactPhrase); wrap it in double quotes for the exact phrase only.
  • feeds · array · optionnel
    RSS or Atom feeds this keyword reads, at most 20, each { url }: a feed's URL, or a page's (a forum, a community, a blog), in which case the feed the page advertises is used, else a usual address such as /feed or /rss. A URL with no feed behind it is a 400. Each feed is read every hour; an item is a mention of this keyword when it holds the term (with the keyword's matching rules), and only of keywords that named the feed. A newly connected feed brings its newest 10 items of the last 30 days that hold the term, billed like any mention and never sent as instant alerts.
  • context · ? · optionnel
    A sentence the classifier reads for this keyword only, on top of the company profile or the group's own description (at most 300 characters): what the term means here, what to ignore. "Arc is our browser; ignore the geometry word." Null clears it.
  • groupId · string · optionnel
    The group to track it in (grp_...); omit for the workspace's default group. A term may be tracked once per group.
  • comments · object · optionnel
    Comments under this keyword's mentions; omitted fields are untouched (on create: off, 20 per post).
  • matching · object · optionnel
    Omitted fields are untouched; an empty list clears one.
  • platforms · ? · optionnel
    Platforms to search the term on; omit or null for every platform. [] searches it nowhere: a keyword that only collects reviews or reads feeds, which then needs reviewSources or feeds.
  • reviewSources · array · optionnel
    Review pages this keyword collects, at most 10: App Store and Google Play apps, Trustpilot pages, Google Maps places. Every new review of one is a mention of the keyword, whatever its text says. Polled once a day (per country on the app stores). A newly connected page brings its last 30 days, the newest 100 reviews (per country), free and never sent as instant alerts; after that each review bills like any mention.
  • readsWorkspaceFeeds · boolean · optionnel
    Whether the keyword also reads the workspace's feeds (GET /v1/feeds); default true. A new keyword reading them gets the look-back of the 8 most recently connected.

  Exemple d'appel

  {"name": "add_keyword", "arguments": {"term": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• create_alert≈ 4595 tokens

  Create an alert rule. mode "instant" sends each matching mention as it happens; "hourly" sends one digest every UTC hour (five minutes past) for the previous hour, nothing when it had no mention over the floor, takes no schedule and no email channel (Slack, Telegram, webhook); "daily" sends one digest at schedule.hour in schedule.timezone; "weekly" sends one a week on schedule.weekday (0 Sunday to 6 Saturday). filter narrows by keywordIds, platforms, minRelevance (the relevance floor: absent sends relevant mentions only, 40 and up; 0 sends every scored match, noise included), minConfidence, sentiments, intents, excludeAuthors, minFollowers, tags, linkHosts (the hosts a post links to, a host or any subdomain of it). channelIds come from list_channels.

  Paramètres, retour & exemple (7)

  Paramètres

  • mode · string · optionnel · instant | hourly | daily | weekly
  • name · string · requis
  • event · ? · optionnel
    Custom event name for webhook payloads; null for the mode default.
  • filter · object · optionnel
  • enabled · boolean · optionnel
  • schedule · object · optionnel
    Required for daily and weekly alerts (weekly ones also need schedule.weekday). Hourly alerts take none: they send every UTC hour, so a time of day and a zone are ignored and a weekday is refused.
  • channelIds · array · optionnel
    Channel ids from GET /v1/channels.

  Exemple d'appel

  {"name": "create_alert", "arguments": {"name": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• create_group≈ 600 tokens

  Create a keyword group: a name (unique per workspace), optionally your own id for it (externalId, unique too, a customer id say), and optionally its own company description (context: who the business is, what it sells, for whom), which the classifier reads in place of the whole workspace profile (guidelines and competitors included) for this group's keywords, so a rule for the group goes in that text. One group per customer with its description is how a reseller gets each customer judged as itself. Then pass its id as groupId to add_keyword.

  Paramètres, retour & exemple (3)

  Paramètres

  • name · string · requis
    The group's name: a customer, a campaign, a product. Unique per workspace.
  • context · ? · optionnel
    What the classifier reads as "the company" for this group's keywords, in place of the WHOLE workspace profile, its relevance guidelines and competitor list included (at most 4000 characters): who the business is, what it sells, for whom, what is not it, and any rule that should apply to this group ("ignore job posts"). For a group per customer, the customer's description. Null: the workspace profile, as for every keyword before groups.
  • externalId · ? · optionnel
    Your own id for the group (a customer id, say). Unique per workspace; find the group by it with GET /v1/groups?externalId=.

  Exemple d'appel

  {"name": "create_group", "arguments": {"name": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• create_segment≈ 1282 tokens

  Save an audience segment: a name plus a filter (platforms, tags, follower range, minimum mentions or negatives, intents seen, keyword kinds mentioned or never mentioned, first seen within N days, linkHosts they have shared a link to). Evaluated on every read, never materialized. With groupId the segment belongs to that keyword group and is only listed there.

  Paramètres, retour & exemple (4)

  Paramètres

  • name · string · requis
  • filter · object · optionnel
  • groupId · string · optionnel
    Scope to one keyword group (grp_...): only people who mentioned that group's keywords, with that group's own tags, notes, mute, merges, activities and segments. Omit for the whole workspace.
  • description · string · optionnel

  Exemple d'appel

  {"name": "create_segment", "arguments": {"name": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• create_view≈ 5005 tokens

  Save a view: a name plus a filter in the vocabulary of search_mentions (keywords or keyword kinds, platforms, status, relevant, sentiments, intents, languages, author countries, author tags, follower range, replies, link hosts, automated, organization, free text), lists any-of, `not` lists none-of, every condition ANDed, plus anyOf for OR: groups of those conditions, at least one of which must hold. Nothing is materialized: the view selects whatever matches when it is read.

  Paramètres, retour & exemple (3)

  Paramètres

  • name · string · requis
    Unique per workspace, case-insensitive.
  • filter · object · optionnel
    The filter; empty selects every mention.
  • description · string · optionnel
    What the view is for, shown under its name.

  Exemple d'appel

  {"name": "create_view", "arguments": {"name": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• delete_activity≈ 235 tokens

  Delete an outreach activity logged by mistake. The person's owner and stage stay as they are. An activity logged in a keyword group is found with that groupId.

  Paramètres, retour & exemple (3)

  Paramètres

  • id · string · requis
    Person id (aut_...)
  • groupId · string · optionnel
    Scope to one keyword group (grp_...): only people who mentioned that group's keywords, with that group's own tags, notes, mute, merges, activities and segments. Omit for the whole workspace.
  • activityId · string · requis
    Activity id (act_...), from list_activities

  Exemple d'appel

  {"name": "delete_activity", "arguments": {"id": "texte", "activityId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• delete_alert≈ 132 tokens

  Delete an alert rule. Its channels stay and can serve other rules. Irreversible; disabling it (update_alert enabled=false) keeps the rule.

  Paramètres, retour & exemple (1)

  Paramètres

  • id · string · requis
    Alert id (feed_...)

  Exemple d'appel

  {"name": "delete_alert", "arguments": {"id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• delete_feed≈ 137 tokens

  Stop the workspace reading a feed (fd_..., from list_feeds). Its mentions stay; keywords that name the same feed in their own feeds keep reading it.

  Paramètres, retour & exemple (1)

  Paramètres

  • id · string · requis
    Feed id (fd_...), from list_feeds

  Exemple d'appel

  {"name": "delete_feed", "arguments": {"id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• delete_group≈ 139 tokens

  Delete a keyword group and EVERY keyword in it (each as delete_keyword does: its mentions go with it). The default group cannot be deleted. Says how many keywords went.

  Paramètres, retour & exemple (1)

  Paramètres

  • id · string · requis
    Group id (grp_...)

  Exemple d'appel

  {"name": "delete_group", "arguments": {"id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• delete_keyword≈ 172 tokens

  Stop tracking a keyword and delete its mentions (a post also matched by another keyword stays). Alert rules that named it stop naming it; a rule that named only this keyword is disabled rather than widened to every keyword. Irreversible; muting (update_keyword muted=true) keeps the mentions.

  Paramètres, retour & exemple (1)

  Paramètres

  • id · string · requis
    Keyword id (kw_...)

  Exemple d'appel

  {"name": "delete_keyword", "arguments": {"id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• delete_segment≈ 196 tokens

  Delete a saved segment. Nobody in it is affected. A segment saved in a keyword group is found with that groupId.

  Paramètres, retour & exemple (2)

  Paramètres

  • id · string · requis
    Segment id (seg_...), from list_segments
  • groupId · string · optionnel
    Scope to one keyword group (grp_...): only people who mentioned that group's keywords, with that group's own tags, notes, mute, merges, activities and segments. Omit for the whole workspace.

  Exemple d'appel

  {"name": "delete_segment", "arguments": {"id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• delete_view≈ 107 tokens

  Delete a saved view. No mention is affected.

  Paramètres, retour & exemple (1)

  Paramètres

  • id · string · requis
    View id (vw_...)

  Exemple d'appel

  {"name": "delete_view", "arguments": {"id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• dismiss_attention≈ 136 tokens

  Dismiss an attention item (att_... from list_attention): it leaves the open list and does not come back while its condition lasts.

  Paramètres, retour & exemple (1)

  Paramètres

  • id · string · requis
    Attention item id (att_...)

  Exemple d'appel

  {"name": "dismiss_attention", "arguments": {"id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• duplicate_keyword≈ 398 tokens

  Create a new keyword with an existing one's settings: give the new term (or the same term with another groupId, since a term is tracked once per group). It copies the kind, platforms, context, every matching rule, the monthly mention cap and the comments setting; review apps and feeds only when listed in include (reviewSources, feeds), since two keywords on one app collect and bill every review twice. It is a new keyword: $5 per month, and its last 30 days come in at once.

  Paramètres, retour & exemple (4)

  Paramètres

  • id · string · requis
    The keyword to copy (kw_...)
  • term · string · requis
    The term of the copy. The same term as the original only in another group (groupId): a term is tracked once per group. Wrap it in double quotes for the exact phrase only.
  • groupId · string · optionnel
    The group of the copy (grp_...); omit for the original's group.
  • include · array · optionnel
    Also copy these: reviewSources (its review apps) and feeds (its RSS or Atom feeds). Off by default, since two keywords on one app or feed collect, and bill, every review or item twice.

  Exemple d'appel

  {"name": "duplicate_keyword", "arguments": {"id": "texte", "term": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_alert≈ 115 tokens

  One alert rule by id: its filter, mode and schedule, channels and delivery stats.

  Paramètres, retour & exemple (1)

  Paramètres

  • id · string · requis
    Alert id (feed_...)

  Exemple d'appel

  {"name": "get_alert", "arguments": {"id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_analytics_breakdown≈ 755 tokens

  One table grouped by a dimension `by`: platform, keyword, sentiment, intent, status (open, ignored, done), hour (weekday and hour of day in timezone, for "when do people talk"), person (who posted most, with followers), language (ISO 639-1), country (where the authors are, ISO 3166-1 alpha-2; "unknown" for posts nobody could place), or subreddit (Reddit posts only: which subreddits your mentions come from). Each row has matched, relevant, share of the window in percent, a sentiment split and, with compare=true, the same group in the period right before. Same window parameters as get_analytics_summary. At most 50 groups, most matched first.

  Paramètres, retour & exemple (8)

  Paramètres

  • by · string · requis · platform | keyword | sentiment | intent | status | hour | person | language
    The dimension to group by: platform, keyword, sentiment (unclassified included), intent (a mention can carry several), status (open, ignored, done), hour (weekday and hour of day in `timezone`), person (who posted; anonymous posts are left out), language (ISO 639-1; "unknown" for posts without one), country (where the author is, ISO 3166-1 alpha-2; "unknown" for posts without one), subreddit (Reddit posts only, most active first; `share` stays a percent of the whole window, every platform included).
  • to · string · optionnel
    Last day, YYYY-MM-DD, inclusive, in `timezone`. Default today.
  • from · string · optionnel
    First day, YYYY-MM-DD, inclusive, in `timezone`.
  • range · string · optionnel · 7d | 30d | 90d | 365d
    Preset window ending today. Ignored when from or to is given. Default 30d.
  • compare · boolean · optionnel
    true adds the period of the same length right before the window as `previous`.
  • timezone · string · optionnel
    IANA zone the days are cut in (Europe/Madrid). Default UTC. One offset, the zone's at the end of the window, applies to the whole window.
  • platforms · array · optionnel
    Only these platforms. Repeatable, or comma-separated; omit for every platform.
  • keywordIds · array · optionnel
    Only these keyword ids. Repeatable, or comma-separated; omit for every keyword.

  Exemple d'appel

  {"name": "get_analytics_breakdown", "arguments": {"by": "platform"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_analytics_series≈ 634 tokens

  Mentions over time: one point per day or week (bucket; default day up to 90 days) with matched, relevant and sentiment counts, as a single "total" series or split with by="platform" or by="keyword" (top 20, the rest as "other"). Same window parameters as get_analytics_summary; compare=true adds `previous`, the period right before, points aligned by index.

  Paramètres, retour & exemple (9)

  Paramètres

  • by · string · optionnel · platform | keyword | sentiment
    Split into one series per platform, per keyword (the top 20 by matched, the rest folded into "other") or per sentiment (positive, neutral, negative, unclassified). Omit for one total series.
  • to · string · optionnel
    Last day, YYYY-MM-DD, inclusive, in `timezone`. Default today.
  • from · string · optionnel
    First day, YYYY-MM-DD, inclusive, in `timezone`.
  • range · string · optionnel · 7d | 30d | 90d | 365d
    Preset window ending today. Ignored when from or to is given. Default 30d.
  • bucket · string · optionnel · hour | day | week | month
    Point granularity: hour (windows of at most 14 days), day, week (Monday start) or month. Default: day up to 90 days, week beyond.
  • compare · boolean · optionnel
    true adds the period of the same length right before the window as `previous`.
  • timezone · string · optionnel
    IANA zone the days are cut in (Europe/Madrid). Default UTC. One offset, the zone's at the end of the window, applies to the whole window.
  • platforms · array · optionnel
    Only these platforms. Repeatable, or comma-separated; omit for every platform.
  • keywordIds · array · optionnel
    Only these keyword ids. Repeatable, or comma-separated; omit for every keyword.

  Exemple d'appel

  {"name": "get_analytics_series", "arguments": {"by": "platform", "to": "texte", "from": "texte", "range": "7d", "bucket": "hour", "compare": true}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_analytics_summary≈ 554 tokens

  Headline counts for a window: matched and relevant mentions, distinct posts and people, sentiment split, buying intent and questions, estimated reach (followers of the people whose count is known), and triage (open, ignored, done, waiting over 24h, handled rate, median time to done). Window: range 7d|30d|90d|365d ending today, or from/to as YYYY-MM-DD; keywordIds and platforms are lists; timezone (IANA) cuts the days, UTC by default; compare=true adds the same counts for the period right before as `previous`. Time axis is the publish date.

  Paramètres, retour & exemple (7)

  Paramètres

  • to · string · optionnel
    Last day, YYYY-MM-DD, inclusive, in `timezone`. Default today.
  • from · string · optionnel
    First day, YYYY-MM-DD, inclusive, in `timezone`.
  • range · string · optionnel · 7d | 30d | 90d | 365d
    Preset window ending today. Ignored when from or to is given. Default 30d.
  • compare · boolean · optionnel
    true adds the period of the same length right before the window as `previous`.
  • timezone · string · optionnel
    IANA zone the days are cut in (Europe/Madrid). Default UTC. One offset, the zone's at the end of the window, applies to the whole window.
  • platforms · array · optionnel
    Only these platforms. Repeatable, or comma-separated; omit for every platform.
  • keywordIds · array · optionnel
    Only these keyword ids. Repeatable, or comma-separated; omit for every keyword.

  Exemple d'appel

  {"name": "get_analytics_summary", "arguments": {"to": "texte", "from": "texte", "range": "7d", "compare": true, "timezone": "texte", "platforms": []}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_company≈ 135 tokens

  Read what the classifier knows about the company: name, description, use cases, own accounts, and the composed context it reads to judge relevance (for keywords in a group that carries its own description, the group's text replaces it; see list_groups).

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "get_company", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_filters≈ 150 tokens

  The workspace filters: noise rules applied to every keyword before a mention is stored (excluded terms and authors, excluded GitHub repositories, the subreddits Reddit posts may or may not come from). A post they reject is never classified, delivered or billed. Per-keyword rules live on each keyword (`matching`).

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "get_filters", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_group≈ 109 tokens

  One keyword group by id, with how many keywords it holds.

  Paramètres, retour & exemple (1)

  Paramètres

  • id · string · requis
    Group id (grp_...)

  Exemple d'appel

  {"name": "get_group", "arguments": {"id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_keyword≈ 153 tokens

  One keyword by id: term, kind, platforms, matching rules, context, its monthly mention cap and whether it is at it (pausedForCap), stats (mentions, relevant, last 7 days, this month, your feedback) and poll health per platform.

  Paramètres, retour & exemple (1)

  Paramètres

  • id · string · requis
    Keyword id (kw_...)

  Exemple d'appel

  {"name": "get_keyword", "arguments": {"id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_keyword_health≈ 380 tokens

  Is a keyword worth what it costs, and what would fix it. Over a trailing window (range 7d, 30d or 90d; default 30d): a status (healthy; noisy = 20 or more scored matches and under 30% relevant; quiet = 7 days or older with nothing relevant; capped; paused; new = under 7 days old) with reasons in plain words, matches, relevant, noise share by platform and week, what it cost, the words and authors over-represented in its noise, and suggestions. Each suggestion has a `patch`: pass it to update_keyword with the keyword id to apply it (lists hold the whole new list), and an `effect` measured by running the matcher's rules over the window's posts (noise and relevant matches it would have removed, cents saved). ai=true adds a context rewritten by a language model (cached a day; 20 model calls an hour per workspace). Read only, never billed, cached 5 minutes.

  Paramètres, retour & exemple (3)

  Paramètres

  • ai · boolean · optionnel
    true: also ask a language model for a rewritten context. Default false.
  • id · string · requis
    Keyword id (kw_...)
  • range · string · optionnel · 7d | 30d | 90d
    Trailing window ending today: 7d, 30d (default) or 90d.

  Exemple d'appel

  {"name": "get_keyword_health", "arguments": {"id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_mention≈ 131 tokens

  Fetch a single mention by id, including its classification (relevance, sentiment, intents, confidence, uncertain, note).

  Paramètres, retour & exemple (1)

  Paramètres

  • id · string · requis
    Mention id (mention match id, mm_...)

  Exemple d'appel

  {"name": "get_mention", "arguments": {"id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_mention_stats≈ 252 tokens

  Mention counts for the last N days (default 7), grouped by platform and by sentiment, optionally filtered to one platform or keyword. Unclassified mentions appear under sentiment "unclassified".

  Paramètres, retour & exemple (3)

  Paramètres

  • platform · string · optionnel · bluesky | hackernews | github | stackoverflow | devto | reddit | x | youtube
    Only count mentions from this platform
  • keywordId · string · optionnel
    Only count mentions matching this keyword id
  • sinceDays · integer · optionnel
    Look-back window in days

  Exemple d'appel

  {"name": "get_mention_stats", "arguments": {"platform": "bluesky", "keywordId": "texte", "sinceDays": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_person≈ 301 tokens

  One person from the audience, with their counts, tags, notes and mute for your organization, their outreach (owner, stage, last contacted), plus their public profile (bio, company, location, website and linked accounts) where the platform lists it. GitHub authors are looked up today; profile is null until then. With groupId, the person as that keyword group sees them. Email addresses are not returned over MCP: profile.email is always null (the dashboard and the REST API show it where the person published it).

  Paramètres, retour & exemple (2)

  Paramètres

  • id · string · requis
    Audience author id (aut_...), from list_people or a mention's authorId
  • groupId · string · optionnel
    Scope to one keyword group (grp_...): only people who mentioned that group's keywords, with that group's own tags, notes, mute, merges, activities and segments. Omit for the whole workspace.

  Exemple d'appel

  {"name": "get_person", "arguments": {"id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_reviews_report≈ 556 tokens

  The reviews report: App Store, Google Play, Trustpilot and Google reviews the keywords collect, over a window. Totals (reviews, average stars, 1-5 distribution, replies, open 1-2 star reviews), the tags on the unhappy reviews, and one row per review page with its average stars per day or week (bucket). A review matched by two keywords counts once. Same window parameters as get_analytics_summary; compare=true adds the previous period.

  Paramètres, retour & exemple (8)

  Paramètres

  • to · string · optionnel
    Last day, YYYY-MM-DD, inclusive, in `timezone`. Default today.
  • from · string · optionnel
    First day, YYYY-MM-DD, inclusive, in `timezone`.
  • range · string · optionnel · 7d | 30d | 90d | 365d
    Preset window ending today. Ignored when from or to is given. Default 30d.
  • bucket · string · optionnel · day | week
    Series bucket: day (default up to 90 days) or week.
  • compare · boolean · optionnel
    true adds the period of the same length right before the window as `previous`.
  • timezone · string · optionnel
    IANA zone the days are cut in (Europe/Madrid). Default UTC. One offset, the zone's at the end of the window, applies to the whole window.
  • platforms · array · optionnel
    Only these platforms. Repeatable, or comma-separated; omit for every platform.
  • keywordIds · array · optionnel
    Only these keyword ids. Repeatable, or comma-separated; omit for every keyword.

  Exemple d'appel

  {"name": "get_reviews_report", "arguments": {"to": "texte", "from": "texte", "range": "7d", "bucket": "day", "compare": true, "timezone": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_share_of_voice≈ 498 tokens

  Brand against competitors: every keyword matched in the window with matched, relevant, negative and buy-intent counts and its share of brand plus competitor matches in percent (topics are counted but stay out of the split). Same window parameters as get_analytics_summary; compare=true adds the previous period's matched per keyword.

  Paramètres, retour & exemple (7)

  Paramètres

  • to · string · optionnel
    Last day, YYYY-MM-DD, inclusive, in `timezone`. Default today.
  • from · string · optionnel
    First day, YYYY-MM-DD, inclusive, in `timezone`.
  • range · string · optionnel · 7d | 30d | 90d | 365d
    Preset window ending today. Ignored when from or to is given. Default 30d.
  • compare · boolean · optionnel
    true adds the period of the same length right before the window as `previous`.
  • timezone · string · optionnel
    IANA zone the days are cut in (Europe/Madrid). Default UTC. One offset, the zone's at the end of the window, applies to the whole window.
  • platforms · array · optionnel
    Only these platforms. Repeatable, or comma-separated; omit for every platform.
  • keywordIds · array · optionnel
    Only these keyword ids. Repeatable, or comma-separated; omit for every keyword.

  Exemple d'appel

  {"name": "get_share_of_voice", "arguments": {"to": "texte", "from": "texte", "range": "7d", "compare": true, "timezone": "texte", "platforms": []}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_usage≈ 156 tokens

  The prepaid balance (ledger, pending mention charges, effective), the daily burn and the days it buys, how many keywords run and how many the wallet paused, the matches recorded today and over 30 days, and whether tracking is stopped or the balance is low. Every matched mention bills $0.008 and every active keyword $5 a month, charged daily.

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "get_usage", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_usage_breakdown≈ 934 tokens

  What the workspace consumed and was charged over a window, in USD cents at list price, grouped by ONE dimension per call: `by` = keyword (the default: days charged, mentions billed, totalCents per keyword, a deleted keyword kept with keyword.removed=true), platform, or day. `range` (7d, 30d, 90d; default 30d) reads a trailing window ending today; `month` (YYYY-MM) reads one calendar month, the shape a bill or a per-customer margin is reconciled against; `from`/`to` (YYYY-MM-DD) any window up to 366 days. `keywordIds`, `groupIds` and `platforms` narrow every number (a keyword-day has no platform, so a platform filter counts mentions and comments only). Every call also returns the window's totals (keyword-days, matched and billed mentions, list-price total, what the ledger actually debited). Rows are paged (limit, offset, total). Answer "what did keyword X cost" and "where does the money go" from it; get_usage answers "how much is left". Each keyword's running-month cost is also on get_keyword as stats.cost.

  Paramètres, retour & exemple (10)

  Paramètres

  • by · string · optionnel · day | platform | keyword | group
    The dimension to group by: day (one row per UTC day of the window), platform, keyword (default: the row a margin is computed from), or group (what a customer or a campaign cost).
  • to · string · optionnel
    Last UTC day of a custom window, YYYY-MM-DD, inclusive; never after today. Needs `from`.
  • from · string · optionnel
    First UTC day of a custom window, YYYY-MM-DD, inclusive; with `to` (default today). At most 366 days. Wins over `range` and `month`.
  • limit · integer · optionnel
    Rows per page, 1 to 500 (default 100). Only by=keyword can outgrow a page; a window has at most 90 days and a dozen platforms.
  • month · string · optionnel
    A calendar month (YYYY-MM, UTC) instead of a trailing window: from its first day to its last, or to today for the running month. A future month is a 400.
  • range · string · optionnel · 7d | 30d | 90d
    Trailing window of UTC days ending today: 7d, 30d, 90d (default 30d). Ignored when `month` is given.
  • offset · integer · optionnel
    Skip this many rows.
  • groupIds · array · optionnel
    Only these groups (grp_...): a keyword-day by the group it was metered under, a mention or a comment by its keyword's group as it is now. Repeatable, or comma-separated.
  • platforms · array · optionnel
    Only these platforms. A keyword-day belongs to no platform, so with this filter the keyword line reads 0 and only mentions and comments count. Repeatable, or comma-separated.
  • keywordIds · array · optionnel
    Only these keywords (kw_...), deleted ones included. Repeatable, or comma-separated.

  Exemple d'appel

  {"name": "get_usage_breakdown", "arguments": {"by": "day", "to": "texte", "from": "texte", "limit": 1, "month": "texte", "range": "7d"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_activities≈ 270 tokens

  The outreach log on one person, newest first: every logged contact with who reached out, the channel (email, x, linkedin, bluesky, reddit, github, call, meeting, other), when, and a short note. Check it, and the person's outreach owner, before reaching out so two teammates never contact the same person without knowing. With groupId, the log that keyword group keeps on them.

  Paramètres, retour & exemple (2)

  Paramètres

  • id · string · requis
    Audience author id (aut_...), from list_people or a mention's authorId
  • groupId · string · optionnel
    Scope to one keyword group (grp_...): only people who mentioned that group's keywords, with that group's own tags, notes, mute, merges, activities and segments. Omit for the whole workspace.

  Exemple d'appel

  {"name": "list_activities", "arguments": {"id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_alerts≈ 112 tokens

  List alert rules: what each watches (filter), whether it fires instantly or as an hourly, daily or weekly digest (mode, schedule), and which channels it sends to.

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "list_alerts", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_attention≈ 438 tokens

  What needs a person right now, newest first: a keyword whose mentions spiked in the last hour (mention.spike), whose negative share of the last 24 hours jumped (sentiment.negative_spike), that turned noisy (keyword.noisy), or a channel whose last sends all failed (channel.failing). Detected once an hour; items resolve on their own when the condition is gone. Open items by default; status "all" reads the history. Each item has a one-line title, the facts in data, and data.url pointing at the dashboard.

  Paramètres, retour & exemple (4)

  Paramètres

  • kinds · array · optionnel
    Only these kinds.
  • limit · integer · optionnel
    Items to return, 50 by default.
  • cursor · string · optionnel
    nextCursor from the previous call.
  • status · string · optionnel · open | resolved | dismissed | all
    open (default), resolved, dismissed, or all.

  Exemple d'appel

  {"name": "list_attention", "arguments": {"kinds": [], "limit": 1, "cursor": "texte", "status": "open"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_channels≈ 121 tokens

  List the channels alerts can be sent to: Slack channels, Telegram chats, email address lists, webhooks. Telegram chats connect from the dashboard (Settings, Integrations), not through the API.

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "list_channels", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_feeds≈ 266 tokens

  The RSS and Atom feeds the WORKSPACE reads (forums, communities, blogs): every keyword with readsWorkspaceFeeds (the default) gets an item of one of these feeds as a mention when the item holds its term, with its matching rules, billed like any mention. Each feed with when it was connected and how its hourly poll goes. q filters on address or title; limit and offset page, total counts.

  Paramètres, retour & exemple (3)

  Paramètres

  • q · string · optionnel
    Only feeds whose address or title contains this text, case-insensitive.
  • limit · integer · optionnel
    Feeds per page, at most 500; default 100.
  • offset · integer · optionnel
    Feeds to skip, for the next page.

  Exemple d'appel

  {"name": "list_feeds", "arguments": {"q": "texte", "limit": 1, "offset": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_groups≈ 176 tokens

  The keyword groups of the workspace, the default first: how keywords are grouped (a customer, a campaign, a product). A term may be tracked once per group; every keyword belongs to one; get_usage_breakdown by=group says what each cost. externalId finds the group carrying your own id.

  Paramètres, retour & exemple (1)

  Paramètres

  • externalId · string · optionnel
    Only the group carrying exactly this externalId.

  Exemple d'appel

  {"name": "list_groups", "arguments": {"externalId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_keywords≈ 820 tokens

  The tracked keywords of your organization with their stats, poll health, matching rules and context, plus `total`. Without arguments: every keyword, newest first. Search the term and context (q), narrow by kind, status (active, muted by a person, paused by the wallet, noisy: paused by the noise brake, capped at its monthly mention cap), platform or group (groupId), order (sort) and page (limit, offset).

  Paramètres, retour & exemple (8)

  Paramètres

  • q · string · optionnel
    Text to find in the term or in the keyword's context, case-insensitive.
  • kind · array · optionnel
    Only these kinds: brand, competitor, topic. Repeatable, or comma-separated.
  • sort · string · optionnel · newest | oldest | term | mentions | relevant | recent | lastMention
    newest: created most recently first. oldest: the reverse. term: A to Z. mentions: most matches first. relevant: most relevant matches first. recent: most matches in the last 7 days first. lastMention: newest matched post first, keywords with none last.
  • limit · integer · optionnel
    Page size, 1 to 500. Omit for every keyword after `offset`.
  • offset · integer · optionnel
    Skip this many keywords.
  • status · array · optionnel
    Only keywords in these states: active, muted, paused, capped. Repeatable, or comma-separated.
  • groupId · array · optionnel
    Only keywords in any of these groups (grp_...). Repeatable, or comma-separated.
  • platform · array · optionnel
    Only keywords tracked on any of these platforms: its term searched there (every platform when its platforms are null), or for appstore and googleplay, an app of that store among its reviewSources. Repeatable, or comma-separated.

  Exemple d'appel

  {"name": "list_keywords", "arguments": {"q": "texte", "kind": [], "sort": "newest", "limit": 1, "offset": 1, "status": []}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_ledger≈ 208 tokens

  Every movement of the prepaid balance, newest first: the welcome credit, top-ups, refunds, the daily keyword-day and mention debits, adjustments. A debit row carries the UTC day it settled and the cumulative units behind it. Cursor paged (limit up to 100). Adding funds is a checkout on the dashboard's billing page or POST /v1/billing/top-ups on the REST API.

  Paramètres, retour & exemple (2)

  Paramètres

  • limit · integer · optionnel
    Page size (default 25).
  • cursor · string · optionnel
    Opaque cursor from a previous page.

  Exemple d'appel

  {"name": "list_ledger", "arguments": {"limit": 1, "cursor": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_members≈ 115 tokens

  The people in the workspace with their role (owner, admin, member), email and user id. The user id is the value update_mention assigneeId and update_person ownerId take.

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "list_members", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_mention_comments≈ 305 tokens

  The comments under a mention's post, newest first: the whole thread, whether or not each comment names the keyword, each with its author, text, time, engagement, a light sentiment and intent read, and mentionId when the comment is itself one of your mentions. Filled from 30 minutes after the post and read again while its platform's conversations last (a day on Reddit, Hacker News and Bluesky, a week on GitHub, Stack Overflow and DEV, a month on YouTube) for relevant mentions whose keyword has comments enabled (add_keyword / update_keyword `comments`); empty otherwise. Page with cursor.

  Paramètres, retour & exemple (3)

  Paramètres

  • id · string · requis
    Mention id (mm_...)
  • limit · integer · optionnel
    Page size, 1 to 100.
  • cursor · string · optionnel
    nextCursor from the previous page.

  Exemple d'appel

  {"name": "list_mention_comments", "arguments": {"id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_people≈ 1406 tokens

  The people who wrote mentions matching your keywords: name, profile, platform, how many of their posts matched (and how many scored relevant), their sentiment split, when they were first and last seen, and where your outreach stands (owner, stage, last contacted). Filter by platform or name, find one person by handle or profile link (handle), outreach stage (stages), owner (ownerIds, "none" for unowned) or automated (bot accounts, whose posts mostly read machine-made); sort by mentions or recency. With groupId, only the people who mentioned that keyword group's keywords, with that group's own counts, tags, notes, merges and outreach. Use search_mentions with authorId to read what one person said. Email addresses are not returned over MCP: profile.email is always null (the dashboard and the REST API show it where the person published it).

  Paramètres, retour & exemple (25)

  Paramètres

  • q · string · optionnel
    Match the display name or the profile handle/url
  • tag · string · optionnel
    Only people carrying this tag
  • sort · string · optionnel · mentions | recent | reach | new
    "mentions": most matches first; "recent": last seen first; "reach": most followers first; "new": first seen most recently first
  • tags · array · optionnel
    People carrying any of these tags
  • limit · integer · optionnel
  • muted · boolean · optionnel
    true: only muted people; false: only unmuted; omit: everyone
  • since · integer · optionnel
    Only people whose first matched mention is at or after this instant (ISO 8601, or epoch ms): new voices
  • handle · string · optionnel
    Find one person by an account: a handle (@jane, u/jane) or a profile or post link (https://x.com/jane). Exact, case-insensitive; add platform to pick one platform
  • offset · integer · optionnel
    Skip this many people (paging)
  • stages · array · optionnel
    People at any of these outreach stages (not_contacted, contacted, replied, in_talks, customer, not_a_fit)
  • groupId · string · optionnel
    Scope to one keyword group (grp_...): only people who mentioned that group's keywords, with that group's own tags, notes, mute, merges, activities and segments. Omit for the whole workspace.
  • intents · array · optionnel
    At least one mention carrying any of these intents
  • ownerIds · array · optionnel
    People owned by any of these members (user ids); "none" for people nobody owns
  • platform · string · optionnel · bluesky | hackernews | github | stackoverflow | devto | reddit | x | youtube
    Only people with an account on this platform
  • automated · boolean · optionnel
    true: only people whose matched posts are mostly machine-made (bot accounts); false: only the rest
  • linkHosts · array · optionnel
    At least one mention linking to any of these hosts, the host itself or a subdomain of it (octolens.com also matches blog.octolens.com)
  • platforms · array · optionnel
    People with an account on any of these platforms
  • segmentId · string · optionnel
    A saved segment (from list_segments) applied on top of the other filters
  • minMentions · integer · optionnel
    At least this many matched mentions
  • minNegative · integer · optionnel
    At least this many negative mentions
  • keywordKinds · array · optionnel
    Mentioned a keyword of any of these kinds (brand, competitor, topic)
  • maxFollowers · integer · optionnel
  • minFollowers · integer · optionnel
    At least this many followers (unknown reach never matches)
  • newSinceDays · integer · optionnel
    First seen within this many days
  • neverKeywordKinds · array · optionnel
    Never mentioned a keyword of these kinds

  Exemple d'appel

  {"name": "list_people", "arguments": {"q": "texte", "tag": "texte", "sort": "mentions", "tags": [], "limit": 1, "muted": true}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_segments≈ 218 tokens

  Your saved audience segments (named filters such as "Influencers" or "Switch prospects"), each with the number of people in it right now, plus presets you can save with create_segment. Pass a segment id to list_people to see its members. With groupId, the segments saved in that keyword group, counted over its own people.

  Paramètres, retour & exemple (1)

  Paramètres

  • groupId · string · optionnel
    Scope to one keyword group (grp_...): only people who mentioned that group's keywords, with that group's own tags, notes, mute, merges, activities and segments. Omit for the whole workspace.

  Exemple d'appel

  {"name": "list_segments", "arguments": {"groupId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_views≈ 115 tokens

  Your saved views (named filters over mentions such as "Negative about us" or "Needs a reply"). Pass a view id as viewId to search_mentions to read exactly what it selects.

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "list_views", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• log_activity≈ 469 tokens

  Record that someone reached out to a person: an email, a DM, a call. The first contact claims an unowned person for whoever reached out and moves not_contacted to contacted; an existing owner and a later stage are kept (set them with update_person). memberId defaults to the signed-in user; with an API key and no memberId the activity is unattributed and claims nobody. Returns the activity and the person as they now read. With groupId the activity, and the owner and stage it moves, are that keyword group's own.

  Paramètres, retour & exemple (6)

  Paramètres

  • id · string · requis
    Person id (aut_...), from list_people or a mention's authorId
  • note · string · optionnel
    What was sent or said, briefly.
  • channel · string · requis · email | x | linkedin | bluesky | reddit | github | call | meeting
    How they were reached: email, x, linkedin, bluesky, reddit, github, call, meeting or other.
  • groupId · string · optionnel
    Scope to one keyword group (grp_...): only people who mentioned that group's keywords, with that group's own tags, notes, mute, merges, activities and segments. Omit for the whole workspace.
  • memberId · string · optionnel
    The member who reached out (user id). Defaults to the signed-in member; an API key that omits it logs an unattributed activity.
  • occurredAt · integer · optionnel
    When the contact happened (ISO 8601, or epoch ms). Defaults to now.

  Exemple d'appel

  {"name": "log_activity", "arguments": {"id": "texte", "channel": "email"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• merge_people≈ 257 tokens

  Declare that two accounts are the same person, for your organization only: fold account `id` into person `into`. Their mentions, tags and notes combine; the folded account shows under the person's platforms. With groupId the merge holds in that keyword group only.

  Paramètres, retour & exemple (3)

  Paramètres

  • id · string · requis
    The account to fold in (aut_...)
  • into · string · requis
    The person to fold it into (aut_...)
  • groupId · string · optionnel
    Scope to one keyword group (grp_...): only people who mentioned that group's keywords, with that group's own tags, notes, mute, merges, activities and segments. Omit for the whole workspace.

  Exemple d'appel

  {"name": "merge_people", "arguments": {"id": "texte", "into": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• mute_authors≈ 280 tokens

  Mute authors on an alert without touching the rest of its filter. Accepts profile or post links, @handles, u/names, Bluesky DIDs or display names; a link is stored as the author's profile. Already muted authors are skipped; an entry that names no person is rejected.

  Paramètres, retour & exemple (2)

  Paramètres

  • id · string · requis
    Rule id
  • authors · array · requis
    Profile or post links (x.com/name, linkedin.com/in/name, reddit.com/user/name, a post URL), handles (@name, u/name), Bluesky DIDs or display names. A link is stored as the author's profile; a plain name or handle matches that name on every platform.

  Exemple d'appel

  {"name": "mute_authors", "arguments": {"id": "texte", "authors": []}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• search_mentions≈ 6446 tokens

  Search tracked mentions for your organization. Filter by keyword, platform, status (open, ignored, done), relevant, minimum relevance, minimum confidence (0 to 1), sentiment, intent, free text (q, the post text or the author name), time range (ISO 8601), one person (personId from list_people), assignee (assigneeId), author reach (minFollowers, maxFollowers), engagement the platform reported (minLikes, minReposts, minReplies, minQuotes, minViews, minBookmarks; a post without the count never passes), review stars (ratings, or notRatings to leave some out), author tags (tags, any-of), the hosts a post links to (linkHosts, any-of, a host or any subdomain of it), Reddit subreddits (subreddits or notSubreddits, names without the r/), replies against top-level posts (isReply), posts against comments (kind: post or comment), whether the post reads as machine-made (automated=true for the bots, false for the rest), where the author is (countries, or notCountries to leave some out, lowercase ISO 3166-1 alpha-2 codes like in, us, de, as the classifier read the profile and the post; an unknown country passes notCountries), whether the author is a company or organization (organization=true for companies, brands and organizations, false for people), the language of the post (languages or notLanguages, ISO 639-1), an alert rule's whole filter (alertId, the same mentions the rule would send), a saved view's filter (viewId, from list_views, ANDed with the rest), the kind of keyword that matched (keywordKinds: brand, competitor, topic), or the keyword's group (groupIds, or notGroupIds to leave groups out; ids from list_groups). Every filter is ANDed; for OR, anyOf takes up to 10 groups of the same conditions (an object each, all its conditions ANDed) and keeps a mention when at least one group holds, on top of the rest: anyOf=[{platforms:["reddit"],sentiments:["negative"]},{intents:["buy_intent"]}]. Snoozed mentions are hidden unless snoozed=true. sort="newest" (default) or "priority" (attention score from relevance, author reach, intent and age, over the last 30 days of matches only; each mention carries it as `priority`). Returns 10 mentions by default (limit, up to 100). Each mention nests post, author, classification and triage. A cross-post (the same author posting the same text again for the same keyword within three days, like one announcement in five subreddits) is listed once: the original carries the others in duplicates; includeDuplicates=true lists them separately, each with duplicateOf. A GitHub repository event (a new repository, a star milestone, fast growth) is a mention whose post.kind is repository, with the facts in post.repository (name, event, stars, weeklyStars); kind=repository lists them alone.

  Paramètres, retour & exemple (57)

  Paramètres

  • q · string · optionnel
    Substring search in the post text or the author's name.
  • kind · string · optionnel · post | comment | repository
    Only posts (post), only comments (comment) or only GitHub repository events (repository). Omitted: all.
  • sort · string · optionnel · newest | priority
    newest: by match time, newest first. priority: by attention score, highest first; priority ranks the last 30 days of matches only, older ones stay reachable under newest. Cursors are specific to a sort.
  • tags · array · optionnel
    Only authors tagged with any of these (exact, case-sensitive), in the workspace's tags or those of the mention's own keyword group. Repeatable, or comma-separated.
  • anyOf · array · optionnel
    OR across groups: a mention passes when it meets every condition of at least one group (1 to 10 groups). The other conditions still apply to every mention: the whole filter is (other conditions) AND (group 1 OR group 2 ...). A group takes the conditions of a view filter (platforms, sentiments, intents, keywordKinds, the not lists ...), with no anyOf of its own.
  • limit · integer · optionnel
    How many mentions to return, 1 to 100. Default 10: narrow the filters before asking for more.
  • since · integer · optionnel
    Only posts published at or after this instant (ISO 8601, or epoch ms).
  • until · integer · optionnel
    Only posts published at or before this instant (ISO 8601, or epoch ms).
  • intent · string · optionnel
    Only mentions carrying this intent or topic tag (buy_intent, question, complaint, praise, comparison, churn_intent, bug_report, pricing, hiring, event, promotional, testimonial, industry_insight, launch, feedback).
  • status · string · optionnel · open | ignored | done
    Only mentions in this status. Omit for every status.
  • viewId · string · optionnel
    Apply a saved view's filter (an id from GET /v1/views) on top of the other filters, every condition ANDed: exactly what the view selects. Unknown ids are a 404.
  • alertId · string · optionnel
    Apply an alert rule's filter (an id from GET /v1/alerts) on top of the other filters: the same mentions the rule would send, for a feed-shaped export or a preview. Unknown ids are a 404.
  • intents · array · optionnel
    Only mentions carrying any of these intent or topic tags.
  • isReply · boolean · optionnel
    true: only replies and comments (posts answering another post); false: only top-level posts. Omitted: both.
  • notTags · array · optionnel
    Never authors tagged with any of these, in the workspace's tags or those of the mention's own keyword group.
  • ratings · array · optionnel
    Only app store reviews with any of these star ratings (1 to 5): ratings=1,2 is the unhappy ones. Every other post fails it.
  • snoozed · boolean · optionnel
    true: only mentions currently snoozed. Otherwise snoozed mentions stay out until they wake.
  • groupIds · array · optionnel
    Only matches of keywords in any of these groups (grp_...). Repeatable, or comma-separated.
  • minLikes · integer · optionnel
    Only posts with at least this many likes (upvotes, reactions), as the platform reported them when the post was found. A post without that count never passes.
  • minViews · integer · optionnel
    Only posts with at least this many views (plays), as the platform reported them when the post was found. A post without that count never passes.
  • personId · string · optionnel
    Only this person (an id from /v1/people), merged accounts included. Implies includeMuted.
  • platform · string · optionnel · bluesky | hackernews | github | stackoverflow | devto | reddit | x | youtube
    Only posts from this platform.
  • relevant · boolean · optionnel
    true: only mentions the classifier scored relevant; false: only the rest (unclassified included).
  • automated · boolean · optionnel
    true: only mentions that read as machine-made (a bot account, a scheduled or templated post, AI-written text); false: only the rest, mentions judged before this existed included. Omitted: everything.
  • countries · array · optionnel
    Only posts whose author is in any of these countries (ISO 3166-1 alpha-2: us, in, de), as the classifier read the author's profile and the post. A post whose country is unknown never passes.
  • keywordId · string · optionnel
    Only matches of this keyword.
  • languages · array · optionnel
    Only posts in any of these languages (ISO 639-1: en, es, de). A post whose language is unknown never passes.
  • linkHosts · array · optionnel
    Only posts linking to any of these hosts, the host itself or a subdomain of it (octolens.com also matches blog.octolens.com). Repeatable, or comma-separated.
  • minQuotes · integer · optionnel
    Only posts with at least this many quotes, as the platform reported them when the post was found. A post without that count never passes.
  • platforms · array · optionnel
    Only posts from any of these platforms.
  • sentiment · string · optionnel · positive | neutral | negative
    Only this sentiment.
  • assigneeId · string · optionnel
    Only mentions assigned to this workspace member (user id).
  • keywordIds · array · optionnel
    Only matches of any of these keywords.
  • minReplies · integer · optionnel
    Only posts with at least this many replies (comments), as the platform reported them when the post was found. A post without that count never passes.
  • minReposts · integer · optionnel
    Only posts with at least this many reposts (shares, retweets), as the platform reported them when the post was found. A post without that count never passes.
  • notIntents · array · optionnel
    Never mentions carrying these intent or topic tags.
  • notRatings · array · optionnel
    Never reviews with these star ratings (1 to 5): notRatings=5 hides the five star reviews. Posts that are not reviews still pass.
  • sentiments · array · optionnel
    Only these sentiments.
  • subreddits · array · optionnel
    Only Reddit posts from any of these subreddits: subreddits=SaaS,startups (names without the r/, any case). Every other post fails it. Repeatable, or comma-separated.
  • notGroupIds · array · optionnel
    Never matches of keywords in these groups.
  • includeMuted · boolean · optionnel
    true: include mentions by people you muted, hidden by default: muted for the workspace, or for the mention's own keyword group.
  • keywordKinds · array · optionnel
    Only matches of keywords of any of these kinds: brand, competitor, topic. Repeatable, or comma-separated.
  • maxFollowers · integer · optionnel
    Only authors with at most this many followers. Unknown reach never passes.
  • minBookmarks · integer · optionnel
    Only posts with at least this many bookmarks (saves), as the platform reported them when the post was found. A post without that count never passes.
  • minFollowers · integer · optionnel
    Only authors with at least this many followers. Unknown reach never passes.
  • minRelevance · integer · optionnel
    Only mentions scored at least this; unclassified ones are excluded.
  • notCountries · array · optionnel
    Never posts whose author is in these countries: notCountries=in. A post whose country is unknown still passes.
  • notLanguages · array · optionnel
    Never posts in these languages. A post whose language is unknown still passes.
  • notLinkHosts · array · optionnel
    Never posts linking to these hosts, the host itself or a subdomain of it.
  • notPlatforms · array · optionnel
    Never posts from these platforms.
  • organization · boolean · optionnel
    true: only posts by companies, brands and organizations (a LinkedIn company page, a GitHub organization, a business account); false: only posts by people, mentions judged before this existed included. Omitted: everything.
  • minConfidence · number · optionnel
    Only mentions whose classifier confidence is at least this, 0 to 1. Mentions without a confidence are excluded.
  • notKeywordIds · array · optionnel
    Never matches of these keywords.
  • notSentiments · array · optionnel
    Never these sentiments. A mention the classifier has not scored yet still passes.
  • notSubreddits · array · optionnel
    Never Reddit posts from these subreddits; posts from other platforms still pass.
  • excludeAuthors · array · optionnel
    Hide these authors: display names, handles or profile URLs. Repeatable, or one comma-separated value.
  • includeDuplicates · boolean · optionnel
    true: list cross-posts (a mention whose duplicateOf is set) as mentions of their own. By default each is listed only in its original's duplicates.

  Exemple d'appel

  {"name": "search_mentions", "arguments": {"q": "texte", "kind": "post", "sort": "newest", "tags": [], "anyOf": [], "limit": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• split_person≈ 209 tokens

  Undo a merge: the account becomes its own person again for your organization. A merge made in a keyword group is undone with that groupId.

  Paramètres, retour & exemple (2)

  Paramètres

  • id · string · requis
    Audience author id (aut_...), from list_people or a mention's authorId
  • groupId · string · optionnel
    Scope to one keyword group (grp_...): only people who mentioned that group's keywords, with that group's own tags, notes, mute, merges, activities and segments. Omit for the whole workspace.

  Exemple d'appel

  {"name": "split_person", "arguments": {"id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• unmute_authors≈ 260 tokens

  Unmute authors on an alert without touching the rest of its filter. Name each by the stored entry or any link to that profile or its posts; authors that are not muted are ignored.

  Paramètres, retour & exemple (2)

  Paramètres

  • id · string · requis
    Rule id
  • authors · array · requis
    Profile or post links (x.com/name, linkedin.com/in/name, reddit.com/user/name, a post URL), handles (@name, u/name), Bluesky DIDs or display names. A link is stored as the author's profile; a plain name or handle matches that name on every platform.

  Exemple d'appel

  {"name": "unmute_authors", "arguments": {"id": "texte", "authors": []}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• update_alert≈ 4412 tokens

  Change an alert: name, enabled, mode, schedule, filter (replaces the whole filter) or channelIds (replaces the whole list).

  Paramètres, retour & exemple (8)

  Paramètres

  • id · string · requis
    Rule id
  • mode · string · optionnel · instant | hourly | daily | weekly
  • name · string · optionnel
  • event · ? · optionnel
  • filter · object · optionnel
    Replaces the whole filter.
  • enabled · boolean · optionnel
  • schedule · ? · optionnel
    Daily and weekly alerts. Ignored on an hourly one, except a weekday, which is refused.
  • channelIds · array · optionnel
    Replaces the whole list.

  Exemple d'appel

  {"name": "update_alert", "arguments": {"id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• update_company≈ 467 tokens

  Update the company profile (name, description, useCases, accounts) or override the classifier context directly. Profile edits recompose the context; an explicit context wins until the next profile edit. The context is the single biggest lever on relevance scoring, so keep it accurate and specific; it does not reach keywords in a group with its own description (update_group for those). Omitted fields are untouched.

  Paramètres, retour & exemple (8)

  Paramètres

  • name · string · optionnel
  • context · string · optionnel
    Overrides the composed context until the next profile edit.
  • website · ? · optionnel
    The company website; null clears it.
  • accounts · object · optionnel
  • useCases · array · optionnel
    Replaces the whole list.
  • guidelines · ? · optionnel
    Free-text rules for the classifier; null clears them.
  • competitors · array · optionnel
    Replaces the whole list; [] clears it.
  • description · string · optionnel

  Exemple d'appel

  {"name": "update_company", "arguments": {"name": "texte", "context": "texte", "website": "texte", "accounts": {}, "useCases": [], "guidelines": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• update_feed≈ 541 tokens

  Rename a workspace feed (title; null clears it) or set its sign-in for a members-only forum (auth: { type: 'cookie', value } with the Cookie header the person's signed-in browser sends, or { type: 'header', name, value }). A sign-in is checked by reading the feed with it (feed_login_expired when it does not work), stored encrypted, never shown again, and the feed is then read for this workspace alone; auth: null removes it.

  Paramètres, retour & exemple (3)

  Paramètres

  • id · string · requis
    Feed id (fd_...), from list_feeds
  • auth · ? · optionnel
    Replaces the sign-in (checked by reading the feed with it first); null removes it and the feed is read signed out again.
  • title · ? · optionnel
    Your name for the feed; null clears it.

  Exemple d'appel

  {"name": "update_feed", "arguments": {"id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• update_filters≈ 429 tokens

  Change the workspace filters: excludedTerms (a `*` at an end is a wildcard), excludedAuthors (links, handles, names), excludedRepos (owner/name or a github.com link), subreddits.only (an allowlist; when set, excluded is ignored) and subreddits.excluded. Each list optional; an omitted list is untouched, an empty one clears it. Takes effect on new mentions within a minute.

  Paramètres, retour & exemple (4)

  Paramètres

  • subreddits · object · optionnel
    Reddit only; an omitted list is untouched.
  • excludedRepos · array · optionnel
    Replaces the list; [] clears it.
  • excludedTerms · array · optionnel
    Replaces the list; [] clears it.
  • excludedAuthors · array · optionnel
    Replaces the list; [] clears it.

  Exemple d'appel

  {"name": "update_filters", "arguments": {"subreddits": {}, "excludedRepos": [], "excludedTerms": [], "excludedAuthors": []}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• update_group≈ 516 tokens

  Rename a keyword group, change your id for it (externalId, null clears) or its company description (context, null clears: the workspace profile applies again; new mentions are judged with it at once). The default group can be renamed but takes no description: it is the workspace itself and reads the company profile (update_company).

  Paramètres, retour & exemple (4)

  Paramètres

  • id · string · requis
    Group id (grp_...)
  • name · string · optionnel
    The group's name: a customer, a campaign, a product. Unique per workspace.
  • context · ? · optionnel
    Replaces the group's company description; null clears it (the workspace profile applies again). New mentions are judged with it at once; old ones are not rescored. Not on the default group (400 default_group_context): that one is the workspace itself and reads the profile.
  • externalId · ? · optionnel
    Replaces your id for the group; null clears it.

  Exemple d'appel

  {"name": "update_group", "arguments": {"id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• update_keyword≈ 3404 tokens

  Change a keyword: rename it (term: the new term is tracked from now on, with no look-back; the keyword keeps its id, its settings and what the old term found), the platforms it is tracked on (platforms: a list, or null for every platform), mute or unmute it, reclassify it (kind), set its classifier context (null clears), or its matching rules (matching: each field optional, an empty list clears one; requiredTerms with requiredMode any|all, requiredGroups (every term of at least one combination), excludedTerms, a `*` wildcard at an end of any rule term, excludedAuthors, caseSensitive, exactPhrase: true for the exact phrase only, false to also match its words close together, subreddits: { only, excluded } for its Reddit posts alone, each list replaced when sent), or its monthly mention cap (cap: { mentions: N, per: "day" | "week" | "month" }, null removes it; a cap above the current period's count resumes a capped keyword at once), or move it to another group (groupId; a 409 when that group already tracks the term), or replace where it collects reviews, App Store, Google Play, Trustpilot or Google Maps (reviewSources: the whole list, [] disconnects them; a newly added app or country brings its last 30 days free), or replace the RSS or Atom feeds it reads (feeds: the whole list of URLs, [] disconnects them; a newly added feed brings its newest 10 matching items of the last 30 days). It also switches comments on or off (comments: { enabled, maxPerPost }; $0.008 per comment delivered). Rules apply to new mentions only. Returns the updated keyword with its stats. On GitHub a keyword also gets events about repositories naming it; matching.repositories chooses them: events (traction: a repository under 30 days old reached 10 stars; stars: a star milestone from 100 up; growth: fast growth in a week; new: every repository created, even with no stars, off by default), minStars and minWeeklyStars (stars gained in 7 days, 25 or more). An event outside the rule is dropped before it is stored, so it is never billed: "repositories about X with 200+ stars gaining 100 a week" is { events: ["stars","growth"], minStars: 200, minWeeklyStars: 100 }.

  Paramètres, retour & exemple (13)

  Paramètres

  • id · string · requis
    Keyword id
  • cap · ? · optionnel
    Replaces the mention cap and its period (per, default month); null removes it. A cap above the current period's count resumes a capped keyword at once, one at or under it pauses it.
  • kind · string · optionnel · brand | competitor | topic
    Reclassify it as brand, competitor or topic.
  • term · string · optionnel
    Renames the keyword: the new term is tracked from now on, with no look-back, and the keyword keeps its id, its settings and the mentions the old term found. Wrap it in double quotes for the exact phrase only. A 409 when its group already tracks the new term.
  • feeds · array · optionnel
    Replaces the feeds this keyword reads; [] disconnects them all (their mentions stay). A feed added here is checked now and brings its newest 10 matching items of the last 30 days; one already listed keeps its place.
  • muted · boolean · optionnel
    A muted keyword stops polling and matching; its mentions stay.
  • context · ? · optionnel
    A sentence the classifier reads for this keyword only, on top of the company profile or the group's own description (at most 300 characters): what the term means here, what to ignore. "Arc is our browser; ignore the geometry word." Null clears it.
  • groupId · string · optionnel
    Moves the keyword to this group (grp_...). A 409 when that group already tracks the term.
  • comments · object · optionnel
    Comments under this keyword's mentions; omitted fields are untouched (on create: off, 20 per post).
  • matching · object · optionnel
    Omitted fields are untouched; an empty list clears one.
  • platforms · ? · optionnel
    Replaces the platform list; null means every platform, [] none (reviews only, when the keyword has reviewSources).
  • reviewSources · array · optionnel
    Replaces the list of apps whose reviews this keyword collects; [] disconnects them all (their reviews stay). An app or country added here gets the free 30-day look-back; one already listed keeps its place.
  • readsWorkspaceFeeds · boolean · optionnel
    true: the keyword also reads the workspace's feeds (GET /v1/feeds), live from now on. false: its own feeds alone.

  Exemple d'appel

  {"name": "update_keyword", "arguments": {"id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• update_mention≈ 598 tokens

  The one write on a mention: status "ignored" (not interesting) or "done" (handled), "open" to put it back; assign it to a workspace member (assigneeId, null to unassign); snooze it out of the feed until an ISO 8601 instant (snoozedUntil, null to wake it); leave an internal note (note, null to clear); or correct the classifier with `relevant` (true or false: your verdict, which sets relevance to 100 or 0 and moves the mention in or out of the relevant feed; null withdraws it) and `sentiment` (a corrected label; null restores the classifier's). Use the verdicts when the user says a mention is noise or was missed. Omitted fields are untouched. Delivery and billing never change.

  Paramètres, retour & exemple (7)

  Paramètres

  • id · string · requis
    Mention id (mm_...)
  • note · ? · optionnel
    Internal note; null or empty clears it.
  • status · string · optionnel · open | ignored | done
    ignored or done to handle it; open to put it back.
  • relevant · boolean|null · optionnel
    Your verdict on relevance, correcting the classifier: true sets relevance to 100 and puts a filtered mention back in the relevant feed, false sets it to 0 and takes it out; null withdraws the verdict and restores the classifier's score. Never billed or unbilled. A mention still being classified answers 409 classification_pending.
  • sentiment · ? · optionnel
    Your corrected sentiment; null withdraws the correction and restores the classifier's.
  • assigneeId · ? · optionnel
    A workspace member (user id), or null to unassign.
  • snoozedUntil · ? · optionnel
    ISO 8601 (or epoch ms) until which the mention leaves the feed; null wakes it.

  Exemple d'appel

  {"name": "update_mention", "arguments": {"id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• update_person≈ 534 tokens

  Annotate a person for your organization: replace their tags, set notes, mute/unmute them, or set the outreach owner (ownerId, a member user id; null clears) and stage. Muting hides their posts from the feed and from every channel; ingest and billing are unchanged. With groupId the annotations are that keyword group's own: muted hides the person from the mentions of that group's keywords only (feed, alerts and digests), and the group's tags show on those mentions next to the workspace's. A mute set without groupId hides them for every group.

  Paramètres, retour & exemple (7)

  Paramètres

  • id · string · requis
    Audience author id (aut_...)
  • tags · array · optionnel
    Replaces the whole list.
  • muted · boolean · optionnel
    true hides their posts from the feed, the alerts and the digests; false shows them again. Without groupId, for every keyword of the workspace; with groupId, for the mentions of that group's keywords only, leaving the workspace's mute as it is.
  • notes · string · optionnel
  • stage · string · optionnel · not_contacted | contacted | replied | in_talks | customer | not_a_fit
    Where your workspace stands with the person: not_contacted, contacted, replied, in_talks, customer or not_a_fit.
  • groupId · string · optionnel
    Scope to one keyword group (grp_...): only people who mentioned that group's keywords, with that group's own tags, notes, mute, merges, activities and segments. Omit for the whole workspace.
  • ownerId · ? · optionnel
    The member who owns the contact (user id); null clears.

  Exemple d'appel

  {"name": "update_person", "arguments": {"id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• update_segment≈ 1263 tokens

  Rename, describe or refilter a saved segment. `filter` replaces the whole filter. A segment saved in a keyword group is found with that groupId.

  Paramètres, retour & exemple (5)

  Paramètres

  • id · string · requis
    Segment id (seg_...)
  • name · string · optionnel
  • filter · object · optionnel
    Replaces the whole filter.
  • groupId · string · optionnel
    Scope to one keyword group (grp_...): only people who mentioned that group's keywords, with that group's own tags, notes, mute, merges, activities and segments. Omit for the whole workspace.
  • description · string · optionnel

  Exemple d'appel

  {"name": "update_segment", "arguments": {"id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• update_view≈ 4882 tokens

  Rename, describe or refilter a saved view. `filter` replaces the whole filter.

  Paramètres, retour & exemple (4)

  Paramètres

  • id · string · requis
    View id (vw_...)
  • name · string · optionnel
  • filter · object · optionnel
    Replaces the whole filter.
  • description · string · optionnel

  Exemple d'appel

  {"name": "update_view", "arguments": {"id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• whoami≈ 134 tokens

  The workspace this credential acts on, how it authenticated (an API key or an OAuth sign-in), whether it may write, and the person behind it when there is one. Call it once at the start of a session to name the workspace and know whether write tools are available.

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "whoami", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

C'est votre serveur ?

Revendiquez-le sur l'espace créateur (preuve GitHub, domaine ou npm) pour afficher le badge « propriétaire vérifié » et lancer un pentest comportemental à la demande afin d'obtenir le badge « Vérifié ».

Créer un compte / revendiquer →

Source

https://mcp.mentio.dev/mcp