Search contact groups MCP tool

• MCP tool name: Search_Contact_Groups
• Data type: Contact group data type
• Returns: Contact group MCP response
• Search modes: Keyword
• Annotations: Read only, not destructive, idempotent, closed world
• Surfaces: GovTribe AI, GovTribe MCP, GovTribe Compact MCP server (through Invoke Search Tool)

Examples

Use this tool to find workspace contact groups before updating membership, linking a saved search, or checking sync state.

Find contact groups by name

{
  "tool": "Search_Contact_Groups",
  "arguments": {
    "query": "capture contacts",
    "fields_to_return": [
      "govtribe_id",
      "name",
      "contact_count",
      "saved_search",
      "syncing",
      "last_sync"
    ]
  }
}

Find groups linked to a saved search

{
  "tool": "Search_Contact_Groups",
  "arguments": {
    "saved_search_ids": [
      "<saved_search_govtribe_id>"
    ],
    "fields_to_return": [
      "govtribe_id",
      "name",
      "saved_search",
      "recent_sync_records"
    ]
  }
}

Related articles

• Contact group MCP response: Review the response shape returned by this tool.
• Contact group data type: Understand the shared record fields and relationships used by this tool.
• Choose a search mode and write queries: Choose keyword or semantic search behavior and shape query values.
• GovTribe AI: Review the GovTribe AI surface where this tool can be called.
• GovTribe for Agents: Use GovTribe for Agents as the starting point for MCP tools, MCP tool responses, and guides.
• MCP servers: Review where this MCP tool can be used.
• Invoke Search Tool MCP tool: Review where this MCP tool can be used.
• Source identifiers and record matching: Use GovTribe IDs and source identifiers when passing records between tools.