Search stages MCP tool

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

Examples

Use stage search when the agent needs a workspace pipeline stage ID before creating tasks, moving pursuits, or filtering pipeline work.

Which stages named Triage are available in this workspace?

{
  "tool": "Search_Stages",
  "arguments": {
    "query": "Triage",
    "fields_to_return": [
      "govtribe_id",
      "name",
      "type",
      "pipeline",
      "owner",
      "updated_at"
    ]
  }
}

Which stages belong to a known pipeline?

{
  "tool": "Search_Pipelines",
  "arguments": {
    "query": "Federal pipeline",
    "fields_to_return": [
      "govtribe_id",
      "name",
      "owner",
      "stages"
    ]
  }
}

{
  "tool": "Search_Stages",
  "arguments": {
    "pipeline_ids": [
      "<pipeline_govtribe_id>"
    ],
    "fields_to_return": [
      "govtribe_id",
      "name",
      "type",
      "pipeline",
      "owner",
      "updated_at"
    ]
  }
}

Related articles

• Stage MCP response: Review the response shape returned by this tool.
• Stage 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.