SAM.gov MCP

- 19 tools covering entity, exclusion, opportunity, and award data
- Entity lookup by UEI, CAGE, or DUNS with registration status
- Exclusion checks by UEI/CAGE and search by name/agency/type
- Contract opportunity search with set-aside and NAICS filters
- Award search by PIID, vendor UEI, agency, NAICS, or fiscal year
- Federal hierarchy lookup and FFATA subaward reporting

- keyword_search: Search GSA CALC+ ceiling rates by keyword.

Performs wildcard matching across labor_category, vendor_name, and
idv_piid fields. This is the primary search tool for finding rates.

Returns matching rate records plus aggregation statistics (wage_stats,
percentiles, education breakdown, business size) covering the FULL
result set even when individual hits are capped at 10,000.

Important notes:
- These are NTE (not-to-exceed) ceiling rates, not prices paid
- Rates are fully burdened hourly rates from GSA MAS contracts
- Data refreshes nightly from vendor price proposal tables
- Use P50 from percentiles for median (more accurate than median_price)

Filter parameters:
- education_level: AA, BA, HS, MA, PHD, TEC (pipe-delimited for OR: 'BA|MA')
- experience_min/max: years of experience range
- price_min/max: hourly rate range in USD
- business_size: 'S' (small) or 'O' (other/large)
- security_clearance: 'yes' or 'no'
- sin: Special Item Number (e.g., '54151S' for IT Professional Services)
- worksite: 'Customer', 'Contractor', or 'Both'

ordering: current_price, labor_category, vendor_name, education_level,
min_years_experience. sort: 'asc' or 'desc'.

exclude: pipe-delimited hit _id values to exclude from results and stats.

- exact_search: Exact match search on a specific field.

Use suggest_contains() first to discover the exact field value, then
pass it here. The API requires exact string matching -- partial matches
return 0 results.

Fields: labor_category, vendor_name, idv_piid (GSA MAS contract number).

- suggest_contains: Discover exact field values via autocomplete/contains matching.

Returns aggregation buckets showing matching values and their record
counts. Use this BEFORE exact_search() to find the right value string.

Minimum 2 characters required for the search term.

Example workflow:
1. suggest_contains('vendor_name', 'booz') -> finds 'Booz Allen Hamilton Inc.'
2. exact_search('vendor_name', 'Booz Allen Hamilton Inc.') -> all their rates

- filtered_browse: Browse rates with filters only (no search keyword).

Useful for market segment statistics: "what do all BA-level rates with
5-15 years experience look like across all of GSA MAS?" Returns rate
records plus full aggregation statistics.

- igce_benchmark: Get ceiling rate benchmarks for IGCE development.

Returns statistical summary for a labor category: count, min, max, avg,
median, standard deviation, percentile distribution (P10-P90), education
breakdown, and outlier bounds.

This is the primary tool for building Independent Government Cost
Estimates. The returned statistics represent the market distribution
of GSA MAS ceiling rates for comparable labor categories.

Reminder: these are ceiling rates (max a contractor can charge), not
prices paid. Actual task order rates should be lower per FAR 8.405-2(d).

- price_reasonableness_check: Evaluate a proposed hourly rate against GSA ceiling rate distribution.

Returns the benchmark statistics plus a positioning analysis: z-score,
comparison to median, IQR position, and delta from average.

Use this for FAR 15.404-1 price analysis: is the proposed rate within
the expected range for comparable labor categories on GSA MAS?

A rate above P75 may be high; above P90 warrants scrutiny. A rate below
P25 may indicate an unrealistically low offer (potential performance risk).

- vendor_rate_card: Get all ceiling rates for a specific vendor.

Auto-discovers the exact vendor name via suggest-contains, then pulls
all their rate records. Returns labor categories, rates, education
levels, experience requirements, SINs, and contract numbers.

Pass a partial name (e.g., 'booz' for Booz Allen Hamilton). The tool
finds the exact registered name automatically.

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.

- sin_analysis: Get rate distribution and statistics for a specific SIN.

Returns rate statistics, education breakdown, business size breakdown,
and sample records for a GSA MAS Special Item Number.

Common SINs for professional services:
- 54151S: IT Professional Services
- 541611: Management and Financial Consulting
- 541715: Engineering R&D
- 541330ENG: Engineering Services
- 541512: Computer Systems Design
- 611430: Training