Search federal contract vehicle subcategories MCP tool
Search Federal Contract Vehicle Subcategories (FCV): GovTribe catalog records for GSA Multiple Award Schedule Special Item Numbers (MAS SINs) and other vehicle lots, pools, and lanes. The callable name Search_FCV_Subcategories is retained for compatibility.
- MCP tool name:
Search_FCV_Subcategories - Data type: Federal contract vehicle subcategory data type
- Returns: Federal contract vehicle subcategory 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 this tool when the agent needs the SIN, group, pool, lane, domain, or other subdivision under a parent federal contract vehicle. Resolve the parent vehicle first when the question names a vehicle such as SEWP V, MAS, OASIS+, or another master vehicle.
Which vehicle subcategories match IT modernization and cybersecurity work?
{
"tool": "Search_FCV_Subcategories",
"arguments": {
"query": "cybersecurity information technology services",
"search_mode": "semantic",
"fields_to_return": [
"govtribe_id",
"name",
"short_name",
"description",
"federal_contract_vehicle"
]
}
}Which SEWP V groups are available for an IT hardware or product requirement?
{
"tool": "Search_Federal_Contract_Vehicles",
"arguments": {
"query": "NASA SEWP",
"search_mode": "keyword",
"fields_to_return": [
"govtribe_id",
"name",
"contract_type",
"last_date_to_order"
]
}
}{
"tool": "Search_FCV_Subcategories",
"arguments": {
"federal_contract_vehicle_ids": [
"<sewp_v_govtribe_id>"
],
"fields_to_return": [
"govtribe_id",
"name",
"short_name",
"description",
"federal_contract_vehicle"
]
}
}Which MAS SINs are available on the Multiple Award Schedule?
{
"tool": "Search_Federal_Contract_Vehicles",
"arguments": {
"query": "Multiple Award Schedule MAS",
"search_mode": "keyword",
"fields_to_return": [
"govtribe_id",
"name",
"contract_type",
"last_date_to_order"
]
}
}{
"tool": "Search_FCV_Subcategories",
"arguments": {
"federal_contract_vehicle_ids": [
"<multiple_award_schedule_govtribe_id>"
],
"fields_to_return": [
"govtribe_id",
"name",
"short_name",
"description",
"federal_contract_vehicle"
]
}
}Which vehicle subcategories have a shared ceiling of at least $10B?
{
"tool": "Search_FCV_Subcategories",
"arguments": {
"shared_ceiling_range": {
"min": 10000000000
},
"fields_to_return": [
"govtribe_id",
"name",
"short_name",
"shared_ceiling",
"federal_contract_vehicle"
]
}
}Which vendors hold awards under a subcategory?
awardees returns a preview of up to 10 vendors per subcategory, and awardee_count gives the total. When awardee_count is larger than the preview, page through the subcategory's IDVs to get every awardee: each IDV names its awardee.
{
"tool": "Search_FCV_Subcategories",
"arguments": {
"query": "Information Technology Professional Services",
"search_mode": "keyword",
"fields_to_return": [
"govtribe_id",
"name",
"awardees"
]
}
}{
"tool": "Search_Federal_Contract_IDVs",
"arguments": {
"federal_contract_vehicle_subcategory_ids": [
"<subcategory_govtribe_id>"
],
"fields_to_return": [
"govtribe_id",
"awardee"
],
"per_page": 25,
"page": 1
}
}Related articles
- Federal contract vehicle subcategory MCP response: Review the response shape returned by this tool.
- Federal contract vehicle subcategory 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 custom field definitions
Searches the workspace's pursuit custom field definitions and returns each field's ID, name, type (text, number, date, or dollar), and whether it is required. Use the returned IDs as custom_field_id when reading or writing a pursuit's custom_fields.
Search federal agencies
Searches GovTribe federal agency records and returns agency profiles with identifiers, classifications, and URLs.