Search GovTribe MCP response
MCP tool response returned by the Search GovTribe MCP tool.
- Returned by: Search GovTribe MCP tool
- Response type: Structured integrated search results
Response Shape
The response is a broad finder result. Use resolver hints from each result to call the typed Search_* tool that can retrieve richer records.
| Field | Type | Notes |
|---|---|---|
query | string | The query submitted to the integrated finder. |
retrieval_strategy | string | Description of the retrieval strategy used for the request. |
rerank_applied | boolean | true when the broad finder applied a rerank pass after hybrid retrieval. |
rerank_status | string | Rerank outcome. Values include applied, disabled, skipped_query_too_short, skipped_too_few_candidates, failed_open, and empty_reranker_response. |
rerank_strategy | string or null | laravel_ai_sdk_collection_rerank when reranking was applied; otherwise null. |
rerank_candidate_count | integer | Number of candidates considered for the rerank pass or skip decision. |
matched_types | string array | GovTribe record types that matched the query. |
results | object array | Ranked candidate records with resolver hints for typed follow-up searches. |
Each results item includes rank, score, matched_retrievers, govtribe_id, govtribe_type, title, url, snippet, and resolver.
rank is the authoritative result order after any reranking. score remains the fused retrieval score from keyword, semantic, and RRF retrieval, not a reranker score.
The resolver object includes tool, filter, arguments, suggested_fields, and documentation_articles. Those values tell an agent which typed search tool to call next, what identifier argument to apply, which fields are useful to request, and which docs can help with the follow-up call.
Follow-up Behavior
Use results[].resolver.tool with results[].resolver.arguments to retrieve fuller typed records. Resolver arguments use govtribe_ids when the finder already has the GovTribe record ID. Search_GovTribe is a broad finder and does not replace dataset-specific Search_* tools when an agent needs complete record fields.
Search_GovTribe can fail open when its reranker is unavailable or returns no usable ranking. In that case, the response still returns retrieval-ranked candidates and resolver hints. Check rerank_status for the reason before treating a non-reranked response as a search failure.
Use Rerank Search Results when a later step needs to rerank a bounded shortlist from typed search replay, Search_GovTribe candidates, or merged candidate sources.
Example
{
"query": "cloud modernization contract",
"retrieval_strategy": "hybrid_rrf_then_ai_collection_rerank",
"rerank_applied": true,
"rerank_status": "applied",
"rerank_strategy": "laravel_ai_sdk_collection_rerank",
"rerank_candidate_count": 12,
"matched_types": ["federal_contract_opportunity"],
"results": [
{
"rank": 1,
"score": 0.0478,
"matched_retrievers": ["keyword", "semantic"],
"govtribe_id": "OPPORTUNITY_ID",
"govtribe_type": "federal_contract_opportunity",
"title": "Cloud modernization support",
"url": "https://govtribe.com/opportunity/OPPORTUNITY_ID",
"snippet": "A short matched excerpt from the candidate record.",
"resolver": {
"tool": "Search_Federal_Contract_Opportunities",
"filter": "govtribe_ids",
"arguments": {
"govtribe_ids": ["OPPORTUNITY_ID"],
"fields_to_return": ["govtribe_id", "title", "url"]
},
"suggested_fields": ["govtribe_id", "title", "url"],
"documentation_articles": []
}
}
]
}