Search contact groups MCP tool
Searches GovTribe workspace contact groups and returns saved-search sync state, linked contacts, tags, and ownership fields.
- 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
- Available in: GovTribe AI, GovTribe MCP
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"
]
}
}contacts returns a preview of up to 25 contacts per group, and contact_count gives the total. When contact_count is larger than the preview, the list is truncated.
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
queryvalues. - Source identifiers and record matching: Use GovTribe IDs and source identifiers when passing records between tools.
Search automations
Search GovTribe AI automations owned by the calling user. Optionally embed recent runs per automation.
Search contacts
Searches the bounded GovTribe contact catalog and returns stored profiles with communication details and linked organizations. Retrieves existing GovTribe records; does not contact people or search arbitrary external sites.