Search pursuits MCP tool

Searches GovTribe pursuits and returns pursuit records with pipeline placement, owners, linked items, and attachments.

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

Examples

Use these examples as task-shaped tool calls. Examples may combine query, search_mode, filters, sorting, returned fields, resolver calls, and aggregations. When an example resolves a related record first, pass the returned govtribe_id into the target search.

Which pursuits mention facility modernization?

{
  "tool": "Search_Pursuits",
  "arguments": {
    "query": "facility modernization",
    "search_mode": "keyword",
    "fields_to_return": [
      "govtribe_id",
      "name",
      "description",
      "updated_at",
      "govtribe_ai_summary"
    ]
  }
}

Which pursuits exactly mention "technical support services"?

{
  "tool": "Search_Pursuits",
  "arguments": {
    "query": "\"technical support services\"",
    "search_mode": "keyword",
    "fields_to_return": [
      "govtribe_id",
      "name",
      "description",
      "govtribe_ai_summary",
      "due_date"
    ]
  }
}

{
  "tool": "Search_Pursuits",
  "arguments": {
    "query": "cybersecurity modernization, zero trust upgrades, network defense services",
    "search_mode": "semantic",
    "fields_to_return": [
      "govtribe_id",
      "name",
      "govtribe_ai_summary",
      "description",
      "due_date"
    ]
  }
}

Which pursuits are assigned to a teammate?

{
  "tool": "Search_Users",
  "arguments": {
    "query": "teammate@example.com",
    "fields_to_return": [
      "govtribe_id",
      "name",
      "email"
    ]
  }
}

{
  "tool": "Search_Pursuits",
  "arguments": {
    "owner_ids": [
      "<teammate_user_govtribe_id>"
    ],
    "fields_to_return": [
      "govtribe_id",
      "name",
      "govtribe_ai_summary",
      "description",
      "due_date"
    ]
  }
}

Which pursuits are in a specific pipeline?

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

{
  "tool": "Search_Pursuits",
  "arguments": {
    "pipeline_ids": [
      "<federal_pipeline_govtribe_id>"
    ],
    "fields_to_return": [
      "govtribe_id",
      "name",
      "govtribe_ai_summary",
      "description",
      "due_date"
    ]
  }
}

Which pursuits are in a specific pipeline stage?

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

{
  "tool": "Search_Pursuits",
  "arguments": {
    "stage_ids": [
      "<triage_stage_govtribe_id>"
    ],
    "fields_to_return": [
      "govtribe_id",
      "name",
      "govtribe_ai_summary",
      "description",
      "due_date"
    ]
  }
}

Aggregation examples

Use aggregations when the task asks for a workspace-level summary instead of individual pursuit rows. Set per_page to 0 when the agent only needs rollups.

What is the total estimated and probable value of the pursuit portfolio?

{
  "tool": "Search_Pursuits",
  "arguments": {
    "aggregations": [
      "estimated_value_stats",
      "probable_value_stats"
    ],
    "per_page": 0
  }
}

How are pursuits distributed by pipeline, stage, owner, creator, and tag?

{
  "tool": "Search_Pursuits",
  "arguments": {
    "aggregations": [
      "top_pipelines_by_doc_count",
      "top_stages_by_doc_count",
      "top_owners_by_doc_count",
      "top_creators_by_doc_count",
      "top_tags_by_doc_count"
    ],
    "per_page": 0
  }
}

How is one pipeline distributed by stage?

{
  "tool": "Search_Pursuits",
  "arguments": {
    "pipeline_ids": [
      "<pipeline_govtribe_id>"
    ],
    "aggregations": [
      "top_stages_by_doc_count"
    ],
    "per_page": 0
  }
}

When are pursuits due or expected to award?

{
  "tool": "Search_Pursuits",
  "arguments": {
    "aggregations": [
      "due_date_histogram",
      "estimated_award_date_histogram"
    ],
    "per_page": 0
  }
}

Which pursuits look stale?

{
  "tool": "Search_Pursuits",
  "arguments": {
    "aggregations": [
      "updated_at_histogram",
      "updated_at_staleness"
    ],
    "per_page": 0
  }
}

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

On this page