Skip to main content
Glama

Lookup Rates For Tin

lookup_rates_for_tin
Read-onlyIdempotent

Look up the negotiated rates a payer attaches to a tax entity (TIN/EIN), resolved at query time through the canonical graph: TIN → provider groups (idx_tin_provider_group) → pg_sets → rates. Accepts hyphenated EINs (normalized digits-only 9). Every result carries provenance: tin_business_name (the payer-asserted entity name), tin_scope_class (fanout class), and tin_index_path ('membership' = payer-asserted NPI↔TIN rows; 'bridge' = system-level group evidence). A TIN is system-shared, NOT building-exact — use lookup_rates_for_npi first for building-specific evidence; this is the fallback rung of the facility identity ladder. Payers without a TIN index (e.g. carefirst-class, no usable EIN rows) return an honest empty. PAGED: limit (default 25, max 500) and offset bound both matching_rates and provider_groups; rate_count / provider_group_count are the full totals and paging names what was cut plus the call that returns the next page. value is a COUNT, never a price: it is the TOTAL number of matching rates, unit says so, and headline spells it out in fields (kind=count, is_a_price=false). The prices themselves are one per row in matching_rates.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
tinYes
codeNo
limitNoRows per page for `matching_rates` and `provider_groups` (default 25, max 500). The totals are always reported in full; `paging` says what was cut and how to ask for the next page.
payerYes
stateYes
offsetNoRows to skip before this page. Pass the `paging.next_offset` from the previous answer.
versionNo

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
tinNo
codeNo
unitNo
as_ofNo
limitNo
payerNo
stateNo
valueNo
offsetNo
pagingNo
sourceNo
statusNocomplete
caveatsNo
failureNo
qualityNo
refusalNo
versionNo
vintageNo
headlineNo
no_matchNo
tin_foundNo
rate_countNo
explanationNo
methodologyNo
tool_versionNounknown
response_hashNo
matching_ratesNo
bridge_pg_countNo
elapsed_secondsNo
freshness_stateNounknown
provider_groupsNo
tin_index_pathsNo
not_found_reasonNo
semantic_versionNo
invariants_appliedNo
tin_business_namesNo
membership_pg_countNo
returned_rate_countNo
provider_group_countNo
provider_specific_countNo
broad_applicability_countNo
returned_provider_group_countNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • addedOutput schema / properties / no_match
      Added value: +{
      +  "anyOf": [
      +    {
      +      "additionalProperties": true,
      +      "type": "object"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "No Match"
      +}
    • addedOutput schema / properties / not_found_reason
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Not Found Reason"
      +}
  2. Changed2 schema fields changed
    • addedOutput schema / properties / rate_count / anyOf
      Added value: +[
      +  {
      +    "type": "integer"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • removedOutput schema / properties / rate_count / type
      Removed value: -"integer"
  3. First observed

TDQS

Score is being calculated.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources