Search federal forecasts MCP tool
Searches GovTribe federal forecasts and returns planned requirement records with estimates, timelines, and contacts.
- MCP tool name:
Search_Federal_Forecasts - Data type: Federal forecast data type
- Returns: Federal forecast MCP response
- Search modes: Keyword, Semantic
- Annotations: Read only, not destructive, idempotent, closed world
- Surfaces: GovTribe AI, GovTribe MCP
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 federal forecasts mention facility modernization?
{
"tool": "Search_Federal_Forecasts",
"arguments": {
"query": "facility modernization",
"search_mode": "keyword",
"fields_to_return": [
"govtribe_id",
"name",
"descriptions",
"updated_at",
"govtribe_ai_summary"
]
}
}Which federal forecasts exactly mention "technical support services"?
{
"tool": "Search_Federal_Forecasts",
"arguments": {
"query": "\"technical support services\"",
"search_mode": "keyword",
"fields_to_return": [
"govtribe_id",
"name",
"descriptions",
"govtribe_ai_summary",
"updated_at"
]
}
}Which federal forecasts are conceptually related to cybersecurity modernization?
{
"tool": "Search_Federal_Forecasts",
"arguments": {
"query": "cybersecurity modernization, zero trust upgrades, network defense services",
"search_mode": "semantic",
"fields_to_return": [
"govtribe_id",
"name",
"govtribe_ai_summary",
"descriptions",
"updated_at"
]
}
}Which forecasts do not list a set-aside value?
{
"tool": "Search_Federal_Forecasts",
"arguments": {
"set_aside_types": [
"No Set-Aside Used"
],
"fields_to_return": [
"govtribe_id",
"name",
"govtribe_ai_summary",
"descriptions",
"updated_at"
]
}
}Which forecasts has my team not moved into capture work?
This example uses the authenticated GovTribe workspace context.
{
"tool": "Search_Federal_Forecasts",
"arguments": {
"pursuing": false,
"fields_to_return": [
"govtribe_id",
"name",
"govtribe_ai_summary",
"descriptions",
"updated_at"
]
}
}Which forecasts have a planned award period ending in the target window?
{
"tool": "Search_Federal_Forecasts",
"arguments": {
"anticipated_award_end_date_range": {
"from": "now-12M/d",
"to": "now/d"
},
"fields_to_return": [
"govtribe_id",
"name",
"govtribe_ai_summary",
"descriptions",
"updated_at"
]
}
}Which forecasts have anticipated award starts in the next 12 months?
{
"tool": "Search_Federal_Forecasts",
"arguments": {
"anticipated_award_start_date_range": {
"from": "now/d",
"to": "now+12M/d"
},
"fields_to_return": [
"govtribe_id",
"name",
"govtribe_ai_summary",
"descriptions",
"updated_at"
]
}
}Which forecasts list Hannah Moussa as a contact?
{
"tool": "Search_Contacts",
"arguments": {
"query": "Hannah Moussa",
"search_mode": "keyword",
"fields_to_return": [
"govtribe_id",
"name",
"organization"
]
}
}{
"tool": "Search_Federal_Forecasts",
"arguments": {
"contact_ids": [
"<hannah_moussa_govtribe_id>"
],
"fields_to_return": [
"govtribe_id",
"name",
"govtribe_ai_summary",
"descriptions",
"updated_at"
]
}
}Which forecasts list an estimated value ceiling above my target amount?
{
"tool": "Search_Federal_Forecasts",
"arguments": {
"estimated_award_value_max_range": {
"min": 10000000,
"max": null
},
"fields_to_return": [
"govtribe_id",
"name",
"govtribe_ai_summary",
"descriptions",
"updated_at"
]
}
}Which forecasts list an estimated value floor above my target amount?
{
"tool": "Search_Federal_Forecasts",
"arguments": {
"estimated_award_value_min_range": {
"min": 10000000,
"max": null
},
"fields_to_return": [
"govtribe_id",
"name",
"govtribe_ai_summary",
"descriptions",
"updated_at"
]
}
}Which forecasts have expected solicitation releases in the next 12 months?
{
"tool": "Search_Federal_Forecasts",
"arguments": {
"estimated_solicitation_release_date_range": {
"from": "now/d",
"to": "now+12M/d"
},
"fields_to_return": [
"govtribe_id",
"name",
"govtribe_ai_summary",
"descriptions",
"updated_at"
]
}
}Which forecasts are tied to Department of Veterans Affairs?
{
"tool": "Search_Federal_Agencies",
"arguments": {
"query": "Department of Veterans Affairs",
"search_mode": "keyword",
"fields_to_return": [
"govtribe_id",
"name",
"acronym"
]
}
}{
"tool": "Search_Federal_Forecasts",
"arguments": {
"federal_agency_ids": [
"<department_of_veterans_affairs_govtribe_id>"
],
"fields_to_return": [
"govtribe_id",
"name",
"govtribe_ai_summary",
"descriptions",
"updated_at"
]
}
}Which forecasts are recompetes?
{
"tool": "Search_Federal_Forecasts",
"arguments": {
"forecast_type": [
"Recompete"
],
"fields_to_return": [
"govtribe_id",
"name",
"govtribe_ai_summary",
"descriptions",
"updated_at"
]
}
}Which forecasts are in NAICS 541512?
{
"tool": "Search_Naics_Categories",
"arguments": {
"query": "541512",
"search_mode": "keyword",
"fields_to_return": [
"govtribe_id",
"code",
"name"
]
}
}{
"tool": "Search_Federal_Forecasts",
"arguments": {
"naics_category_ids": [
"<naics_541512_govtribe_id>"
],
"fields_to_return": [
"govtribe_id",
"name",
"govtribe_ai_summary",
"descriptions",
"updated_at"
]
}
}Which forecasts are performed in Virginia?
{
"tool": "Search_Federal_Forecasts",
"arguments": {
"place_of_performance_ids": [
"Virginia"
],
"fields_to_return": [
"govtribe_id",
"name",
"govtribe_ai_summary",
"descriptions",
"updated_at"
]
}
}Which forecasts are already connected to pursuit work?
This example uses the authenticated GovTribe workspace context.
{
"tool": "Search_Federal_Forecasts",
"arguments": {
"pursuing": true,
"fields_to_return": [
"govtribe_id",
"name",
"govtribe_ai_summary",
"descriptions",
"updated_at"
]
}
}Which forecasts are total small-business set-asides?
{
"tool": "Search_Federal_Forecasts",
"arguments": {
"set_aside_types": [
"Total Small Business"
],
"fields_to_return": [
"govtribe_id",
"name",
"govtribe_ai_summary",
"descriptions",
"updated_at"
]
}
}Aggregation examples
Use aggregation examples when the answer needs rollups instead of individual rows. These examples use quoted keyword anchors in query so long-tail matches do not skew buckets; broaden the query only when the user asks for exploratory sizing, and pair broader queries with structured filters when possible. Set per_page to 0 when row results are not needed.
Which organizations are most represented among cloud modernization federal forecasts?
{
"tool": "Search_Federal_Forecasts",
"arguments": {
"query": "\"cloud modernization\"",
"per_page": 0,
"aggregations": [
"top_federal_agencies_by_doc_count",
"top_contacts_by_doc_count"
],
"search_mode": "keyword"
}
}Which categories define cloud modernization federal forecasts?
{
"tool": "Search_Federal_Forecasts",
"arguments": {
"query": "\"cloud modernization\"",
"per_page": 0,
"aggregations": [
"top_set_aside_types_by_doc_count",
"top_naics_codes_by_doc_count"
],
"search_mode": "keyword"
}
}Related articles
- Federal forecast MCP response: Review the response shape returned by this tool.
- Federal forecast 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. - 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.