Search users MCP tool

• MCP tool name: Search_Users
• Data type: User data type
• Returns: User MCP response
• Search modes: Keyword
• Annotations: Read only, not destructive, idempotent, closed world
• Surfaces: GovTribe AI, GovTribe MCP

Examples

Use user search to resolve workspace user IDs for owner, creator, assignee, and teammate filters. Return email only when the user specifically needs it.

Which workspace users are available to assign work to?

{
  "tool": "Search_Users",
  "arguments": {
    "per_page": 10,
    "fields_to_return": [
      "govtribe_id",
      "name",
      "created_at",
      "updated_at"
    ]
  }
}

Which workspace user has this GovTribe ID?

{
  "tool": "Search_Users",
  "arguments": {
    "user_ids": [
      "<user_govtribe_id>"
    ],
    "fields_to_return": [
      "govtribe_id",
      "name",
      "created_at",
      "updated_at"
    ]
  }
}

Related articles

• User MCP response: Review the response shape returned by this tool.
• User 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.
• Source identifiers and record matching: Use GovTribe IDs and source identifiers when passing records between tools.