Search line items MCP tool

Searches GovTribe state and local awarded line items and returns unit prices, quantities, and parent award context for pricing evidence workflows.

MCP tool name: Search_Line_Items
Data type: Line item data type
Returns: Line item MCP response
Search modes: Keyword, Semantic
Annotations: Read only, not destructive, idempotent, closed world
Surfaces: GovTribe AI, GovTribe MCP

Examples

Use line item examples when the user needs state and local pricing evidence, unit prices, quantities, or parent award context.

Which line items mention water testing?

{
  "tool": "Search_Line_Items",
  "arguments": {
    "query": "water testing",
    "search_mode": "semantic",
    "fields_to_return": [
      "govtribe_id",
      "name",
      "description",
      "quantity",
      "unit_of_measure",
      "unit_price",
      "state",
      "state_local_contract_award"
    ]
  }
}

Which line items mention sensors?

{
  "tool": "Search_Line_Items",
  "arguments": {
    "query": "sensor",
    "search_mode": "semantic",
    "sort": {
      "key": "unitPrice",
      "direction": "desc"
    },
    "fields_to_return": [
      "govtribe_id",
      "name",
      "description",
      "quantity",
      "unit_of_measure",
      "unit_price",
      "state",
      "state_local_contract_award"
    ]
  }
}

Which line items belong to a known state and local award?

{
  "tool": "Search_State_And_Local_Contract_Awards",
  "arguments": {
    "query": "water testing services",
    "search_mode": "semantic",
    "fields_to_return": [
      "govtribe_id",
      "name",
      "state",
      "awardee_name"
    ]
  }
}

{
  "tool": "Search_Line_Items",
  "arguments": {
    "state_local_contract_award_ids": [
      "<state_local_contract_award_govtribe_id>"
    ],
    "fields_to_return": [
      "govtribe_id",
      "name",
      "description",
      "quantity",
      "unit_of_measure",
      "unit_price",
      "state_local_contract_award"
    ]
  }
}

Use aggregation examples when the answer needs price, quantity, category, or location rollups instead of individual line item 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.

What is the price and quantity profile for software license line items over $1,000?

{
  "tool": "Search_Line_Items",
  "arguments": {
    "query": "\"software license\"",
    "unit_price_range": {
      "min": 1000
    },
    "per_page": 0,
    "aggregations": [
      "unit_price_stats",
      "quantity_stats"
    ],
    "search_mode": "keyword"
  }
}

Which units of measure appear most often in network equipment line items?

{
  "tool": "Search_Line_Items",
  "arguments": {
    "query": "\"network equipment\"",
    "per_page": 0,
    "aggregations": [
      "top_unit_of_measurements_by_doc_count"
    ],
    "search_mode": "keyword"
  }
}

Which NIGP and UNSPSC categories define software license line items?

{
  "tool": "Search_Line_Items",
  "arguments": {
    "query": "\"software license\"",
    "per_page": 0,
    "aggregations": [
      "top_nigp_codes_by_doc_count",
      "top_unspsc_codes_by_doc_count"
    ],
    "search_mode": "keyword"
  }
}

Which states have the most facilities maintenance line items?

{
  "tool": "Search_Line_Items",
  "arguments": {
    "query": "\"facilities maintenance\"",
    "per_page": 0,
    "aggregations": [
      "top_states_by_doc_count"
    ],
    "search_mode": "keyword"
  }
}

Line item MCP response: Review the response shape returned by this tool.
Line item 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.
Source identifiers and record matching: Use GovTribe IDs and source identifiers when passing records between tools.