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, 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 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.
- 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.
Search federal contract vehicles
Searches GovTribe federal contract vehicles and returns vehicle records with scope, ordering windows, and program context.
Search federal grant awards
Searches GovTribe federal grant awards and returns award records with funding amounts, recipients, and program metadata.