Search GSA labor rates MCP tool

MCP tool name: Search_GSA_Labor_Rates
Data type: GSA labor rate data type
Returns: GSA labor rate 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 for GSA Schedule labor-rate rows when pricing labor categories, comparing vendor or IDV ceiling rates, or narrowing labor-rate evidence by SIN, vehicle, worksite, education, business size, clearance, or rate-year fields.

Use query with search_mode for search text, rate_year for the calendar year of a rate row, and fields_to_return for row fields. This tool does not use BLS-style keyword, mode or item_fields_to_return arguments; search_by and contract_year are not supported inputs.

What are senior program manager GSA labor rates?

{
  "tool": "Search_GSA_Labor_Rates",
  "arguments": {
    "query": "\"program manager\"",
    "search_mode": "keyword",
    "per_page": 5,
    "sort": {
      "key": "price",
      "direction": "desc"
    },
    "fields_to_return": [
      "govtribe_id",
      "labor_category",
      "price",
      "vendor",
      "federal_contract_idv",
      "education_level",
      "min_years_experience",
      "worksite",
      "rate_year"
    ]
  }
}

What rates and schedule contracts belong to a known vendor?

vendor_ids accepts GovTribe vendor IDs or UEIs. Use the resolved identifier to keep similarly named vendors out of the comparison.

{
  "tool": "Search_GSA_Labor_Rates",
  "arguments": {
    "vendor_ids": ["<vendor_govtribe_id_or_uei>"],
    "fields_to_return": ["govtribe_id", "labor_category", "price", "vendor", "federal_contract_idv", "rate_year"],
    "aggregations": ["price_stats", "top_idvs_by_doc_count", "top_sins_by_doc_count"]
  }
}

Which rows belong to the same rate group?

rate_group_key is not the IDV. Use federal_contract_idv_ids or contract_number to search within a schedule contract, then use rate_group_key to retrieve sibling contract-year rows for the same labor-rate family.

{
  "tool": "Search_GSA_Labor_Rates",
  "arguments": {
    "rate_group_key": [
      "<rate_group_key>"
    ],
    "sort": {
      "key": "rateYear",
      "direction": "asc"
    },
    "fields_to_return": [
      "govtribe_id",
      "labor_category",
      "price",
      "contract_start",
      "contract_end",
      "rate_year",
      "rate_group_key"
    ]
  }
}

Aggregation examples

Use aggregation examples when the answer needs price, vendor, IDV, vehicle, SIN, category, worksite, business-size, clearance, or rate-year rollups instead of individual labor-rate 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 filters narrow systems engineering rate research?

{
  "tool": "Search_GSA_Labor_Rates",
  "arguments": {
    "query": "\"systems engineer\"",
    "search_mode": "keyword",
    "per_page": 0,
    "aggregations": [
      "top_labor_categories_by_doc_count",
      "top_education_levels_by_doc_count",
      "top_worksites_by_doc_count",
      "top_security_clearance_values_by_doc_count",
      "top_sins_by_doc_count",
      "top_rate_years_by_doc_count"
    ]
  }
}

What labor rates are attached to a known IDV?

{
  "tool": "Search_GSA_Labor_Rates",
  "arguments": {
    "federal_contract_idv_ids": [
      "<federal_contract_idv_govtribe_id>"
    ],
    "search_mode": "keyword",
    "fields_to_return": [
      "govtribe_id",
      "labor_category",
      "price",
      "federal_contract_idv",
      "federal_contract_vehicle",
      "federal_contract_vehicle_subcategories",
      "rate_group_key"
    ],
    "aggregations": [
      "price_stats",
      "price_percentiles",
      "top_labor_categories_by_doc_count",
      "top_sins_by_doc_count"
    ]
  }
}

GSA labor rate MCP response: Review the response shape returned by this tool.
GSA labor rate 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 query values.
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.

On this page