For a complete vendor card or a role-specific subset (for example,
project managers), fetch every page: while has_more is true, call this
tool again with page=next_page and the same vendor_name, page_size,
ordering, and sort. Stop only when has_more is false, then combine the
pages and match the requested roles client-side.
If you stop early, say clearly that the results are partial, report
the fetched returned_range against total_rates, and explain that later
pages may contain additional matching roles or rates. Do not claim a role is absent
or present a complete role-specific rate range from a partial card.

Auto-discovers the exact vendor name via suggest-contains, then pulls
their rate records. Returns labor categories, rates, education levels,
experience requirements, SINs, contract numbers, contract end dates, and
worksite. A vendor often lists the same category twice at two prices,
one for work at the customer's site (Customer_Facility) and one at the
contractor's site (Contractor_Facility); check worksite before comparing.

Pass a partial name (e.g., 'booz' for Booz Allen Hamilton). The tool
finds the exact registered name automatically. Use part of the legal
name, not an acronym ('Science Applications', not 'SAIC').

total_rates counts rate rows, not titles: one title can have several
rows (worksite, contract, SIN). distinct_labor_categories is the number
of distinct titles (case-sensitive); when a vendor has more than 500 it
is null and distinct_labor_categories_min gives the floor.

Large vendors span many pages: Booz Allen Hamilton carries ~1,900 rate
rows (more than 500 distinct titles). The default page_size is 100 (~23KB) because a 500-row page
for a vendor that size is ~114KB and overflows MCP client output limits.
Rows are ordered by labor_category ascending by default, so a partial
card is alphabet-biased and may omit all requested roles on page 1.

There is no server-side way to intersect a vendor with a labor-category
keyword (the v3 API ignores vendor_name and labor_category as filter
fields; live-verified). To find specific categories, page through the
full card and match client-side.

If the discovery term matches multiple vendors, this tool picks the one
with the most rate records and returns a _candidates list so the caller
can re-query with a more specific term if needed.