Search federal transactions MCP tool
Searches GovTribe federal contract transactions and returns FPDS transaction lines with financial amounts, agencies, and vendors.
- MCP tool name:
Search_Federal_Transactions - Data type: Federal transaction data type
- Returns: Federal transaction MCP response
- Search modes: Keyword
- Annotations: Read only, not destructive, idempotent, closed world
- Surfaces: GovTribe AI, GovTribe MCP
Examples
Use this tool when the agent needs FPDS transaction lines, modification history, obligation changes, or transaction-level spending evidence beneath an award, IDV, vehicle, vendor, agency, NAICS, or PSC.
Which transaction lines mention Veritas eDiscovery software?
{
"tool": "Search_Federal_Transactions",
"arguments": {
"query": "Veritas eDiscovery platform software",
"sort": {
"key": "transactionDate",
"direction": "desc"
},
"fields_to_return": [
"govtribe_id",
"date",
"last_mod_number",
"reason_for_modification",
"federal_value",
"total_value",
"awardee",
"contracting_federal_agency"
]
}
}What are the transaction lines for a known award?
{
"tool": "Search_Federal_Contract_Awards",
"arguments": {
"query": "W52P1J20D0049 W912HQ25F0178",
"search_mode": "keyword",
"fields_to_return": [
"govtribe_id",
"name",
"contract_number",
"award_date"
]
}
}{
"tool": "Search_Federal_Transactions",
"arguments": {
"federal_contract_award_ids": [
"<federal_contract_award_govtribe_id>"
],
"sort": {
"key": "transactionDate",
"direction": "asc"
},
"fields_to_return": [
"govtribe_id",
"date",
"last_mod_number",
"reason_for_modification",
"federal_value",
"total_value",
"awardee"
]
}
}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.
How much recent cloud migration transaction activity is there?
{
"tool": "Search_Federal_Transactions",
"arguments": {
"query": "\"cloud migration\"",
"transaction_date_range": {
"from": "now-12M/d",
"to": "now/d"
},
"per_page": 0,
"aggregations": [
"dollars_obligated_stats"
]
}
}Which vendors lead program operations support transactions?
{
"tool": "Search_Federal_Transactions",
"arguments": {
"query": "\"program operations support\"",
"per_page": 0,
"aggregations": [
"top_awardees_by_dollars_obligated"
]
}
}Which agencies drive cybersecurity compliance transactions?
{
"tool": "Search_Federal_Transactions",
"arguments": {
"query": "\"cybersecurity compliance\" + \"security assessment\"",
"per_page": 0,
"aggregations": [
"top_funding_federal_agencies_by_dollars_obligated",
"top_contracting_federal_agencies_by_dollars_obligated"
]
}
}Which categories and set-asides define medical logistics transactions?
{
"tool": "Search_Federal_Transactions",
"arguments": {
"query": "\"home oxygen\" + \"medical equipment\"",
"per_page": 0,
"aggregations": [
"top_set_aside_types_by_dollars_obligated",
"top_naics_codes_by_dollars_obligated",
"top_psc_codes_by_dollars_obligated"
]
}
}Where are facilities or engineering transactions concentrated?
{
"tool": "Search_Federal_Transactions",
"arguments": {
"query": "\"architect engineering\" + facilities",
"per_page": 0,
"aggregations": [
"top_locations_by_dollars_obligated"
]
}
}Which vehicles and IDVs organize cloud modernization transactions?
{
"tool": "Search_Federal_Transactions",
"arguments": {
"query": "\"cloud modernization\"",
"per_page": 0,
"aggregations": [
"top_idvs_by_dollars_obligated",
"top_federal_contract_vehicles_by_dollars_obligated"
]
}
}Related articles
- Federal transaction MCP response: Review the response shape returned by this tool.
- Federal transaction 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.
Search federal grant sub awards
Searches GovTribe federal grant sub-awards and returns pass-through grant records with amounts, prime recipients, and sub-recipients.
Search GAO bid protests
Searches GovTribe GAO bid protest records with file-number, agency, opportunity, protester, status, outcome, date, and procurement identifier filters.