{
  "notice": "bxzxxr MCP archive: a record of what public MCP servers declared when we listed them (we never call their tools). It is data, not a rating: nothing here says a server is safe, secure, verified or trustworthy, and a server can change after we looked. Secrets we detected are redacted; redacted tool lists are withheld and only their hash is shown.",
  "infrastructure": {
    "host": "mcp.mentio.dev",
    "site": "mentio.dev",
    "addresses": [
      {
        "address": "104.21.81.42",
        "endpoints": 1,
        "shared_infrastructure": false,
        "network": {
          "asn": 13335,
          "name": "CLOUDFLARENET - Cloudflare, Inc.",
          "prefix": "104.21.64.0/19",
          "country": "US"
        }
      },
      {
        "address": "172.67.138.26",
        "endpoints": 1,
        "shared_infrastructure": false,
        "network": {
          "asn": 13335,
          "name": "CLOUDFLARENET - Cloudflare, Inc.",
          "prefix": "172.67.128.0/20",
          "country": "US"
        }
      },
      {
        "address": "2606:4700:3033::ac43:8a1a",
        "endpoints": 1,
        "shared_infrastructure": false,
        "network": {
          "asn": 13335,
          "name": "CLOUDFLARENET - Cloudflare, Inc.",
          "prefix": "2606:4700:3033::/48",
          "country": "US"
        }
      },
      {
        "address": "2606:4700:3035::6815:512a",
        "endpoints": 1,
        "shared_infrastructure": false,
        "network": {
          "asn": 13335,
          "name": "CLOUDFLARENET - Cloudflare, Inc.",
          "prefix": "2606:4700:3035::/48",
          "country": "US"
        }
      }
    ],
    "addresses_recorded": true,
    "address_history": [
      {
        "addresses": [
          "104.21.81.42",
          "172.67.138.26",
          "2606:4700:3033::ac43:8a1a",
          "2606:4700:3035::6815:512a"
        ],
        "first_seen": "2026-11-22T17:29:03.996Z",
        "last_seen": "2026-11-22T17:29:03.996Z",
        "checks": 1
      },
      {
        "addresses": [
          "172.67.138.26",
          "104.21.81.42",
          "2606:4700:3035::6815:512a",
          "2606:4700:3033::ac43:8a1a"
        ],
        "first_seen": "2026-11-21T12:28:01.672Z",
        "last_seen": "2026-11-21T12:28:01.672Z",
        "checks": 1
      }
    ],
    "hosting": [
      {
        "value": "Cloudflare",
        "evidence": "Server header \"cloudflare\""
      }
    ],
    "software": [],
    "server_info": {
      "name": "mentio-mcp",
      "version": "0.1.0",
      "protocol_version": "2025-06-18"
    },
    "headers": {
      "server": "cloudflare"
    },
    "auth": null
  },
  "related": {
    "same_address": {
      "total": 0,
      "sample": []
    },
    "same_site": {
      "total": 0,
      "sample": []
    },
    "same_tool_list": {
      "total": 0,
      "sample": []
    },
    "same_publisher": {
      "publisher": "dev.mentio",
      "total": 0,
      "sample": []
    },
    "same_repository": null,
    "note": "Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators."
  },
  "endpoint": {
    "id": "20337",
    "server_name": "dev.mentio/mcp",
    "url": "https://mcp.mentio.dev/mcp",
    "host": "mcp.mentio.dev",
    "transport": "streamable-http",
    "last_checked_at": "2026-11-22T17:29:03.996Z",
    "last_state": "listed",
    "last_detail": null,
    "consecutive_failures": 0,
    "current_sha": "0fcd5f9059b51ae4371de8d71438058b2630f74a80e5d57a487f42336c0c8358",
    "first_listed_at": "2026-11-21T12:28:01.672Z",
    "created_at": "2026-11-21T07:25:06.955Z",
    "resolved_addresses": [
      "104.21.81.42",
      "172.67.138.26",
      "2606:4700:3033::ac43:8a1a",
      "2606:4700:3035::6815:512a"
    ]
  },
  "server": {
    "name": "dev.mentio/mcp",
    "title": "Mentio",
    "description": "Social listening for agents: brand mentions across 16 platforms, scored for relevance and intent",
    "version": "1.0.0",
    "registry_status": "active",
    "repository_url": null,
    "website_url": "https://mentio.dev",
    "published_at": "2026-10-04T11:46:47.426Z",
    "updated_at": "2026-10-04T11:46:47.426Z",
    "first_seen": "2026-11-21T07:25:06.391Z"
  },
  "other_endpoints": [],
  "intel": {
    "capabilities": [],
    "evm_addresses": [],
    "chains": [],
    "tokens": [],
    "computed_at": "2026-11-22T17:29:12.993Z"
  },
  "operator": {
    "key": "mentio.dev",
    "name": "mentio.dev",
    "platform": false
  },
  "needs_sign_in": false,
  "reachability": {
    "window_days": 30,
    "checks": 2,
    "answered": 2,
    "answered_percent": 100,
    "avg_listing_latency_ms": 1249,
    "first_check_in_window": "2026-11-21T12:28:01.672Z",
    "consecutive_failures_now": 0,
    "days": [
      {
        "day": "2026-11-21",
        "checks": 1,
        "answered": 1,
        "last_state": "listed"
      },
      {
        "day": "2026-11-22",
        "checks": 1,
        "answered": 1,
        "last_state": "listed"
      }
    ]
  },
  "tool_list": {
    "sha256": "0fcd5f9059b51ae4371de8d71438058b2630f74a80e5d57a487f42336c0c8358",
    "tools": 94,
    "resources": 4,
    "prompts": 0,
    "first_seen": "2026-11-22T17:29:05.285Z",
    "tool_names": [
      "list_segments",
      "create_segment",
      "update_segment",
      "delete_segment",
      "list_views",
      "create_view",
      "update_view",
      "delete_view",
      "list_accounts",
      "add_account",
      "update_account",
      "delete_account",
      "list_followers",
      "start_search",
      "estimate_keyword",
      "get_keyword_estimate",
      "list_keyword_estimates",
      "list_searches",
      "get_search",
      "list_search_results",
      "create_export",
      "get_export",
      "list_exports",
      "update_mentions",
      "list_labels",
      "list_automations",
      "get_automation",
      "create_automation",
      "update_automation",
      "delete_automation",
      "list_groups",
      "get_group",
      "create_group",
      "update_group",
      "delete_group",
      "search_mentions",
      "get_mention",
      "list_mention_comments",
      "update_mention",
      "add_keyword",
      "add_keywords",
      "update_keyword",
      "duplicate_keyword",
      "list_feeds",
      "add_feeds",
      "update_feed",
      "delete_feed",
      "get_analytics_summary",
      "get_analytics_series",
      "get_analytics_breakdown",
      "get_share_of_voice",
      "get_reviews_report",
      "list_alerts",
      "get_alert",
      "delete_alert",
      "list_channels",
      "list_slack_channels",
      "create_channel",
      "list_attention",
      "dismiss_attention",
      "create_alert",
      "update_alert",
      "mute_authors",
      "unmute_authors",
      "list_keywords",
      "get_keyword",
      "get_keyword_health",
      "get_keyword_deletion_preview",
      "delete_keyword",
      "whoami",
      "list_members",
      "get_usage",
      "get_usage_breakdown",
      "list_ledger",
      "list_workspaces",
      "create_workspace",
      "update_workspace",
      "delete_workspace",
      "transfer_credit",
      "list_workspace_transfers",
      "list_workspace_members",
      "get_filters",
      "update_filters",
      "get_company",
      "update_company",
      "list_people",
      "get_person",
      "update_person",
      "merge_people",
      "split_person",
      "list_activities",
      "log_activity",
      "delete_activity",
      "get_mention_stats"
    ],
    "declared": {
      "tools": [
        {
          "name": "list_segments",
          "title": "List segments",
          "description": "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.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "groupId": {
                "type": "string",
                "minLength": 1,
                "description": "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."
              },
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "List segments",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "create_segment",
          "title": "Create segment",
          "description": "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.",
          "inputSchema": {
            "type": "object",
            "required": [
              "name"
            ],
            "properties": {
              "name": {
                "type": "string",
                "maxLength": 80,
                "minLength": 1,
                "description": "Segment name, unique in its scope."
              },
              "filter": {
                "type": "object",
                "default": {},
                "properties": {
                  "tags": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 40,
                      "minLength": 1
                    },
                    "maxItems": 20,
                    "description": "People carrying any of these tags."
                  },
                  "muted": {
                    "type": "boolean",
                    "description": "true: only muted people; false: only unmuted."
                  },
                  "stages": {
                    "type": "array",
                    "items": {
                      "enum": [
                        "not_contacted",
                        "contacted",
                        "replied",
                        "in_talks",
                        "customer",
                        "not_a_fit"
                      ],
                      "type": "string",
                      "description": "Where your workspace stands with the person: not_contacted, contacted, replied, in_talks, customer or not_a_fit."
                    },
                    "maxItems": 6,
                    "description": "People at any of these outreach stages."
                  },
                  "intents": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 40,
                      "minLength": 1
                    },
                    "maxItems": 10,
                    "description": "At least one mention carrying any of these intents."
                  },
                  "notTags": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 40,
                      "minLength": 1
                    },
                    "maxItems": 20,
                    "description": "Nobody carrying any of these tags."
                  },
                  "ownerIds": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 200,
                      "minLength": 1
                    },
                    "maxItems": 20,
                    "description": "People owned by any of these members (user ids); \"none\" matches people nobody owns."
                  },
                  "automated": {
                    "type": "boolean",
                    "description": "true: only people whose matched posts are mostly machine-made (bot accounts); false: only the rest."
                  },
                  "linkHosts": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 200,
                      "minLength": 1
                    },
                    "maxItems": 20,
                    "description": "At least one mention linking to any of these hosts, the host itself or a subdomain of it."
                  },
                  "notStages": {
                    "type": "array",
                    "items": {
                      "enum": [
                        "not_contacted",
                        "contacted",
                        "replied",
                        "in_talks",
                        "customer",
                        "not_a_fit"
                      ],
                      "type": "string",
                      "description": "Where your workspace stands with the person: not_contacted, contacted, replied, in_talks, customer or not_a_fit."
                    },
                    "maxItems": 6,
                    "description": "Nobody at these outreach stages."
                  },
                  "platforms": {
                    "type": "array",
                    "items": {
                      "enum": [
                        "bluesky",
                        "hackernews",
                        "github",
                        "stackoverflow",
                        "devto",
                        "reddit",
                        "x",
                        "youtube",
                        "news",
                        "linkedin",
                        "tiktok",
                        "instagram",
                        "facebook",
                        "podcasts",
                        "web",
                        "substack",
                        "producthunt",
                        "threads",
                        "mastodon",
                        "appstore",
                        "googleplay",
                        "trustpilot",
                        "googlemaps",
                        "rss"
                      ],
                      "type": "string",
                      "description": "Platform, one of:\n- Social: bluesky, x, reddit, linkedin, facebook, instagram, tiktok, threads, mastodon\n- Developer: hackernews, github, stackoverflow, devto\n- Media: news, youtube, podcasts (with transcripts), rss (keyword feeds)\n- Web: web (blogs), substack, producthunt\n- Reviews: appstore, googleplay, trustpilot, googlemaps (Google reviews)"
                    },
                    "maxItems": 20,
                    "description": "People with an account on any of these platforms."
                  },
                  "notIntents": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 40,
                      "minLength": 1
                    },
                    "maxItems": 10,
                    "description": "Nobody whose mentions carry any of these intents."
                  },
                  "minMentions": {
                    "type": "integer",
                    "minimum": 1,
                    "description": "At least this many matched mentions."
                  },
                  "minNegative": {
                    "type": "integer",
                    "minimum": 1,
                    "description": "At least this many negative mentions."
                  },
                  "notOwnerIds": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 200,
                      "minLength": 1
                    },
                    "maxItems": 20,
                    "description": "Nobody owned by these members (user ids); \"none\" drops the people nobody owns."
                  },
                  "keywordKinds": {
                    "type": "array",
                    "items": {
                      "enum": [
                        "brand",
                        "competitor",
                        "topic"
                      ],
                      "type": "string"
                    },
                    "maxItems": 3,
                    "description": "Mentioned a keyword of any of these kinds."
                  },
                  "maxFollowers": {
                    "type": "integer",
                    "minimum": 0,
                    "description": "At most this many followers. Unknown reach never matches."
                  },
                  "minFollowers": {
                    "type": "integer",
                    "minimum": 0,
                    "description": "At least this many followers. Unknown reach never matches."
                  },
                  "newSinceDays": {
                    "type": "integer",
                    "maximum": 365,
                    "minimum": 1,
                    "description": "First seen within this many days."
                  },
                  "notLinkHosts": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 200,
                      "minLength": 1
                    },
                    "maxItems": 20,
                    "description": "Nobody with a mention linking to any of these hosts, the host itself or a subdomain of it."
                  },
                  "notPlatforms": {
                    "type": "array",
                    "items": {
                      "enum": [
                        "bluesky",
                        "hackernews",
                        "github",
                        "stackoverflow",
                        "devto",
                        "reddit",
                        "x",
                        "youtube",
                        "news",
                        "linkedin",
                        "tiktok",
                        "instagram",
                        "facebook",
                        "podcasts",
                        "web",
                        "substack",
                        "producthunt",
                        "threads",
                        "mastodon",
                        "appstore",
                        "googleplay",
                        "trustpilot",
                        "googlemaps",
                        "rss"
                      ],
                      "type": "string",
                      "description": "Platform, one of:\n- Social: bluesky, x, reddit, linkedin, facebook, instagram, tiktok, threads, mastodon\n- Developer: hackernews, github, stackoverflow, devto\n- Media: news, youtube, podcasts (with transcripts), rss (keyword feeds)\n- Web: web (blogs), substack, producthunt\n- Reviews: appstore, googleplay, trustpilot, googlemaps (Google reviews)"
                    },
                    "maxItems": 20,
                    "description": "Nobody with an account on these platforms."
                  },
                  "neverKeywordKinds": {
                    "type": "array",
                    "items": {
                      "enum": [
                        "brand",
                        "competitor",
                        "topic"
                      ],
                      "type": "string"
                    },
                    "maxItems": 3,
                    "description": "Never mentioned a keyword of these kinds."
                  }
                },
                "additionalProperties": false
              },
              "groupId": {
                "type": "string",
                "minLength": 1,
                "description": "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": {
                "type": "string",
                "default": "",
                "maxLength": 500,
                "description": "What the segment is for."
              },
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              },
              "idempotencyKey": {
                "type": "string",
                "pattern": "^[\\x21-\\x7e]+$",
                "maxLength": 255,
                "minLength": 1,
                "description": "Optional. A unique value (a UUID) for this call: 1 to 255 visible ASCII characters, no spaces. Calling again with the same key and the same input within 24 hours returns the first result instead of doing it twice."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Create segment",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "update_segment",
          "title": "Update segment",
          "description": "Rename, describe or refilter a saved segment. `filter` replaces the whole filter. A segment saved in a keyword group is found with that groupId.",
          "inputSchema": {
            "type": "object",
            "required": [
              "id"
            ],
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "description": "Segment id (seg_...)"
              },
              "name": {
                "type": "string",
                "maxLength": 80,
                "minLength": 1,
                "description": "Segment name, unique in its scope."
              },
              "filter": {
                "type": "object",
                "properties": {
                  "tags": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 40,
                      "minLength": 1
                    },
                    "maxItems": 20,
                    "description": "People carrying any of these tags."
                  },
                  "muted": {
                    "type": "boolean",
                    "description": "true: only muted people; false: only unmuted."
                  },
                  "stages": {
                    "type": "array",
                    "items": {
                      "enum": [
                        "not_contacted",
                        "contacted",
                        "replied",
                        "in_talks",
                        "customer",
                        "not_a_fit"
                      ],
                      "type": "string",
                      "description": "Where your workspace stands with the person: not_contacted, contacted, replied, in_talks, customer or not_a_fit."
                    },
                    "maxItems": 6,
                    "description": "People at any of these outreach stages."
                  },
                  "intents": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 40,
                      "minLength": 1
                    },
                    "maxItems": 10,
                    "description": "At least one mention carrying any of these intents."
                  },
                  "notTags": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 40,
                      "minLength": 1
                    },
                    "maxItems": 20,
                    "description": "Nobody carrying any of these tags."
                  },
                  "ownerIds": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 200,
                      "minLength": 1
                    },
                    "maxItems": 20,
                    "description": "People owned by any of these members (user ids); \"none\" matches people nobody owns."
                  },
                  "automated": {
                    "type": "boolean",
                    "description": "true: only people whose matched posts are mostly machine-made (bot accounts); false: only the rest."
                  },
                  "linkHosts": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 200,
                      "minLength": 1
                    },
                    "maxItems": 20,
                    "description": "At least one mention linking to any of these hosts, the host itself or a subdomain of it."
                  },
                  "notStages": {
                    "type": "array",
                    "items": {
                      "enum": [
                        "not_contacted",
                        "contacted",
                        "replied",
                        "in_talks",
                        "customer",
                        "not_a_fit"
                      ],
                      "type": "string",
                      "description": "Where your workspace stands with the person: not_contacted, contacted, replied, in_talks, customer or not_a_fit."
                    },
                    "maxItems": 6,
                    "description": "Nobody at these outreach stages."
                  },
                  "platforms": {
                    "type": "array",
                    "items": {
                      "enum": [
                        "bluesky",
                        "hackernews",
                        "github",
                        "stackoverflow",
                        "devto",
                        "reddit",
                        "x",
                        "youtube",
                        "news",
                        "linkedin",
                        "tiktok",
                        "instagram",
                        "facebook",
                        "podcasts",
                        "web",
                        "substack",
                        "producthunt",
                        "threads",
                        "mastodon",
                        "appstore",
                        "googleplay",
                        "trustpilot",
                        "googlemaps",
                        "rss"
                      ],
                      "type": "string",
                      "description": "Platform, one of:\n- Social: bluesky, x, reddit, linkedin, facebook, instagram, tiktok, threads, mastodon\n- Developer: hackernews, github, stackoverflow, devto\n- Media: news, youtube, podcasts (with transcripts), rss (keyword feeds)\n- Web: web (blogs), substack, producthunt\n- Reviews: appstore, googleplay, trustpilot, googlemaps (Google reviews)"
                    },
                    "maxItems": 20,
                    "description": "People with an account on any of these platforms."
                  },
                  "notIntents": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 40,
                      "minLength": 1
                    },
                    "maxItems": 10,
                    "description": "Nobody whose mentions carry any of these intents."
                  },
                  "minMentions": {
                    "type": "integer",
                    "minimum": 1,
                    "description": "At least this many matched mentions."
                  },
                  "minNegative": {
                    "type": "integer",
                    "minimum": 1,
                    "description": "At least this many negative mentions."
                  },
                  "notOwnerIds": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 200,
                      "minLength": 1
                    },
                    "maxItems": 20,
                    "description": "Nobody owned by these members (user ids); \"none\" drops the people nobody owns."
                  },
                  "keywordKinds": {
                    "type": "array",
                    "items": {
                      "enum": [
                        "brand",
                        "competitor",
                        "topic"
                      ],
                      "type": "string"
                    },
                    "maxItems": 3,
                    "description": "Mentioned a keyword of any of these kinds."
                  },
                  "maxFollowers": {
                    "type": "integer",
                    "minimum": 0,
                    "description": "At most this many followers. Unknown reach never matches."
                  },
                  "minFollowers": {
                    "type": "integer",
                    "minimum": 0,
                    "description": "At least this many followers. Unknown reach never matches."
                  },
                  "newSinceDays": {
                    "type": "integer",
                    "maximum": 365,
                    "minimum": 1,
                    "description": "First seen within this many days."
                  },
                  "notLinkHosts": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 200,
                      "minLength": 1
                    },
                    "maxItems": 20,
                    "description": "Nobody with a mention linking to any of these hosts, the host itself or a subdomain of it."
                  },
                  "notPlatforms": {
                    "type": "array",
                    "items": {
                      "enum": [
                        "bluesky",
                        "hackernews",
                        "github",
                        "stackoverflow",
                        "devto",
                        "reddit",
                        "x",
                        "youtube",
                        "news",
                        "linkedin",
                        "tiktok",
                        "instagram",
                        "facebook",
                        "podcasts",
                        "web",
                        "substack",
                        "producthunt",
                        "threads",
                        "mastodon",
                        "appstore",
                        "googleplay",
                        "trustpilot",
                        "googlemaps",
                        "rss"
                      ],
                      "type": "string",
                      "description": "Platform, one of:\n- Social: bluesky, x, reddit, linkedin, facebook, instagram, tiktok, threads, mastodon\n- Developer: hackernews, github, stackoverflow, devto\n- Media: news, youtube, podcasts (with transcripts), rss (keyword feeds)\n- Web: web (blogs), substack, producthunt\n- Reviews: appstore, googleplay, trustpilot, googlemaps (Google reviews)"
                    },
                    "maxItems": 20,
                    "description": "Nobody with an account on these platforms."
                  },
                  "neverKeywordKinds": {
                    "type": "array",
                    "items": {
                      "enum": [
                        "brand",
                        "competitor",
                        "topic"
                      ],
                      "type": "string"
                    },
                    "maxItems": 3,
                    "description": "Never mentioned a keyword of these kinds."
                  }
                },
                "description": "Replaces the whole filter.",
                "additionalProperties": false
              },
              "groupId": {
                "type": "string",
                "minLength": 1,
                "description": "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": {
                "type": "string",
                "maxLength": 500,
                "description": "What the segment is for."
              },
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              },
              "idempotencyKey": {
                "type": "string",
                "pattern": "^[\\x21-\\x7e]+$",
                "maxLength": 255,
                "minLength": 1,
                "description": "Optional. A unique value (a UUID) for this call: 1 to 255 visible ASCII characters, no spaces. Calling again with the same key and the same input within 24 hours returns the first result instead of doing it twice."
              }
            },
            "description": "Omitted fields are untouched.",
            "additionalProperties": false
          },
          "annotations": {
            "title": "Update segment",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": true
          }
        },
        {
          "name": "delete_segment",
          "title": "Delete segment",
          "description": "Delete a saved segment. Nobody in it is affected. A segment saved in a keyword group is found with that groupId.",
          "inputSchema": {
            "type": "object",
            "required": [
              "id"
            ],
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "description": "Segment id (seg_...), from list_segments"
              },
              "groupId": {
                "type": "string",
                "minLength": 1,
                "description": "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."
              },
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              },
              "idempotencyKey": {
                "type": "string",
                "pattern": "^[\\x21-\\x7e]+$",
                "maxLength": 255,
                "minLength": 1,
                "description": "Optional. A unique value (a UUID) for this call: 1 to 255 visible ASCII characters, no spaces. Calling again with the same key and the same input within 24 hours returns the first result instead of doing it twice."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Delete segment",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": true
          }
        },
        {
          "name": "list_views",
          "title": "List views",
          "description": "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.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "List views",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "create_view",
          "title": "Create view",
          "description": "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.",
          "inputSchema": {
            "truncated": true,
            "chars": 21950
          },
          "annotations": {
            "title": "Create view",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "update_view",
          "title": "Update view",
          "description": "Rename, describe or refilter a saved view. `filter` replaces the whole filter.",
          "inputSchema": {
            "truncated": true,
            "chars": 21952
          },
          "annotations": {
            "title": "Update view",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": true
          }
        },
        {
          "name": "delete_view",
          "title": "Delete view",
          "description": "Delete a saved view. No mention is affected.",
          "inputSchema": {
            "type": "object",
            "required": [
              "id"
            ],
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "description": "View id (vw_...)"
              },
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              },
              "idempotencyKey": {
                "type": "string",
                "pattern": "^[\\x21-\\x7e]+$",
                "maxLength": 255,
                "minLength": 1,
                "description": "Optional. A unique value (a UUID) for this call: 1 to 255 visible ASCII characters, no spaces. Calling again with the same key and the same input within 24 hours returns the first result instead of doing it twice."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Delete view",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": true
          }
        },
        {
          "name": "list_accounts",
          "title": "List accounts",
          "description": "The social accounts the workspace tracks for new followers (x, bluesky, github): handle, follower count, new followers billed this month, poll state. A tracked account costs $2 a month; every new follower $0.008.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "List accounts",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "add_account",
          "title": "Add account",
          "description": "Track an account's new followers: platform (x, bluesky or github; instagram is not trackable yet) and handle (with or without @, a profile link works). The first read is a baseline (existing followers, never billed); from then on each new follower is billed at $0.008 and announced as a followers.new account event. Optional groupId (list_groups) and cap ({ followers: N } a month). Costs $2 a month: confirm with the user first. Needs a workspace that has topped up at least once (funding_required otherwise).",
          "inputSchema": {
            "type": "object",
            "required": [
              "platform",
              "handle"
            ],
            "properties": {
              "cap": {
                "anyOf": [
                  {
                    "type": "object",
                    "required": [
                      "followers"
                    ],
                    "properties": {
                      "followers": {
                        "type": "integer",
                        "maximum": 1000000,
                        "minimum": 1,
                        "description": "New followers billed in a UTC calendar month at most; past it the account stops being read until the 1st."
                      }
                    },
                    "description": "A monthly cap on billed new followers.",
                    "additionalProperties": false
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "A monthly cap on billed new followers; omit or null for none."
              },
              "handle": {
                "type": "string",
                "maxLength": 200,
                "minLength": 1,
                "description": "The handle on the platform, with or without the @; a profile link works too (https://x.com/acme, https://bsky.app/profile/acme.bsky.social)."
              },
              "groupId": {
                "type": "string",
                "minLength": 1,
                "description": "The keyword group it belongs to (grp_...); omit for the default group."
              },
              "platform": {
                "enum": [
                  "x",
                  "instagram",
                  "bluesky",
                  "github"
                ],
                "type": "string",
                "description": "x, bluesky or github. instagram is refused for now (a 400): its follower list is not readable newest first."
              },
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              },
              "idempotencyKey": {
                "type": "string",
                "pattern": "^[\\x21-\\x7e]+$",
                "maxLength": 255,
                "minLength": 1,
                "description": "Optional. A unique value (a UUID) for this call: 1 to 255 visible ASCII characters, no spaces. Calling again with the same key and the same input within 24 hours returns the first result instead of doing it twice."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Add account",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "update_account",
          "title": "Update account",
          "description": "Pause or resume a tracked account (muted), move it to a keyword group (groupId), or set its monthly follower cap (cap, null removes it).",
          "inputSchema": {
            "type": "object",
            "required": [
              "id"
            ],
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "description": "Tracked account id (acc_...)"
              },
              "cap": {
                "anyOf": [
                  {
                    "type": "object",
                    "required": [
                      "followers"
                    ],
                    "properties": {
                      "followers": {
                        "type": "integer",
                        "maximum": 1000000,
                        "minimum": 1,
                        "description": "New followers billed in a UTC calendar month at most; past it the account stops being read until the 1st."
                      }
                    },
                    "description": "A monthly cap on billed new followers.",
                    "additionalProperties": false
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Set the monthly follower cap; null removes it."
              },
              "muted": {
                "type": "boolean",
                "description": "Pause (true) or resume (false) reading and charging it."
              },
              "groupId": {
                "type": "string",
                "minLength": 1,
                "description": "Move it to this keyword group (grp_...)."
              },
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              },
              "idempotencyKey": {
                "type": "string",
                "pattern": "^[\\x21-\\x7e]+$",
                "maxLength": 255,
                "minLength": 1,
                "description": "Optional. A unique value (a UUID) for this call: 1 to 255 visible ASCII characters, no spaces. Calling again with the same key and the same input within 24 hours returns the first result instead of doing it twice."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Update account",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": true
          }
        },
        {
          "name": "delete_account",
          "title": "Delete account",
          "description": "Stop tracking an account. Its followers list goes; what was billed stays on the usage record.",
          "inputSchema": {
            "type": "object",
            "required": [
              "id"
            ],
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "description": "Tracked account id (acc_...)"
              },
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              },
              "idempotencyKey": {
                "type": "string",
                "pattern": "^[\\x21-\\x7e]+$",
                "maxLength": 255,
                "minLength": 1,
                "description": "Optional. A unique value (a UUID) for this call: 1 to 255 visible ASCII characters, no spaces. Calling again with the same key and the same input within 24 hours returns the first result instead of doing it twice."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Delete account",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": true
          }
        },
        {
          "name": "list_followers",
          "title": "List followers",
          "description": "The new followers of a tracked account (list_accounts), newest first: handle, name, bio, their own follower count, when Mentio first saw them. Filter by range, from or to (on when Mentio first saw them), minFollowers, q (text in handle, name or bio); includeBaseline adds the followers the first read found. Cursor paged.",
          "inputSchema": {
            "type": "object",
            "required": [
              "id"
            ],
            "properties": {
              "q": {
                "type": "string",
                "maxLength": 100,
                "minLength": 1,
                "description": "Text in the handle, the name or the bio."
              },
              "id": {
                "type": "string",
                "minLength": 1,
                "description": "Tracked account id (acc_...)"
              },
              "to": {
                "type": "string",
                "description": "End, inclusive: a day (YYYY-MM-DD, to its last moment in `timezone`) or an instant (ISO 8601 with its offset, or epoch ms)."
              },
              "from": {
                "type": "string",
                "description": "Start, inclusive: a day (YYYY-MM-DD, from its first moment in `timezone`) or an instant (ISO 8601 with its offset, or epoch ms)."
              },
              "limit": {
                "type": "integer",
                "default": 25,
                "maximum": 100,
                "minimum": 1,
                "description": "Page size, 1 to 100."
              },
              "range": {
                "enum": [
                  "7d",
                  "30d",
                  "90d",
                  "365d"
                ],
                "type": "string",
                "description": "A preset window ending now: 7d is today and the six days before, in `timezone`, as in the analytics reports. Ignored when from or to is given. Omit range, from and to for no window."
              },
              "cursor": {
                "type": "string",
                "description": "From the previous page's nextCursor."
              },
              "timezone": {
                "type": "string",
                "maxLength": 64,
                "description": "IANA zone that days in range, from and to are cut in (Europe/Madrid). Default UTC."
              },
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              },
              "minFollowers": {
                "type": "integer",
                "minimum": 0,
                "description": "Only followers with at least this many followers of their own."
              },
              "includeBaseline": {
                "type": "boolean",
                "description": "true: also the followers the first read found. Default false: only new ones."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "List followers",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "start_search",
          "title": "Start search",
          "description": "Search a term over the last 24h, 7d, 30d, 90d or 365d (range, default 7d) without creating a keyword: each platform that can search that far back is read once (past 30d linkedin, tiktok, facebook, threads, web, substack and instagram are skipped with reason window) (platforms to narrow; at most 25 results a platform) and every result is scored for relevance, sentiment and intents against the company profile, with kind (brand, competitor, topic: the default) and context telling the classifier what the term is. Results stay apart from the mentions: no alert, digest or report sees them. Billed $0.008 per scored result; the workspace must have topped up at least once (else funding_required) and the balance must cover the maximum (maxCostCents) (else insufficient_balance). At most 10 searches an hour. Returns the search queued: poll get_search until status is done (usually a minute or two), then read list_search_results.",
          "inputSchema": {
            "type": "object",
            "required": [
              "term"
            ],
            "properties": {
              "kind": {
                "enum": [
                  "brand",
                  "competitor",
                  "topic"
                ],
                "type": "string",
                "default": "topic",
                "description": "What the term is to you, as on a keyword: brand (your company or product), competitor, or topic (the default). The classifier judges relevance with it."
              },
              "term": {
                "type": "string",
                "maxLength": 80,
                "minLength": 2,
                "description": "The word or phrase to search, case-insensitive, matched as the phrase (written joined or as a hashtag counts). Quotes are not needed."
              },
              "range": {
                "enum": [
                  "24h",
                  "7d",
                  "30d",
                  "90d",
                  "365d"
                ],
                "type": "string",
                "default": "7d",
                "description": "How far back the search reads, ending now. See [Search](/guides/search#platforms).\n\n- 24h, 7d, 30d: every platform (instagram at most 7 days).\n- 90d, 365d: only platforms reaching that far; the others are skipped (window)."
              },
              "context": {
                "type": "string",
                "maxLength": 300,
                "description": "A sentence the classifier reads for this search only, on top of the company profile: what the term means here, what to ignore."
              },
              "platforms": {
                "type": "array",
                "items": {
                  "enum": [
                    "bluesky",
                    "hackernews",
                    "github",
                    "stackoverflow",
                    "devto",
                    "reddit",
                    "x",
                    "youtube",
                    "news",
                    "linkedin",
                    "tiktok",
                    "instagram",
                    "facebook",
                    "podcasts",
                    "web",
                    "substack",
                    "producthunt",
                    "threads",
                    "mastodon"
                  ],
                  "type": "string"
                },
                "maxItems": 19,
                "minItems": 1,
                "description": "Platforms to read; omit for all that search back in time (bluesky, hackernews, github, stackoverflow, reddit, x, youtube, linkedin, tiktok, instagram, facebook, podcasts, web, substack, threads, mastodon). devto, news and producthunt are skipped."
              },
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              },
              "idempotencyKey": {
                "type": "string",
                "pattern": "^[\\x21-\\x7e]+$",
                "maxLength": 255,
                "minLength": 1,
                "description": "Optional. A unique value (a UUID) for this call: 1 to 255 visible ASCII characters, no spaces. Calling again with the same key and the same input within 24 hours returns the first result instead of doing it twice."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Start search",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "estimate_keyword",
          "title": "Estimate keyword",
          "description": "Before adding keywords, estimate how many matched mentions up to 10 candidate terms would bring a month on each platform (platforms to narrow, default every platform; matching with requiredTerms, excludedTerms, exactPhrase as a keyword takes them) and what each would cost a month ($5 keyword fee plus $0.008 a match, as a low to high range). Numbers come from posts Mentio already reads for the term (method index, counted) or one page of the platform search extrapolated (method sample). Free by default (includePaid false): paid platforms Mentio does not read yet for the term come back skipped with reason paid. includePaid true samples them too, charged per term and platform read (web 2 cents, threads 3, reddit 5, x 5, linkedin 7, tiktok 7, facebook 10, instagram 20; maxCostCents is the most), funded workspaces only. At most 30 estimates and 60 platform samples an hour. Returns the estimate: when status is not done yet, poll get_keyword_estimate (usually under a minute).",
          "inputSchema": {
            "type": "object",
            "required": [
              "terms"
            ],
            "properties": {
              "terms": {
                "type": "array",
                "items": {
                  "type": "string",
                  "maxLength": 80,
                  "minLength": 2,
                  "description": "A candidate keyword, as you would type it (double quotes set exactPhrase for that term)."
                },
                "maxItems": 10,
                "minItems": 1,
                "description": "Up to 10 candidate keywords, each estimated on its own."
              },
              "matching": {
                "type": "object",
                "properties": {
                  "exactPhrase": {
                    "type": "boolean",
                    "description": "true: only the exact phrase matches (a term sent in double quotes sets it). false: a multi-word keyword also matches its words close together, kept and billed only when scored relevant. See [Keywords](/guides/keywords#the-exact-phrase-only)."
                  },
                  "requiredMode": {
                    "enum": [
                      "any",
                      "all"
                    ],
                    "type": "string",
                    "description": "any: at least one required term must appear. all: every one must."
                  },
                  "excludedTerms": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 80,
                      "minLength": 1
                    },
                    "maxItems": 50,
                    "description": "A post containing any of these is dropped. A `*` at the start or the end of an entry is a wildcard (beta.* matches beta.0.1; *bot matches nightlybot)."
                  },
                  "requiredTerms": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 80,
                      "minLength": 1
                    },
                    "maxItems": 50,
                    "description": "The post must ALSO contain these terms, any one of them or all of them per requiredMode. A `*` at the start or the end of an entry is a wildcard (alert* matches alerts and alerting). Empty: no requirement."
                  },
                  "requiredGroups": {
                    "type": "array",
                    "items": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "maxLength": 80,
                        "minLength": 1
                      },
                      "maxItems": 10,
                      "minItems": 1
                    },
                    "maxItems": 50,
                    "description": "Combinations: the post must ALSO contain every term of at least one group (an OR of ANDs), on top of requiredTerms, with the same phrase and wildcard rules. See [Keywords](/guides/keywords#several-searches-in-one-keyword)."
                  }
                },
                "description": "The rules the keyword would carry, as on a keyword: a sampled post must pass them to count. Omitted fields take the keyword defaults.",
                "additionalProperties": false
              },
              "platforms": {
                "type": "array",
                "items": {
                  "enum": [
                    "bluesky",
                    "hackernews",
                    "github",
                    "stackoverflow",
                    "devto",
                    "reddit",
                    "x",
                    "youtube",
                    "news",
                    "linkedin",
                    "tiktok",
                    "instagram",
                    "facebook",
                    "podcasts",
                    "web",
                    "substack",
                    "producthunt",
                    "threads",
                    "mastodon"
                  ],
                  "type": "string"
                },
                "maxItems": 19,
                "minItems": 1,
                "description": "The platforms the keyword would track; omit for every platform (what a new keyword tracks)."
              },
              "includePaid": {
                "type": "boolean",
                "default": false,
                "description": "Also sample the paid platforms. See [Keyword estimates](/guides/keyword-estimates#cost).\n\n- false (default): index numbers and free samples only; costs nothing.\n- true: also the paid platforms, 2 to 20 cents per term and platform read; funded only."
              },
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              },
              "idempotencyKey": {
                "type": "string",
                "pattern": "^[\\x21-\\x7e]+$",
                "maxLength": 255,
                "minLength": 1,
                "description": "Optional. A unique value (a UUID) for this call: 1 to 255 visible ASCII characters, no spaces. Calling again with the same key and the same input within 24 hours returns the first result instead of doing it twice."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Estimate keyword",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "get_keyword_estimate",
          "title": "Get keyword estimate",
          "description": "One keyword estimate: status (queued, running, done, failed) and per term the monthly matched-mention range (low, high), whether every platform has a number (complete), the monthly cost range, and per platform its status, reason (when skipped or failed), method (index or sample), monthly range and sample size.",
          "inputSchema": {
            "type": "object",
            "required": [
              "id"
            ],
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "description": "Estimate id (est_...)"
              },
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Get keyword estimate",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "list_keyword_estimates",
          "title": "List keyword estimates",
          "description": "The keyword estimates started in the workspace (estimate_keyword), newest first, kept 30 days; limit (default 50) and cursor (nextCursor from the previous page).",
          "inputSchema": {
            "type": "object",
            "properties": {
              "limit": {
                "type": "integer",
                "default": 50,
                "maximum": 100,
                "minimum": 1,
                "description": "Page size, 1 to 100."
              },
              "cursor": {
                "type": "string",
                "description": "nextCursor from the previous page."
              },
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "List keyword estimates",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "list_searches",
          "title": "List searches",
          "description": "The searches started in the workspace (start_search), newest first, kept 30 days; limit (default 50) and cursor (nextCursor from the previous page).",
          "inputSchema": {
            "type": "object",
            "properties": {
              "limit": {
                "type": "integer",
                "default": 50,
                "maximum": 100,
                "minimum": 1,
                "description": "Page size, 1 to 100."
              },
              "cursor": {
                "type": "string",
                "description": "nextCursor from the previous page."
              },
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "List searches",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "get_search",
          "title": "Get search",
          "description": "One search: status (queued, running, done, failed), each platform's progress (status, the reason a platform was skipped or failed, results and relevant counts), totals, costCents so far and maxCostCents.",
          "inputSchema": {
            "type": "object",
            "required": [
              "id"
            ],
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "description": "Search id (srch_...)"
              },
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Get search",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "list_search_results",
          "title": "List search results",
          "description": "The posts a search found, newest first, each with post, author, classification (relevance 0 to 100, sentiment, intents, note; null while it waits for the classifier), relevant, and alreadyInWorkspace (the post is already one of your mentions). minRelevance keeps the scored results at or above it; limit (default 50) and cursor page. Readable while the search runs.",
          "inputSchema": {
            "type": "object",
            "required": [
              "id"
            ],
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "description": "Search id (srch_...)"
              },
              "limit": {
                "type": "integer",
                "default": 50,
                "maximum": 100,
                "minimum": 1,
                "description": "Page size, 1 to 100."
              },
              "cursor": {
                "type": "string",
                "description": "nextCursor from the previous page."
              },
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              },
              "minRelevance": {
                "type": "integer",
                "maximum": 100,
                "minimum": 0,
                "description": "Only results scored at least this relevant (0 to 100); unscored results are left out when set."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "List search results",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "create_export",
          "title": "Create export",
          "description": "Export the mentions a filter selects to a file in the background, for more than search_mentions pages comfortably hold: format csv (spreadsheet columns) or jsonl (one whole mention per line), up to 1,000,000 rows (maxRows), newest matched first. filter takes the search_mentions filters as an object (viewId and alertId too; {} is every mention). Not billed. At most 2 running at once and 3,000,000 rows a day per workspace. Returns the export queued: poll get_export until status is succeeded, then hand the person download.url (a signed link valid for an hour).",
          "inputSchema": {
            "type": "object",
            "properties": {
              "filter": {
                "type": "object",
                "default": {},
                "properties": {
                  "q": {
                    "type": "string",
                    "description": "Substring search in the post text or the author's name."
                  },
                  "to": {
                    "type": "string",
                    "description": "End, inclusive: a day (YYYY-MM-DD, to its last moment in `timezone`) or an instant (ISO 8601 with its offset, or epoch ms)."
                  },
                  "from": {
                    "type": "string",
                    "description": "Start, inclusive: a day (YYYY-MM-DD, from its first moment in `timezone`) or an instant (ISO 8601 with its offset, or epoch ms)."
                  },
                  "kind": {
                    "enum": [
                      "post",
                      "comment",
                      "repository"
                    ],
                    "type": "string",
                    "description": "Only posts (post), only comments (comment) or only GitHub repository events (repository). Omitted: all."
                  },
                  "tags": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 200,
                      "minLength": 1
                    },
                    "maxItems": 20,
                    "description": "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": {
                    "type": "string",
                    "description": "OR across groups of conditions, as URL-encoded JSON: a mention passes when one group holds, on top of every other filter. Each group holds view-filter conditions, no nesting. See [anyOf](/conventions#or-across-groups-anyof)."
                  },
                  "range": {
                    "enum": [
                      "7d",
                      "30d",
                      "90d",
                      "365d"
                    ],
                    "type": "string",
                    "description": "A preset window ending now: 7d is today and the six days before, in `timezone`, as in the analytics reports. Ignored when from or to is given. Omit range, from and to for no window."
                  },
                  "since": {
                    "type": "integer",
                    "description": "Deprecated: use from. Only posts published at or after this instant (ISO 8601, or epoch ms)."
                  },
                  "until": {
                    "type": "integer",
                    "description": "Deprecated: use to. Only posts published at or before this instant (ISO 8601, or epoch ms)."
                  },
                  "intent": {
                    "type": "string",
                    "description": "Deprecated: use intents. Only mentions carrying this intent or topic tag, combined with intents as either (buy_intent, question, complaint, praise, comparison, churn_intent, bug_report, pricing, hiring, event, promotional, testimonial, industry_insight, launch, feedback)."
                  },
                  "labels": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 200,
                      "minLength": 1
                    },
                    "maxItems": 20,
                    "description": "Only mentions carrying any of these labels (exact, case-sensitive). Repeatable, or comma-separated."
                  },
                  "status": {
                    "enum": [
                      "open",
                      "ignored",
                      "done"
                    ],
                    "type": "string",
                    "description": "Only mentions in this status. Omit for every status."
                  },
                  "viewId": {
                    "type": "string",
                    "minLength": 1,
                    "description": "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": {
                    "type": "string",
                    "minLength": 1,
                    "description": "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": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 200,
                      "minLength": 1
                    },
                    "maxItems": 20,
                    "description": "Only mentions carrying any of these intent or topic tags."
                  },
                  "isReply": {
                    "type": "boolean",
                    "description": "true: only replies and comments (posts answering another post); false: only top-level posts. Omitted: both."
                  },
                  "notTags": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 200,
                      "minLength": 1
                    },
                    "maxItems": 20,
                    "description": "Never authors tagged with any of these, in the workspace's tags or those of the mention's own keyword group."
                  },
                  "ratings": {
                    "type": "array",
                    "items": {
                      "type": "integer",
                      "maximum": 5,
                      "minimum": 1
                    },
                    "maxItems": 5,
                    "description": "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": {
                    "type": "boolean",
                    "description": "true: only mentions currently snoozed. Otherwise snoozed mentions stay out until they wake."
                  },
                  "emotions": {
                    "type": "array",
                    "items": {
                      "enum": [
                        "joy",
                        "trust",
                        "anticipation",
                        "surprise",
                        "confusion",
                        "frustration",
                        "anger",
                        "fear",
                        "sadness",
                        "neutral"
                      ],
                      "type": "string",
                      "description": "An emotion toward the keyword (see classification.emotion)."
                    },
                    "maxItems": 10,
                    "description": "Only mentions showing any of these emotions toward the keyword (joy, trust, anticipation, surprise, confusion, frustration, anger, fear, sadness, neutral). A mention whose emotion was not judged never passes."
                  },
                  "groupIds": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 200,
                      "minLength": 1
                    },
                    "maxItems": 50,
                    "description": "Only matches of keywords in any of these groups (grp_...). Repeatable, or comma-separated."
                  },
                  "minLikes": {
                    "type": "integer",
                    "minimum": 0,
                    "description": "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": {
                    "type": "integer",
                    "minimum": 0,
                    "description": "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": {
                    "type": "string",
                    "minLength": 1,
                    "description": "Only this person (an id from /v1/people), merged accounts included. Implies includeMuted."
                  },
                  "platform": {
                    "enum": [
                      "bluesky",
                      "hackernews",
                      "github",
                      "stackoverflow",
                      "devto",
                      "reddit",
                      "x",
                      "youtube",
                      "news",
                      "linkedin",
                      "tiktok",
                      "instagram",
                      "facebook",
                      "podcasts",
                      "web",
                      "substack",
                      "producthunt",
                      "threads",
                      "mastodon",
                      "appstore",
                      "googleplay",
                      "trustpilot",
                      "googlemaps",
                      "rss"
                    ],
                    "type": "string",
                    "description": "Deprecated: use platforms. Only posts from this platform; combines with platforms as either."
                  },
                  "relevant": {
                    "type": "boolean",
                    "description": "true: only mentions the classifier scored relevant; false: only the rest (unclassified included)."
                  },
                  "timezone": {
                    "type": "string",
                    "maxLength": 64,
                    "description": "IANA zone that days in range, from and to are cut in (Europe/Madrid). Default UTC."
                  },
                  "automated": {
                    "type": "boolean",
                    "description": "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": {
                    "type": "array",
                    "items": {
                      "enum": [
                        "us",
                        "ca",
                        "mx",
                        "br",
                        "ar",
                        "co",
                        "cl",
                        "pe",
                        "gb",
                        "ie",
                        "fr",
                        "de",
                        "es",
                        "pt",
                        "it",
                        "nl",
                        "be",
                        "ch",
                        "at",
                        "se",
                        "no",
                        "dk",
                        "fi",
                        "pl",
                        "cz",
                        "ro",
                        "gr",
                        "hu",
                        "ua",
                        "ru",
                        "lt",
                        "lv",
                        "ee",
                        "tr",
                        "il",
                        "ae",
                        "sa",
                        "eg",
                        "ng",
                        "ke",
                        "za",
                        "ma",
                        "in",
                        "pk",
                        "bd",
                        "lk",
                        "np",
                        "cn",
                        "hk",
                        "tw",
                        "jp",
                        "kr",
                        "sg",
                        "my",
                        "id",
                        "ph",
                        "vn",
                        "th",
                        "au",
                        "nz"
                      ],
                      "type": "string"
                    },
                    "maxItems": 100,
                    "description": "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": {
                    "type": "string",
                    "description": "Deprecated: use keywordIds. Only matches of this keyword; combines with keywordIds as either."
                  },
                  "languages": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "pattern": "^[a-z]{2}$"
                    },
                    "maxItems": 20,
                    "description": "Only posts in any of these languages (ISO 639-1: en, es, de). A post whose language is unknown never passes."
                  },
                  "linkHosts": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 200,
                      "minLength": 1
                    },
                    "maxItems": 20,
                    "description": "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": {
                    "type": "integer",
                    "minimum": 0,
                    "description": "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."
                  },
                  "notLabels": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 200,
                      "minLength": 1
                    },
                    "maxItems": 20,
                    "description": "Never mentions carrying any of these labels. Repeatable, or comma-separated."
                  },
                  "platforms": {
                    "type": "array",
                    "items": {
                      "enum": [
                        "bluesky",
                        "hackernews",
                        "github",
                        "stackoverflow",
                        "devto",
                        "reddit",
                        "x",
                        "youtube",
                        "news",
                        "linkedin",
                        "tiktok",
                        "instagram",
                        "facebook",
                        "podcasts",
                        "web",
                        "substack",
                        "producthunt",
                        "threads",
                        "mastodon",
                        "appstore",
                        "googleplay",
                        "trustpilot",
                        "googlemaps",
                        "rss"
                      ],
                      "type": "string",
                      "description": "Platform, one of:\n- Social: bluesky, x, reddit, linkedin, facebook, instagram, tiktok, threads, mastodon\n- Developer: hackernews, github, stackoverflow, devto\n- Media: news, youtube, podcasts (with transcripts), rss (keyword feeds)\n- Web: web (blogs), substack, producthunt\n- Reviews: appstore, googleplay, trustpilot, googlemaps (Google reviews)"
                    },
                    "maxItems": 20,
                    "description": "Only posts from any of these platforms."
                  },
                  "sentiment": {
                    "enum": [
                      "positive",
                      "neutral",
                      "negative"
                    ],
                    "type": "string",
                    "description": "Deprecated: use sentiments. Only this sentiment; combines with sentiments as either."
                  },
                  "assigneeId": {
                    "type": "string",
                    "minLength": 1,
                    "description": "Only mentions assigned to this workspace member (user id)."
                  },
                  "keywordIds": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 200,
                      "minLength": 1
                    },
                    "maxItems": 50,
                    "description": "Only matches of any of these keywords."
                  },
                  "minReplies": {
                    "type": "integer",
                    "minimum": 0,
                    "description": "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": {
                    "type": "integer",
                    "minimum": 0,
                    "description": "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."
                  },
                  "notAuthors": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 200,
                      "minLength": 1
                    },
                    "maxItems": 200,
                    "description": "Hide these authors: display names, handles or profile URLs. Repeatable, or one comma-separated value."
                  },
                  "notIntents": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 200,
                      "minLength": 1
                    },
                    "maxItems": 20,
                    "description": "Never mentions carrying these intent or topic tags."
                  },
                  "notRatings": {
                    "type": "array",
                    "items": {
                      "type": "integer",
                      "maximum": 5,
                      "minimum": 1
                    },
                    "maxItems": 5,
                    "description": "Never reviews with these star ratings (1 to 5): notRatings=5 hides the five star reviews. Posts that are not reviews still pass."
                  },
                  "sentiments": {
                    "type": "array",
                    "items": {
                      "enum": [
                        "positive",
                        "neutral",
                        "negative"
                      ],
                      "type": "string",
                      "description": "Classifier sentiment."
                    },
                    "maxItems": 3,
                    "description": "Only these sentiments."
                  },
                  "subreddits": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 200,
                      "minLength": 1
                    },
                    "maxItems": 50,
                    "description": "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."
                  },
                  "notEmotions": {
                    "type": "array",
                    "items": {
                      "enum": [
                        "joy",
                        "trust",
                        "anticipation",
                        "surprise",
                        "confusion",
                        "frustration",
                        "anger",
                        "fear",
                        "sadness",
                        "neutral"
                      ],
                      "type": "string",
                      "description": "An emotion toward the keyword (see classification.emotion)."
                    },
                    "maxItems": 10,
                    "description": "Never these emotions. A mention whose emotion was not judged still passes."
                  },
                  "notGroupIds": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 200,
                      "minLength": 1
                    },
                    "maxItems": 50,
                    "description": "Never matches of keywords in these groups."
                  },
                  "includeMuted": {
                    "type": "boolean",
                    "description": "true: include mentions by people you muted, hidden by default: muted for the workspace, or for the mention's own keyword group."
                  },
                  "keywordKinds": {
                    "type": "array",
                    "items": {
                      "enum": [
                        "brand",
                        "competitor",
                        "topic"
                      ],
                      "type": "string"
                    },
                    "maxItems": 3,
                    "description": "Only matches of keywords of any of these kinds: brand, competitor, topic. Repeatable, or comma-separated."
                  },
                  "maxFollowers": {
                    "type": "integer",
                    "minimum": 0,
                    "description": "Only authors with at most this many followers. Unknown reach never passes."
                  },
                  "minBookmarks": {
                    "type": "integer",
                    "minimum": 0,
                    "description": "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": {
                    "type": "integer",
                    "minimum": 0,
                    "description": "Only authors with at least this many followers. Unknown reach never passes."
                  },
                  "minRelevance": {
                    "type": "integer",
                    "maximum": 100,
                    "minimum": 0,
                    "description": "Only mentions scored at least this; unclassified ones are excluded."
                  },
                  "notCountries": {
                    "type": "array",
                    "items": {
                      "enum": [
                        "us",
                        "ca",
                        "mx",
                        "br",
                        "ar",
                        "co",
                        "cl",
                        "pe",
                        "gb",
                        "ie",
                        "fr",
                        "de",
                        "es",
                        "pt",
                        "it",
                        "nl",
                        "be",
                        "ch",
                        "at",
                        "se",
                        "no",
                        "dk",
                        "fi",
                        "pl",
                        "cz",
                        "ro",
                        "gr",
                        "hu",
                        "ua",
                        "ru",
                        "lt",
                        "lv",
                        "ee",
                        "tr",
                        "il",
                        "ae",
                        "sa",
                        "eg",
                        "ng",
                        "ke",
                        "za",
                        "ma",
                        "in",
                        "pk",
                        "bd",
                        "lk",
                        "np",
                        "cn",
                        "hk",
                        "tw",
                        "jp",
                        "kr",
                        "sg",
                        "my",
                        "id",
                        "ph",
                        "vn",
                        "th",
                        "au",
                        "nz"
                      ],
                      "type": "string"
                    },
                    "maxItems": 100,
                    "description": "Never posts whose author is in these countries: notCountries=in. A post whose country is unknown still passes."
                  },
                  "notLanguages": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "pattern": "^[a-z]{2}$"
                    },
                    "maxItems": 20,
                    "description": "Never posts in these languages. A post whose language is unknown still passes."
                  },
                  "notLinkHosts": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 200,
                      "minLength": 1
                    },
                    "maxItems": 20,
                    "description": "Never posts linking to these hosts, the host itself or a subdomain of it."
                  },
                  "notPlatforms": {
                    "type": "array",
                    "items": {
                      "enum": [
                        "bluesky",
                        "hackernews",
                        "github",
                        "stackoverflow",
                        "devto",
                        "reddit",
                        "x",
                        "youtube",
                        "news",
                        "linkedin",
                        "tiktok",
                        "instagram",
                        "facebook",
                        "podcasts",
                        "web",
                        "substack",
                        "producthunt",
                        "threads",
                        "mastodon",
                        "appstore",
                        "googleplay",
                        "trustpilot",
                        "googlemaps",
                        "rss"
                      ],
                      "type": "string",
                      "description": "Platform, one of:\n- Social: bluesky, x, reddit, linkedin, facebook, instagram, tiktok, threads, mastodon\n- Developer: hackernews, github, stackoverflow, devto\n- Media: news, youtube, podcasts (with transcripts), rss (keyword feeds)\n- Web: web (blogs), substack, producthunt\n- Reviews: appstore, googleplay, trustpilot, googlemaps (Google reviews)"
                    },
                    "maxItems": 20,
                    "description": "Never posts from these platforms."
                  },
                  "organization": {
                    "type": "boolean",
                    "description": "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."
                  },
                  "includeHidden": {
                    "type": "boolean",
                    "description": "true: include mentions their keyword's display lists hide (a language or country it does not show), hidden by default."
                  },
                  "minConfidence": {
                    "type": "number",
                    "maximum": 1,
                    "minimum": 0,
                    "description": "Only mentions whose classifier confidence is at least this, 0 to 1. Mentions without a confidence are excluded."
                  },
                  "notKeywordIds": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 200,
                      "minLength": 1
                    },
                    "maxItems": 50,
                    "description": "Never matches of these keywords."
                  },
                  "notSentiments": {
                    "type": "array",
                    "items": {
                      "enum": [
                        "positive",
                        "neutral",
                        "negative"
                      ],
                      "type": "string",
                      "description": "Classifier sentiment."
                    },
                    "maxItems": 3,
                    "description": "Never these sentiments. A mention the classifier has not scored yet still passes."
                  },
                  "notSubreddits": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 200,
                      "minLength": 1
                    },
                    "maxItems": 50,
                    "description": "Never Reddit posts from these subreddits; posts from other platforms still pass."
                  },
                  "excludeAuthors": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 200,
                      "minLength": 1
                    },
                    "maxItems": 200,
                    "description": "Deprecated: use notAuthors, the same filter. Both may be sent; every author named in either is hidden."
                  },
                  "notKeywordKinds": {
                    "type": "array",
                    "items": {
                      "enum": [
                        "brand",
                        "competitor",
                        "topic"
                      ],
                      "type": "string"
                    },
                    "maxItems": 3,
                    "description": "Never matches of keywords of these kinds. Repeatable, or comma-separated."
                  },
                  "includeDuplicates": {
                    "type": "boolean",
                    "description": "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."
                  }
                },
                "description": "Which mentions: every filter of GET /v1/mentions, in the same vocabulary (a list as an array or comma-separated), viewId and alertId included. {} is every mention the list shows.",
                "additionalProperties": false
              },
              "format": {
                "enum": [
                  "csv",
                  "jsonl"
                ],
                "type": "string",
                "default": "csv",
                "description": "csv: the spreadsheet columns of GET /v1/mentions/export.csv, text cut at 1,000 characters. jsonl: one whole Mention object per line (newline-delimited JSON), as GET /v1/mentions returns it."
              },
              "maxRows": {
                "type": "integer",
                "maximum": 1000000,
                "minimum": 1,
                "description": "Stop after this many rows, newest matched first. At most 1,000,000, the default."
              },
              "resource": {
                "enum": [
                  "mentions"
                ],
                "type": "string",
                "default": "mentions",
                "description": "What is exported: mentions."
              },
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              },
              "idempotencyKey": {
                "type": "string",
                "pattern": "^[\\x21-\\x7e]+$",
                "maxLength": 255,
                "minLength": 1,
                "description": "Optional. A unique value (a UUID) for this call: 1 to 255 visible ASCII characters, no spaces. Calling again with the same key and the same input within 24 hours returns the first result instead of doing it twice."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Create export",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "get_export",
          "title": "Get export",
          "description": "One export: status (queued, running, succeeded, failed, expired), stats (rows and bytes written so far), truncated (more matched than it holds), error, and once succeeded download.url, a signed link to the file that works without a key for an hour (call again for a fresh one). Files are kept 7 days.",
          "inputSchema": {
            "type": "object",
            "required": [
              "id"
            ],
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "description": "Export id (exp_...)"
              },
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Get export",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "list_exports",
          "title": "List exports",
          "description": "The workspace's exports (create_export and scheduled runs), newest first, kept 90 days; limit (default 50) and cursor (nextCursor from the previous page).",
          "inputSchema": {
            "type": "object",
            "properties": {
              "limit": {
                "type": "integer",
                "default": 50,
                "maximum": 100,
                "minimum": 1,
                "description": "Page size, 1 to 100."
              },
              "cursor": {
                "type": "string",
                "description": "nextCursor from the previous page."
              },
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "List exports",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "update_mentions",
          "title": "Update mentions",
          "description": "One change to many mentions at once: status (\"ignored\", \"done\", \"open\"), assigneeId (a member, null to unassign), addLabels and removeLabels (removals first, so moving a label is one call). Name the mentions by ids (up to 100, from search_mentions; all of it lands or none of it does, unknown ids come back in notFound) OR by filter, the search_mentions filters as an object, to act on everything they select (\"mark all open mentions as done\": filter {status: \"open\"}, update {status: \"done\"}): up to 1,000 a call, newest first, and while nextCursor comes back call again with the same filter and that cursor. A mention still being classified keeps its status (it is listed in pending) but takes the labels and assignee. Use it to triage a page of results, clear an inbox, or label mentions that existed before an automation.",
          "inputSchema": {
            "type": "object",
            "required": [
              "update"
            ],
            "properties": {
              "ids": {
                "type": "array",
                "items": {
                  "type": "string",
                  "minLength": 1
                },
                "maxItems": 100,
                "minItems": 1,
                "description": "Mention ids (mm_...), 1 to 100: a page of GET /v1/mentions. Send ids or filter, never both."
              },
              "cursor": {
                "type": "string",
                "minLength": 1,
                "description": "With filter only: nextCursor from the previous call, to carry on where it stopped."
              },
              "filter": {
                "type": "object",
                "properties": {
                  "q": {
                    "type": "string",
                    "description": "Substring search in the post text or the author's name."
                  },
                  "to": {
                    "type": "string",
                    "description": "End, inclusive: a day (YYYY-MM-DD, to its last moment in `timezone`) or an instant (ISO 8601 with its offset, or epoch ms)."
                  },
                  "from": {
                    "type": "string",
                    "description": "Start, inclusive: a day (YYYY-MM-DD, from its first moment in `timezone`) or an instant (ISO 8601 with its offset, or epoch ms)."
                  },
                  "kind": {
                    "enum": [
                      "post",
                      "comment",
                      "repository"
                    ],
                    "type": "string",
                    "description": "Only posts (post), only comments (comment) or only GitHub repository events (repository). Omitted: all."
                  },
                  "tags": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 200,
                      "minLength": 1
                    },
                    "maxItems": 20,
                    "description": "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": {
                    "type": "string",
                    "description": "OR across groups of conditions, as URL-encoded JSON: a mention passes when one group holds, on top of every other filter. Each group holds view-filter conditions, no nesting. See [anyOf](/conventions#or-across-groups-anyof)."
                  },
                  "range": {
                    "enum": [
                      "7d",
                      "30d",
                      "90d",
                      "365d"
                    ],
                    "type": "string",
                    "description": "A preset window ending now: 7d is today and the six days before, in `timezone`, as in the analytics reports. Ignored when from or to is given. Omit range, from and to for no window."
                  },
                  "since": {
                    "type": "integer",
                    "description": "Deprecated: use from. Only posts published at or after this instant (ISO 8601, or epoch ms)."
                  },
                  "until": {
                    "type": "integer",
                    "description": "Deprecated: use to. Only posts published at or before this instant (ISO 8601, or epoch ms)."
                  },
                  "intent": {
                    "type": "string",
                    "description": "Deprecated: use intents. Only mentions carrying this intent or topic tag, combined with intents as either (buy_intent, question, complaint, praise, comparison, churn_intent, bug_report, pricing, hiring, event, promotional, testimonial, industry_insight, launch, feedback)."
                  },
                  "labels": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 200,
                      "minLength": 1
                    },
                    "maxItems": 20,
                    "description": "Only mentions carrying any of these labels (exact, case-sensitive). Repeatable, or comma-separated."
                  },
                  "status": {
                    "enum": [
                      "open",
                      "ignored",
                      "done"
                    ],
                    "type": "string",
                    "description": "Only mentions in this status. Omit for every status."
                  },
                  "viewId": {
                    "type": "string",
                    "minLength": 1,
                    "description": "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": {
                    "type": "string",
                    "minLength": 1,
                    "description": "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": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 200,
                      "minLength": 1
                    },
                    "maxItems": 20,
                    "description": "Only mentions carrying any of these intent or topic tags."
                  },
                  "isReply": {
                    "type": "boolean",
                    "description": "true: only replies and comments (posts answering another post); false: only top-level posts. Omitted: both."
                  },
                  "notTags": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 200,
                      "minLength": 1
                    },
                    "maxItems": 20,
                    "description": "Never authors tagged with any of these, in the workspace's tags or those of the mention's own keyword group."
                  },
                  "ratings": {
                    "type": "array",
                    "items": {
                      "type": "integer",
                      "maximum": 5,
                      "minimum": 1
                    },
                    "maxItems": 5,
                    "description": "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": {
                    "type": "boolean",
                    "description": "true: only mentions currently snoozed. Otherwise snoozed mentions stay out until they wake."
                  },
                  "emotions": {
                    "type": "array",
                    "items": {
                      "enum": [
                        "joy",
                        "trust",
                        "anticipation",
                        "surprise",
                        "confusion",
                        "frustration",
                        "anger",
                        "fear",
                        "sadness",
                        "neutral"
                      ],
                      "type": "string",
                      "description": "An emotion toward the keyword (see classification.emotion)."
                    },
                    "maxItems": 10,
                    "description": "Only mentions showing any of these emotions toward the keyword (joy, trust, anticipation, surprise, confusion, frustration, anger, fear, sadness, neutral). A mention whose emotion was not judged never passes."
                  },
                  "groupIds": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 200,
                      "minLength": 1
                    },
                    "maxItems": 50,
                    "description": "Only matches of keywords in any of these groups (grp_...). Repeatable, or comma-separated."
                  },
                  "minLikes": {
                    "type": "integer",
                    "minimum": 0,
                    "description": "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": {
                    "type": "integer",
                    "minimum": 0,
                    "description": "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": {
                    "type": "string",
                    "minLength": 1,
                    "description": "Only this person (an id from /v1/people), merged accounts included. Implies includeMuted."
                  },
                  "platform": {
                    "enum": [
                      "bluesky",
                      "hackernews",
                      "github",
                      "stackoverflow",
                      "devto",
                      "reddit",
                      "x",
                      "youtube",
                      "news",
                      "linkedin",
                      "tiktok",
                      "instagram",
                      "facebook",
                      "podcasts",
                      "web",
                      "substack",
                      "producthunt",
                      "threads",
                      "mastodon",
                      "appstore",
                      "googleplay",
                      "trustpilot",
                      "googlemaps",
                      "rss"
                    ],
                    "type": "string",
                    "description": "Deprecated: use platforms. Only posts from this platform; combines with platforms as either."
                  },
                  "relevant": {
                    "type": "boolean",
                    "description": "true: only mentions the classifier scored relevant; false: only the rest (unclassified included)."
                  },
                  "timezone": {
                    "type": "string",
                    "maxLength": 64,
                    "description": "IANA zone that days in range, from and to are cut in (Europe/Madrid). Default UTC."
                  },
                  "automated": {
                    "type": "boolean",
                    "description": "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": {
                    "type": "array",
                    "items": {
                      "enum": [
                        "us",
                        "ca",
                        "mx",
                        "br",
                        "ar",
                        "co",
                        "cl",
                        "pe",
                        "gb",
                        "ie",
                        "fr",
                        "de",
                        "es",
                        "pt",
                        "it",
                        "nl",
                        "be",
                        "ch",
                        "at",
                        "se",
                        "no",
                        "dk",
                        "fi",
                        "pl",
                        "cz",
                        "ro",
                        "gr",
                        "hu",
                        "ua",
                        "ru",
                        "lt",
                        "lv",
                        "ee",
                        "tr",
                        "il",
                        "ae",
                        "sa",
                        "eg",
                        "ng",
                        "ke",
                        "za",
                        "ma",
                        "in",
                        "pk",
                        "bd",
                        "lk",
                        "np",
                        "cn",
                        "hk",
                        "tw",
                        "jp",
                        "kr",
                        "sg",
                        "my",
                        "id",
                        "ph",
                        "vn",
                        "th",
                        "au",
                        "nz"
                      ],
                      "type": "string"
                    },
                    "maxItems": 100,
                    "description": "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": {
                    "type": "string",
                    "description": "Deprecated: use keywordIds. Only matches of this keyword; combines with keywordIds as either."
                  },
                  "languages": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "pattern": "^[a-z]{2}$"
                    },
                    "maxItems": 20,
                    "description": "Only posts in any of these languages (ISO 639-1: en, es, de). A post whose language is unknown never passes."
                  },
                  "linkHosts": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 200,
                      "minLength": 1
                    },
                    "maxItems": 20,
                    "description": "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": {
                    "type": "integer",
                    "minimum": 0,
                    "description": "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."
                  },
                  "notLabels": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 200,
                      "minLength": 1
                    },
                    "maxItems": 20,
                    "description": "Never mentions carrying any of these labels. Repeatable, or comma-separated."
                  },
                  "platforms": {
                    "type": "array",
                    "items": {
                      "enum": [
                        "bluesky",
                        "hackernews",
                        "github",
                        "stackoverflow",
                        "devto",
                        "reddit",
                        "x",
                        "youtube",
                        "news",
                        "linkedin",
                        "tiktok",
                        "instagram",
                        "facebook",
                        "podcasts",
                        "web",
                        "substack",
                        "producthunt",
                        "threads",
                        "mastodon",
                        "appstore",
                        "googleplay",
                        "trustpilot",
                        "googlemaps",
                        "rss"
                      ],
                      "type": "string",
                      "description": "Platform, one of:\n- Social: bluesky, x, reddit, linkedin, facebook, instagram, tiktok, threads, mastodon\n- Developer: hackernews, github, stackoverflow, devto\n- Media: news, youtube, podcasts (with transcripts), rss (keyword feeds)\n- Web: web (blogs), substack, producthunt\n- Reviews: appstore, googleplay, trustpilot, googlemaps (Google reviews)"
                    },
                    "maxItems": 20,
                    "description": "Only posts from any of these platforms."
                  },
                  "sentiment": {
                    "enum": [
                      "positive",
                      "neutral",
                      "negative"
                    ],
                    "type": "string",
                    "description": "Deprecated: use sentiments. Only this sentiment; combines with sentiments as either."
                  },
                  "assigneeId": {
                    "type": "string",
                    "minLength": 1,
                    "description": "Only mentions assigned to this workspace member (user id)."
                  },
                  "keywordIds": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 200,
                      "minLength": 1
                    },
                    "maxItems": 50,
                    "description": "Only matches of any of these keywords."
                  },
                  "minReplies": {
                    "type": "integer",
                    "minimum": 0,
                    "description": "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": {
                    "type": "integer",
                    "minimum": 0,
                    "description": "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."
                  },
                  "notAuthors": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 200,
                      "minLength": 1
                    },
                    "maxItems": 200,
                    "description": "Hide these authors: display names, handles or profile URLs. Repeatable, or one comma-separated value."
                  },
                  "notIntents": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 200,
                      "minLength": 1
                    },
                    "maxItems": 20,
                    "description": "Never mentions carrying these intent or topic tags."
                  },
                  "notRatings": {
                    "type": "array",
                    "items": {
                      "type": "integer",
                      "maximum": 5,
                      "minimum": 1
                    },
                    "maxItems": 5,
                    "description": "Never reviews with these star ratings (1 to 5): notRatings=5 hides the five star reviews. Posts that are not reviews still pass."
                  },
                  "sentiments": {
                    "type": "array",
                    "items": {
                      "enum": [
                        "positive",
                        "neutral",
                        "negative"
                      ],
                      "type": "string",
                      "description": "Classifier sentiment."
                    },
                    "maxItems": 3,
                    "description": "Only these sentiments."
                  },
                  "subreddits": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 200,
                      "minLength": 1
                    },
                    "maxItems": 50,
                    "description": "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."
                  },
                  "notEmotions": {
                    "type": "array",
                    "items": {
                      "enum": [
                        "joy",
                        "trust",
                        "anticipation",
                        "surprise",
                        "confusion",
                        "frustration",
                        "anger",
                        "fear",
                        "sadness",
                        "neutral"
                      ],
                      "type": "string",
                      "description": "An emotion toward the keyword (see classification.emotion)."
                    },
                    "maxItems": 10,
                    "description": "Never these emotions. A mention whose emotion was not judged still passes."
                  },
                  "notGroupIds": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 200,
                      "minLength": 1
                    },
                    "maxItems": 50,
                    "description": "Never matches of keywords in these groups."
                  },
                  "includeMuted": {
                    "type": "boolean",
                    "description": "true: include mentions by people you muted, hidden by default: muted for the workspace, or for the mention's own keyword group."
                  },
                  "keywordKinds": {
                    "type": "array",
                    "items": {
                      "enum": [
                        "brand",
                        "competitor",
                        "topic"
                      ],
                      "type": "string"
                    },
                    "maxItems": 3,
                    "description": "Only matches of keywords of any of these kinds: brand, competitor, topic. Repeatable, or comma-separated."
                  },
                  "maxFollowers": {
                    "type": "integer",
                    "minimum": 0,
                    "description": "Only authors with at most this many followers. Unknown reach never passes."
                  },
                  "minBookmarks": {
                    "type": "integer",
                    "minimum": 0,
                    "description": "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": {
                    "type": "integer",
                    "minimum": 0,
                    "description": "Only authors with at least this many followers. Unknown reach never passes."
                  },
                  "minRelevance": {
                    "type": "integer",
                    "maximum": 100,
                    "minimum": 0,
                    "description": "Only mentions scored at least this; unclassified ones are excluded."
                  },
                  "notCountries": {
                    "type": "array",
                    "items": {
                      "enum": [
                        "us",
                        "ca",
                        "mx",
                        "br",
                        "ar",
                        "co",
                        "cl",
                        "pe",
                        "gb",
                        "ie",
                        "fr",
                        "de",
                        "es",
                        "pt",
                        "it",
                        "nl",
                        "be",
                        "ch",
                        "at",
                        "se",
                        "no",
                        "dk",
                        "fi",
                        "pl",
                        "cz",
                        "ro",
                        "gr",
                        "hu",
                        "ua",
                        "ru",
                        "lt",
                        "lv",
                        "ee",
                        "tr",
                        "il",
                        "ae",
                        "sa",
                        "eg",
                        "ng",
                        "ke",
                        "za",
                        "ma",
                        "in",
                        "pk",
                        "bd",
                        "lk",
                        "np",
                        "cn",
                        "hk",
                        "tw",
                        "jp",
                        "kr",
                        "sg",
                        "my",
                        "id",
                        "ph",
                        "vn",
                        "th",
                        "au",
                        "nz"
                      ],
                      "type": "string"
                    },
                    "maxItems": 100,
                    "description": "Never posts whose author is in these countries: notCountries=in. A post whose country is unknown still passes."
                  },
                  "notLanguages": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "pattern": "^[a-z]{2}$"
                    },
                    "maxItems": 20,
                    "description": "Never posts in these languages. A post whose language is unknown still passes."
                  },
                  "notLinkHosts": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 200,
                      "minLength": 1
                    },
                    "maxItems": 20,
                    "description": "Never posts linking to these hosts, the host itself or a subdomain of it."
                  },
                  "notPlatforms": {
                    "type": "array",
                    "items": {
                      "enum": [
                        "bluesky",
                        "hackernews",
                        "github",
                        "stackoverflow",
                        "devto",
                        "reddit",
                        "x",
                        "youtube",
                        "news",
                        "linkedin",
                        "tiktok",
                        "instagram",
                        "facebook",
                        "podcasts",
                        "web",
                        "substack",
                        "producthunt",
                        "threads",
                        "mastodon",
                        "appstore",
                        "googleplay",
                        "trustpilot",
                        "googlemaps",
                        "rss"
                      ],
                      "type": "string",
                      "description": "Platform, one of:\n- Social: bluesky, x, reddit, linkedin, facebook, instagram, tiktok, threads, mastodon\n- Developer: hackernews, github, stackoverflow, devto\n- Media: news, youtube, podcasts (with transcripts), rss (keyword feeds)\n- Web: web (blogs), substack, producthunt\n- Reviews: appstore, googleplay, trustpilot, googlemaps (Google reviews)"
                    },
                    "maxItems": 20,
                    "description": "Never posts from these platforms."
                  },
                  "organization": {
                    "type": "boolean",
                    "description": "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."
                  },
                  "includeHidden": {
                    "type": "boolean",
                    "description": "true: include mentions their keyword's display lists hide (a language or country it does not show), hidden by default."
                  },
                  "minConfidence": {
                    "type": "number",
                    "maximum": 1,
                    "minimum": 0,
                    "description": "Only mentions whose classifier confidence is at least this, 0 to 1. Mentions without a confidence are excluded."
                  },
                  "notKeywordIds": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 200,
                      "minLength": 1
                    },
                    "maxItems": 50,
                    "description": "Never matches of these keywords."
                  },
                  "notSentiments": {
                    "type": "array",
                    "items": {
                      "enum": [
                        "positive",
                        "neutral",
                        "negative"
                      ],
                      "type": "string",
                      "description": "Classifier sentiment."
                    },
                    "maxItems": 3,
                    "description": "Never these sentiments. A mention the classifier has not scored yet still passes."
                  },
                  "notSubreddits": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 200,
                      "minLength": 1
                    },
                    "maxItems": 50,
                    "description": "Never Reddit posts from these subreddits; posts from other platforms still pass."
                  },
                  "excludeAuthors": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 200,
                      "minLength": 1
                    },
                    "maxItems": 200,
                    "description": "Deprecated: use notAuthors, the same filter. Both may be sent; every author named in either is hidden."
                  },
                  "notKeywordKinds": {
                    "type": "array",
                    "items": {
                      "enum": [
                        "brand",
                        "competitor",
                        "topic"
                      ],
                      "type": "string"
                    },
                    "maxItems": 3,
                    "description": "Never matches of keywords of these kinds. Repeatable, or comma-separated."
                  },
                  "includeDuplicates": {
                    "type": "boolean",
                    "description": "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."
                  }
                },
                "description": "Instead of ids: every mention GET /v1/mentions would list with these filters, up to 1000 a call, newest first. Repeat with the same filter and nextCursor until it is null.",
                "additionalProperties": false
              },
              "update": {
                "type": "object",
                "properties": {
                  "status": {
                    "enum": [
                      "open",
                      "ignored",
                      "done"
                    ],
                    "type": "string",
                    "description": "ignored or done to handle them; open to put them back."
                  },
                  "addLabels": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 40,
                      "minLength": 1
                    },
                    "maxItems": 20,
                    "minItems": 1,
                    "description": "Labels to add; a mention keeps at most 20, and labels past that are not added."
                  },
                  "assigneeId": {
                    "anyOf": [
                      {
                        "type": "string",
                        "minLength": 1
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "A workspace member (user id), or null to unassign."
                  },
                  "removeLabels": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 40,
                      "minLength": 1
                    },
                    "maxItems": 20,
                    "minItems": 1,
                    "description": "Labels to remove; a label a mention does not carry is ignored."
                  }
                },
                "description": "Every field is optional, at least one is required; omitted fields are untouched.",
                "additionalProperties": false
              },
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              },
              "idempotencyKey": {
                "type": "string",
                "pattern": "^[\\x21-\\x7e]+$",
                "maxLength": 255,
                "minLength": 1,
                "description": "Optional. A unique value (a UUID) for this call: 1 to 255 visible ASCII characters, no spaces. Calling again with the same key and the same input within 24 hours returns the first result instead of doing it twice."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Update mentions",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": true
          }
        },
        {
          "name": "list_labels",
          "title": "List labels",
          "description": "Labels in the workspace and how many mentions carry each, the most used first, paged with limit and offset (total says how many there are). Filter mentions by them with search_mentions labels / notLabels.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "limit": {
                "type": "integer",
                "default": 50,
                "maximum": 100,
                "minimum": 1,
                "description": "Page size, 1 to 100."
              },
              "offset": {
                "type": "integer",
                "default": 0,
                "minimum": 0,
                "description": "Skip this many labels."
              },
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "List labels",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "list_automations",
          "title": "List automations",
          "description": "The workspace's automations, in the order they run: each is a mention filter (the search_mentions vocabulary) plus actions (labels to add, a member to assign), applied to every NEW mention the filter selects as soon as it is scored and before it is delivered.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "List automations",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "get_automation",
          "title": "Get automation",
          "description": "One automation by id.",
          "inputSchema": {
            "type": "object",
            "required": [
              "id"
            ],
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "description": "Automation id (atm_...)"
              },
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Get automation",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "create_automation",
          "title": "Create automation",
          "description": "Create an automation: a name, a filter in the vocabulary of search_mentions (as create_view takes it; empty acts on every mention) and actions: addLabels (up to 10) and/or assigneeId (a member, assigned only when nobody is). It runs on every NEW mention its filter selects, right after scoring and before delivery, so an alert rule on `labels` can route what it labels (\"buy intent on LinkedIn\" -> label hot-lead -> an alert rule on labels [hot-lead] to the sales channel). Existing mentions are not touched: use update_mentions for those. At most 25 per workspace; they run oldest first, a later one seeing labels an earlier one added.",
          "inputSchema": {
            "truncated": true,
            "chars": 22476
          },
          "annotations": {
            "title": "Create automation",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "update_automation",
          "title": "Update automation",
          "description": "Rename, pause (enabled: false) or change an automation. `filter` and `actions` each replace the whole of themselves; the change applies to mentions scored from then on.",
          "inputSchema": {
            "truncated": true,
            "chars": 22458
          },
          "annotations": {
            "title": "Update automation",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": true
          }
        },
        {
          "name": "delete_automation",
          "title": "Delete automation",
          "description": "Delete an automation. The labels it added stay on their mentions.",
          "inputSchema": {
            "type": "object",
            "required": [
              "id"
            ],
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "description": "Automation id (atm_...)"
              },
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              },
              "idempotencyKey": {
                "type": "string",
                "pattern": "^[\\x21-\\x7e]+$",
                "maxLength": 255,
                "minLength": 1,
                "description": "Optional. A unique value (a UUID) for this call: 1 to 255 visible ASCII characters, no spaces. Calling again with the same key and the same input within 24 hours returns the first result instead of doing it twice."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Delete automation",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": true
          }
        },
        {
          "name": "list_groups",
          "title": "List groups",
          "description": "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.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "externalId": {
                "type": "string",
                "maxLength": 128,
                "minLength": 1,
                "description": "Only the group carrying exactly this externalId."
              },
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "List groups",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "get_group",
          "title": "Get group",
          "description": "One keyword group by id, with how many keywords it holds.",
          "inputSchema": {
            "type": "object",
            "required": [
              "id"
            ],
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "description": "Group id (grp_...)"
              },
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Get group",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "create_group",
          "title": "Create group",
          "description": "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.",
          "inputSchema": {
            "type": "object",
            "required": [
              "name"
            ],
            "properties": {
              "name": {
                "type": "string",
                "maxLength": 80,
                "minLength": 1,
                "description": "The group's name: a customer, a campaign, a product. Unique per workspace."
              },
              "context": {
                "anyOf": [
                  {
                    "type": "string",
                    "maxLength": 4000,
                    "description": "What the classifier reads as \"the company\" for this group's keywords, instead of the WHOLE workspace profile (guidelines and competitors included). Null: the workspace profile. See [Groups](/guides/groups#a-company-description-per-group)."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "What the classifier reads as \"the company\" for this group's keywords, instead of the WHOLE workspace profile (guidelines and competitors included). Null: the workspace profile. See [Groups](/guides/groups#a-company-description-per-group)."
              },
              "externalId": {
                "anyOf": [
                  {
                    "type": "string",
                    "maxLength": 128,
                    "minLength": 1,
                    "description": "Your own id for the group (a customer id, say). Unique per workspace; find the group by it with GET /v1/groups?externalId=."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Your own id for the group (a customer id, say). Unique per workspace; find the group by it with GET /v1/groups?externalId=."
              },
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              },
              "idempotencyKey": {
                "type": "string",
                "pattern": "^[\\x21-\\x7e]+$",
                "maxLength": 255,
                "minLength": 1,
                "description": "Optional. A unique value (a UUID) for this call: 1 to 255 visible ASCII characters, no spaces. Calling again with the same key and the same input within 24 hours returns the first result instead of doing it twice."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Create group",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "update_group",
          "title": "Update group",
          "description": "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).",
          "inputSchema": {
            "type": "object",
            "required": [
              "id"
            ],
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "description": "Group id (grp_...)"
              },
              "name": {
                "type": "string",
                "maxLength": 80,
                "minLength": 1,
                "description": "The group's name: a customer, a campaign, a product. Unique per workspace."
              },
              "context": {
                "anyOf": [
                  {
                    "type": "string",
                    "maxLength": 4000,
                    "description": "What the classifier reads as \"the company\" for this group's keywords, instead of the WHOLE workspace profile (guidelines and competitors included). Null: the workspace profile. See [Groups](/guides/groups#a-company-description-per-group)."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Replaces the group's company description; null clears it. New mentions are judged with it at once, old ones are not rescored. Not on the default group (400 default_group_context)."
              },
              "externalId": {
                "anyOf": [
                  {
                    "type": "string",
                    "maxLength": 128,
                    "minLength": 1,
                    "description": "Your own id for the group (a customer id, say). Unique per workspace; find the group by it with GET /v1/groups?externalId=."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Replaces your id for the group; null clears it."
              },
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              },
              "idempotencyKey": {
                "type": "string",
                "pattern": "^[\\x21-\\x7e]+$",
                "maxLength": 255,
                "minLength": 1,
                "description": "Optional. A unique value (a UUID) for this call: 1 to 255 visible ASCII characters, no spaces. Calling again with the same key and the same input within 24 hours returns the first result instead of doing it twice."
              }
            },
            "description": "Omitted fields are untouched.",
            "additionalProperties": false
          },
          "annotations": {
            "title": "Update group",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": true
          }
        },
        {
          "name": "delete_group",
          "title": "Delete group",
          "description": "Delete a keyword group, EVERY keyword in it (each as delete_keyword does: its mentions go with it) and every tracked account in it. The default group cannot be deleted. Says how many keywords and accounts went.",
          "inputSchema": {
            "type": "object",
            "required": [
              "id"
            ],
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "description": "Group id (grp_...)"
              },
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              },
              "idempotencyKey": {
                "type": "string",
                "pattern": "^[\\x21-\\x7e]+$",
                "maxLength": 255,
                "minLength": 1,
                "description": "Optional. A unique value (a UUID) for this call: 1 to 255 visible ASCII characters, no spaces. Calling again with the same key and the same input within 24 hours returns the first result instead of doing it twice."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Delete group",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": true
          }
        },
        {
          "name": "search_mentions",
          "title": "Search mentions",
          "description": "Search tracked mentions for your organization. Filter by keyword, platform, status (open, ignored, done), relevant, minimum relevance, minimum confidence (0 to 1), sentiment, the emotion the author shows toward the keyword (emotions or notEmotions: joy, trust, anticipation, surprise, confusion, frustration, anger, fear, sadness, neutral; one not judged yet never passes emotions and always passes notEmotions), 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), your labels on the mention (labels, notLabels), 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 notKeywordKinds to leave kinds out), authors to hide (notAuthors: names, handles or profile links), 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), \"priority\" (attention score from relevance, author reach, intent and age, over the last 30 days of matches only; each mention carries it as `priority`), \"reach\" (most followers first, unknown last) or \"engagement\" (likes + reposts + replies + quotes the platform reported, posts without engagement last); reach and engagement rank the last 30 days of matches unless a time range start is given. Each author carries influence, 0 to 100 from followers on a log scale. 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.",
          "inputSchema": {
            "truncated": true,
            "chars": 26594
          },
          "annotations": {
            "title": "Search mentions",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "get_mention",
          "title": "Get mention",
          "description": "Fetch a single mention by id, including its classification (relevance, sentiment, emotion, intents, confidence, uncertain, note).",
          "inputSchema": {
            "type": "object",
            "required": [
              "id"
            ],
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "description": "Mention id (mention match id, mm_...)"
              },
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Get mention",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "list_mention_comments",
          "title": "List mention comments",
          "description": "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.",
          "inputSchema": {
            "type": "object",
            "required": [
              "id"
            ],
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "description": "Mention id (mm_...)"
              },
              "limit": {
                "type": "integer",
                "default": 50,
                "maximum": 100,
                "minimum": 1,
                "description": "Page size, 1 to 100."
              },
              "cursor": {
                "type": "string",
                "minLength": 1,
                "description": "nextCursor from the previous page."
              },
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "List mention comments",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "update_mention",
          "title": "Update mention",
          "description": "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); replace its labels (labels: your own words like hot-lead or replied, [] clears; update_mentions adds or removes a few on many); 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.",
          "inputSchema": {
            "type": "object",
            "required": [
              "id"
            ],
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "description": "Mention id (mm_...)"
              },
              "note": {
                "anyOf": [
                  {
                    "type": "string",
                    "maxLength": 2000
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Internal note; null or empty clears it."
              },
              "labels": {
                "type": "array",
                "items": {
                  "type": "string",
                  "maxLength": 40,
                  "minLength": 1
                },
                "maxItems": 20,
                "description": "Replaces the mention's whole list of labels (exact, case-sensitive, at most 20); [] removes every label. To add or remove a few without reading first, use POST /v1/mentions/batch."
              },
              "status": {
                "enum": [
                  "open",
                  "ignored",
                  "done"
                ],
                "type": "string",
                "description": "ignored or done to handle it; open to put it back."
              },
              "relevant": {
                "type": [
                  "boolean",
                  "null"
                ],
                "description": "Your verdict: true sets relevance to 100 (a filtered mention becomes relevant), false to 0; null restores the classifier's score. Billing never changes. 409 classification_pending while it is still being classified."
              },
              "sentiment": {
                "anyOf": [
                  {
                    "enum": [
                      "positive",
                      "neutral",
                      "negative"
                    ],
                    "type": "string",
                    "description": "Classifier sentiment."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Your corrected sentiment; null withdraws the correction and restores the classifier's."
              },
              "assigneeId": {
                "anyOf": [
                  {
                    "type": "string",
                    "minLength": 1
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "A workspace member (user id), or null to unassign."
              },
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              },
              "snoozedUntil": {
                "anyOf": [
                  {
                    "type": "integer"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "ISO 8601 (or epoch ms) until which the mention leaves the feed; null wakes it."
              },
              "idempotencyKey": {
                "type": "string",
                "pattern": "^[\\x21-\\x7e]+$",
                "maxLength": 255,
                "minLength": 1,
                "description": "Optional. A unique value (a UUID) for this call: 1 to 255 visible ASCII characters, no spaces. Calling again with the same key and the same input within 24 hours returns the first result instead of doing it twice."
              }
            },
            "description": "Every field is optional; omitted fields are untouched.",
            "additionalProperties": false
          },
          "annotations": {
            "title": "Update mention",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": true
          }
        },
        {
          "name": "add_keyword",
          "title": "Add keyword",
          "description": "Start tracking a keyword: send term (the word or phrase), or query instead, a boolean query as Brand24, Awario or Brandwatch write one (\"acme cloud\" AND (pricing OR price*) -jobs: quoted phrases, words, AND, OR, NOT or -word, parentheses, a * at a word end; side by side means AND), compiled into term and matching (the first word of every alternative is the term searched everywhere and must be the same in all, so put the brand first; the other words are required, NOT words excluded, exact phrase only); never both, and never query with matching.requiredTerms, requiredMode, requiredGroups, excludedTerms or exactPhrase. A query whose alternatives start with different words (acme OR globex, (acme OR globex) pricing) is refused with query_needs_one_term: add one keyword per term. 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, onlyAuthors: only posts BY these accounts, termIn: [\"title\" | \"body\" | \"url\" | \"author\"] where the term must appear): 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. To follow a whole subreddit instead of a term, send `subreddit` ({ name: \"SaaS\" or a reddit.com link, keep: \"relevant\" | \"all\" }) in place of `term` (never with query) and no platforms: every new post there is read every 3 hours whether it names anything or not; keep \"relevant\" (default) keeps and bills only the posts the classifier scores relevant to the keyword's `context` and ",
          "inputSchema": {
            "type": "object",
            "properties": {
              "cap": {
                "anyOf": [
                  {
                    "type": "object",
                    "required": [
                      "mentions"
                    ],
                    "properties": {
                      "per": {
                        "enum": [
                          "day",
                          "week",
                          "month"
                        ],
                        "type": "string",
                        "default": "month",
                        "description": "The period the cap counts in, in UTC: day, week (from Monday) or calendar month (the default). At the cap the keyword stops until the next period starts."
                      },
                      "mentions": {
                        "type": "integer",
                        "maximum": 1000000,
                        "minimum": 1,
                        "description": "Charged items allowed per period (see per): matched mentions plus the thread comments delivered under them. Every match counts, relevant or not, the look-back a new keyword gets included, because every match bills."
                      }
                    },
                    "description": "A ceiling on what this keyword may be charged for per day, week or month, mentions and comments together. At the cap it stops matching and receiving comments until the next period starts (UTC), or until the cap is raised or removed. It stays unmuted: it keeps its place and its daily keyword charge; pause it to stop that too.",
                    "additionalProperties": false
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "A mention cap per day, week or month (per, default month); omit or null for none."
              },
              "kind": {
                "enum": [
                  "brand",
                  "competitor",
                  "topic"
                ],
                "type": "string",
                "default": "brand",
                "description": "brand: your own names. competitor: theirs. topic: the space. Drives share of voice and segments."
              },
              "term": {
                "type": "string",
                "maxLength": 80,
                "minLength": 2,
                "description": "The word or phrase to track, case-insensitive; send exactly one of term, `query` and `subreddit`. A multi-word term also matches its words close together (see matching.exactPhrase); double quotes mean the exact phrase only."
              },
              "feeds": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "url"
                  ],
                  "properties": {
                    "url": {
                      "type": "string",
                      "maxLength": 500,
                      "minLength": 4,
                      "description": "A feed's address (https://forum.example.com/posts.rss), or a page's (https://forum.example.com): the feed the page advertises is used."
                    }
                  },
                  "description": "One feed to read.",
                  "additionalProperties": false
                },
                "maxItems": 20,
                "description": "RSS or Atom feeds only this keyword reads: a feed's URL, or a page that advertises one (else a 400). Read hourly; an item holding the term is a mention. See [RSS](/platforms/rss#a-keywords-own-feeds)."
              },
              "query": {
                "type": "string",
                "maxLength": 1000,
                "minLength": 1,
                "description": "The keyword as one boolean query instead of term and matching, like \"acme cloud\" AND (pricing OR price*) -jobs ([Keywords](/guides/keywords#write-it-as-a-query)):\n\n- Phrases, words, AND, OR, NOT or -word, parentheses, word-end *\n- Compiled into term and the term rules; never sent with them (400).\n- Each alternative starts with the term; else 400 query_needs_one_term."
              },
              "context": {
                "anyOf": [
                  {
                    "type": "string",
                    "maxLength": 300,
                    "description": "A sentence the classifier reads for this keyword only, on top of the company profile or group description: what the term means here, what to ignore. \"Arc is our browser; ignore the geometry word.\" Null clears it."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "A sentence the classifier reads for this keyword only, on top of the company profile or group description: what the term means here, what to ignore. \"Arc is our browser; ignore the geometry word.\" Null clears it."
              },
              "display": {
                "type": "object",
                "properties": {
                  "countries": {
                    "type": "object",
                    "properties": {
                      "only": {
                        "type": "array",
                        "items": {
                          "enum": [
                            "us",
                            "ca",
                            "mx",
                            "br",
                            "ar",
                            "co",
                            "cl",
                            "pe",
                            "gb",
                            "ie",
                            "fr",
                            "de",
                            "es",
                            "pt",
                            "it",
                            "nl",
                            "be",
                            "ch",
                            "at",
                            "se",
                            "no",
                            "dk",
                            "fi",
                            "pl",
                            "cz",
                            "ro",
                            "gr",
                            "hu",
                            "ua",
                            "ru",
                            "lt",
                            "lv",
                            "ee",
                            "tr",
                            "il",
                            "ae",
                            "sa",
                            "eg",
                            "ng",
                            "ke",
                            "za",
                            "ma",
                            "in",
                            "pk",
                            "bd",
                            "lk",
                            "np",
                            "cn",
                            "hk",
                            "tw",
                            "jp",
                            "kr",
                            "sg",
                            "my",
                            "id",
                            "ph",
                            "vn",
                            "th",
                            "au",
                            "nz"
                          ],
                          "type": "string"
                        },
                        "maxItems": 60,
                        "description": "Replaces the list; [] clears it."
                      },
                      "excluded": {
                        "type": "array",
                        "items": {
                          "enum": [
                            "us",
                            "ca",
                            "mx",
                            "br",
                            "ar",
                            "co",
                            "cl",
                            "pe",
                            "gb",
                            "ie",
                            "fr",
                            "de",
                            "es",
                            "pt",
                            "it",
                            "nl",
                            "be",
                            "ch",
                            "at",
                            "se",
                            "no",
                            "dk",
                            "fi",
                            "pl",
                            "cz",
                            "ro",
                            "gr",
                            "hu",
                            "ua",
                            "ru",
                            "lt",
                            "lv",
                            "ee",
                            "tr",
                            "il",
                            "ae",
                            "sa",
                            "eg",
                            "ng",
                            "ke",
                            "za",
                            "ma",
                            "in",
                            "pk",
                            "bd",
                            "lk",
                            "np",
                            "cn",
                            "hk",
                            "tw",
                            "jp",
                            "kr",
                            "sg",
                            "my",
                            "id",
                            "ph",
                            "vn",
                            "th",
                            "au",
                            "nz"
                          ],
                          "type": "string"
                        },
                        "maxItems": 60,
                        "description": "Replaces the list; [] clears it."
                      }
                    },
                    "description": "By where the author is (ISO 3166-1 alpha-2); omitted: untouched.",
                    "additionalProperties": false
                  },
                  "languages": {
                    "type": "object",
                    "properties": {
                      "only": {
                        "type": "array",
                        "items": {
                          "enum": [
                            "en",
                            "es",
                            "de",
                            "fr",
                            "pt",
                            "it",
                            "nl",
                            "ca",
                            "pl",
                            "tr",
                            "sv",
                            "da",
                            "ru",
                            "uk",
                            "ar",
                            "hi",
                            "id",
                            "ja",
                            "zh",
                            "ko"
                          ],
                          "type": "string"
                        },
                        "maxItems": 60,
                        "description": "Replaces the list; [] clears it."
                      },
                      "excluded": {
                        "type": "array",
                        "items": {
                          "enum": [
                            "en",
                            "es",
                            "de",
                            "fr",
                            "pt",
                            "it",
                            "nl",
                            "ca",
                            "pl",
                            "tr",
                            "sv",
                            "da",
                            "ru",
                            "uk",
                            "ar",
                            "hi",
                            "id",
                            "ja",
                            "zh",
                            "ko"
                          ],
                          "type": "string"
                        },
                        "maxItems": 60,
                        "description": "Replaces the list; [] clears it."
                      }
                    },
                    "description": "By the language of the post (ISO 639-1); omitted: untouched.",
                    "additionalProperties": false
                  }
                },
                "description": "Which of this keyword's mentions you see, by language and country; each list is replaced when sent, kept when omitted. Hidden mentions are still billed.",
                "additionalProperties": false
              },
              "groupId": {
                "type": "string",
                "minLength": 1,
                "description": "The group to track it in (grp_...); omit for the workspace's default group. A term may be tracked once per group."
              },
              "comments": {
                "type": "object",
                "properties": {
                  "enabled": {
                    "type": "boolean",
                    "description": "Read the comments under this keyword's relevant mentions. Each comment delivered costs $0.008; comments under three words are dropped, never billed. See [Comments](/guides/comments)."
                  },
                  "maxPerPost": {
                    "type": "integer",
                    "maximum": 100,
                    "minimum": 1,
                    "description": "The newest comments of one thread you receive: the ceiling on what one mention's comments can cost. A comment naming the keyword is a mention only among these."
                  }
                },
                "description": "Comments under this keyword's mentions; omitted fields are untouched (on create: off, 20 per post).",
                "additionalProperties": false
              },
              "matching": {
                "type": "object",
                "properties": {
                  "termIn": {
                    "type": "array",
                    "items": {
                      "enum": [
                        "title",
                        "body",
                        "url",
                        "author"
                      ],
                      "type": "string"
                    },
                    "maxItems": 4,
                    "description": "Where the term must appear, any part listed; empty: anywhere; reviews are exempt. See [Keywords](/guides/keywords#where-the-term-must-appear).\n\n- title: the post's title (none on X, Bluesky or LinkedIn).\n- body: the text after the title.\n- url: the post's link.\n- author: the author's name or handle."
                  },
                  "subreddits": {
                    "type": "object",
                    "properties": {
                      "only": {
                        "type": "array",
                        "items": {
                          "type": "string",
                          "maxLength": 100,
                          "minLength": 1
                        },
                        "maxItems": 50,
                        "description": "Replaces the keyword's allowlist; [] clears it."
                      },
                      "excluded": {
                        "type": "array",
                        "items": {
                          "type": "string",
                          "maxLength": 100,
                          "minLength": 1
                        },
                        "maxItems": 50,
                        "description": "Replaces the keyword's deny list; [] clears it."
                      }
                    },
                    "description": "Reddit only, for this keyword alone: each list is replaced when sent, kept when omitted.",
                    "additionalProperties": false
                  },
                  "exactPhrase": {
                    "type": "boolean",
                    "description": "true: only the exact phrase matches (a term sent in double quotes sets it). false: a multi-word keyword also matches its words close together, kept and billed only when scored relevant. See [Keywords](/guides/keywords#the-exact-phrase-only)."
                  },
                  "onlyAuthors": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 500,
                      "minLength": 1
                    },
                    "maxItems": 100,
                    "description": "When non-empty, only posts BY these accounts match, in the forms excludedAuthors takes; a Bluesky handle is stored with its DID. Reviews and comments read under a mention are exempt."
                  },
                  "repositories": {
                    "type": "object",
                    "properties": {
                      "events": {
                        "type": "array",
                        "items": {
                          "enum": [
                            "new",
                            "traction",
                            "stars",
                            "growth"
                          ],
                          "type": "string"
                        },
                        "description": "The repository events this keyword takes (default traction, stars, growth; empty: none). See [GitHub](/platforms/github#repositories).\n\n- traction: under 30 days old, it reached 10 stars.\n- stars: it passed a milestone (100, 250, 500, 1,000 ...).\n- growth: it gained stars fast in a week.\n- new: every repository created; opt in, mostly noise."
                      },
                      "minStars": {
                        "anyOf": [
                          {
                            "type": "integer",
                            "maximum": 1000000,
                            "minimum": 0
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Only repositories with at least this many stars; null for no minimum."
                      },
                      "minWeeklyStars": {
                        "anyOf": [
                          {
                            "type": "integer",
                            "maximum": 1000000,
                            "minimum": 25
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Only repositories that gained at least this many stars in the last 7 days, for every event; an unknown week fails. null: growth needs 100 stars and 20% a week, other events nothing."
                      }
                    },
                    "description": "GitHub only: each field is replaced when sent, kept when omitted; null clears a minimum.",
                    "additionalProperties": false
                  },
                  "requiredMode": {
                    "enum": [
                      "any",
                      "all"
                    ],
                    "type": "string",
                    "description": "any: at least one required term must appear. all: every one must."
                  },
                  "caseSensitive": {
                    "type": "boolean",
                    "description": "true: the term must appear in the case it was typed (RAG, never rag). Default false."
                  },
                  "excludedTerms": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 80,
                      "minLength": 1
                    },
                    "maxItems": 50,
                    "description": "A post containing any of these is dropped. A `*` at the start or the end of an entry is a wildcard (beta.* matches beta.0.1; *bot matches nightlybot)."
                  },
                  "requiredTerms": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 80,
                      "minLength": 1
                    },
                    "maxItems": 50,
                    "description": "The post must ALSO contain these terms, any one of them or all of them per requiredMode. A `*` at the start or the end of an entry is a wildcard (alert* matches alerts and alerting). Empty: no requirement."
                  },
                  "requiredGroups": {
                    "type": "array",
                    "items": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "maxLength": 80,
                        "minLength": 1
                      },
                      "maxItems": 10,
                      "minItems": 1
                    },
                    "maxItems": 50,
                    "description": "Combinations: the post must ALSO contain every term of at least one group (an OR of ANDs), on top of requiredTerms, with the same phrase and wildcard rules. See [Keywords](/guides/keywords#several-searches-in-one-keyword)."
                  },
                  "excludedAuthors": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 500,
                      "minLength": 1
                    },
                    "maxItems": 100,
                    "description": "Posts by these authors are dropped: profile or post links, @handles, u/names, Bluesky DIDs or display names, stored in canonical form like an alert's muted list."
                  }
                },
                "description": "Omitted fields are untouched; an empty list clears one.",
                "additionalProperties": false
              },
              "platforms": {
                "anyOf": [
                  {
                    "type": "array",
                    "items": {
                      "enum": [
                        "bluesky",
                        "hackernews",
                        "github",
                        "stackoverflow",
                        "devto",
                        "reddit",
                        "x",
                        "youtube",
                        "news",
                        "linkedin",
                        "tiktok",
                        "instagram",
                        "facebook",
                        "podcasts",
                        "web",
                        "substack",
                        "producthunt",
                        "threads",
                        "mastodon"
                      ],
                      "type": "string"
                    }
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "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. Not with `subreddit` (its platform is Reddit)."
              },
              "subreddit": {
                "type": "object",
                "required": [
                  "name"
                ],
                "properties": {
                  "keep": {
                    "enum": [
                      "relevant",
                      "all"
                    ],
                    "type": "string",
                    "default": "relevant",
                    "description": "relevant: the classifier keeps the posts relevant to the keyword's context (else your company); the rest are dropped unbilled. all: every new post is a mention, billed like any."
                  },
                  "name": {
                    "type": "string",
                    "maxLength": 300,
                    "minLength": 1,
                    "description": "The subreddit: SaaS, r/SaaS or a reddit.com link to it. A name Reddit would not allow is a 400."
                  }
                },
                "description": "Follow a whole subreddit in place of `term`: its new posts are read every 3 hours, named or not. Send no `platforms`; `context` says what to keep. See [Follow a whole subreddit](/platforms/reddit#follow-a-whole-subreddit).",
                "additionalProperties": false
              },
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              },
              "reviewSources": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "maxLength": 200,
                      "minLength": 1,
                      "description": "The id on the platform: the digits after \"id\" on the App Store, the package name on Google Play, the company's domain on Trustpilot (notion.so), a Place ID (ChIJ...) on Google Maps."
                    },
                    "url": {
                      "type": "string",
                      "maxLength": 500,
                      "minLength": 1,
                      "description": "The review page's link: an App Store or Google Play app (https://apps.apple.com/us/app/notion/id1232780281, https://play.google.com/store/apps/details?id=notion.id), a Trustpilot page (https://www.trustpilot.com/review/notion.so) or a Google Maps place (its full link, or a maps.app.goo.gl share link). Or give platform and id."
                    },
                    "language": {
                      "type": "string",
                      "maxLength": 10,
                      "minLength": 2,
                      "description": "Google Play only: the language of the reviews to read (en, es, de, pt-BR); Google Play answers one language at a time. Default: the link's hl, else en."
                    },
                    "platform": {
                      "enum": [
                        "appstore",
                        "googleplay",
                        "trustpilot",
                        "googlemaps"
                      ],
                      "type": "string",
                      "description": "appstore (Apple App Store), googleplay (Google Play), trustpilot (a company's Trustpilot page) or googlemaps (a place's Google reviews)."
                    },
                    "countries": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "pattern": "^[A-Za-z]{2}$"
                      },
                      "maxItems": 20,
                      "minItems": 1,
                      "description": "App Store and Google Play storefronts to read, as two-letter codes; default the link's, else us. Each adds a daily poll; a review seen in two is one mention. Trustpilot and Google Maps take none."
                    }
                  },
                  "description": "A review page whose reviews become this keyword's mentions: its link, or the platform and the id.",
                  "additionalProperties": false
                },
                "maxItems": 10,
                "description": "Review pages this keyword collects (app store apps, Trustpilot pages, Google Maps places): every new review is a mention, whatever it says. Polled daily; a newly connected page brings 30 days back, free. See [Reviews](/platforms/reviews)."
              },
              "idempotencyKey": {
                "type": "string",
                "pattern": "^[\\x21-\\x7e]+$",
                "maxLength": 255,
                "minLength": 1,
                "description": "Optional. A unique value (a UUID) for this call: 1 to 255 visible ASCII characters, no spaces. Calling again with the same key and the same input within 24 hours returns the first result instead of doing it twice."
              },
              "readsWorkspaceFeeds": {
                "type": "boolean",
                "description": "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."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Add keyword",
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "add_keywords",
          "title": "Add keywords",
          "description": "Start tracking up to 100 keywords in one call (a list from a spreadsheet, a migration, a new customer's brands): keywords is a list of add_keyword inputs, without reviewSources and feeds (add those afterwards with update_keyword). Each one is created or refused on its own and answered in order in data: status created with the keyword, or failed with error.code (duplicate_keyword: its group already tracks the term; invalid_query, query_needs_one_term, validation_error; not_found: its groupId; insufficient_balance or keyword_limit_reached: the wallet or the 500 ceiling ran out at that keyword, so the rest fail too). When nothing is created and the wallet or the ceiling refused one, the tool fails with that error instead. Each created keyword costs $5 a month and gets its last 30 days at once, like add_keyword. Before the first top-up a call takes at most 10 (funding_required).",
          "inputSchema": {
            "type": "object",
            "required": [
              "keywords"
            ],
            "properties": {
              "keywords": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "cap": {
                      "anyOf": [
                        {
                          "type": "object",
                          "required": [
                            "mentions"
                          ],
                          "properties": {
                            "per": {
                              "enum": [
                                "day",
                                "week",
                                "month"
                              ],
                              "type": "string",
                              "default": "month",
                              "description": "The period the cap counts in, in UTC: day, week (from Monday) or calendar month (the default). At the cap the keyword stops until the next period starts."
                            },
                            "mentions": {
                              "type": "integer",
                              "maximum": 1000000,
                              "minimum": 1,
                              "description": "Charged items allowed per period (see per): matched mentions plus the thread comments delivered under them. Every match counts, relevant or not, the look-back a new keyword gets included, because every match bills."
                            }
                          },
                          "description": "A ceiling on what this keyword may be charged for per day, week or month, mentions and comments together. At the cap it stops matching and receiving comments until the next period starts (UTC), or until the cap is raised or removed. It stays unmuted: it keeps its place and its daily keyword charge; pause it to stop that too.",
                          "additionalProperties": false
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "A mention cap per day, week or month (per, default month); omit or null for none."
                    },
                    "kind": {
                      "enum": [
                        "brand",
                        "competitor",
                        "topic"
                      ],
                      "type": "string",
                      "default": "brand",
                      "description": "brand: your own names. competitor: theirs. topic: the space. Drives share of voice and segments."
                    },
                    "term": {
                      "type": "string",
                      "maxLength": 80,
                      "minLength": 2,
                      "description": "The word or phrase to track, case-insensitive; send exactly one of term, `query` and `subreddit`. A multi-word term also matches its words close together (see matching.exactPhrase); double quotes mean the exact phrase only."
                    },
                    "query": {
                      "type": "string",
                      "maxLength": 1000,
                      "minLength": 1,
                      "description": "The keyword as one boolean query instead of term and matching, like \"acme cloud\" AND (pricing OR price*) -jobs ([Keywords](/guides/keywords#write-it-as-a-query)):\n\n- Phrases, words, AND, OR, NOT or -word, parentheses, word-end *\n- Compiled into term and the term rules; never sent with them (400).\n- Each alternative starts with the term; else 400 query_needs_one_term."
                    },
                    "context": {
                      "anyOf": [
                        {
                          "type": "string",
                          "maxLength": 300,
                          "description": "A sentence the classifier reads for this keyword only, on top of the company profile or group description: what the term means here, what to ignore. \"Arc is our browser; ignore the geometry word.\" Null clears it."
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "A sentence the classifier reads for this keyword only, on top of the company profile or group description: what the term means here, what to ignore. \"Arc is our browser; ignore the geometry word.\" Null clears it."
                    },
                    "display": {
                      "type": "object",
                      "properties": {
                        "countries": {
                          "type": "object",
                          "properties": {
                            "only": {
                              "type": "array",
                              "items": {
                                "enum": [
                                  "us",
                                  "ca",
                                  "mx",
                                  "br",
                                  "ar",
                                  "co",
                                  "cl",
                                  "pe",
                                  "gb",
                                  "ie",
                                  "fr",
                                  "de",
                                  "es",
                                  "pt",
                                  "it",
                                  "nl",
                                  "be",
                                  "ch",
                                  "at",
                                  "se",
                                  "no",
                                  "dk",
                                  "fi",
                                  "pl",
                                  "cz",
                                  "ro",
                                  "gr",
                                  "hu",
                                  "ua",
                                  "ru",
                                  "lt",
                                  "lv",
                                  "ee",
                                  "tr",
                                  "il",
                                  "ae",
                                  "sa",
                                  "eg",
                                  "ng",
                                  "ke",
                                  "za",
                                  "ma",
                                  "in",
                                  "pk",
                                  "bd",
                                  "lk",
                                  "np",
                                  "cn",
                                  "hk",
                                  "tw",
                                  "jp",
                                  "kr",
                                  "sg",
                                  "my",
                                  "id",
                                  "ph",
                                  "vn",
                                  "th",
                                  "au",
                                  "nz"
                                ],
                                "type": "string"
                              },
                              "maxItems": 60,
                              "description": "Replaces the list; [] clears it."
                            },
                            "excluded": {
                              "type": "array",
                              "items": {
                                "enum": [
                                  "us",
                                  "ca",
                                  "mx",
                                  "br",
                                  "ar",
                                  "co",
                                  "cl",
                                  "pe",
                                  "gb",
                                  "ie",
                                  "fr",
                                  "de",
                                  "es",
                                  "pt",
                                  "it",
                                  "nl",
                                  "be",
                                  "ch",
                                  "at",
                                  "se",
                                  "no",
                                  "dk",
                                  "fi",
                                  "pl",
                                  "cz",
                                  "ro",
                                  "gr",
                                  "hu",
                                  "ua",
                                  "ru",
                                  "lt",
                                  "lv",
                                  "ee",
                                  "tr",
                                  "il",
                                  "ae",
                                  "sa",
                                  "eg",
                                  "ng",
                                  "ke",
                                  "za",
                                  "ma",
                                  "in",
                                  "pk",
                                  "bd",
                                  "lk",
                                  "np",
                                  "cn",
                                  "hk",
                                  "tw",
                                  "jp",
                                  "kr",
                                  "sg",
                                  "my",
                                  "id",
                                  "ph",
                                  "vn",
                                  "th",
                                  "au",
                                  "nz"
                                ],
                                "type": "string"
                              },
                              "maxItems": 60,
                              "description": "Replaces the list; [] clears it."
                            }
                          },
                          "description": "By where the author is (ISO 3166-1 alpha-2); omitted: untouched.",
                          "additionalProperties": false
                        },
                        "languages": {
                          "type": "object",
                          "properties": {
                            "only": {
                              "type": "array",
                              "items": {
                                "enum": [
                                  "en",
                                  "es",
                                  "de",
                                  "fr",
                                  "pt",
                                  "it",
                                  "nl",
                                  "ca",
                                  "pl",
                                  "tr",
                                  "sv",
                                  "da",
                                  "ru",
                                  "uk",
                                  "ar",
                                  "hi",
                                  "id",
                                  "ja",
                                  "zh",
                                  "ko"
                                ],
                                "type": "string"
                              },
                              "maxItems": 60,
                              "description": "Replaces the list; [] clears it."
                            },
                            "excluded": {
                              "type": "array",
                              "items": {
                                "enum": [
                                  "en",
                                  "es",
                                  "de",
                                  "fr",
                                  "pt",
                                  "it",
                                  "nl",
                                  "ca",
                                  "pl",
                                  "tr",
                                  "sv",
                                  "da",
                                  "ru",
                                  "uk",
                                  "ar",
                                  "hi",
                                  "id",
                                  "ja",
                                  "zh",
                                  "ko"
                                ],
                                "type": "string"
                              },
                              "maxItems": 60,
                              "description": "Replaces the list; [] clears it."
                            }
                          },
                          "description": "By the language of the post (ISO 639-1); omitted: untouched.",
                          "additionalProperties": false
                        }
                      },
                      "description": "Which of this keyword's mentions you see, by language and country; each list is replaced when sent, kept when omitted. Hidden mentions are still billed.",
                      "additionalProperties": false
                    },
                    "groupId": {
                      "type": "string",
                      "minLength": 1,
                      "description": "The group to track it in (grp_...); omit for the workspace's default group. A term may be tracked once per group."
                    },
                    "comments": {
                      "type": "object",
                      "properties": {
                        "enabled": {
                          "type": "boolean",
                          "description": "Read the comments under this keyword's relevant mentions. Each comment delivered costs $0.008; comments under three words are dropped, never billed. See [Comments](/guides/comments)."
                        },
                        "maxPerPost": {
                          "type": "integer",
                          "maximum": 100,
                          "minimum": 1,
                          "description": "The newest comments of one thread you receive: the ceiling on what one mention's comments can cost. A comment naming the keyword is a mention only among these."
                        }
                      },
                      "description": "Comments under this keyword's mentions; omitted fields are untouched (on create: off, 20 per post).",
                      "additionalProperties": false
                    },
                    "matching": {
                      "type": "object",
                      "properties": {
                        "termIn": {
                          "type": "array",
                          "items": {
                            "enum": [
                              "title",
                              "body",
                              "url",
                              "author"
                            ],
                            "type": "string"
                          },
                          "maxItems": 4,
                          "description": "Where the term must appear, any part listed; empty: anywhere; reviews are exempt. See [Keywords](/guides/keywords#where-the-term-must-appear).\n\n- title: the post's title (none on X, Bluesky or LinkedIn).\n- body: the text after the title.\n- url: the post's link.\n- author: the author's name or handle."
                        },
                        "subreddits": {
                          "type": "object",
                          "properties": {
                            "only": {
                              "type": "array",
                              "items": {
                                "type": "string",
                                "maxLength": 100,
                                "minLength": 1
                              },
                              "maxItems": 50,
                              "description": "Replaces the keyword's allowlist; [] clears it."
                            },
                            "excluded": {
                              "type": "array",
                              "items": {
                                "type": "string",
                                "maxLength": 100,
                                "minLength": 1
                              },
                              "maxItems": 50,
                              "description": "Replaces the keyword's deny list; [] clears it."
                            }
                          },
                          "description": "Reddit only, for this keyword alone: each list is replaced when sent, kept when omitted.",
                          "additionalProperties": false
                        },
                        "exactPhrase": {
                          "type": "boolean",
                          "description": "true: only the exact phrase matches (a term sent in double quotes sets it). false: a multi-word keyword also matches its words close together, kept and billed only when scored relevant. See [Keywords](/guides/keywords#the-exact-phrase-only)."
                        },
                        "onlyAuthors": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "maxLength": 500,
                            "minLength": 1
                          },
                          "maxItems": 100,
                          "description": "When non-empty, only posts BY these accounts match, in the forms excludedAuthors takes; a Bluesky handle is stored with its DID. Reviews and comments read under a mention are exempt."
                        },
                        "repositories": {
                          "type": "object",
                          "properties": {
                            "events": {
                              "type": "array",
                              "items": {
                                "enum": [
                                  "new",
                                  "traction",
                                  "stars",
                                  "growth"
                                ],
                                "type": "string"
                              },
                              "description": "The repository events this keyword takes (default traction, stars, growth; empty: none). See [GitHub](/platforms/github#repositories).\n\n- traction: under 30 days old, it reached 10 stars.\n- stars: it passed a milestone (100, 250, 500, 1,000 ...).\n- growth: it gained stars fast in a week.\n- new: every repository created; opt in, mostly noise."
                            },
                            "minStars": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "maximum": 1000000,
                                  "minimum": 0
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "Only repositories with at least this many stars; null for no minimum."
                            },
                            "minWeeklyStars": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "maximum": 1000000,
                                  "minimum": 25
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "Only repositories that gained at least this many stars in the last 7 days, for every event; an unknown week fails. null: growth needs 100 stars and 20% a week, other events nothing."
                            }
                          },
                          "description": "GitHub only: each field is replaced when sent, kept when omitted; null clears a minimum.",
                          "additionalProperties": false
                        },
                        "requiredMode": {
                          "enum": [
                            "any",
                            "all"
                          ],
                          "type": "string",
                          "description": "any: at least one required term must appear. all: every one must."
                        },
                        "caseSensitive": {
                          "type": "boolean",
                          "description": "true: the term must appear in the case it was typed (RAG, never rag). Default false."
                        },
                        "excludedTerms": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "maxLength": 80,
                            "minLength": 1
                          },
                          "maxItems": 50,
                          "description": "A post containing any of these is dropped. A `*` at the start or the end of an entry is a wildcard (beta.* matches beta.0.1; *bot matches nightlybot)."
                        },
                        "requiredTerms": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "maxLength": 80,
                            "minLength": 1
                          },
                          "maxItems": 50,
                          "description": "The post must ALSO contain these terms, any one of them or all of them per requiredMode. A `*` at the start or the end of an entry is a wildcard (alert* matches alerts and alerting). Empty: no requirement."
                        },
                        "requiredGroups": {
                          "type": "array",
                          "items": {
                            "type": "array",
                            "items": {
                              "type": "string",
                              "maxLength": 80,
                              "minLength": 1
                            },
                            "maxItems": 10,
                            "minItems": 1
                          },
                          "maxItems": 50,
                          "description": "Combinations: the post must ALSO contain every term of at least one group (an OR of ANDs), on top of requiredTerms, with the same phrase and wildcard rules. See [Keywords](/guides/keywords#several-searches-in-one-keyword)."
                        },
                        "excludedAuthors": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "maxLength": 500,
                            "minLength": 1
                          },
                          "maxItems": 100,
                          "description": "Posts by these authors are dropped: profile or post links, @handles, u/names, Bluesky DIDs or display names, stored in canonical form like an alert's muted list."
                        }
                      },
                      "description": "Omitted fields are untouched; an empty list clears one.",
                      "additionalProperties": false
                    },
                    "platforms": {
                      "anyOf": [
                        {
                          "type": "array",
                          "items": {
                            "enum": [
                              "bluesky",
                              "hackernews",
                              "github",
                              "stackoverflow",
                              "devto",
                              "reddit",
                              "x",
                              "youtube",
                              "news",
                              "linkedin",
                              "tiktok",
                              "instagram",
                              "facebook",
                              "podcasts",
                              "web",
                              "substack",
                              "producthunt",
                              "threads",
                              "mastodon"
                            ],
                            "type": "string"
                          }
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "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. Not with `subreddit` (its platform is Reddit)."
                    },
                    "readsWorkspaceFeeds": {
                      "type": "boolean",
                      "description": "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."
                    }
                  },
                  "description": "One keyword, as POST /v1/keywords takes it, without reviewSources and feeds (add those afterwards) or subreddit (follow one with POST /v1/keywords).",
                  "additionalProperties": false
                },
                "maxItems": 100,
                "minItems": 1,
                "description": "The keywords to create, 1 to 100 (10 before the first top-up), in order. Each is created or refused on its own."
              },
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              },
              "idempotencyKey": {
                "type": "string",
                "pattern": "^[\\x21-\\x7e]+$",
                "maxLength": 255,
                "minLength": 1,
                "description": "Optional. A unique value (a UUID) for this call: 1 to 255 visible ASCII characters, no spaces. Calling again with the same key and the same input within 24 hours returns the first result instead of doing it twice."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Add keywords",
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "update_keyword",
          "title": "Update keyword",
          "description": "Change a keyword: rewrite it from a boolean query (query: replaces the term and the rules requiredTerms, requiredMode, requiredGroups, excludedTerms and exactPhrase with what the query compiles to, never sent with them or with term; a later hand change of the term or those rules clears the stored query), 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, onlyAuthors: only posts BY these accounts, termIn: the parts (title, body, url, author) the term must appear in), 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). On a keyword that follows a subreddit, subreddit: { keep: \"relevant\" | \"all\" } changes what it keeps; its term, platforms, review pages and feeds cannot be set. It also switches comments on or off (comments: { enabled, maxPerPost }; $0.008 per comment delivered), and sets which mentions it shows by language and country (display: { languages: { only, excluded }, countries: { only, excluded } }, each list replaced when sent; hidden mentions are still billed, and the change applies to older mentions too). 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 }.",
          "inputSchema": {
            "type": "object",
            "required": [
              "id"
            ],
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "description": "Keyword id"
              },
              "cap": {
                "anyOf": [
                  {
                    "type": "object",
                    "required": [
                      "mentions"
                    ],
                    "properties": {
                      "per": {
                        "enum": [
                          "day",
                          "week",
                          "month"
                        ],
                        "type": "string",
                        "default": "month",
                        "description": "The period the cap counts in, in UTC: day, week (from Monday) or calendar month (the default). At the cap the keyword stops until the next period starts."
                      },
                      "mentions": {
                        "type": "integer",
                        "maximum": 1000000,
                        "minimum": 1,
                        "description": "Charged items allowed per period (see per): matched mentions plus the thread comments delivered under them. Every match counts, relevant or not, the look-back a new keyword gets included, because every match bills."
                      }
                    },
                    "description": "A ceiling on what this keyword may be charged for per day, week or month, mentions and comments together. At the cap it stops matching and receiving comments until the next period starts (UTC), or until the cap is raised or removed. It stays unmuted: it keeps its place and its daily keyword charge; pause it to stop that too.",
                    "additionalProperties": false
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "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": {
                "enum": [
                  "brand",
                  "competitor",
                  "topic"
                ],
                "type": "string",
                "description": "Reclassify it as brand, competitor or topic."
              },
              "term": {
                "type": "string",
                "maxLength": 80,
                "minLength": 2,
                "description": "Renames the keyword: the new term is tracked from now on, with no look-back, keeping its id, settings and old mentions. Double quotes mean the exact phrase only. 409 when its group already tracks it. Clears query."
              },
              "feeds": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "url"
                  ],
                  "properties": {
                    "url": {
                      "type": "string",
                      "maxLength": 500,
                      "minLength": 4,
                      "description": "A feed's address (https://forum.example.com/posts.rss), or a page's (https://forum.example.com): the feed the page advertises is used."
                    }
                  },
                  "description": "One feed to read.",
                  "additionalProperties": false
                },
                "maxItems": 20,
                "description": "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": {
                "type": "boolean",
                "description": "A muted keyword stops polling and matching; its mentions stay."
              },
              "query": {
                "type": "string",
                "maxLength": 1000,
                "minLength": 1,
                "description": "Rewrites the term (a rename) and the term rules from a boolean query; the other matching fields stay. Never with term or those rules (400). A later hand change of either clears it. See [Keywords](/guides/keywords#write-it-as-a-query)."
              },
              "context": {
                "anyOf": [
                  {
                    "type": "string",
                    "maxLength": 300,
                    "description": "A sentence the classifier reads for this keyword only, on top of the company profile or group description: what the term means here, what to ignore. \"Arc is our browser; ignore the geometry word.\" Null clears it."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "A sentence the classifier reads for this keyword only, on top of the company profile or group description: what the term means here, what to ignore. \"Arc is our browser; ignore the geometry word.\" Null clears it."
              },
              "display": {
                "type": "object",
                "properties": {
                  "countries": {
                    "type": "object",
                    "properties": {
                      "only": {
                        "type": "array",
                        "items": {
                          "enum": [
                            "us",
                            "ca",
                            "mx",
                            "br",
                            "ar",
                            "co",
                            "cl",
                            "pe",
                            "gb",
                            "ie",
                            "fr",
                            "de",
                            "es",
                            "pt",
                            "it",
                            "nl",
                            "be",
                            "ch",
                            "at",
                            "se",
                            "no",
                            "dk",
                            "fi",
                            "pl",
                            "cz",
                            "ro",
                            "gr",
                            "hu",
                            "ua",
                            "ru",
                            "lt",
                            "lv",
                            "ee",
                            "tr",
                            "il",
                            "ae",
                            "sa",
                            "eg",
                            "ng",
                            "ke",
                            "za",
                            "ma",
                            "in",
                            "pk",
                            "bd",
                            "lk",
                            "np",
                            "cn",
                            "hk",
                            "tw",
                            "jp",
                            "kr",
                            "sg",
                            "my",
                            "id",
                            "ph",
                            "vn",
                            "th",
                            "au",
                            "nz"
                          ],
                          "type": "string"
                        },
                        "maxItems": 60,
                        "description": "Replaces the list; [] clears it."
                      },
                      "excluded": {
                        "type": "array",
                        "items": {
                          "enum": [
                            "us",
                            "ca",
                            "mx",
                            "br",
                            "ar",
                            "co",
                            "cl",
                            "pe",
                            "gb",
                            "ie",
                            "fr",
                            "de",
                            "es",
                            "pt",
                            "it",
                            "nl",
                            "be",
                            "ch",
                            "at",
                            "se",
                            "no",
                            "dk",
                            "fi",
                            "pl",
                            "cz",
                            "ro",
                            "gr",
                            "hu",
                            "ua",
                            "ru",
                            "lt",
                            "lv",
                            "ee",
                            "tr",
                            "il",
                            "ae",
                            "sa",
                            "eg",
                            "ng",
                            "ke",
                            "za",
                            "ma",
                            "in",
                            "pk",
                            "bd",
                            "lk",
                            "np",
                            "cn",
                            "hk",
                            "tw",
                            "jp",
                            "kr",
                            "sg",
                            "my",
                            "id",
                            "ph",
                            "vn",
                            "th",
                            "au",
                            "nz"
                          ],
                          "type": "string"
                        },
                        "maxItems": 60,
                        "description": "Replaces the list; [] clears it."
                      }
                    },
                    "description": "By where the author is (ISO 3166-1 alpha-2); omitted: untouched.",
                    "additionalProperties": false
                  },
                  "languages": {
                    "type": "object",
                    "properties": {
                      "only": {
                        "type": "array",
                        "items": {
                          "enum": [
                            "en",
                            "es",
                            "de",
                            "fr",
                            "pt",
                            "it",
                            "nl",
                            "ca",
                            "pl",
                            "tr",
                            "sv",
                            "da",
                            "ru",
                            "uk",
                            "ar",
                            "hi",
                            "id",
                            "ja",
                            "zh",
                            "ko"
                          ],
                          "type": "string"
                        },
                        "maxItems": 60,
                        "description": "Replaces the list; [] clears it."
                      },
                      "excluded": {
                        "type": "array",
                        "items": {
                          "enum": [
                            "en",
                            "es",
                            "de",
                            "fr",
                            "pt",
                            "it",
                            "nl",
                            "ca",
                            "pl",
                            "tr",
                            "sv",
                            "da",
                            "ru",
                            "uk",
                            "ar",
                            "hi",
                            "id",
                            "ja",
                            "zh",
                            "ko"
                          ],
                          "type": "string"
                        },
                        "maxItems": 60,
                        "description": "Replaces the list; [] clears it."
                      }
                    },
                    "description": "By the language of the post (ISO 639-1); omitted: untouched.",
                    "additionalProperties": false
                  }
                },
                "description": "Which of this keyword's mentions you see, by language and country; each list is replaced when sent, kept when omitted. Hidden mentions are still billed.",
                "additionalProperties": false
              },
              "groupId": {
                "type": "string",
                "minLength": 1,
                "description": "Moves the keyword to this group (grp_...). A 409 when that group already tracks the term."
              },
              "comments": {
                "type": "object",
                "properties": {
                  "enabled": {
                    "type": "boolean",
                    "description": "Read the comments under this keyword's relevant mentions. Each comment delivered costs $0.008; comments under three words are dropped, never billed. See [Comments](/guides/comments)."
                  },
                  "maxPerPost": {
                    "type": "integer",
                    "maximum": 100,
                    "minimum": 1,
                    "description": "The newest comments of one thread you receive: the ceiling on what one mention's comments can cost. A comment naming the keyword is a mention only among these."
                  }
                },
                "description": "Comments under this keyword's mentions; omitted fields are untouched (on create: off, 20 per post).",
                "additionalProperties": false
              },
              "matching": {
                "type": "object",
                "properties": {
                  "termIn": {
                    "type": "array",
                    "items": {
                      "enum": [
                        "title",
                        "body",
                        "url",
                        "author"
                      ],
                      "type": "string"
                    },
                    "maxItems": 4,
                    "description": "Where the term must appear, any part listed; empty: anywhere; reviews are exempt. See [Keywords](/guides/keywords#where-the-term-must-appear).\n\n- title: the post's title (none on X, Bluesky or LinkedIn).\n- body: the text after the title.\n- url: the post's link.\n- author: the author's name or handle."
                  },
                  "subreddits": {
                    "type": "object",
                    "properties": {
                      "only": {
                        "type": "array",
                        "items": {
                          "type": "string",
                          "maxLength": 100,
                          "minLength": 1
                        },
                        "maxItems": 50,
                        "description": "Replaces the keyword's allowlist; [] clears it."
                      },
                      "excluded": {
                        "type": "array",
                        "items": {
                          "type": "string",
                          "maxLength": 100,
                          "minLength": 1
                        },
                        "maxItems": 50,
                        "description": "Replaces the keyword's deny list; [] clears it."
                      }
                    },
                    "description": "Reddit only, for this keyword alone: each list is replaced when sent, kept when omitted.",
                    "additionalProperties": false
                  },
                  "exactPhrase": {
                    "type": "boolean",
                    "description": "true: only the exact phrase matches (a term sent in double quotes sets it). false: a multi-word keyword also matches its words close together, kept and billed only when scored relevant. See [Keywords](/guides/keywords#the-exact-phrase-only)."
                  },
                  "onlyAuthors": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 500,
                      "minLength": 1
                    },
                    "maxItems": 100,
                    "description": "When non-empty, only posts BY these accounts match, in the forms excludedAuthors takes; a Bluesky handle is stored with its DID. Reviews and comments read under a mention are exempt."
                  },
                  "repositories": {
                    "type": "object",
                    "properties": {
                      "events": {
                        "type": "array",
                        "items": {
                          "enum": [
                            "new",
                            "traction",
                            "stars",
                            "growth"
                          ],
                          "type": "string"
                        },
                        "description": "The repository events this keyword takes (default traction, stars, growth; empty: none). See [GitHub](/platforms/github#repositories).\n\n- traction: under 30 days old, it reached 10 stars.\n- stars: it passed a milestone (100, 250, 500, 1,000 ...).\n- growth: it gained stars fast in a week.\n- new: every repository created; opt in, mostly noise."
                      },
                      "minStars": {
                        "anyOf": [
                          {
                            "type": "integer",
                            "maximum": 1000000,
                            "minimum": 0
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Only repositories with at least this many stars; null for no minimum."
                      },
                      "minWeeklyStars": {
                        "anyOf": [
                          {
                            "type": "integer",
                            "maximum": 1000000,
                            "minimum": 25
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Only repositories that gained at least this many stars in the last 7 days, for every event; an unknown week fails. null: growth needs 100 stars and 20% a week, other events nothing."
                      }
                    },
                    "description": "GitHub only: each field is replaced when sent, kept when omitted; null clears a minimum.",
                    "additionalProperties": false
                  },
                  "requiredMode": {
                    "enum": [
                      "any",
                      "all"
                    ],
                    "type": "string",
                    "description": "any: at least one required term must appear. all: every one must."
                  },
                  "caseSensitive": {
                    "type": "boolean",
                    "description": "true: the term must appear in the case it was typed (RAG, never rag). Default false."
                  },
                  "excludedTerms": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 80,
                      "minLength": 1
                    },
                    "maxItems": 50,
                    "description": "A post containing any of these is dropped. A `*` at the start or the end of an entry is a wildcard (beta.* matches beta.0.1; *bot matches nightlybot)."
                  },
                  "requiredTerms": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 80,
                      "minLength": 1
                    },
                    "maxItems": 50,
                    "description": "The post must ALSO contain these terms, any one of them or all of them per requiredMode. A `*` at the start or the end of an entry is a wildcard (alert* matches alerts and alerting). Empty: no requirement."
                  },
                  "requiredGroups": {
                    "type": "array",
                    "items": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "maxLength": 80,
                        "minLength": 1
                      },
                      "maxItems": 10,
                      "minItems": 1
                    },
                    "maxItems": 50,
                    "description": "Combinations: the post must ALSO contain every term of at least one group (an OR of ANDs), on top of requiredTerms, with the same phrase and wildcard rules. See [Keywords](/guides/keywords#several-searches-in-one-keyword)."
                  },
                  "excludedAuthors": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 500,
                      "minLength": 1
                    },
                    "maxItems": 100,
                    "description": "Posts by these authors are dropped: profile or post links, @handles, u/names, Bluesky DIDs or display names, stored in canonical form like an alert's muted list."
                  }
                },
                "description": "Omitted fields are untouched; an empty list clears one.",
                "additionalProperties": false
              },
              "platforms": {
                "anyOf": [
                  {
                    "type": "array",
                    "items": {
                      "enum": [
                        "bluesky",
                        "hackernews",
                        "github",
                        "stackoverflow",
                        "devto",
                        "reddit",
                        "x",
                        "youtube",
                        "news",
                        "linkedin",
                        "tiktok",
                        "instagram",
                        "facebook",
                        "podcasts",
                        "web",
                        "substack",
                        "producthunt",
                        "threads",
                        "mastodon"
                      ],
                      "type": "string"
                    }
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Replaces the platform list; null means every platform, [] none (reviews only, when the keyword has reviewSources)."
              },
              "subreddit": {
                "type": "object",
                "required": [
                  "keep"
                ],
                "properties": {
                  "keep": {
                    "enum": [
                      "relevant",
                      "all"
                    ],
                    "type": "string",
                    "description": "relevant: the classifier keeps the posts relevant to the keyword's context (else your company); the rest are dropped unbilled. all: every new post is a mention, billed like any."
                  }
                },
                "description": "A keyword that follows a subreddit: what it keeps from now on. The subreddit itself cannot change (create another keyword), and a phrase keyword cannot become one (400).",
                "additionalProperties": false
              },
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              },
              "reviewSources": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "maxLength": 200,
                      "minLength": 1,
                      "description": "The id on the platform: the digits after \"id\" on the App Store, the package name on Google Play, the company's domain on Trustpilot (notion.so), a Place ID (ChIJ...) on Google Maps."
                    },
                    "url": {
                      "type": "string",
                      "maxLength": 500,
                      "minLength": 1,
                      "description": "The review page's link: an App Store or Google Play app (https://apps.apple.com/us/app/notion/id1232780281, https://play.google.com/store/apps/details?id=notion.id), a Trustpilot page (https://www.trustpilot.com/review/notion.so) or a Google Maps place (its full link, or a maps.app.goo.gl share link). Or give platform and id."
                    },
                    "language": {
                      "type": "string",
                      "maxLength": 10,
                      "minLength": 2,
                      "description": "Google Play only: the language of the reviews to read (en, es, de, pt-BR); Google Play answers one language at a time. Default: the link's hl, else en."
                    },
                    "platform": {
                      "enum": [
                        "appstore",
                        "googleplay",
                        "trustpilot",
                        "googlemaps"
                      ],
                      "type": "string",
                      "description": "appstore (Apple App Store), googleplay (Google Play), trustpilot (a company's Trustpilot page) or googlemaps (a place's Google reviews)."
                    },
                    "countries": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "pattern": "^[A-Za-z]{2}$"
                      },
                      "maxItems": 20,
                      "minItems": 1,
                      "description": "App Store and Google Play storefronts to read, as two-letter codes; default the link's, else us. Each adds a daily poll; a review seen in two is one mention. Trustpilot and Google Maps take none."
                    }
                  },
                  "description": "A review page whose reviews become this keyword's mentions: its link, or the platform and the id.",
                  "additionalProperties": false
                },
                "maxItems": 10,
                "description": "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."
              },
              "idempotencyKey": {
                "type": "string",
                "pattern": "^[\\x21-\\x7e]+$",
                "maxLength": 255,
                "minLength": 1,
                "description": "Optional. A unique value (a UUID) for this call: 1 to 255 visible ASCII characters, no spaces. Calling again with the same key and the same input within 24 hours returns the first result instead of doing it twice."
              },
              "readsWorkspaceFeeds": {
                "type": "boolean",
                "description": "true: the keyword also reads the workspace's feeds (GET /v1/feeds), live from now on. false: its own feeds alone."
              }
            },
            "description": "Omitted fields are untouched.",
            "additionalProperties": false
          },
          "annotations": {
            "title": "Update keyword",
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": true,
            "destructiveHint": true
          }
        },
        {
          "name": "duplicate_keyword",
          "title": "Duplicate keyword",
          "description": "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.",
          "inputSchema": {
            "type": "object",
            "required": [
              "term",
              "id"
            ],
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "description": "The keyword to copy (kw_...)"
              },
              "term": {
                "type": "string",
                "maxLength": 80,
                "minLength": 2,
                "description": "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": {
                "type": "string",
                "minLength": 1,
                "description": "The group of the copy (grp_...); omit for the original's group."
              },
              "include": {
                "type": "array",
                "items": {
                  "enum": [
                    "reviewSources",
                    "feeds"
                  ],
                  "type": "string"
                },
                "maxItems": 2,
                "description": "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."
              },
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              },
              "idempotencyKey": {
                "type": "string",
                "pattern": "^[\\x21-\\x7e]+$",
                "maxLength": 255,
                "minLength": 1,
                "description": "Optional. A unique value (a UUID) for this call: 1 to 255 visible ASCII characters, no spaces. Calling again with the same key and the same input within 24 hours returns the first result instead of doing it twice."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Duplicate keyword",
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "list_feeds",
          "title": "List feeds",
          "description": "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.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "q": {
                "type": "string",
                "maxLength": 200,
                "minLength": 1,
                "description": "Only feeds whose address or title contains this text, case-insensitive."
              },
              "limit": {
                "type": "integer",
                "default": 100,
                "maximum": 500,
                "minimum": 1,
                "description": "Feeds per page, at most 500; default 100."
              },
              "offset": {
                "type": "integer",
                "default": 0,
                "minimum": 0,
                "description": "Feeds to skip, for the next page."
              },
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "List feeds",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "add_feeds",
          "title": "Add feeds",
          "description": "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.",
          "inputSchema": {
            "type": "object",
            "required": [
              "feeds"
            ],
            "properties": {
              "feeds": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "url"
                  ],
                  "properties": {
                    "url": {
                      "type": "string",
                      "maxLength": 500,
                      "minLength": 4,
                      "description": "A feed's address (https://forum.example.com/posts.rss), or a page's (https://forum.example.com): the feed the page advertises is used."
                    },
                    "auth": {
                      "anyOf": [
                        {
                          "type": "object",
                          "required": [
                            "type",
                            "value"
                          ],
                          "properties": {
                            "type": {
                              "type": "string",
                              "const": "cookie"
                            },
                            "value": {
                              "type": "string",
                              "maxLength": 8000,
                              "minLength": 1,
                              "description": "The Cookie header your browser sends to the forum (devtools, Network, the feed's request, Request Headers, cookie)."
                            }
                          },
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "required": [
                            "type",
                            "name",
                            "value"
                          ],
                          "properties": {
                            "name": {
                              "type": "string",
                              "maxLength": 100,
                              "minLength": 1,
                              "description": "The header name, e.g. Api-Key (Discourse) or Authorization."
                            },
                            "type": {
                              "type": "string",
                              "const": "header"
                            },
                            "value": {
                              "type": "string",
                              "maxLength": 8000,
                              "minLength": 1,
                              "description": "Its value."
                            }
                          },
                          "additionalProperties": false
                        }
                      ],
                      "description": "A sign-in for a members-only feed: a cookie, or one header. Write-only: stored encrypted, sent to the feed's own site alone, never shown again. A feed with a sign-in is read for this workspace alone."
                    }
                  },
                  "description": "One feed to connect, with a sign-in when it is members-only.",
                  "additionalProperties": false
                },
                "maxItems": 100,
                "minItems": 1,
                "description": "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."
              },
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              },
              "idempotencyKey": {
                "type": "string",
                "pattern": "^[\\x21-\\x7e]+$",
                "maxLength": 255,
                "minLength": 1,
                "description": "Optional. A unique value (a UUID) for this call: 1 to 255 visible ASCII characters, no spaces. Calling again with the same key and the same input within 24 hours returns the first result instead of doing it twice."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Add feeds",
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "update_feed",
          "title": "Update feed",
          "description": "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.",
          "inputSchema": {
            "type": "object",
            "required": [
              "id"
            ],
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "description": "Feed id (fd_...), from list_feeds"
              },
              "auth": {
                "anyOf": [
                  {
                    "anyOf": [
                      {
                        "type": "object",
                        "required": [
                          "type",
                          "value"
                        ],
                        "properties": {
                          "type": {
                            "type": "string",
                            "const": "cookie"
                          },
                          "value": {
                            "type": "string",
                            "maxLength": 8000,
                            "minLength": 1,
                            "description": "The Cookie header your browser sends to the forum (devtools, Network, the feed's request, Request Headers, cookie)."
                          }
                        },
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "required": [
                          "type",
                          "name",
                          "value"
                        ],
                        "properties": {
                          "name": {
                            "type": "string",
                            "maxLength": 100,
                            "minLength": 1,
                            "description": "The header name, e.g. Api-Key (Discourse) or Authorization."
                          },
                          "type": {
                            "type": "string",
                            "const": "header"
                          },
                          "value": {
                            "type": "string",
                            "maxLength": 8000,
                            "minLength": 1,
                            "description": "Its value."
                          }
                        },
                        "additionalProperties": false
                      }
                    ],
                    "description": "A sign-in for a members-only feed: a cookie, or one header. Write-only: stored encrypted, sent to the feed's own site alone, never shown again. A feed with a sign-in is read for this workspace alone."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Replaces the sign-in (checked by reading the feed with it first); null removes it and the feed is read signed out again."
              },
              "title": {
                "anyOf": [
                  {
                    "type": "string",
                    "maxLength": 200,
                    "minLength": 1
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Your name for the feed; null clears it."
              },
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              },
              "idempotencyKey": {
                "type": "string",
                "pattern": "^[\\x21-\\x7e]+$",
                "maxLength": 255,
                "minLength": 1,
                "description": "Optional. A unique value (a UUID) for this call: 1 to 255 visible ASCII characters, no spaces. Calling again with the same key and the same input within 24 hours returns the first result instead of doing it twice."
              }
            },
            "description": "Omitted fields are untouched.",
            "additionalProperties": false
          },
          "annotations": {
            "title": "Update feed",
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": true,
            "destructiveHint": true
          }
        },
        {
          "name": "delete_feed",
          "title": "Delete feed",
          "description": "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.",
          "inputSchema": {
            "type": "object",
            "required": [
              "id"
            ],
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "description": "Feed id (fd_...), from list_feeds"
              },
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              },
              "idempotencyKey": {
                "type": "string",
                "pattern": "^[\\x21-\\x7e]+$",
                "maxLength": 255,
                "minLength": 1,
                "description": "Optional. A unique value (a UUID) for this call: 1 to 255 visible ASCII characters, no spaces. Calling again with the same key and the same input within 24 hours returns the first result instead of doing it twice."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Delete feed",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": true
          }
        },
        {
          "name": "get_analytics_summary",
          "title": "Get analytics summary",
          "description": "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, and notKeywordIds and notPlatforms leave keywords or platforms out; 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.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "to": {
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                "description": "Last day, YYYY-MM-DD, inclusive, in `timezone`. Default today."
              },
              "from": {
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                "description": "First day, YYYY-MM-DD, inclusive, in `timezone`."
              },
              "range": {
                "enum": [
                  "7d",
                  "30d",
                  "90d",
                  "365d"
                ],
                "type": "string",
                "description": "Preset window ending today. Ignored when from or to is given. Default 30d."
              },
              "compare": {
                "type": "boolean",
                "description": "true adds the period of the same length right before the window as `previous`."
              },
              "timezone": {
                "type": "string",
                "maxLength": 64,
                "description": "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": {
                "type": "array",
                "items": {
                  "enum": [
                    "bluesky",
                    "hackernews",
                    "github",
                    "stackoverflow",
                    "devto",
                    "reddit",
                    "x",
                    "youtube",
                    "news",
                    "linkedin",
                    "tiktok",
                    "instagram",
                    "facebook",
                    "podcasts",
                    "web",
                    "substack",
                    "producthunt",
                    "threads",
                    "mastodon",
                    "appstore",
                    "googleplay",
                    "trustpilot",
                    "googlemaps",
                    "rss"
                  ],
                  "type": "string"
                },
                "maxItems": 20,
                "description": "Only these platforms. Repeatable, or comma-separated; omit for every platform."
              },
              "keywordIds": {
                "type": "array",
                "items": {
                  "type": "string",
                  "maxLength": 200,
                  "minLength": 1
                },
                "maxItems": 50,
                "description": "Only these keyword ids. Repeatable, or comma-separated; omit for every keyword."
              },
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              },
              "notPlatforms": {
                "type": "array",
                "items": {
                  "enum": [
                    "bluesky",
                    "hackernews",
                    "github",
                    "stackoverflow",
                    "devto",
                    "reddit",
                    "x",
                    "youtube",
                    "news",
                    "linkedin",
                    "tiktok",
                    "instagram",
                    "facebook",
                    "podcasts",
                    "web",
                    "substack",
                    "producthunt",
                    "threads",
                    "mastodon",
                    "appstore",
                    "googleplay",
                    "trustpilot",
                    "googlemaps",
                    "rss"
                  ],
                  "type": "string"
                },
                "maxItems": 20,
                "description": "Never these platforms. Repeatable, or comma-separated."
              },
              "notKeywordIds": {
                "type": "array",
                "items": {
                  "type": "string",
                  "maxLength": 200,
                  "minLength": 1
                },
                "maxItems": 50,
                "description": "Never these keyword ids. Repeatable, or comma-separated."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Get analytics summary",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "get_analytics_series",
          "title": "Get analytics series",
          "description": "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.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "by": {
                "enum": [
                  "platform",
                  "keyword",
                  "sentiment"
                ],
                "type": "string",
                "description": "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": {
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                "description": "Last day, YYYY-MM-DD, inclusive, in `timezone`. Default today."
              },
              "from": {
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                "description": "First day, YYYY-MM-DD, inclusive, in `timezone`."
              },
              "range": {
                "enum": [
                  "7d",
                  "30d",
                  "90d",
                  "365d"
                ],
                "type": "string",
                "description": "Preset window ending today. Ignored when from or to is given. Default 30d."
              },
              "bucket": {
                "enum": [
                  "hour",
                  "day",
                  "week",
                  "month"
                ],
                "type": "string",
                "description": "Point granularity: hour (windows of at most 14 days), day, week (Monday start) or month. Default: day up to 90 days, week beyond."
              },
              "compare": {
                "type": "boolean",
                "description": "true adds the period of the same length right before the window as `previous`."
              },
              "timezone": {
                "type": "string",
                "maxLength": 64,
                "description": "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": {
                "type": "array",
                "items": {
                  "enum": [
                    "bluesky",
                    "hackernews",
                    "github",
                    "stackoverflow",
                    "devto",
                    "reddit",
                    "x",
                    "youtube",
                    "news",
                    "linkedin",
                    "tiktok",
                    "instagram",
                    "facebook",
                    "podcasts",
                    "web",
                    "substack",
                    "producthunt",
                    "threads",
                    "mastodon",
                    "appstore",
                    "googleplay",
                    "trustpilot",
                    "googlemaps",
                    "rss"
                  ],
                  "type": "string"
                },
                "maxItems": 20,
                "description": "Only these platforms. Repeatable, or comma-separated; omit for every platform."
              },
              "keywordIds": {
                "type": "array",
                "items": {
                  "type": "string",
                  "maxLength": 200,
                  "minLength": 1
                },
                "maxItems": 50,
                "description": "Only these keyword ids. Repeatable, or comma-separated; omit for every keyword."
              },
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              },
              "notPlatforms": {
                "type": "array",
                "items": {
                  "enum": [
                    "bluesky",
                    "hackernews",
                    "github",
                    "stackoverflow",
                    "devto",
                    "reddit",
                    "x",
                    "youtube",
                    "news",
                    "linkedin",
                    "tiktok",
                    "instagram",
                    "facebook",
                    "podcasts",
                    "web",
                    "substack",
                    "producthunt",
                    "threads",
                    "mastodon",
                    "appstore",
                    "googleplay",
                    "trustpilot",
                    "googlemaps",
                    "rss"
                  ],
                  "type": "string"
                },
                "maxItems": 20,
                "description": "Never these platforms. Repeatable, or comma-separated."
              },
              "notKeywordIds": {
                "type": "array",
                "items": {
                  "type": "string",
                  "maxLength": 200,
                  "minLength": 1
                },
                "maxItems": 50,
                "description": "Never these keyword ids. Repeatable, or comma-separated."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Get analytics series",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "get_analytics_breakdown",
          "title": "Get analytics breakdown",
          "description": "One table grouped by a dimension `by`: platform, keyword, sentiment, emotion (the emotion toward the keyword; \"unclassified\" when not judged), 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), subreddit (Reddit posts only: which subreddits your mentions come from), domain (the sites posts link to), link (the URLs posts link to) or hashtag (lowercase, without the #). A post can carry several intents, domains, links or hashtags, so those shares can add up past 100. 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.",
          "inputSchema": {
            "type": "object",
            "required": [
              "by"
            ],
            "properties": {
              "by": {
                "enum": [
                  "platform",
                  "keyword",
                  "sentiment",
                  "emotion",
                  "intent",
                  "status",
                  "hour",
                  "person",
                  "language",
                  "country",
                  "subreddit",
                  "domain",
                  "link",
                  "hashtag"
                ],
                "type": "string",
                "description": "The dimension to group by:\n\n- platform or keyword.\n- sentiment: unclassified included.\n- emotion: the emotion toward the keyword; \"unclassified\" if not judged.\n- intent: a mention can carry several.\n- status: open, ignored, done.\n- hour: weekday and hour of day in `timezone`.\n- person: who posted; anonymous posts are left out.\n- language: ISO 639-1; \"unknown\" if none, \"other\" if unnamed.\n- country: the author's, ISO 3166-1 alpha-2; \"unknown\", \"other\" likewise.\n- subreddit: Reddit posts only; `share` stays of the whole window.\n- domain: hosts posts link to; a post can carry several.\n- link: URLs posts link to; a post can carry several.\n- hashtag: lowercase, no #; a post can carry several."
              },
              "to": {
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                "description": "Last day, YYYY-MM-DD, inclusive, in `timezone`. Default today."
              },
              "from": {
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                "description": "First day, YYYY-MM-DD, inclusive, in `timezone`."
              },
              "range": {
                "enum": [
                  "7d",
                  "30d",
                  "90d",
                  "365d"
                ],
                "type": "string",
                "description": "Preset window ending today. Ignored when from or to is given. Default 30d."
              },
              "compare": {
                "type": "boolean",
                "description": "true adds the period of the same length right before the window as `previous`."
              },
              "timezone": {
                "type": "string",
                "maxLength": 64,
                "description": "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": {
                "type": "array",
                "items": {
                  "enum": [
                    "bluesky",
                    "hackernews",
                    "github",
                    "stackoverflow",
                    "devto",
                    "reddit",
                    "x",
                    "youtube",
                    "news",
                    "linkedin",
                    "tiktok",
                    "instagram",
                    "facebook",
                    "podcasts",
                    "web",
                    "substack",
                    "producthunt",
                    "threads",
                    "mastodon",
                    "appstore",
                    "googleplay",
                    "trustpilot",
                    "googlemaps",
                    "rss"
                  ],
                  "type": "string"
                },
                "maxItems": 20,
                "description": "Only these platforms. Repeatable, or comma-separated; omit for every platform."
              },
              "keywordIds": {
                "type": "array",
                "items": {
                  "type": "string",
                  "maxLength": 200,
                  "minLength": 1
                },
                "maxItems": 50,
                "description": "Only these keyword ids. Repeatable, or comma-separated; omit for every keyword."
              },
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              },
              "notPlatforms": {
                "type": "array",
                "items": {
                  "enum": [
                    "bluesky",
                    "hackernews",
                    "github",
                    "stackoverflow",
                    "devto",
                    "reddit",
                    "x",
                    "youtube",
                    "news",
                    "linkedin",
                    "tiktok",
                    "instagram",
                    "facebook",
                    "podcasts",
                    "web",
                    "substack",
                    "producthunt",
                    "threads",
                    "mastodon",
                    "appstore",
                    "googleplay",
                    "trustpilot",
                    "googlemaps",
                    "rss"
                  ],
                  "type": "string"
                },
                "maxItems": 20,
                "description": "Never these platforms. Repeatable, or comma-separated."
              },
              "notKeywordIds": {
                "type": "array",
                "items": {
                  "type": "string",
                  "maxLength": 200,
                  "minLength": 1
                },
                "maxItems": 50,
                "description": "Never these keyword ids. Repeatable, or comma-separated."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Get analytics breakdown",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "get_share_of_voice",
          "title": "Get share of voice",
          "description": "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.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "to": {
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                "description": "Last day, YYYY-MM-DD, inclusive, in `timezone`. Default today."
              },
              "from": {
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                "description": "First day, YYYY-MM-DD, inclusive, in `timezone`."
              },
              "range": {
                "enum": [
                  "7d",
                  "30d",
                  "90d",
                  "365d"
                ],
                "type": "string",
                "description": "Preset window ending today. Ignored when from or to is given. Default 30d."
              },
              "compare": {
                "type": "boolean",
                "description": "true adds the period of the same length right before the window as `previous`."
              },
              "timezone": {
                "type": "string",
                "maxLength": 64,
                "description": "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": {
                "type": "array",
                "items": {
                  "enum": [
                    "bluesky",
                    "hackernews",
                    "github",
                    "stackoverflow",
                    "devto",
                    "reddit",
                    "x",
                    "youtube",
                    "news",
                    "linkedin",
                    "tiktok",
                    "instagram",
                    "facebook",
                    "podcasts",
                    "web",
                    "substack",
                    "producthunt",
                    "threads",
                    "mastodon",
                    "appstore",
                    "googleplay",
                    "trustpilot",
                    "googlemaps",
                    "rss"
                  ],
                  "type": "string"
                },
                "maxItems": 20,
                "description": "Only these platforms. Repeatable, or comma-separated; omit for every platform."
              },
              "keywordIds": {
                "type": "array",
                "items": {
                  "type": "string",
                  "maxLength": 200,
                  "minLength": 1
                },
                "maxItems": 50,
                "description": "Only these keyword ids. Repeatable, or comma-separated; omit for every keyword."
              },
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              },
              "notPlatforms": {
                "type": "array",
                "items": {
                  "enum": [
                    "bluesky",
                    "hackernews",
                    "github",
                    "stackoverflow",
                    "devto",
                    "reddit",
                    "x",
                    "youtube",
                    "news",
                    "linkedin",
                    "tiktok",
                    "instagram",
                    "facebook",
                    "podcasts",
                    "web",
                    "substack",
                    "producthunt",
                    "threads",
                    "mastodon",
                    "appstore",
                    "googleplay",
                    "trustpilot",
                    "googlemaps",
                    "rss"
                  ],
                  "type": "string"
                },
                "maxItems": 20,
                "description": "Never these platforms. Repeatable, or comma-separated."
              },
              "notKeywordIds": {
                "type": "array",
                "items": {
                  "type": "string",
                  "maxLength": 200,
                  "minLength": 1
                },
                "maxItems": 50,
                "description": "Never these keyword ids. Repeatable, or comma-separated."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Get share of voice",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "get_reviews_report",
          "title": "Get reviews report",
          "description": "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.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "to": {
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                "description": "Last day, YYYY-MM-DD, inclusive, in `timezone`. Default today."
              },
              "from": {
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                "description": "First day, YYYY-MM-DD, inclusive, in `timezone`."
              },
              "range": {
                "enum": [
                  "7d",
                  "30d",
                  "90d",
                  "365d"
                ],
                "type": "string",
                "description": "Preset window ending today. Ignored when from or to is given. Default 30d."
              },
              "bucket": {
                "enum": [
                  "day",
                  "week"
                ],
                "type": "string",
                "description": "Series bucket: day (default up to 90 days) or week."
              },
              "compare": {
                "type": "boolean",
                "description": "true adds the period of the same length right before the window as `previous`."
              },
              "timezone": {
                "type": "string",
                "maxLength": 64,
                "description": "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": {
                "type": "array",
                "items": {
                  "enum": [
                    "bluesky",
                    "hackernews",
                    "github",
                    "stackoverflow",
                    "devto",
                    "reddit",
                    "x",
                    "youtube",
                    "news",
                    "linkedin",
                    "tiktok",
                    "instagram",
                    "facebook",
                    "podcasts",
                    "web",
                    "substack",
                    "producthunt",
                    "threads",
                    "mastodon",
                    "appstore",
                    "googleplay",
                    "trustpilot",
                    "googlemaps",
                    "rss"
                  ],
                  "type": "string"
                },
                "maxItems": 20,
                "description": "Only these platforms. Repeatable, or comma-separated; omit for every platform."
              },
              "keywordIds": {
                "type": "array",
                "items": {
                  "type": "string",
                  "maxLength": 200,
                  "minLength": 1
                },
                "maxItems": 50,
                "description": "Only these keyword ids. Repeatable, or comma-separated; omit for every keyword."
              },
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              },
              "notPlatforms": {
                "type": "array",
                "items": {
                  "enum": [
                    "bluesky",
                    "hackernews",
                    "github",
                    "stackoverflow",
                    "devto",
                    "reddit",
                    "x",
                    "youtube",
                    "news",
                    "linkedin",
                    "tiktok",
                    "instagram",
                    "facebook",
                    "podcasts",
                    "web",
                    "substack",
                    "producthunt",
                    "threads",
                    "mastodon",
                    "appstore",
                    "googleplay",
                    "trustpilot",
                    "googlemaps",
                    "rss"
                  ],
                  "type": "string"
                },
                "maxItems": 20,
                "description": "Never these platforms. Repeatable, or comma-separated."
              },
              "notKeywordIds": {
                "type": "array",
                "items": {
                  "type": "string",
                  "maxLength": 200,
                  "minLength": 1
                },
                "maxItems": 50,
                "description": "Never these keyword ids. Repeatable, or comma-separated."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Get reviews report",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "list_alerts",
          "title": "List alerts",
          "description": "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.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "List alerts",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "get_alert",
          "title": "Get alert",
          "description": "One alert rule by id: its filter, mode and schedule, channels and delivery stats.",
          "inputSchema": {
            "type": "object",
            "required": [
              "id"
            ],
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "description": "Alert id (feed_...)"
              },
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Get alert",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "delete_alert",
          "title": "Delete alert",
          "description": "Delete an alert rule. Its channels stay and can serve other rules. Irreversible; disabling it (update_alert enabled=false) keeps the rule.",
          "inputSchema": {
            "type": "object",
            "required": [
              "id"
            ],
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "description": "Alert id (feed_...)"
              },
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              },
              "idempotencyKey": {
                "type": "string",
                "pattern": "^[\\x21-\\x7e]+$",
                "maxLength": 255,
                "minLength": 1,
                "description": "Optional. A unique value (a UUID) for this call: 1 to 255 visible ASCII characters, no spaces. Calling again with the same key and the same input within 24 hours returns the first result instead of doing it twice."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Delete alert",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": true
          }
        },
        {
          "name": "list_channels",
          "title": "List channels",
          "description": "List the channels alerts can be sent to: Slack channels, Telegram chats, Discord and Teams channels, email address lists, webhooks. Add a Slack, Discord or Teams channel or a webhook with create_channel; Telegram chats connect from the dashboard (Settings, Integrations), not through the API.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "List channels",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "list_slack_channels",
          "title": "List slack channels",
          "description": "The channels of the connected Slack workspace that alerts can post to: every public channel, plus each private channel the Mentio bot was added to (in Slack, /invite @Mentio). privateChannels false means the workspace was connected before Mentio could see private channels: reconnect Slack once in the dashboard (Settings, Integrations). Pass a channel id and name to create_channel.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "List slack channels",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "create_channel",
          "title": "Create channel",
          "description": "Add a channel alerts can be sent to, then name its id in create_alert or update_alert channelIds. kind \"slack\": channelId and channelName from list_slack_channels (a private channel needs the bot invited first). kind \"webhook\": url, optional label and headers; the signing secret comes back once, in this answer. kind \"discord\": url is the Discord incoming webhook URL (https://discord.com/api/webhooks/<id>/<token>, from the Discord channel's settings, Integrations, Webhooks). kind \"teams\": url is a Teams Workflows webhook URL (in Teams, the channel's menu, Workflows, \"Send webhook alerts to a channel\"); old Office 365 connector URLs are refused, Microsoft retired them. Discord and Teams URLs are write-only: answers show urlHint. Email lists are made in the dashboard or with POST /v1/channels, which send each address its confirmation link. events: attention events to receive here (mention.spike, sentiment.negative_spike, keyword.noisy, channel.failing; on a webhook also the account events), on top of what rules send.",
          "inputSchema": {
            "type": "object",
            "required": [
              "kind"
            ],
            "properties": {
              "url": {
                "type": "string",
                "format": "uri",
                "description": "webhook: where the signed POSTs go. discord, teams: the incoming webhook URL."
              },
              "kind": {
                "enum": [
                  "slack",
                  "webhook",
                  "discord",
                  "teams"
                ],
                "type": "string",
                "description": "slack, webhook, discord or teams."
              },
              "label": {
                "type": "string",
                "maxLength": 80,
                "description": "webhook, discord, teams: a name; the URL host (webhook) or \"Discord\" / \"Teams\" when omitted."
              },
              "events": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "maxItems": 20,
                "description": "Events to receive here on top of rules. Omit for none."
              },
              "headers": {
                "type": "object",
                "description": "webhook: extra request headers, for your own auth.",
                "propertyNames": {
                  "pattern": "^[A-Za-z0-9-]{1,64}$"
                },
                "additionalProperties": {
                  "type": "string",
                  "maxLength": 1024
                }
              },
              "channelId": {
                "type": "string",
                "maxLength": 40,
                "minLength": 1,
                "description": "slack: the channel id (C...) from list_slack_channels."
              },
              "channelName": {
                "type": "string",
                "maxLength": 90,
                "minLength": 1,
                "description": "slack: the channel name, for the label."
              },
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              },
              "idempotencyKey": {
                "type": "string",
                "pattern": "^[\\x21-\\x7e]+$",
                "maxLength": 255,
                "minLength": 1,
                "description": "Optional. A unique value (a UUID) for this call: 1 to 255 visible ASCII characters, no spaces. Calling again with the same key and the same input within 24 hours returns the first result instead of doing it twice."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Create channel",
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "list_attention",
          "title": "List attention",
          "description": "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), a channel whose last sends all failed (channel.failing), a workspace feed that failed 3 reads in a row (feed.failing), a person with 100,000+ followers whose relevant mention nobody answered for 3 hours (mention.unanswered_influencer, one item per person about their newest such post), or many relevant posts on one keyword sharing an intent tag or a hashtag in 24 hours (mention.topic_cluster). 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.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "kinds": {
                "type": "array",
                "items": {
                  "enum": [
                    "mention.spike",
                    "sentiment.negative_spike",
                    "keyword.noisy",
                    "channel.failing",
                    "feed.failing",
                    "feed.recovered",
                    "mention.unanswered_influencer",
                    "mention.topic_cluster"
                  ],
                  "type": "string",
                  "description": "- mention.spike: far more mentions in the last hour than usual.\n- sentiment.negative_spike: the negative share of the last 24 hours jumped.\n- keyword.noisy: most scored matches are noise.\n- channel.failing: the channel's last sends all failed.\n- feed.failing: a workspace feed failed its last 3 hourly reads.\n- feed.recovered: it read again after failing.\n- mention.unanswered_influencer: a top influencer's relevant mention is still open after 3 hours.\n- mention.topic_cluster: posts on one keyword share a tag in 24 hours."
                },
                "maxItems": 8,
                "description": "Only these kinds."
              },
              "limit": {
                "type": "integer",
                "maximum": 100,
                "minimum": 1,
                "description": "Items to return, 50 by default."
              },
              "cursor": {
                "type": "string",
                "description": "nextCursor from the previous call."
              },
              "status": {
                "enum": [
                  "open",
                  "resolved",
                  "dismissed",
                  "all"
                ],
                "type": "string",
                "description": "open (default), resolved, dismissed, or all."
              },
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "List attention",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "dismiss_attention",
          "title": "Dismiss attention",
          "description": "Dismiss an attention item (att_... from list_attention): it leaves the open list and does not come back while its condition lasts.",
          "inputSchema": {
            "type": "object",
            "required": [
              "id"
            ],
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "description": "Attention item id (att_...)"
              },
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              },
              "idempotencyKey": {
                "type": "string",
                "pattern": "^[\\x21-\\x7e]+$",
                "maxLength": 255,
                "minLength": 1,
                "description": "Optional. A unique value (a UUID) for this call: 1 to 255 visible ASCII characters, no spaces. Calling again with the same key and the same input within 24 hours returns the first result instead of doing it twice."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Dismiss attention",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "create_alert",
          "title": "Create alert",
          "description": "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, Discord, Teams, 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.",
          "inputSchema": {
            "truncated": true,
            "chars": 20038
          },
          "annotations": {
            "title": "Create alert",
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "update_alert",
          "title": "Update alert",
          "description": "Change an alert: name, enabled, mode, schedule, filter (replaces the whole filter) or channelIds (replaces the whole list).",
          "inputSchema": {
            "type": "object",
            "required": [
              "id"
            ],
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "description": "Rule id"
              },
              "mode": {
                "enum": [
                  "instant",
                  "hourly",
                  "daily",
                  "weekly"
                ],
                "type": "string"
              },
              "name": {
                "type": "string",
                "maxLength": 80,
                "minLength": 1,
                "description": "Rule name."
              },
              "event": {
                "anyOf": [
                  {
                    "type": "string",
                    "pattern": "^[a-z][a-z0-9_]*(\\.[a-z][a-z0-9_]*)*$",
                    "maxLength": 60
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "filter": {
                "type": "object",
                "properties": {
                  "tags": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 40,
                      "minLength": 1
                    },
                    "maxItems": 20,
                    "description": "Only authors tagged with any of these, in the workspace's tags or those of the mention's own keyword group."
                  },
                  "anyOf": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "q": {
                          "type": "string",
                          "maxLength": 200,
                          "minLength": 1,
                          "description": "Substring in the post text or the author's name."
                        },
                        "kind": {
                          "enum": [
                            "post",
                            "comment",
                            "repository"
                          ],
                          "type": "string",
                          "description": "Only posts (post), only comments (comment) or only GitHub repository events (repository)."
                        },
                        "tags": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "maxLength": 40,
                            "minLength": 1
                          },
                          "maxItems": 20,
                          "description": "Only authors tagged with any of these, in the workspace's tags or those of the mention's own keyword group."
                        },
                        "labels": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "maxLength": 40,
                            "minLength": 1
                          },
                          "maxItems": 20,
                          "description": "Only mentions carrying any of these labels (exact, case-sensitive)."
                        },
                        "status": {
                          "enum": [
                            "open",
                            "ignored",
                            "done"
                          ],
                          "type": "string",
                          "description": "Only mentions in this status: open, ignored, done."
                        },
                        "intents": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "maxLength": 40,
                            "minLength": 1
                          },
                          "maxItems": 20,
                          "description": "Only mentions carrying any of these intent or topic tags."
                        },
                        "isReply": {
                          "type": "boolean",
                          "description": "true: only replies and comments; false: only top-level posts."
                        },
                        "notTags": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "maxLength": 40,
                            "minLength": 1
                          },
                          "maxItems": 20,
                          "description": "Never authors tagged with any of these, in the workspace's tags or those of the mention's own keyword group."
                        },
                        "ratings": {
                          "type": "array",
                          "items": {
                            "type": "integer",
                            "maximum": 5,
                            "minimum": 1
                          },
                          "maxItems": 5,
                          "description": "Only app store reviews with any of these star ratings; every other post fails it."
                        },
                        "emotions": {
                          "type": "array",
                          "items": {
                            "enum": [
                              "joy",
                              "trust",
                              "anticipation",
                              "surprise",
                              "confusion",
                              "frustration",
                              "anger",
                              "fear",
                              "sadness",
                              "neutral"
                            ],
                            "type": "string",
                            "description": "An emotion toward the keyword (see classification.emotion)."
                          },
                          "maxItems": 10,
                          "description": "Only mentions showing any of these emotions toward the keyword. A mention whose emotion was not judged never passes."
                        },
                        "groupIds": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1
                          },
                          "maxItems": 50,
                          "description": "Only matches of keywords in any of these groups (grp_...)."
                        },
                        "minLikes": {
                          "type": "integer",
                          "minimum": 0,
                          "description": "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": {
                          "type": "integer",
                          "minimum": 0,
                          "description": "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."
                        },
                        "relevant": {
                          "type": "boolean",
                          "description": "true: only mentions the classifier scored relevant; false: only the rest."
                        },
                        "automated": {
                          "type": "boolean",
                          "description": "true: only posts that read as machine-made; false: only the rest."
                        },
                        "countries": {
                          "type": "array",
                          "items": {
                            "enum": [
                              "us",
                              "ca",
                              "mx",
                              "br",
                              "ar",
                              "co",
                              "cl",
                              "pe",
                              "gb",
                              "ie",
                              "fr",
                              "de",
                              "es",
                              "pt",
                              "it",
                              "nl",
                              "be",
                              "ch",
                              "at",
                              "se",
                              "no",
                              "dk",
                              "fi",
                              "pl",
                              "cz",
                              "ro",
                              "gr",
                              "hu",
                              "ua",
                              "ru",
                              "lt",
                              "lv",
                              "ee",
                              "tr",
                              "il",
                              "ae",
                              "sa",
                              "eg",
                              "ng",
                              "ke",
                              "za",
                              "ma",
                              "in",
                              "pk",
                              "bd",
                              "lk",
                              "np",
                              "cn",
                              "hk",
                              "tw",
                              "jp",
                              "kr",
                              "sg",
                              "my",
                              "id",
                              "ph",
                              "vn",
                              "th",
                              "au",
                              "nz"
                            ],
                            "type": "string"
                          },
                          "maxItems": 100,
                          "description": "Only posts whose author is in any of these countries (ISO 3166-1 alpha-2: us, in, de). An unknown country never passes."
                        },
                        "languages": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "pattern": "^[a-z]{2}$"
                          },
                          "maxItems": 20,
                          "description": "Only posts in any of these languages (ISO 639-1)."
                        },
                        "linkHosts": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "maxLength": 200,
                            "minLength": 1
                          },
                          "maxItems": 20,
                          "description": "Only posts linking to any of these hosts, the host itself or a subdomain of it."
                        },
                        "minQuotes": {
                          "type": "integer",
                          "minimum": 0,
                          "description": "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."
                        },
                        "notLabels": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "maxLength": 40,
                            "minLength": 1
                          },
                          "maxItems": 20,
                          "description": "Never mentions carrying any of these labels."
                        },
                        "platforms": {
                          "type": "array",
                          "items": {
                            "enum": [
                              "bluesky",
                              "hackernews",
                              "github",
                              "stackoverflow",
                              "devto",
                              "reddit",
                              "x",
                              "youtube",
                              "news",
                              "linkedin",
                              "tiktok",
                              "instagram",
                              "facebook",
                              "podcasts",
                              "web",
                              "substack",
                              "producthunt",
                              "threads",
                              "mastodon",
                              "appstore",
                              "googleplay",
                              "trustpilot",
                              "googlemaps",
                              "rss"
                            ],
                            "type": "string",
                            "description": "Platform, one of:\n- Social: bluesky, x, reddit, linkedin, facebook, instagram, tiktok, threads, mastodon\n- Developer: hackernews, github, stackoverflow, devto\n- Media: news, youtube, podcasts (with transcripts), rss (keyword feeds)\n- Web: web (blogs), substack, producthunt\n- Reviews: appstore, googleplay, trustpilot, googlemaps (Google reviews)"
                          },
                          "maxItems": 20,
                          "description": "Only posts from any of these platforms."
                        },
                        "keywordIds": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1
                          },
                          "maxItems": 50,
                          "description": "Only matches of any of these keywords."
                        },
                        "minReplies": {
                          "type": "integer",
                          "minimum": 0,
                          "description": "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": {
                          "type": "integer",
                          "minimum": 0,
                          "description": "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."
                        },
                        "notAuthors": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "maxLength": 200,
                            "minLength": 1
                          },
                          "maxItems": 200,
                          "description": "Never these authors: display names, handles or profile URLs."
                        },
                        "notIntents": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "maxLength": 40,
                            "minLength": 1
                          },
                          "maxItems": 20,
                          "description": "Never mentions carrying these tags."
                        },
                        "notRatings": {
                          "type": "array",
                          "items": {
                            "type": "integer",
                            "maximum": 5,
                            "minimum": 1
                          },
                          "maxItems": 5,
                          "description": "Never reviews with these star ratings; posts that are not reviews still pass."
                        },
                        "sentiments": {
                          "type": "array",
                          "items": {
                            "enum": [
                              "positive",
                              "neutral",
                              "negative"
                            ],
                            "type": "string",
                            "description": "Classifier sentiment."
                          },
                          "maxItems": 3,
                          "description": "Only these sentiments."
                        },
                        "subreddits": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "maxLength": 60,
                            "minLength": 1
                          },
                          "maxItems": 50,
                          "description": "Only Reddit posts from any of these subreddits (names without the r/, any case); every other post fails it."
                        },
                        "notEmotions": {
                          "type": "array",
                          "items": {
                            "enum": [
                              "joy",
                              "trust",
                              "anticipation",
                              "surprise",
                              "confusion",
                              "frustration",
                              "anger",
                              "fear",
                              "sadness",
                              "neutral"
                            ],
                            "type": "string",
                            "description": "An emotion toward the keyword (see classification.emotion)."
                          },
                          "maxItems": 10,
                          "description": "Never these emotions; a mention whose emotion was not judged still passes."
                        },
                        "notGroupIds": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1
                          },
                          "maxItems": 50,
                          "description": "Never matches of keywords in these groups."
                        },
                        "keywordKinds": {
                          "type": "array",
                          "items": {
                            "enum": [
                              "brand",
                              "competitor",
                              "topic"
                            ],
                            "type": "string"
                          },
                          "maxItems": 3,
                          "description": "Only matches of keywords of any of these kinds: brand, competitor, topic."
                        },
                        "maxFollowers": {
                          "type": "integer",
                          "minimum": 0,
                          "description": "Only authors with at most this many followers; unknown reach never passes."
                        },
                        "minBookmarks": {
                          "type": "integer",
                          "minimum": 0,
                          "description": "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": {
                          "type": "integer",
                          "minimum": 0,
                          "description": "Only authors with at least this many followers; unknown reach never passes."
                        },
                        "minRelevance": {
                          "type": "integer",
                          "maximum": 100,
                          "minimum": 0,
                          "description": "Only mentions scored at least this."
                        },
                        "notCountries": {
                          "type": "array",
                          "items": {
                            "enum": [
                              "us",
                              "ca",
                              "mx",
                              "br",
                              "ar",
                              "co",
                              "cl",
                              "pe",
                              "gb",
                              "ie",
                              "fr",
                              "de",
                              "es",
                              "pt",
                              "it",
                              "nl",
                              "be",
                              "ch",
                              "at",
                              "se",
                              "no",
                              "dk",
                              "fi",
                              "pl",
                              "cz",
                              "ro",
                              "gr",
                              "hu",
                              "ua",
                              "ru",
                              "lt",
                              "lv",
                              "ee",
                              "tr",
                              "il",
                              "ae",
                              "sa",
                              "eg",
                              "ng",
                              "ke",
                              "za",
                              "ma",
                              "in",
                              "pk",
                              "bd",
                              "lk",
                              "np",
                              "cn",
                              "hk",
                              "tw",
                              "jp",
                              "kr",
                              "sg",
                              "my",
                              "id",
                              "ph",
                              "vn",
                              "th",
                              "au",
                              "nz"
                            ],
                            "type": "string"
                          },
                          "maxItems": 100,
                          "description": "Never posts whose author is in these countries; an unknown country still passes."
                        },
                        "notLanguages": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "pattern": "^[a-z]{2}$"
                          },
                          "maxItems": 20,
                          "description": "Never posts in these languages; an unknown language still passes."
                        },
                        "notLinkHosts": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "maxLength": 200,
                            "minLength": 1
                          },
                          "maxItems": 20,
                          "description": "Never posts linking to these hosts."
                        },
                        "notPlatforms": {
                          "type": "array",
                          "items": {
                            "enum": [
                              "bluesky",
                              "hackernews",
                              "github",
                              "stackoverflow",
                              "devto",
                              "reddit",
                              "x",
                              "youtube",
                              "news",
                              "linkedin",
                              "tiktok",
                              "instagram",
                              "facebook",
                              "podcasts",
                              "web",
                              "substack",
                              "producthunt",
                              "threads",
                              "mastodon",
                              "appstore",
                              "googleplay",
                              "trustpilot",
                              "googlemaps",
                              "rss"
                            ],
                            "type": "string",
                            "description": "Platform, one of:\n- Social: bluesky, x, reddit, linkedin, facebook, instagram, tiktok, threads, mastodon\n- Developer: hackernews, github, stackoverflow, devto\n- Media: news, youtube, podcasts (with transcripts), rss (keyword feeds)\n- Web: web (blogs), substack, producthunt\n- Reviews: appstore, googleplay, trustpilot, googlemaps (Google reviews)"
                          },
                          "maxItems": 20,
                          "description": "Never posts from these platforms."
                        },
                        "organization": {
                          "type": "boolean",
                          "description": "true: only posts by companies, brands and organizations; false: only posts by people."
                        },
                        "minConfidence": {
                          "type": "number",
                          "maximum": 1,
                          "minimum": 0,
                          "description": "Only mentions whose classifier confidence is at least this."
                        },
                        "notKeywordIds": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1
                          },
                          "maxItems": 50,
                          "description": "Never matches of these keywords."
                        },
                        "notSentiments": {
                          "type": "array",
                          "items": {
                            "enum": [
                              "positive",
                              "neutral",
                              "negative"
                            ],
                            "type": "string",
                            "description": "Classifier sentiment."
                          },
                          "maxItems": 3,
                          "description": "Never these sentiments; an unscored mention still passes."
                        },
                        "notSubreddits": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "maxLength": 60,
                            "minLength": 1
                          },
                          "maxItems": 50,
                          "description": "Never Reddit posts from these subreddits; posts from other platforms still pass."
                        },
                        "excludeAuthors": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "maxLength": 200,
                            "minLength": 1
                          },
                          "maxItems": 200,
                          "description": "Deprecated: use notAuthors, the same filter. Both may be given; every author named in either is hidden."
                        },
                        "notKeywordKinds": {
                          "type": "array",
                          "items": {
                            "enum": [
                              "brand",
                              "competitor",
                              "topic"
                            ],
                            "type": "string"
                          },
                          "maxItems": 3,
                          "description": "Never matches of keywords of these kinds."
                        }
                      },
                      "description": "A group of conditions, all of which must hold: the vocabulary of a view filter, without anyOf.",
                      "additionalProperties": false
                    },
                    "maxItems": 10,
                    "minItems": 1,
                    "description": "OR across groups: a mention passes when it meets every condition of at least one group, and the other conditions too. A group takes view-filter conditions, no anyOf of its own. See [anyOf](/conventions#or-across-groups-anyof)."
                  },
                  "labels": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 40,
                      "minLength": 1
                    },
                    "maxItems": 20,
                    "description": "Only mentions carrying any of these labels. An automation labels a mention before it is delivered, so a rule can route what an automation labelled."
                  },
                  "intents": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "At least one of these intent or topic tags."
                  },
                  "ratings": {
                    "type": "array",
                    "items": {
                      "type": "integer",
                      "maximum": 5,
                      "minimum": 1
                    },
                    "maxItems": 5,
                    "description": "Only app store reviews with any of these star ratings (1 to 5): [1, 2] sends the unhappy ones. Every other post fails it."
                  },
                  "emotions": {
                    "type": "array",
                    "items": {
                      "enum": [
                        "joy",
                        "trust",
                        "anticipation",
                        "surprise",
                        "confusion",
                        "frustration",
                        "anger",
                        "fear",
                        "sadness",
                        "neutral"
                      ],
                      "type": "string",
                      "description": "An emotion toward the keyword (see classification.emotion)."
                    },
                    "maxItems": 10,
                    "description": "Only mentions showing any of these emotions toward the keyword. A mention whose emotion was not judged never passes."
                  },
                  "groupIds": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Only keywords in these groups (grp_...): one rule per customer, say."
                  },
                  "minLikes": {
                    "type": "integer",
                    "minimum": 0,
                    "description": "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": {
                    "type": "integer",
                    "minimum": 0,
                    "description": "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."
                  },
                  "automated": {
                    "type": "boolean",
                    "description": "true: only posts that read as machine-made (bots, templated posts); false: only the rest. Omit for both."
                  },
                  "countries": {
                    "type": "array",
                    "items": {
                      "enum": [
                        "us",
                        "ca",
                        "mx",
                        "br",
                        "ar",
                        "co",
                        "cl",
                        "pe",
                        "gb",
                        "ie",
                        "fr",
                        "de",
                        "es",
                        "pt",
                        "it",
                        "nl",
                        "be",
                        "ch",
                        "at",
                        "se",
                        "no",
                        "dk",
                        "fi",
                        "pl",
                        "cz",
                        "ro",
                        "gr",
                        "hu",
                        "ua",
                        "ru",
                        "lt",
                        "lv",
                        "ee",
                        "tr",
                        "il",
                        "ae",
                        "sa",
                        "eg",
                        "ng",
                        "ke",
                        "za",
                        "ma",
                        "in",
                        "pk",
                        "bd",
                        "lk",
                        "np",
                        "cn",
                        "hk",
                        "tw",
                        "jp",
                        "kr",
                        "sg",
                        "my",
                        "id",
                        "ph",
                        "vn",
                        "th",
                        "au",
                        "nz"
                      ],
                      "type": "string"
                    },
                    "maxItems": 100,
                    "description": "Only posts whose author is in any of these countries (ISO 3166-1 alpha-2: us, in, de). A post whose country is unknown never passes."
                  },
                  "languages": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "pattern": "^[a-z]{2}$"
                    },
                    "maxItems": 20,
                    "description": "Only posts in any of these languages (ISO 639-1: en, es, de). A post whose language is unknown never passes."
                  },
                  "linkHosts": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 200,
                      "minLength": 1
                    },
                    "maxItems": 20,
                    "description": "Only posts linking to any of these hosts, the host itself or a subdomain of it (octolens.com also matches blog.octolens.com). A post with no links never passes."
                  },
                  "minQuotes": {
                    "type": "integer",
                    "minimum": 0,
                    "description": "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."
                  },
                  "notLabels": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 40,
                      "minLength": 1
                    },
                    "maxItems": 20,
                    "description": "Never mentions carrying any of these labels."
                  },
                  "platforms": {
                    "type": "array",
                    "items": {
                      "enum": [
                        "bluesky",
                        "hackernews",
                        "github",
                        "stackoverflow",
                        "devto",
                        "reddit",
                        "x",
                        "youtube",
                        "news",
                        "linkedin",
                        "tiktok",
                        "instagram",
                        "facebook",
                        "podcasts",
                        "web",
                        "substack",
                        "producthunt",
                        "threads",
                        "mastodon",
                        "appstore",
                        "googleplay",
                        "trustpilot",
                        "googlemaps",
                        "rss"
                      ],
                      "type": "string",
                      "description": "Platform, one of:\n- Social: bluesky, x, reddit, linkedin, facebook, instagram, tiktok, threads, mastodon\n- Developer: hackernews, github, stackoverflow, devto\n- Media: news, youtube, podcasts (with transcripts), rss (keyword feeds)\n- Web: web (blogs), substack, producthunt\n- Reviews: appstore, googleplay, trustpilot, googlemaps (Google reviews)"
                    },
                    "description": "Only posts from these platforms."
                  },
                  "keywordIds": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Only these keywords."
                  },
                  "minReplies": {
                    "type": "integer",
                    "minimum": 0,
                    "description": "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": {
                    "type": "integer",
                    "minimum": 0,
                    "description": "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."
                  },
                  "notRatings": {
                    "type": "array",
                    "items": {
                      "type": "integer",
                      "maximum": 5,
                      "minimum": 1
                    },
                    "maxItems": 5,
                    "description": "Never reviews with these star ratings (1 to 5): [5] keeps the five star reviews out. Posts that are not reviews still pass."
                  },
                  "sentiments": {
                    "type": "array",
                    "items": {
                      "enum": [
                        "positive",
                        "neutral",
                        "negative"
                      ],
                      "type": "string",
                      "description": "Classifier sentiment."
                    },
                    "description": "Only these sentiments."
                  },
                  "notEmotions": {
                    "type": "array",
                    "items": {
                      "enum": [
                        "joy",
                        "trust",
                        "anticipation",
                        "surprise",
                        "confusion",
                        "frustration",
                        "anger",
                        "fear",
                        "sadness",
                        "neutral"
                      ],
                      "type": "string",
                      "description": "An emotion toward the keyword (see classification.emotion)."
                    },
                    "maxItems": 10,
                    "description": "Never these emotions: [\"anger\"]. A mention whose emotion was not judged still passes."
                  },
                  "minBookmarks": {
                    "type": "integer",
                    "minimum": 0,
                    "description": "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": {
                    "type": "integer",
                    "minimum": 0,
                    "description": "Only authors with at least this many followers. Unknown reach never passes."
                  },
                  "minRelevance": {
                    "type": "integer",
                    "maximum": 100,
                    "minimum": 0,
                    "description": "The rule's relevance floor. Absent: relevant mentions only (40 and up); lower, down to 0, it also gets noise; higher, less. Email channels keep the 40 line. Unclassified mentions never pass."
                  },
                  "notCountries": {
                    "type": "array",
                    "items": {
                      "enum": [
                        "us",
                        "ca",
                        "mx",
                        "br",
                        "ar",
                        "co",
                        "cl",
                        "pe",
                        "gb",
                        "ie",
                        "fr",
                        "de",
                        "es",
                        "pt",
                        "it",
                        "nl",
                        "be",
                        "ch",
                        "at",
                        "se",
                        "no",
                        "dk",
                        "fi",
                        "pl",
                        "cz",
                        "ro",
                        "gr",
                        "hu",
                        "ua",
                        "ru",
                        "lt",
                        "lv",
                        "ee",
                        "tr",
                        "il",
                        "ae",
                        "sa",
                        "eg",
                        "ng",
                        "ke",
                        "za",
                        "ma",
                        "in",
                        "pk",
                        "bd",
                        "lk",
                        "np",
                        "cn",
                        "hk",
                        "tw",
                        "jp",
                        "kr",
                        "sg",
                        "my",
                        "id",
                        "ph",
                        "vn",
                        "th",
                        "au",
                        "nz"
                      ],
                      "type": "string"
                    },
                    "maxItems": 100,
                    "description": "Never posts whose author is in these countries: [\"in\"]. A post whose country is unknown still passes."
                  },
                  "organization": {
                    "type": "boolean",
                    "description": "true: only posts by companies, brands and organizations; false: only posts by people. Omit for both."
                  },
                  "minConfidence": {
                    "type": "number",
                    "maximum": 1,
                    "minimum": 0,
                    "description": "Only mentions whose classifier confidence is at least this, 0 to 1. A mention without a confidence never passes."
                  },
                  "excludeAuthors": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 200,
                      "minLength": 1
                    },
                    "maxItems": 200,
                    "description": "Never these authors: display names, handles or profile URLs."
                  }
                },
                "description": "Replaces the whole filter.",
                "additionalProperties": false
              },
              "enabled": {
                "type": "boolean",
                "description": "false: the rule sends nothing."
              },
              "schedule": {
                "anyOf": [
                  {
                    "type": "object",
                    "required": [
                      "hour",
                      "timezone"
                    ],
                    "properties": {
                      "hour": {
                        "type": "integer",
                        "maximum": 23,
                        "minimum": 0,
                        "description": "Hour of the day to send, 0 to 23, in timezone."
                      },
                      "minute": {
                        "type": "integer",
                        "default": 0,
                        "maximum": 59,
                        "minimum": 0,
                        "description": "Minute past the hour, 0 to 59."
                      },
                      "weekday": {
                        "type": "integer",
                        "maximum": 6,
                        "minimum": 0,
                        "description": "Weekly rules: the day it sends, 0 Sunday to 6 Saturday. Required for mode weekly; ignored on daily rules."
                      },
                      "timezone": {
                        "type": "string",
                        "maxLength": 64,
                        "minLength": 1,
                        "description": "IANA zone the schedule runs in (Europe/Madrid)."
                      },
                      "skipEmpty": {
                        "type": "boolean",
                        "default": true,
                        "description": "true: send nothing when the window had no mention."
                      }
                    },
                    "additionalProperties": false
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Daily and weekly alerts. Ignored on an hourly one, except a weekday, which is refused."
              },
              "channelIds": {
                "type": "array",
                "items": {
                  "type": "string",
                  "minLength": 1
                },
                "maxItems": 20,
                "description": "Replaces the whole list."
              },
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              },
              "idempotencyKey": {
                "type": "string",
                "pattern": "^[\\x21-\\x7e]+$",
                "maxLength": 255,
                "minLength": 1,
                "description": "Optional. A unique value (a UUID) for this call: 1 to 255 visible ASCII characters, no spaces. Calling again with the same key and the same input within 24 hours returns the first result instead of doing it twice."
              }
            },
            "description": "Omitted fields are untouched.",
            "additionalProperties": false
          },
          "annotations": {
            "title": "Update alert",
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": true,
            "destructiveHint": true
          }
        },
        {
          "name": "mute_authors",
          "title": "Mute authors",
          "description": "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.",
          "inputSchema": {
            "type": "object",
            "required": [
              "authors",
              "id"
            ],
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "description": "Rule id"
              },
              "authors": {
                "type": "array",
                "items": {
                  "type": "string",
                  "maxLength": 500,
                  "minLength": 1
                },
                "maxItems": 50,
                "minItems": 1,
                "description": "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."
              },
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              },
              "idempotencyKey": {
                "type": "string",
                "pattern": "^[\\x21-\\x7e]+$",
                "maxLength": 255,
                "minLength": 1,
                "description": "Optional. A unique value (a UUID) for this call: 1 to 255 visible ASCII characters, no spaces. Calling again with the same key and the same input within 24 hours returns the first result instead of doing it twice."
              }
            },
            "description": "Authors to add to or remove from the alert's muted list.",
            "additionalProperties": false
          },
          "annotations": {
            "title": "Mute authors",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "unmute_authors",
          "title": "Unmute authors",
          "description": "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.",
          "inputSchema": {
            "type": "object",
            "required": [
              "authors",
              "id"
            ],
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "description": "Rule id"
              },
              "authors": {
                "type": "array",
                "items": {
                  "type": "string",
                  "maxLength": 500,
                  "minLength": 1
                },
                "maxItems": 50,
                "minItems": 1,
                "description": "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."
              },
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              },
              "idempotencyKey": {
                "type": "string",
                "pattern": "^[\\x21-\\x7e]+$",
                "maxLength": 255,
                "minLength": 1,
                "description": "Optional. A unique value (a UUID) for this call: 1 to 255 visible ASCII characters, no spaces. Calling again with the same key and the same input within 24 hours returns the first result instead of doing it twice."
              }
            },
            "description": "Authors to add to or remove from the alert's muted list.",
            "additionalProperties": false
          },
          "annotations": {
            "title": "Unmute authors",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "list_keywords",
          "title": "List keywords",
          "description": "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 kinds, statuses (active, muted by a person, paused by the wallet, noisy: paused by the noise brake, capped at its monthly mention cap), platforms or groupIds, order (sort) and page (limit, offset).",
          "inputSchema": {
            "type": "object",
            "properties": {
              "q": {
                "type": "string",
                "maxLength": 200,
                "minLength": 1,
                "description": "Text to find in the term or in the keyword's context, case-insensitive."
              },
              "kind": {
                "type": "array",
                "items": {
                  "enum": [
                    "brand",
                    "competitor",
                    "topic"
                  ],
                  "type": "string"
                },
                "maxItems": 3,
                "description": "Deprecated: use kinds, the same filter; both are read as one list."
              },
              "sort": {
                "enum": [
                  "newest",
                  "oldest",
                  "term",
                  "mentions",
                  "relevant",
                  "recent",
                  "lastMention"
                ],
                "type": "string",
                "default": "newest",
                "description": "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."
              },
              "kinds": {
                "type": "array",
                "items": {
                  "enum": [
                    "brand",
                    "competitor",
                    "topic"
                  ],
                  "type": "string"
                },
                "maxItems": 3,
                "description": "Only these kinds: brand, competitor, topic. Repeatable, or comma-separated."
              },
              "limit": {
                "type": "integer",
                "maximum": 500,
                "minimum": 1,
                "description": "Page size, 1 to 500. Omit for every keyword after `offset`."
              },
              "offset": {
                "type": "integer",
                "default": 0,
                "minimum": 0,
                "description": "Skip this many keywords."
              },
              "status": {
                "type": "array",
                "items": {
                  "enum": [
                    "active",
                    "muted",
                    "paused",
                    "noisy",
                    "capped"
                  ],
                  "type": "string",
                  "description": "- active: tracking.\n- muted: switched off by a person.\n- paused: switched off by the wallet for lack of balance.\n- noisy: switched off by the noise brake (welcome credit only).\n- capped: at its mention cap until its period turns."
                },
                "maxItems": 5,
                "description": "Deprecated: use statuses, the same filter; both are read as one list."
              },
              "groupId": {
                "type": "array",
                "items": {
                  "type": "string",
                  "maxLength": 200,
                  "minLength": 1
                },
                "maxItems": 50,
                "description": "Deprecated: use groupIds, the same filter; both are read as one list."
              },
              "groupIds": {
                "type": "array",
                "items": {
                  "type": "string",
                  "maxLength": 200,
                  "minLength": 1
                },
                "maxItems": 50,
                "description": "Only keywords in any of these groups (grp_...). Repeatable, or comma-separated."
              },
              "notKinds": {
                "type": "array",
                "items": {
                  "enum": [
                    "brand",
                    "competitor",
                    "topic"
                  ],
                  "type": "string"
                },
                "maxItems": 3,
                "description": "Never these kinds. Repeatable, or comma-separated."
              },
              "platform": {
                "type": "array",
                "items": {
                  "enum": [
                    "bluesky",
                    "hackernews",
                    "github",
                    "stackoverflow",
                    "devto",
                    "reddit",
                    "x",
                    "youtube",
                    "news",
                    "linkedin",
                    "tiktok",
                    "instagram",
                    "facebook",
                    "podcasts",
                    "web",
                    "substack",
                    "producthunt",
                    "threads",
                    "mastodon",
                    "appstore",
                    "googleplay",
                    "trustpilot",
                    "googlemaps",
                    "rss"
                  ],
                  "type": "string",
                  "description": "Platform, one of:\n- Social: bluesky, x, reddit, linkedin, facebook, instagram, tiktok, threads, mastodon\n- Developer: hackernews, github, stackoverflow, devto\n- Media: news, youtube, podcasts (with transcripts), rss (keyword feeds)\n- Web: web (blogs), substack, producthunt\n- Reviews: appstore, googleplay, trustpilot, googlemaps (Google reviews)"
                },
                "maxItems": 20,
                "description": "Deprecated: use platforms, the same filter; both are read as one list."
              },
              "statuses": {
                "type": "array",
                "items": {
                  "enum": [
                    "active",
                    "muted",
                    "paused",
                    "noisy",
                    "capped"
                  ],
                  "type": "string",
                  "description": "- active: tracking.\n- muted: switched off by a person.\n- paused: switched off by the wallet for lack of balance.\n- noisy: switched off by the noise brake (welcome credit only).\n- capped: at its mention cap until its period turns."
                },
                "maxItems": 5,
                "description": "Only keywords in these states: active, muted, paused, noisy, capped. Repeatable, or comma-separated."
              },
              "platforms": {
                "type": "array",
                "items": {
                  "enum": [
                    "bluesky",
                    "hackernews",
                    "github",
                    "stackoverflow",
                    "devto",
                    "reddit",
                    "x",
                    "youtube",
                    "news",
                    "linkedin",
                    "tiktok",
                    "instagram",
                    "facebook",
                    "podcasts",
                    "web",
                    "substack",
                    "producthunt",
                    "threads",
                    "mastodon",
                    "appstore",
                    "googleplay",
                    "trustpilot",
                    "googlemaps",
                    "rss"
                  ],
                  "type": "string",
                  "description": "Platform, one of:\n- Social: bluesky, x, reddit, linkedin, facebook, instagram, tiktok, threads, mastodon\n- Developer: hackernews, github, stackoverflow, devto\n- Media: news, youtube, podcasts (with transcripts), rss (keyword feeds)\n- Web: web (blogs), substack, producthunt\n- Reviews: appstore, googleplay, trustpilot, googlemaps (Google reviews)"
                },
                "maxItems": 20,
                "description": "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."
              },
              "notGroupIds": {
                "type": "array",
                "items": {
                  "type": "string",
                  "maxLength": 200,
                  "minLength": 1
                },
                "maxItems": 50,
                "description": "Never keywords in these groups (grp_...). Repeatable, or comma-separated."
              },
              "notStatuses": {
                "type": "array",
                "items": {
                  "enum": [
                    "active",
                    "muted",
                    "paused",
                    "noisy",
                    "capped"
                  ],
                  "type": "string",
                  "description": "- active: tracking.\n- muted: switched off by a person.\n- paused: switched off by the wallet for lack of balance.\n- noisy: switched off by the noise brake (welcome credit only).\n- capped: at its mention cap until its period turns."
                },
                "maxItems": 5,
                "description": "Never keywords in these states. Repeatable, or comma-separated."
              },
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              },
              "notPlatforms": {
                "type": "array",
                "items": {
                  "enum": [
                    "bluesky",
                    "hackernews",
                    "github",
                    "stackoverflow",
                    "devto",
                    "reddit",
                    "x",
                    "youtube",
                    "news",
                    "linkedin",
                    "tiktok",
                    "instagram",
                    "facebook",
                    "podcasts",
                    "web",
                    "substack",
                    "producthunt",
                    "threads",
                    "mastodon",
                    "appstore",
                    "googleplay",
                    "trustpilot",
                    "googlemaps",
                    "rss"
                  ],
                  "type": "string",
                  "description": "Platform, one of:\n- Social: bluesky, x, reddit, linkedin, facebook, instagram, tiktok, threads, mastodon\n- Developer: hackernews, github, stackoverflow, devto\n- Media: news, youtube, podcasts (with transcripts), rss (keyword feeds)\n- Web: web (blogs), substack, producthunt\n- Reviews: appstore, googleplay, trustpilot, googlemaps (Google reviews)"
                },
                "maxItems": 20,
                "description": "Never keywords tracked on any of these platforms (by the same reading as platforms). Repeatable, or comma-separated."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "List keywords",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "get_keyword",
          "title": "Get keyword",
          "description": "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.",
          "inputSchema": {
            "type": "object",
            "required": [
              "id"
            ],
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "description": "Keyword id (kw_...)"
              },
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Get keyword",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "get_keyword_health",
          "title": "Get keyword health",
          "description": "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.",
          "inputSchema": {
            "type": "object",
            "required": [
              "id"
            ],
            "properties": {
              "ai": {
                "type": "boolean",
                "description": "true: also ask a language model for a rewritten context. Default false."
              },
              "id": {
                "type": "string",
                "minLength": 1,
                "description": "Keyword id (kw_...)"
              },
              "range": {
                "enum": [
                  "7d",
                  "30d",
                  "90d"
                ],
                "type": "string",
                "description": "Trailing window ending today: 7d, 30d (default) or 90d."
              },
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Get keyword health",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "get_keyword_deletion_preview",
          "title": "Get keyword deletion preview",
          "description": "What delete_keyword would remove or change, changing nothing: the keyword's mentions (matches), what it cost this month (charges already made stay, deleting refunds nothing), and every alert rule, automation and view whose filter names it, each with its effect: disabled (it named only this keyword and is switched off), narrowed (it stops naming it and keeps working) or empty (a view naming only it then shows nothing). Call it before delete_keyword and tell the person.",
          "inputSchema": {
            "type": "object",
            "required": [
              "id"
            ],
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "description": "Keyword id (kw_...)"
              },
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Get keyword deletion preview",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "delete_keyword",
          "title": "Delete keyword",
          "description": "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.",
          "inputSchema": {
            "type": "object",
            "required": [
              "id"
            ],
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "description": "Keyword id (kw_...)"
              },
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              },
              "idempotencyKey": {
                "type": "string",
                "pattern": "^[\\x21-\\x7e]+$",
                "maxLength": 255,
                "minLength": 1,
                "description": "Optional. A unique value (a UUID) for this call: 1 to 255 visible ASCII characters, no spaces. Calling again with the same key and the same input within 24 hours returns the first result instead of doing it twice."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Delete keyword",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": true
          }
        },
        {
          "name": "whoami",
          "title": "Whoami",
          "description": "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.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Whoami",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "list_members",
          "title": "List members",
          "description": "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.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "List members",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "get_usage",
          "title": "Get usage",
          "description": "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.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Get usage",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "get_usage_breakdown",
          "title": "Get usage breakdown",
          "description": "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), and `notKeywordIds`, `notGroupIds` and `notPlatforms` leave them out. 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.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "by": {
                "enum": [
                  "day",
                  "platform",
                  "keyword",
                  "group",
                  "workspace"
                ],
                "type": "string",
                "default": "keyword",
                "description": "The dimension to group by:\n\n- day: one row per UTC day.\n- platform.\n- keyword (default): where a margin is read.\n- group: what a customer or campaign cost.\n- workspace: your workspace and each child (no filters)."
              },
              "to": {
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                "description": "Last UTC day of a custom window, YYYY-MM-DD, inclusive; never after today. Needs `from`."
              },
              "from": {
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                "description": "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": {
                "type": "integer",
                "default": 100,
                "maximum": 500,
                "minimum": 1,
                "description": "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": {
                "type": "string",
                "pattern": "^\\d{4}-(0[1-9]|1[0-2])$",
                "description": "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": {
                "enum": [
                  "7d",
                  "30d",
                  "90d"
                ],
                "type": "string",
                "description": "Trailing window of UTC days ending today: 7d, 30d, 90d (default 30d). Ignored when `month` is given."
              },
              "offset": {
                "type": "integer",
                "default": 0,
                "minimum": 0,
                "description": "Skip this many rows."
              },
              "groupIds": {
                "type": "array",
                "items": {
                  "type": "string",
                  "maxLength": 200,
                  "minLength": 1
                },
                "maxItems": 30,
                "description": "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": {
                "type": "array",
                "items": {
                  "enum": [
                    "bluesky",
                    "hackernews",
                    "github",
                    "stackoverflow",
                    "devto",
                    "reddit",
                    "x",
                    "youtube",
                    "news",
                    "linkedin",
                    "tiktok",
                    "instagram",
                    "facebook",
                    "podcasts",
                    "web",
                    "substack",
                    "producthunt",
                    "threads",
                    "mastodon",
                    "appstore",
                    "googleplay",
                    "trustpilot",
                    "googlemaps",
                    "rss"
                  ],
                  "type": "string"
                },
                "maxItems": 20,
                "description": "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": {
                "type": "array",
                "items": {
                  "type": "string",
                  "maxLength": 200,
                  "minLength": 1
                },
                "maxItems": 30,
                "description": "Only these keywords (kw_...), deleted ones included. Repeatable, or comma-separated."
              },
              "notGroupIds": {
                "type": "array",
                "items": {
                  "type": "string",
                  "maxLength": 200,
                  "minLength": 1
                },
                "maxItems": 30,
                "description": "Never keywords of these groups (grp_...). Repeatable, or comma-separated."
              },
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              },
              "notPlatforms": {
                "type": "array",
                "items": {
                  "enum": [
                    "bluesky",
                    "hackernews",
                    "github",
                    "stackoverflow",
                    "devto",
                    "reddit",
                    "x",
                    "youtube",
                    "news",
                    "linkedin",
                    "tiktok",
                    "instagram",
                    "facebook",
                    "podcasts",
                    "web",
                    "substack",
                    "producthunt",
                    "threads",
                    "mastodon",
                    "appstore",
                    "googleplay",
                    "trustpilot",
                    "googlemaps",
                    "rss"
                  ],
                  "type": "string"
                },
                "maxItems": 20,
                "description": "Never mentions or comments from these platforms; keyword-days, which belong to no platform, still count. Repeatable, or comma-separated."
              },
              "notKeywordIds": {
                "type": "array",
                "items": {
                  "type": "string",
                  "maxLength": 200,
                  "minLength": 1
                },
                "maxItems": 30,
                "description": "Never these keywords (kw_...). Repeatable, or comma-separated."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Get usage breakdown",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "list_ledger",
          "title": "List ledger",
          "description": "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.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "limit": {
                "type": "integer",
                "maximum": 100,
                "minimum": 1,
                "description": "Page size (default 50)."
              },
              "cursor": {
                "type": "string",
                "description": "Opaque cursor from a previous page."
              },
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "List ledger",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "list_workspaces",
          "title": "List workspaces",
          "description": "Agency workspaces: the child workspaces this credential's workspace created (one per client, each with its own keywords, alerts, channels, members and wallet), with each one's balance, monthly limit, automatic refill and counts. Always about the credential's own workspace. Act inside one by passing its id as workspaceId to any other tool.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "additionalProperties": false
          },
          "annotations": {
            "title": "List workspaces",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "create_workspace",
          "title": "Create workspace",
          "description": "Create a child workspace for a client: its own keywords, alerts, channels, members and wallet. It starts with no balance and no welcome credit; fund it with transfer_credit (or autoRefill). externalId is your own id for it (unique). Your workspace must have topped up once (else funding_required); at most 100 children.",
          "inputSchema": {
            "type": "object",
            "required": [
              "name"
            ],
            "properties": {
              "name": {
                "type": "string",
                "maxLength": 100,
                "minLength": 1,
                "description": "The workspace name, 1 to 100 characters."
              },
              "autoRefill": {
                "anyOf": [
                  {
                    "type": "object",
                    "required": [
                      "thresholdCents",
                      "amountCents"
                    ],
                    "properties": {
                      "amountCents": {
                        "type": "integer",
                        "maximum": 500000,
                        "minimum": 100,
                        "description": "How much each refill moves from the parent, in USD cents (100 to 500000)."
                      },
                      "thresholdCents": {
                        "type": "integer",
                        "maximum": 500000,
                        "minimum": 0,
                        "description": "Refill when the child's effective balance (balance minus usage not settled yet) drops under this, in USD cents."
                      }
                    },
                    "description": "Automatic refill from the parent: at most once a UTC day, when the child runs low.",
                    "additionalProperties": false
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Refill it from your balance when it runs low; omit or null for off."
              },
              "externalId": {
                "type": "string",
                "maxLength": 100,
                "minLength": 1,
                "description": "Your own id for it (a customer id), unique among your workspaces; a second create with the same one is a 409."
              },
              "idempotencyKey": {
                "type": "string",
                "pattern": "^[\\x21-\\x7e]+$",
                "maxLength": 255,
                "minLength": 1,
                "description": "Optional. A unique value (a UUID) for this call: 1 to 255 visible ASCII characters, no spaces. Calling again with the same key and the same input within 24 hours returns the first result instead of doing it twice."
              },
              "monthlyLimitCents": {
                "anyOf": [
                  {
                    "type": "integer",
                    "maximum": 50000000,
                    "minimum": 0
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "The most you move into it in a UTC calendar month, in USD cents; omit or null for no limit."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Create workspace",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "update_workspace",
          "title": "Update workspace",
          "description": "Rename a child workspace, change its externalId, its monthly limit on transfers in (monthlyLimitCents) or its automatic refill (autoRefill: thresholdCents and amountCents); null clears.",
          "inputSchema": {
            "type": "object",
            "required": [
              "id"
            ],
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "description": "Child workspace id (org_...), from list_workspaces."
              },
              "name": {
                "type": "string",
                "maxLength": 100,
                "minLength": 1,
                "description": "New name, 1 to 100 characters."
              },
              "autoRefill": {
                "anyOf": [
                  {
                    "type": "object",
                    "required": [
                      "thresholdCents",
                      "amountCents"
                    ],
                    "properties": {
                      "amountCents": {
                        "type": "integer",
                        "maximum": 500000,
                        "minimum": 100,
                        "description": "How much each refill moves from the parent, in USD cents (100 to 500000)."
                      },
                      "thresholdCents": {
                        "type": "integer",
                        "maximum": 500000,
                        "minimum": 0,
                        "description": "Refill when the child's effective balance (balance minus usage not settled yet) drops under this, in USD cents."
                      }
                    },
                    "description": "Automatic refill from the parent: at most once a UTC day, when the child runs low.",
                    "additionalProperties": false
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "The automatic refill; null turns it off."
              },
              "externalId": {
                "anyOf": [
                  {
                    "type": "string",
                    "maxLength": 100,
                    "minLength": 1
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Your own id for it; null clears it."
              },
              "idempotencyKey": {
                "type": "string",
                "pattern": "^[\\x21-\\x7e]+$",
                "maxLength": 255,
                "minLength": 1,
                "description": "Optional. A unique value (a UUID) for this call: 1 to 255 visible ASCII characters, no spaces. Calling again with the same key and the same input within 24 hours returns the first result instead of doing it twice."
              },
              "monthlyLimitCents": {
                "anyOf": [
                  {
                    "type": "integer",
                    "maximum": 50000000,
                    "minimum": 0
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "The monthly ceiling on transfers in, in USD cents; null removes it."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Update workspace",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": true
          }
        },
        {
          "name": "delete_workspace",
          "title": "Delete workspace",
          "description": "Delete a child workspace with everything in it (keywords, mentions, alerts, channels, keys, members). Its remaining balance comes back to your workspace first; a debt it ran up is settled from yours. Cannot be undone.",
          "inputSchema": {
            "type": "object",
            "required": [
              "id"
            ],
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "description": "Child workspace id (org_...), from list_workspaces."
              },
              "idempotencyKey": {
                "type": "string",
                "pattern": "^[\\x21-\\x7e]+$",
                "maxLength": 255,
                "minLength": 1,
                "description": "Optional. A unique value (a UUID) for this call: 1 to 255 visible ASCII characters, no spaces. Calling again with the same key and the same input within 24 hours returns the first result instead of doing it twice."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Delete workspace",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": true
          }
        },
        {
          "name": "transfer_credit",
          "title": "Transfer credit",
          "description": "Move money between your workspace and a child workspace, in USD cents: direction to_workspace (default) funds the child from your balance, to_parent takes some of its balance back. Refused when the payer's effective balance cannot cover it (insufficient_balance) or it would pass the child's monthly limit (transfer_limit_reached).",
          "inputSchema": {
            "type": "object",
            "required": [
              "amountCents",
              "id"
            ],
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "description": "Child workspace id (org_...), from list_workspaces."
              },
              "note": {
                "type": "string",
                "maxLength": 200,
                "description": "Free text kept on both ledger rows, up to 200 characters."
              },
              "direction": {
                "enum": [
                  "to_workspace",
                  "to_parent"
                ],
                "type": "string",
                "default": "to_workspace",
                "description": "to_workspace: from the parent into the child workspace. to_parent: from the child back to the parent."
              },
              "amountCents": {
                "type": "integer",
                "maximum": 500000,
                "minimum": 1,
                "description": "How much to move, in USD cents (1 to 500000)."
              },
              "idempotencyKey": {
                "type": "string",
                "pattern": "^[\\x21-\\x7e]+$",
                "maxLength": 255,
                "minLength": 1,
                "description": "Optional. A unique value (a UUID) for this call: 1 to 255 visible ASCII characters, no spaces. Calling again with the same key and the same input within 24 hours returns the first result instead of doing it twice."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Transfer credit",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "list_workspace_transfers",
          "title": "List workspace transfers",
          "description": "The transfers between your workspace and one child workspace, newest first, automatic refills included; cursor paged (limit up to 100).",
          "inputSchema": {
            "type": "object",
            "required": [
              "id"
            ],
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "description": "Child workspace id (org_...), from list_workspaces."
              },
              "limit": {
                "type": "integer",
                "maximum": 100,
                "minimum": 1,
                "description": "Page size (default 50)."
              },
              "cursor": {
                "type": "string",
                "description": "nextCursor from the previous page."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "List workspace transfers",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "list_workspace_members",
          "title": "List workspace members",
          "description": "Everyone in your workspace or any child workspace, one row per person with each workspace they belong to and their role there.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "additionalProperties": false
          },
          "annotations": {
            "title": "List workspace members",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "get_filters",
          "title": "Get filters",
          "description": "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`).",
          "inputSchema": {
            "type": "object",
            "properties": {
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Get filters",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "update_filters",
          "title": "Update filters",
          "description": "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.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "subreddits": {
                "type": "object",
                "properties": {
                  "only": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 100,
                      "minLength": 1
                    },
                    "maxItems": 200,
                    "description": "Replaces the allowlist; [] clears it."
                  },
                  "excluded": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 100,
                      "minLength": 1
                    },
                    "maxItems": 200,
                    "description": "Replaces the deny list; [] clears it."
                  }
                },
                "description": "Reddit only; an omitted list is untouched.",
                "additionalProperties": false
              },
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              },
              "excludedRepos": {
                "type": "array",
                "items": {
                  "type": "string",
                  "maxLength": 200,
                  "minLength": 1
                },
                "maxItems": 200,
                "description": "Replaces the list; [] clears it."
              },
              "excludedTerms": {
                "type": "array",
                "items": {
                  "type": "string",
                  "maxLength": 80,
                  "minLength": 1
                },
                "maxItems": 200,
                "description": "Replaces the list; [] clears it."
              },
              "idempotencyKey": {
                "type": "string",
                "pattern": "^[\\x21-\\x7e]+$",
                "maxLength": 255,
                "minLength": 1,
                "description": "Optional. A unique value (a UUID) for this call: 1 to 255 visible ASCII characters, no spaces. Calling again with the same key and the same input within 24 hours returns the first result instead of doing it twice."
              },
              "excludedAuthors": {
                "type": "array",
                "items": {
                  "type": "string",
                  "maxLength": 500,
                  "minLength": 1
                },
                "maxItems": 200,
                "description": "Replaces the list; [] clears it."
              }
            },
            "description": "Omitted fields are untouched; an empty list clears one.",
            "additionalProperties": false
          },
          "annotations": {
            "title": "Update filters",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": true
          }
        },
        {
          "name": "get_company",
          "title": "Get company",
          "description": "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).",
          "inputSchema": {
            "type": "object",
            "properties": {
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Get company",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "update_company",
          "title": "Update company",
          "description": "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.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "maxLength": 120,
                "minLength": 1,
                "description": "Company name."
              },
              "context": {
                "type": "string",
                "maxLength": 4000,
                "description": "Overrides the composed context until the next profile edit."
              },
              "website": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "uri",
                    "maxLength": 300
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "The company website; null clears it."
              },
              "accounts": {
                "type": "object",
                "properties": {
                  "x": {
                    "anyOf": [
                      {
                        "type": "string",
                        "maxLength": 60
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "linkedin": {
                    "anyOf": [
                      {
                        "type": "string",
                        "maxLength": 200
                      },
                      {
                        "type": "null"
                      }
                    ]
                  }
                },
                "additionalProperties": false
              },
              "useCases": {
                "type": "array",
                "items": {
                  "type": "string",
                  "maxLength": 200,
                  "minLength": 1
                },
                "maxItems": 20,
                "description": "Replaces the whole list."
              },
              "guidelines": {
                "anyOf": [
                  {
                    "type": "string",
                    "maxLength": 2000
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Free-text rules for the classifier; null clears them."
              },
              "competitors": {
                "type": "array",
                "items": {
                  "type": "string",
                  "maxLength": 120,
                  "minLength": 1
                },
                "maxItems": 50,
                "description": "Replaces the whole list; [] clears it."
              },
              "description": {
                "type": "string",
                "maxLength": 1000,
                "description": "What the company does; the classifier reads it."
              },
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              },
              "idempotencyKey": {
                "type": "string",
                "pattern": "^[\\x21-\\x7e]+$",
                "maxLength": 255,
                "minLength": 1,
                "description": "Optional. A unique value (a UUID) for this call: 1 to 255 visible ASCII characters, no spaces. Calling again with the same key and the same input within 24 hours returns the first result instead of doing it twice."
              }
            },
            "description": "Omitted fields are untouched.",
            "additionalProperties": false
          },
          "annotations": {
            "title": "Update company",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": true
          }
        },
        {
          "name": "list_people",
          "title": "List people",
          "description": "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, or notStages to leave some out), owner (ownerIds, \"none\" for unowned; notOwnerIds to leave owners out), links (linkHosts, or notLinkHosts for people who never linked there) 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).",
          "inputSchema": {
            "type": "object",
            "properties": {
              "q": {
                "type": "string",
                "maxLength": 200,
                "minLength": 1,
                "description": "Match the display name or the profile handle/url"
              },
              "tag": {
                "type": "string",
                "maxLength": 40,
                "minLength": 1,
                "description": "Only people carrying this tag"
              },
              "sort": {
                "enum": [
                  "mentions",
                  "recent",
                  "reach",
                  "new"
                ],
                "type": "string",
                "default": "mentions",
                "description": "\"mentions\": most matches first; \"recent\": last seen first; \"reach\": most followers first; \"new\": first seen most recently first"
              },
              "tags": {
                "type": "array",
                "items": {
                  "type": "string",
                  "maxLength": 40,
                  "minLength": 1
                },
                "maxItems": 20,
                "description": "People carrying any of these tags"
              },
              "limit": {
                "type": "integer",
                "default": 50,
                "maximum": 100,
                "minimum": 1
              },
              "muted": {
                "type": "boolean",
                "description": "true: only muted people; false: only unmuted; omit: everyone"
              },
              "since": {
                "type": "integer",
                "description": "Only people whose first matched mention is at or after this instant (ISO 8601, or epoch ms): new voices"
              },
              "handle": {
                "type": "string",
                "maxLength": 300,
                "minLength": 1,
                "description": "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": {
                "type": "integer",
                "default": 0,
                "minimum": 0,
                "description": "Skip this many people (paging)"
              },
              "stages": {
                "type": "array",
                "items": {
                  "enum": [
                    "not_contacted",
                    "contacted",
                    "replied",
                    "in_talks",
                    "customer",
                    "not_a_fit"
                  ],
                  "type": "string",
                  "description": "Where your workspace stands with the person: not_contacted, contacted, replied, in_talks, customer or not_a_fit."
                },
                "maxItems": 6,
                "description": "People at any of these outreach stages (not_contacted, contacted, replied, in_talks, customer, not_a_fit)"
              },
              "groupId": {
                "type": "string",
                "minLength": 1,
                "description": "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": {
                "type": "array",
                "items": {
                  "type": "string",
                  "maxLength": 40,
                  "minLength": 1
                },
                "maxItems": 10,
                "description": "At least one mention carrying any of these intents"
              },
              "ownerIds": {
                "type": "array",
                "items": {
                  "type": "string",
                  "maxLength": 200,
                  "minLength": 1
                },
                "maxItems": 20,
                "description": "People owned by any of these members (user ids); \"none\" for people nobody owns"
              },
              "platform": {
                "enum": [
                  "bluesky",
                  "hackernews",
                  "github",
                  "stackoverflow",
                  "devto",
                  "reddit",
                  "x",
                  "youtube",
                  "news",
                  "linkedin",
                  "tiktok",
                  "instagram",
                  "facebook",
                  "podcasts",
                  "web",
                  "substack",
                  "producthunt",
                  "threads",
                  "mastodon",
                  "appstore",
                  "googleplay",
                  "trustpilot",
                  "googlemaps",
                  "rss"
                ],
                "type": "string",
                "description": "Only people with an account on this platform"
              },
              "automated": {
                "type": "boolean",
                "description": "true: only people whose matched posts are mostly machine-made (bot accounts); false: only the rest"
              },
              "linkHosts": {
                "type": "array",
                "items": {
                  "type": "string",
                  "maxLength": 200,
                  "minLength": 1
                },
                "maxItems": 20,
                "description": "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)"
              },
              "notStages": {
                "type": "array",
                "items": {
                  "enum": [
                    "not_contacted",
                    "contacted",
                    "replied",
                    "in_talks",
                    "customer",
                    "not_a_fit"
                  ],
                  "type": "string",
                  "description": "Where your workspace stands with the person: not_contacted, contacted, replied, in_talks, customer or not_a_fit."
                },
                "maxItems": 6,
                "description": "Nobody at these outreach stages."
              },
              "platforms": {
                "type": "array",
                "items": {
                  "enum": [
                    "bluesky",
                    "hackernews",
                    "github",
                    "stackoverflow",
                    "devto",
                    "reddit",
                    "x",
                    "youtube",
                    "news",
                    "linkedin",
                    "tiktok",
                    "instagram",
                    "facebook",
                    "podcasts",
                    "web",
                    "substack",
                    "producthunt",
                    "threads",
                    "mastodon",
                    "appstore",
                    "googleplay",
                    "trustpilot",
                    "googlemaps",
                    "rss"
                  ],
                  "type": "string"
                },
                "maxItems": 20,
                "description": "People with an account on any of these platforms"
              },
              "segmentId": {
                "type": "string",
                "minLength": 1,
                "description": "A saved segment (from list_segments) applied on top of the other filters"
              },
              "minMentions": {
                "type": "integer",
                "minimum": 1,
                "description": "At least this many matched mentions"
              },
              "minNegative": {
                "type": "integer",
                "minimum": 1,
                "description": "At least this many negative mentions"
              },
              "notOwnerIds": {
                "type": "array",
                "items": {
                  "type": "string",
                  "maxLength": 200,
                  "minLength": 1
                },
                "maxItems": 20,
                "description": "Nobody owned by these members (user ids); \"none\" drops the people nobody owns."
              },
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              },
              "keywordKinds": {
                "type": "array",
                "items": {
                  "enum": [
                    "brand",
                    "competitor",
                    "topic"
                  ],
                  "type": "string"
                },
                "maxItems": 3,
                "description": "Mentioned a keyword of any of these kinds (brand, competitor, topic)"
              },
              "maxFollowers": {
                "type": "integer",
                "minimum": 0
              },
              "minFollowers": {
                "type": "integer",
                "minimum": 0,
                "description": "At least this many followers (unknown reach never matches)"
              },
              "newSinceDays": {
                "type": "integer",
                "maximum": 365,
                "minimum": 1,
                "description": "First seen within this many days"
              },
              "notLinkHosts": {
                "type": "array",
                "items": {
                  "type": "string",
                  "maxLength": 200,
                  "minLength": 1
                },
                "maxItems": 20,
                "description": "Nobody with a mention linking to any of these hosts, the host itself or a subdomain of it."
              },
              "neverKeywordKinds": {
                "type": "array",
                "items": {
                  "enum": [
                    "brand",
                    "competitor",
                    "topic"
                  ],
                  "type": "string"
                },
                "maxItems": 3,
                "description": "Never mentioned a keyword of these kinds"
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "List people",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "get_person",
          "title": "Get person",
          "description": "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).",
          "inputSchema": {
            "type": "object",
            "required": [
              "id"
            ],
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "description": "Audience author id (aut_...), from list_people or a mention's authorId"
              },
              "groupId": {
                "type": "string",
                "minLength": 1,
                "description": "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."
              },
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Get person",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "update_person",
          "title": "Update person",
          "description": "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.",
          "inputSchema": {
            "type": "object",
            "required": [
              "id"
            ],
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "description": "Audience author id (aut_...)"
              },
              "tags": {
                "type": "array",
                "items": {
                  "type": "string",
                  "maxLength": 40,
                  "minLength": 1
                },
                "maxItems": 20,
                "description": "Replaces the whole list."
              },
              "muted": {
                "type": "boolean",
                "description": "true hides their posts from the feed, alerts and digests; false shows them again. Without groupId for the whole workspace; with it, for that group's keywords only."
              },
              "notes": {
                "type": "string",
                "maxLength": 2000,
                "description": "Notes, up to 2,000 characters; replaces the current notes."
              },
              "stage": {
                "enum": [
                  "not_contacted",
                  "contacted",
                  "replied",
                  "in_talks",
                  "customer",
                  "not_a_fit"
                ],
                "type": "string",
                "description": "Where your workspace stands with the person: not_contacted, contacted, replied, in_talks, customer or not_a_fit."
              },
              "groupId": {
                "type": "string",
                "minLength": 1,
                "description": "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": {
                "anyOf": [
                  {
                    "type": "string",
                    "minLength": 1
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "The member who owns the contact (user id); null clears."
              },
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              },
              "idempotencyKey": {
                "type": "string",
                "pattern": "^[\\x21-\\x7e]+$",
                "maxLength": 255,
                "minLength": 1,
                "description": "Optional. A unique value (a UUID) for this call: 1 to 255 visible ASCII characters, no spaces. Calling again with the same key and the same input within 24 hours returns the first result instead of doing it twice."
              }
            },
            "description": "Omitted fields are untouched.",
            "additionalProperties": false
          },
          "annotations": {
            "title": "Update person",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": true
          }
        },
        {
          "name": "merge_people",
          "title": "Merge people",
          "description": "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.",
          "inputSchema": {
            "type": "object",
            "required": [
              "id",
              "into"
            ],
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "description": "The account to fold in (aut_...)"
              },
              "into": {
                "type": "string",
                "minLength": 1,
                "description": "The person to fold it into (aut_...)"
              },
              "groupId": {
                "type": "string",
                "minLength": 1,
                "description": "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."
              },
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              },
              "idempotencyKey": {
                "type": "string",
                "pattern": "^[\\x21-\\x7e]+$",
                "maxLength": 255,
                "minLength": 1,
                "description": "Optional. A unique value (a UUID) for this call: 1 to 255 visible ASCII characters, no spaces. Calling again with the same key and the same input within 24 hours returns the first result instead of doing it twice."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Merge people",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": true
          }
        },
        {
          "name": "split_person",
          "title": "Split person",
          "description": "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.",
          "inputSchema": {
            "type": "object",
            "required": [
              "id"
            ],
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "description": "Audience author id (aut_...), from list_people or a mention's authorId"
              },
              "groupId": {
                "type": "string",
                "minLength": 1,
                "description": "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."
              },
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              },
              "idempotencyKey": {
                "type": "string",
                "pattern": "^[\\x21-\\x7e]+$",
                "maxLength": 255,
                "minLength": 1,
                "description": "Optional. A unique value (a UUID) for this call: 1 to 255 visible ASCII characters, no spaces. Calling again with the same key and the same input within 24 hours returns the first result instead of doing it twice."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Split person",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "list_activities",
          "title": "List activities",
          "description": "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.",
          "inputSchema": {
            "type": "object",
            "required": [
              "id"
            ],
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "description": "Audience author id (aut_...), from list_people or a mention's authorId"
              },
              "groupId": {
                "type": "string",
                "minLength": 1,
                "description": "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."
              },
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "List activities",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "log_activity",
          "title": "Log activity",
          "description": "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.",
          "inputSchema": {
            "type": "object",
            "required": [
              "channel",
              "id"
            ],
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "description": "Person id (aut_...), from list_people or a mention's authorId"
              },
              "note": {
                "type": "string",
                "default": "",
                "maxLength": 2000,
                "description": "What was sent or said, briefly."
              },
              "channel": {
                "enum": [
                  "email",
                  "x",
                  "linkedin",
                  "bluesky",
                  "reddit",
                  "github",
                  "call",
                  "meeting",
                  "other"
                ],
                "type": "string",
                "description": "How they were reached: email, x, linkedin, bluesky, reddit, github, call, meeting or other."
              },
              "groupId": {
                "type": "string",
                "minLength": 1,
                "description": "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": {
                "type": "string",
                "minLength": 1,
                "description": "The member who reached out (user id). Defaults to the signed-in member; an API key that omits it logs an unattributed activity."
              },
              "occurredAt": {
                "type": "integer",
                "description": "When the contact happened (ISO 8601, or epoch ms). Defaults to now."
              },
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              },
              "idempotencyKey": {
                "type": "string",
                "pattern": "^[\\x21-\\x7e]+$",
                "maxLength": 255,
                "minLength": 1,
                "description": "Optional. A unique value (a UUID) for this call: 1 to 255 visible ASCII characters, no spaces. Calling again with the same key and the same input within 24 hours returns the first result instead of doing it twice."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Log activity",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "delete_activity",
          "title": "Delete activity",
          "description": "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.",
          "inputSchema": {
            "type": "object",
            "required": [
              "id",
              "activityId"
            ],
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "description": "Person id (aut_...)"
              },
              "groupId": {
                "type": "string",
                "minLength": 1,
                "description": "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": {
                "type": "string",
                "minLength": 1,
                "description": "Activity id (act_...), from list_activities"
              },
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              },
              "idempotencyKey": {
                "type": "string",
                "pattern": "^[\\x21-\\x7e]+$",
                "maxLength": 255,
                "minLength": 1,
                "description": "Optional. A unique value (a UUID) for this call: 1 to 255 visible ASCII characters, no spaces. Calling again with the same key and the same input within 24 hours returns the first result instead of doing it twice."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Delete activity",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": true
          }
        },
        {
          "name": "get_mention_stats",
          "title": "Get mention stats",
          "description": "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\".",
          "inputSchema": {
            "type": "object",
            "properties": {
              "platform": {
                "enum": [
                  "bluesky",
                  "hackernews",
                  "github",
                  "stackoverflow",
                  "devto",
                  "reddit",
                  "x",
                  "youtube",
                  "news",
                  "linkedin",
                  "tiktok",
                  "instagram",
                  "facebook",
                  "podcasts",
                  "web",
                  "substack",
                  "producthunt",
                  "threads",
                  "mastodon",
                  "appstore",
                  "googleplay",
                  "trustpilot",
                  "googlemaps",
                  "rss"
                ],
                "type": "string",
                "description": "Only count mentions from this platform"
              },
              "keywordId": {
                "type": "string",
                "description": "Only count mentions matching this keyword id"
              },
              "sinceDays": {
                "type": "integer",
                "default": 7,
                "maximum": 365,
                "minimum": 1,
                "description": "Look-back window in days"
              },
              "workspaceId": {
                "type": "string",
                "description": "Optional. Run this call inside one of your child workspaces (org_..., from list_workspaces) instead of your own. Applies to this call only; the result says which workspace it acted on."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Get mention stats",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        }
      ],
      "tools_omitted": 0,
      "resources": [
        {
          "name": "openapi",
          "uri": "https://api.mentio.dev/v1/openapi.json",
          "mimeType": "application/json",
          "description": "Every operation of the REST API the tools mirror, with request and response schemas: the shapes the tools return."
        },
        {
          "name": "docs",
          "uri": "https://docs.mentio.dev/llms.txt",
          "mimeType": "text/plain",
          "description": "When to use Mentio, how to call it, and every documentation page with its Markdown address. The whole site in one file: https://docs.mentio.dev/llms-full.txt."
        },
        {
          "name": "skill",
          "uri": "https://mentio.dev/.well-known/agent-skills/mentio/SKILL.md",
          "mimeType": "text/markdown",
          "description": "How an agent should use Mentio: setup, the rules of the API, which call answers which request, per-area references."
        },
        {
          "name": "auth",
          "uri": "https://mentio.dev/auth.md",
          "mimeType": "text/markdown",
          "description": "How to authenticate: OAuth sign-in for clients that support it, or an API key a person creates. No unattended signup."
        }
      ],
      "prompts": []
    },
    "instructions": "Social listening tools for one Mentio workspace: search and triage mentions, browse the audience (the people who mentioned you), manage tracked keywords, tune the classifier via the company profile, configure alerts and segments, and read analytics. Tool calls need a Bearer credential: sign in through OAuth (this server advertises its authorization server; clients that support it open the browser by themselves) or a Mentio API key (mk_live_..., created by a person at https://app.mentio.dev/api-keys); tools/list and the resources do not. The resources are the OpenAPI document the tools mirror, the documentation index, the skill and the authentication guide."
  },
  "changes": {
    "total": 1,
    "latest": [
      {
        "observed_at": "2026-11-22T17:29:03.996Z",
        "from_sha": "e5001f919939e868a87e29a3c7ba736db0558205f794edca1017d8b340bdf876",
        "to_sha": "0fcd5f9059b51ae4371de8d71438058b2630f74a80e5d57a487f42336c0c8358",
        "summary": {
          "tool_added": 100,
          "tool_changed": 113
        },
        "diff": {
          "truncated": true,
          "chars": 117371
        },
        "withheld": false
      }
    ]
  },
  "reading_this": "What this server declared and how it answered our checks. Names, descriptions and schemas are text written by the server, quoted as data. Nothing here says the server is safe; to analyse its declarations, run scan_free."
}