Dashboard
PayerPrice MCP Documentation
Ask your AI assistant about commercial negotiated rates, provider fee schedules, and Medicare rates, and get answers from PayerPrice data. Connect Claude, Cursor, or another app that supports the Model Context Protocol (MCP), sign in once, then ask in plain language.
For example: What is the median rate commercial payers pay for CPT 99213 in Texas?
Connect your assistant
Choose your app and follow its steps. Your app opens a PayerPrice sign-in; approve access there. Being signed in on this page does not connect your app, and you do not need an API key.
In Claude Desktop, open Customize → Connectors, select + → Add custom connector, and enter the PayerPrice server URL:
https://api.payerprice.com/api/v1/open/mcp
On Team or Enterprise plans, an organization owner must add the remote connector first. Then select Connect to sign in.
Server URL
For other apps that support remote MCP servers
https://api.payerprice.com/api/v1/open/mcpCredits and pricing
- Each tool call uses your organization's API/MCP credit, the same balance the PayerPrice API uses. To answer one question, your assistant may call several tools.
- Each tool below lists its price. Some tools also charge per selection: each billing code or range, payer, period, or provider identifier in a request.
- Trial accounts start with API/MCP trial credit, counted in calls.
- Your balance and usage are in the bar at the top of this page. Try this tool runs a real call and uses credit.
Tools
Expand a tool to see its inputs and try it with your account.
Benchmark a market: percentiles, averages, and ranges of negotiated rates.
Compute aggregate statistics (percentiles, min, max, mean) over commercial negotiated rates across all providers that match the given filters (state, specialty, payer, billing code, etc.).
Use this to understand the distribution of rates in a market - e.g. 'what do BCBS and United typically pay cardiologists in Texas for CPT 99213?'. Returns aggregated numbers only. Rates of $0 (bundled or not paid separately) are left out. Within each groupBy group every TIN contributes one value, its highest matching rate, so include num_distinct_tins and report it as the sample size. Dimensions left out of groupBy collapse to the highest rate, so add billingClass, serviceCode (placeOfService on search_provider_fee_schedule), billingCodeModifier, or negotiatedTypeGroup to groupBy when they could separate different rates; never group by a dimension the filters already fix to one value. negotiatedTypeGroup keeps negotiated and fee schedule dollar rates together; use negotiatedType only when the user asks to split them. Setting metrics.comparedTo returns values as a percent of national Medicare instead of dollars: each rate divides by the Physician Fee Schedule amount for its code and modifier (26 and TC rates by that component, others by the global amount), and institutional rates return null. Use search_market_negotiated_rates for individual rows across a market or search_provider_fee_schedule for identified providers.
Returns
{result: [{...groupBy fields, percentile_50: 125, num_distinct_tins: 8}], url}: one row per group, with each statistic under the aggregation name requested.
Rate rules
- When no payer is named, use United for a one-code clinician or practice lookup, United, Aetna, Cigna, and BCBS plus the regional payers that list it in network (include
'payers') for a hospital or health system, compare United, Aetna, Cigna, and BCBS for a market question in one to four states, and use United alone for a national question or five or more states, unless the user names a payer set ('top payers', 'major payers','BUCA', 'all payers'), which means United, Aetna, Cigna, and BCBS together at any geography (an initialism of B, U, C, and A names BCBS, United, Cigna, and Aetna letter by letter, so'UAC'is United, Aetna, and Cigna;'UHC'is United); state that assumption in the answer. - Find codes for a described service with search_billing_codes or a provider's
topCodes(search_providers or lookup_providers with include'topCodes'). - A value can be dollars, a percentage, or a per diem (
negotiatedTypeGroup: dollar, derived, per diem, or percentage); never compare or rank different groups together. - Filter rate types with
negotiatedTypeGroups(e.g.['dollar']);negotiatedTypesfilters by raw type; use it only to separate negotiated from fee schedule rates. - Query professional and institutional billing classes separately.
- Without
yearMonthseach payer's latest loaded month is used, and months can differ by payer. - No rows means not observed in the searched scope, not 'no contract' or 'not covered'.
- BCBS pools every Blue plan's file and localizes it only by provider state, so BCBS rows in a state can come from out-of-state Blue plans; they do not show that the state's own Blue plan priced the code.
Parameters
Which rates to include. search_market_percentile_negotiated_rates and search_market_negotiated_rates take the same filters.
Required. Two-letter US state codes that providers must be located in (e.g. ['CA', 'MA', 'TX']).
Five-digit US ZIP codes (e.g. ['02451']). Each is searched as the whole county or counties that contain it, not the ZIP alone, so prefer `counties` when the county is known, and name the area as the county.
Counties providers must be located in, as state and county pairs (e.g. [{state: 'VA', county: 'Fairfax County'}]). Narrows states: each county's state must also be in states.
Metropolitan Statistical Areas providers must be located in, as five-digit metropolitan CBSA codes (e.g. [47900] for Washington-Arlington-Alexandria, [19100] for Dallas-Fort Worth-Arlington). Use the metro area code, not a metropolitan division code such as 47894. Keeps providers whose county belongs to the metro area; narrows states, which must include at least one of its states.
Required. NUCC provider taxonomy codes that identify specialty (e.g. ['207Q00000X'] for Family Medicine). Prefer the general specialty code (ending in 00000X) unless the user names a subspecialty.
'individual' (solo practitioner) or 'group' (organization/group practice). Omit to include both.
Required. Insurance payer identifiers (e.g. ['BCBS', 'United', 'Aetna']). All Blue Cross Blue Shield identifiers query one combined Blues dataset reported as 'BCBS'. When the user names none, use ['United'] for a one-code clinician or practice lookup, ['United', 'Aetna', 'Cigna', 'BCBS'] plus the regional payers that list it in network (include 'payers') for a hospital or health system, ['United', 'Aetna', 'Cigna', 'BCBS'] for a market question in one to four states, and ['United'] for a national question or five or more states; state that assumption in the answer. A payer set the user names ('top payers', 'major payers', 'BUCA', 'all payers') is ['United', 'Aetna', 'Cigna', 'BCBS'] at any geography; an initialism of B, U, C, and A names BCBS, United, Cigna, and Aetna letter by letter, so 'UAC' is ['United', 'Aetna', 'Cigna']; 'UHC' is 'United'.
Exact billing codes and their code system (e.g. [{code: '99213', type: 'CPT'}]); search_billing_codes returns codes in this shape. Codes are strings; keep leading zeros.
'professional' (physician/practitioner billing) or 'institutional' (facility/hospital billing). Query them separately; their rates are different products. A rate the payer published for 'both' classes applies to either one, so either filter keeps it; group by billingClass to tell it apart.
CMS Place of Service codes as two-character strings (e.g. '11' office, '21' inpatient, '22' outpatient hospital, '23' emergency room, '02' telehealth). Rows with no place of service or CSTM-00 apply at every place of service, so a filter always keeps them; group by serviceCode (placeOfService on search_provider_fee_schedule) to tell them apart.
CPT/HCPCS modifiers (e.g. '26' professional component, 'TC' technical component). Global, 26, and TC rates are not interchangeable.
Rate type groups to keep, as Report Data groups them: 'dollar' (negotiated, fee schedule, and every other dollar type), 'derived', 'per diem', or 'percentage' (e.g. ['dollar']). 'per diem' and 'percentage' values are not dollars per service; never compare them with dollar rates. Prefer this to negotiatedTypes.
Raw rate types; prefer negotiatedTypeGroups unless negotiated and fee schedule rates must be separated. When both are set, a rate must match both. Use it only to separate negotiated from fee schedule rates.
Year/month periods, e.g. [{year: 2026, month: 9}]. When omitted, each payer's most recent loaded month is used, which can differ between payers.
Plan names exactly as list_payer_plans returns them (e.g. ['Optum Health WESTERN HEALTH ADVANTAGE WHA HMO SG']); a name matches only a plan with that exact name. For a plan type such as PPO or HMO, pass every listed plan name that contains it, and say which names the figure covers.
Individual (un-normalized) network names, exactly as reported in the payer transparency file (e.g. ['Choice Plus', 'Navigate']).
Statistics to compute, returned under these same names (e.g. ['percentile_25', 'percentile_50', 'percentile_75', 'num_distinct_tins']). Include 'num_distinct_tins' and report it as the sample size; num_distinct_npis and num_entries also count TINs at this grain.
Optional. 'medicare_<year>' returns every rate statistic as a percent of the national non-facility Medicare Physician Fee Schedule amount for the same CPT code and modifier (26 and TC compare to their own components, other rates to the global amount; 145 means 145%). Institutional rates, and codes or modifiers without that amount, return null rate statistics. Omit or use 'none' for dollar values.
Dimensions to group results by, e.g. ['payer', 'billingCode'] returns one row per (payer, code) combination. Network output semantics are endpoint-specific: market benchmarks return one group per network, while provider rates return a deduplicated network array. Include at least 'payer' and 'billingCode' in most cases - without them, rates are pooled across payers/codes and are usually not interpretable. Use 'negotiatedTypeGroup' (dollar, derived, per diem, percentage) to keep dollar rates apart from other rate types; 'negotiatedType' also splits negotiated from fee schedule dollar rates.
Order the rows by one of the requested aggregations (e.g. 'percentile_50'), for 'which payer, state, or code pays most'. Rows without the value come last. Not available to trial accounts or unauthenticated requests.
Requires sortBy. Defaults to desc, highest first.
Try this tool
Start with an example, adjust its arguments, and run it with your account.
Request
JSON arguments
Response
Not run yet
Run the tool to see its response here.
Sign in to see pricing and run this tool
List individual providers' negotiated rates in a market.
Retrieve a bounded page of individual provider negotiated-rate rows for a state, specialty, payer, and billing code.
Use for provider-level market comparisons or row-level evidence; one provider can appear on several rows. Use search_market_percentile_negotiated_rates for typical rates, averages, medians, or percentiles, and never compute those from a page of rows; both tools take the same filters. limit is the page size (at most 100) and offset the number of rows to skip. aggregatedColumns collapses listed fields within rows; it is not a group-by setting. On a complete first page, a dollar rate more than 2 standard deviations from the other TINs in its payer, code, class, type, and setting cohort (5+ TINs) carries peerOutlier 'high' or 'low' and peerCohortTinCount; a flag is context to explain, not an error, and no row is dropped.
Returns
{result: [{npi, tin, npiDisplayName, tinDisplayName, negotiatedRate, ...}], url, outlierNote}.
Rate rules
- When no payer is named, use United for a one-code clinician or practice lookup, United, Aetna, Cigna, and BCBS plus the regional payers that list it in network (include
'payers') for a hospital or health system, compare United, Aetna, Cigna, and BCBS for a market question in one to four states, and use United alone for a national question or five or more states, unless the user names a payer set ('top payers', 'major payers','BUCA', 'all payers'), which means United, Aetna, Cigna, and BCBS together at any geography (an initialism of B, U, C, and A names BCBS, United, Cigna, and Aetna letter by letter, so'UAC'is United, Aetna, and Cigna;'UHC'is United); state that assumption in the answer. - Find codes for a described service with search_billing_codes or a provider's
topCodes(search_providers or lookup_providers with include'topCodes'). - A value can be dollars, a percentage, or a per diem (
negotiatedTypeGroup: dollar, derived, per diem, or percentage); never compare or rank different groups together. - Filter rate types with
negotiatedTypeGroups(e.g.['dollar']);negotiatedTypesfilters by raw type; use it only to separate negotiated from fee schedule rates. - Query professional and institutional billing classes separately.
- Without
yearMonthseach payer's latest loaded month is used, and months can differ by payer. - No rows means not observed in the searched scope, not 'no contract' or 'not covered'.
- BCBS pools every Blue plan's file and localizes it only by provider state, so BCBS rows in a state can come from out-of-state Blue plans; they do not show that the state's own Blue plan priced the code.
Parameters
Which rates to include. search_market_percentile_negotiated_rates and search_market_negotiated_rates take the same filters.
Required. Two-letter US state codes that providers must be located in (e.g. ['CA', 'MA', 'TX']).
Five-digit US ZIP codes (e.g. ['02451']). Each is searched as the whole county or counties that contain it, not the ZIP alone, so prefer `counties` when the county is known, and name the area as the county.
Counties providers must be located in, as state and county pairs (e.g. [{state: 'VA', county: 'Fairfax County'}]). Narrows states: each county's state must also be in states.
Metropolitan Statistical Areas providers must be located in, as five-digit metropolitan CBSA codes (e.g. [47900] for Washington-Arlington-Alexandria, [19100] for Dallas-Fort Worth-Arlington). Use the metro area code, not a metropolitan division code such as 47894. Keeps providers whose county belongs to the metro area; narrows states, which must include at least one of its states.
Required. NUCC provider taxonomy codes that identify specialty (e.g. ['207Q00000X'] for Family Medicine). Prefer the general specialty code (ending in 00000X) unless the user names a subspecialty.
'individual' (solo practitioner) or 'group' (organization/group practice). Omit to include both.
Required. Insurance payer identifiers (e.g. ['BCBS', 'United', 'Aetna']). All Blue Cross Blue Shield identifiers query one combined Blues dataset reported as 'BCBS'. When the user names none, use ['United'] for a one-code clinician or practice lookup, ['United', 'Aetna', 'Cigna', 'BCBS'] plus the regional payers that list it in network (include 'payers') for a hospital or health system, ['United', 'Aetna', 'Cigna', 'BCBS'] for a market question in one to four states, and ['United'] for a national question or five or more states; state that assumption in the answer. A payer set the user names ('top payers', 'major payers', 'BUCA', 'all payers') is ['United', 'Aetna', 'Cigna', 'BCBS'] at any geography; an initialism of B, U, C, and A names BCBS, United, Cigna, and Aetna letter by letter, so 'UAC' is ['United', 'Aetna', 'Cigna']; 'UHC' is 'United'.
Exact billing codes and their code system (e.g. [{code: '99213', type: 'CPT'}]); search_billing_codes returns codes in this shape. Codes are strings; keep leading zeros.
'professional' (physician/practitioner billing) or 'institutional' (facility/hospital billing). Query them separately; their rates are different products. A rate the payer published for 'both' classes applies to either one, so either filter keeps it; group by billingClass to tell it apart.
CMS Place of Service codes as two-character strings (e.g. '11' office, '21' inpatient, '22' outpatient hospital, '23' emergency room, '02' telehealth). Rows with no place of service or CSTM-00 apply at every place of service, so a filter always keeps them; group by serviceCode (placeOfService on search_provider_fee_schedule) to tell them apart.
CPT/HCPCS modifiers (e.g. '26' professional component, 'TC' technical component). Global, 26, and TC rates are not interchangeable.
Rate type groups to keep, as Report Data groups them: 'dollar' (negotiated, fee schedule, and every other dollar type), 'derived', 'per diem', or 'percentage' (e.g. ['dollar']). 'per diem' and 'percentage' values are not dollars per service; never compare them with dollar rates. Prefer this to negotiatedTypes.
Raw rate types; prefer negotiatedTypeGroups unless negotiated and fee schedule rates must be separated. When both are set, a rate must match both. Use it only to separate negotiated from fee schedule rates.
Year/month periods, e.g. [{year: 2026, month: 9}]. When omitted, each payer's most recent loaded month is used, which can differ between payers.
Plan names exactly as list_payer_plans returns them (e.g. ['Optum Health WESTERN HEALTH ADVANTAGE WHA HMO SG']); a name matches only a plan with that exact name. For a plan type such as PPO or HMO, pass every listed plan name that contains it, and say which names the figure covers.
Individual (un-normalized) network names, exactly as reported in the payer transparency file (e.g. ['Choice Plus', 'Navigate']).
Fields to collapse into delimited output lists, not group-by dimensions. Payer is always a separate result dimension and is not valid here. Defaults to serviceCode and billingCodeModifier. Include network only when network output is needed because it resolves network_names_arr.
How to combine negotiated rates collapsed into one row. Applies only when aggregatedColumns includes 'negotiatedRate'; defaults to listUniqueValues.
One sort entry, applied before pagination. columnId must be one of payer, tin, npi, billingTypeCode, negotiatedType, billingClass, negotiatedRate, serviceCode, or billingCodeModifier; other values are ignored. Defaults to npi ascending.
Maximum rows to return. Defaults to 100, the most allowed.
Rows to skip. For the next page, pass the previous offset plus limit. Defaults to 0.
Try this tool
Start with an example, adjust its arguments, and run it with your account.
Request
JSON arguments
Response
Not run yet
Run the tool to see its response here.
Sign in to see pricing and run this tool
Negotiated rates for specific providers identified by NPI, TIN, or CCN.
Retrieve the commercial negotiated rates (fee schedule) for specific providers identified by NPI, TIN, or CCN, for the payers and billing codes you specify.
Use this when you want each provider's own rates - e.g. 'what rates has Mayo Clinic negotiated with Aetna for office visits?'. Rate filters go in filters, which takes the market tools' filter fields apart from location and specialty. Billing codes are required; when the user asks for a provider's fee schedule without naming codes, use the topCodes returned by search_providers or lookup_providers. A tin row may not apply to every NPI under the TIN, and an npi row can come from any of its TINs; attribution explains mixed grains. For professional rates group by placeOfService: one Non-Facility (office), Facility, or Global (custom or blank service code) row per code with its serviceCodes, whose negotiatedRate is the amount most of those service codes carry (each code at its highest rate), not the highest, and otherRates for codes paid another amount; without placeOfService or serviceCode a row is the highest rate across settings, for office codes the non-facility amount. With payer, billingCode, and negotiatedTypeGroup in groupBy and 4+ payers, a row more than 2 standard deviations from the mean of the provider's other payers carries crossPayerDeviation 'high' or 'low', context only. Dimensions left out of groupBy collapse to the highest rate, so add billingClass, serviceCode (placeOfService on search_provider_fee_schedule), billingCodeModifier, or negotiatedTypeGroup to groupBy when they could separate different rates; never group by a dimension the filters already fix to one value. negotiatedTypeGroup keeps negotiated and fee schedule dollar rates together; use negotiatedType only when the user asks to split them. With no filters.yearMonths each payer is read at its latest loaded month, named in periods. With yearMonths each row names its month in yearMonth and, across several months, is its group's newest month; add yearMonth to groupBy for one row per month. When a requested payer has no row, searchNotes names the earlier months to search next for it. At most 12 payer-month combinations per call. Use search_market_negotiated_rates for individual rates across a market or search_market_percentile_negotiated_rates for market statistics.
Returns
{result: [{...groupBy fields, tin: 123456789, negotiatedRate: 98.76}], url, attribution, outlierNote}: each row names its provider as npi, tin, or ccn, and negotiatedRate is that provider's highest rate in the group.
Rate rules
- When no payer is named, use United for a one-code clinician or practice lookup, United, Aetna, Cigna, and BCBS plus the regional payers that list it in network (include
'payers') for a hospital or health system, compare United, Aetna, Cigna, and BCBS for a market question in one to four states, and use United alone for a national question or five or more states, unless the user names a payer set ('top payers', 'major payers','BUCA', 'all payers'), which means United, Aetna, Cigna, and BCBS together at any geography (an initialism of B, U, C, and A names BCBS, United, Cigna, and Aetna letter by letter, so'UAC'is United, Aetna, and Cigna;'UHC'is United); state that assumption in the answer. - Find codes for a described service with search_billing_codes or a provider's
topCodes(search_providers or lookup_providers with include'topCodes'). - A value can be dollars, a percentage, or a per diem (
negotiatedTypeGroup: dollar, derived, per diem, or percentage); never compare or rank different groups together. - Filter rate types with
negotiatedTypeGroups(e.g.['dollar']);negotiatedTypesfilters by raw type; use it only to separate negotiated from fee schedule rates. - Query professional and institutional billing classes separately.
- Without
yearMonthseach payer's latest loaded month is used, and months can differ by payer. - No rows means not observed in the searched scope, not 'no contract' or 'not covered'.
- BCBS pools every Blue plan's file and localizes it only by provider state, so BCBS rows in a state can come from out-of-state Blue plans; they do not show that the state's own Blue plan priced the code.
Parameters
Providers to return rates for. Provide at least one of npis, tins, or ccns. Use search_providers first if you only know the provider's name.
NPIs (10-digit numbers) whose negotiated rates to retrieve.
TINs as integers without dashes whose negotiated rates to retrieve; leading zeros drop (04-1234567 becomes 41234567).
CCNs (CMS Certification Numbers, 6 characters) whose negotiated rates to retrieve.
Which rates to include for these providers, with the same fields as the market tools' filters apart from location and specialty.
Required. Insurance payer identifiers (e.g. ['BCBS', 'United', 'Aetna']). All Blue Cross Blue Shield identifiers query one combined Blues dataset reported as 'BCBS'. When the user names none, use ['United'] for a one-code clinician or practice lookup, ['United', 'Aetna', 'Cigna', 'BCBS'] plus the regional payers that list it in network (include 'payers') for a hospital or health system, ['United', 'Aetna', 'Cigna', 'BCBS'] for a market question in one to four states, and ['United'] for a national question or five or more states; state that assumption in the answer. A payer set the user names ('top payers', 'major payers', 'BUCA', 'all payers') is ['United', 'Aetna', 'Cigna', 'BCBS'] at any geography; an initialism of B, U, C, and A names BCBS, United, Cigna, and Aetna letter by letter, so 'UAC' is ['United', 'Aetna', 'Cigna']; 'UHC' is 'United'.
Exact billing codes and their code system (e.g. [{code: '99213', type: 'CPT'}]); search_billing_codes returns codes in this shape. Codes are strings; keep leading zeros.
'professional' (physician/practitioner billing) or 'institutional' (facility/hospital billing). Query them separately; their rates are different products. A rate the payer published for 'both' classes applies to either one, so either filter keeps it; group by billingClass to tell it apart.
CMS Place of Service codes as two-character strings (e.g. '11' office, '21' inpatient, '22' outpatient hospital, '23' emergency room, '02' telehealth). Rows with no place of service or CSTM-00 apply at every place of service, so a filter always keeps them; group by serviceCode (placeOfService on search_provider_fee_schedule) to tell them apart.
CPT/HCPCS modifiers (e.g. '26' professional component, 'TC' technical component). Global, 26, and TC rates are not interchangeable.
Rate type groups to keep, as Report Data groups them: 'dollar' (negotiated, fee schedule, and every other dollar type), 'derived', 'per diem', or 'percentage' (e.g. ['dollar']). 'per diem' and 'percentage' values are not dollars per service; never compare them with dollar rates. Prefer this to negotiatedTypes.
Raw rate types; prefer negotiatedTypeGroups unless negotiated and fee schedule rates must be separated. When both are set, a rate must match both. Use it only to separate negotiated from fee schedule rates.
Year/month periods, e.g. [{year: 2026, month: 9}]. When omitted, each payer's most recent loaded month is used, which can differ between payers.
Plan names exactly as list_payer_plans returns them (e.g. ['Optum Health WESTERN HEALTH ADVANTAGE WHA HMO SG']); a name matches only a plan with that exact name. For a plan type such as PPO or HMO, pass every listed plan name that contains it, and say which names the figure covers.
Individual (un-normalized) network names, exactly as reported in the payer transparency file (e.g. ['Choice Plus', 'Navigate']).
Dimensions to group provider-rate results by. Include at least 'payer' and 'billingCode'. For professional rates add 'placeOfService': one row per Non-Facility (office), Facility, or Global (custom or blank service code) setting with its serviceCodes and any otherRates, instead of 'serviceCode', which returns one row per place-of-service code. With placeOfService, leave filters.serviceCodes empty unless the user asked for one setting; an office-only list such as ['11', 'CSTM-00', 'none'] drops the facility rate. Without either, settings collapse to the highest rate, which for office codes is the non-facility amount. Network and planName are returned as deduplicated arrays instead of splitting otherwise identical rate rows. With filters.yearMonths each row names its month in yearMonth and, across several months, is its group's newest month; add 'yearMonth' for one row per month, e.g. a rate's history.
Order the rows by negotiatedRate, e.g. a provider's highest-paid codes. Rank within one negotiatedTypeGroup. Not available to trial accounts or unauthenticated requests.
Requires sortBy. Defaults to desc, highest first.
Try this tool
Start with an example, adjust its arguments, and run it with your account.
Request
JSON arguments
Response
Not run yet
Run the tool to see its response here.
Sign in to see pricing and run this tool
Look up healthcare providers by name, specialty, or state.
Look up healthcare providers by name (e.g. 'Mayo Clinic'), specialty (via taxonomyCodes), or state, and return their identifying details: NPI/TIN/CCN, name, credentials, practice or organization address, states, specialties (taxonomy code and name), entity type, and the number of NPIs under a TIN.
Add include 'payers' for in-network payers and 'topCodes' for the codes the provider bills most, only when the question needs them. CCN matches include city and state. Commonly used as the first step before search_provider_fee_schedule - find the provider(s) here, then pass the returned NPI/TIN/CCN values to fetch their negotiated rates, requesting topCodes to use as billingCodeAndTypes when the user names no codes. Returns NPI and TIN matches unless types includes 'ccn'. For the largest groups in a specialty or state, set sortBy 'npiCount': Tax IDs only, most NPIs first. For who performs a service or does the most of it, pass cmsCodes (with states) and sortBy 'cmsVolume'; cmsVolume alone ranks by total Medicare and Medicaid volume. Results carry cmsVolume and cmsCodeVolumes; say the ranking is Medicare and Medicaid volume, not all payers. A Tax ID's volume includes the full volume of each linked NPI, so it overlaps other Tax IDs. sortBy is refused for trial accounts. Results are candidates; confirm name, address, and specialty before using them, and ask the user when same-named providers remain. Use lookup_providers when you already have identifiers, and search_facilities for hospitals and other facilities by name, location, or type.
Parameters
Name of an individual provider, group, hospital, or clinic (e.g. 'Dr. John Smith' or 'Mayo Clinic'). Do not put specialties (e.g. 'Cardiology', 'Pediatrics') here - use taxonomyCodes for that.
Which identifier types to return results for:
* 'npi' - National Provider Identifier, covers both individuals and organizations.
* 'tin' - Tax Identification Number, used for organizations/group practices.
* 'ccn' - CMS Certification Number, used for Medicare-certified hospitals and facilities. Searched only when listed; uses providerName and the first state.
Omit to return NPI and TIN matches.
Two-letter US state codes to filter providers by (e.g. ['CA', 'MA']). Omit to search across all states.
Provider taxonomy codes (NUCC) that identify a specialty, e.g. '208000000X' for Pediatrics. Required when searching by specialty rather than by a specific provider name or identifier.
Maximum number of providers to return per identifier type. Defaults to the top 10 most relevant matches per type; capped at 30.
NPI and TIN details to add; omit for identity only. 'payers': payers whose files list the provider in network (all Blues plans as BCBS). 'topCodes': up to 20 codes the provider bills most, to seed a fee schedule search when no codes are named.
CPT or HCPCS codes (e.g. ['95004', '95024']). Keeps providers with Medicare or Medicaid volume in any of them. A provider's index entry holds its 100 highest-volume codes, so a code it bills rarely may not match; CMS also omits low-volume rows. Not available to unauthenticated requests.
'npiCount' returns Tax IDs only, largest first by the number of NPIs under them: use it for the largest groups in a specialty or state; requires states or taxonomyCodes. 'cmsVolume' orders by CMS volume (Medicare services plus Medicaid claims, all loaded years): volume in cmsCodes when given, otherwise total volume. Medicare counts services, so each billing unit of a drug (a J code) or lab test counts as one and drug- or lab-heavy providers rank high on total volume. Use it with cmsCodes for 'who does the most of this service' and alone with states for the highest-volume providers. A Tax ID's volume credits the full volume of every NPI linked to it (connection score 70 or higher), and an NPI linked to several Tax IDs counts in each, so Tax ID volumes overlap and must not be summed; it is not limited to the searched state. Not available to trial accounts or unauthenticated requests.
For cmsVolume only; refused with any other or no sortBy. Defaults to desc, highest first.
Try this tool
Start with an example, adjust its arguments, and run it with your account.
Request
JSON arguments
Response
Not run yet
Run the tool to see its response here.
Sign in to see pricing and run this tool
Get details for NPIs, TINs, or CCNs you already have, in bulk.
Look up providers you already have identifiers for: up to 10 each of NPIs, TINs, and CCNs in one call.
NPIs and TINs return the same records as search_providers: name, credentials, address, entity or TIN type, states, specialties, the TINs an NPI bills under, and the number of NPIs under a TIN. CCNs return facility name, address, CMS provider type, ownership, beds, health system, and organization NPI. Request more only when the question needs it, with include: 'payers' for in-network payers (NPIs, TINs, and CCNs), 'topCodes' for the codes an NPI or TIN bills most, 'claims' for claim volume by code and year (narrow it with claimCodes), 'quality' for CMS clinician quality or facility star ratings, 'relatedIdentifiers' for an NPI's related NPIs and alternate names, 'registry' for an NPI's CMS NPPES record (legal name, parent organization, authorized official, locations, licenses, deactivation), 'connections' for how strongly each NPI is tied to its TINs, and for CCNs 'financials' (cost report: revenue, expenses, net income, payer days) and 'hospitalProfile' (accreditation, ownership, Medicare inpatient DRGs and outpatient APCs, clinician counts). More profile detail, each only on request: for NPIs 'registryEndpoints' (NPPES health information exchange endpoints), 'ccns' (linked facilities), and 'addresses' (mailing address, practice counties); 'linkedNpis' for other NPIs tied to an NPI's or a TIN's Tax IDs (at most 3 NPIs and TINs per call); for TINs 'sampleNpis' and 'relatedGroupNpis'; for CCNs 'qualityDetail' (every CMS quality measure), 'clinicianList' (affiliated clinicians), 'payerTins' (Tax IDs and NPIs in payer files), 'nearbyHospitals', and 'facilityDetail' (phone, clinical services). Use it to verify identifiers from the user or another tool, or to expand an NPI into its TINs, before search_provider_fee_schedule. To find providers by name, use search_providers or search_facilities.
Returns
{npis, tins, ccns, notFound}; notFound lists identifiers that are invalid, have no record, or are outside your organization's data access.
Parameters
NPIs to look up, as 10-digit integers (at most 10).
TINs to look up, as integers without dashes; leading zeros drop, so 04-1234567 is 41234567 (at most 10).
CCNs (CMS Certification Numbers) to look up, as 6-character strings such as '050454'. A 5-digit CCN missing its leading zero is also accepted (at most 10).
Extra detail to return; omit for identity only, which is fastest. 'payers': payers whose files list the provider in network (all Blues plans as BCBS). 'topCodes': up to 20 codes the provider bills most, to seed a fee schedule search when no codes are named. 'payers' also applies to CCNs. 'claims' (NPIs and TINs): Medicare, Medicaid, and, for accounts with commercial claims access, commercial claim volume by billing code and year. 'quality' (NPIs and CCNs): CMS clinician quality (MIPS, procedure volume, affiliations) or facility star ratings. 'relatedIdentifiers' (NPIs): related NPIs and alternate names, for resolving an organization. 'registry' (NPIs): the CMS NPPES registry record: legal name, parent organization, authorized official, practice locations, taxonomies with licenses, other identifiers, and enumeration and deactivation dates. 'connections' (NPIs): connection strength between each NPI and its TINs, plus any TINs in this request. 'financials' (CCNs): CMS cost report and financial statements (revenue, operating expense, net income, payer days). 'hospitalProfile' (CCNs): CMS profile (accreditation, ownership, certified beds), Medicare inpatient services with top DRGs, Medicare outpatient APC services, and clinician counts by specialty. 'registryEndpoints' (NPIs): health information exchange endpoints registered with NPPES, such as Direct addresses and FHIR URLs, with their affiliations. 'ccns' (NPIs): CMS Certification Numbers of facilities linked to the NPI. 'addresses' (NPIs): mailing address and practice counties. 'linkedNpis' (NPIs and TINs): up to 20 other NPIs with a medium-or-stronger tie to the NPI's TINs, or to the TIN; computed for at most 3 NPIs and TINs per call. 'sampleNpis' (TINs): sample NPIs payer files list under the TIN. 'relatedGroupNpis' (TINs): organization NPIs related to the TIN. 'qualityDetail' (CCNs): every CMS quality measure by care setting, with state and national comparisons (at most 100 measures per setting). 'clinicianList' (CCNs): up to 24 clinicians CMS lists as affiliated with the facility, with NPI, name, credential, and specialty. 'payerTins' (CCNs): Tax IDs payers list for the facility in their price files, with the payers and up to 10 organization NPIs under each, and the facility's website. 'nearbyHospitals' (CCNs): up to four nearby hospitals of the same provider type, with distance in miles. 'facilityDetail' (CCNs): phone number and clinical services offered. Values that do not apply to an identifier type are ignored.
With include 'claims': billing codes (such as '99214' or 'J1745') to return claim volume for, across every year available (at most 20). Omit to get the provider's highest-volume codes in the latest year of each source.
Try this tool
Start with an example, adjust its arguments, and run it with your account.
Request
JSON arguments
Response
Not run yet
Run the tool to see its response here.
Sign in to see pricing and run this tool
Find hospitals and other Medicare-certified facilities by name, CCN, location, or type.
Search hospitals, critical access hospitals, nursing homes, dialysis facilities, ambulatory surgery centers, health centers, hospices, and home health agencies identified by CMS Certification Number (CCN).
Match by name words (names, aliases, health system, city), an exact CCN, or states, and narrow by facilityTypes or, for hospitals, hospitalTypes such as 'Critical Access Hospitals'. Provide at least one of name, ccn, or states. Several rows can share one CCN when a hospital has more than one site. Results are candidates; confirm name and location, then pass the CCN to search_provider_fee_schedule for the facility's negotiated rates.
Returns
{facilities: [{ccn, name, address, facilityType, providerType, ownership, bedCount, affiliatedHealthSystem, npi}]}, best name matches first, or ordered by sortBy ('bedCount' for the largest, 'careQuality' for the highest CMS star rating within one facility type; refused for trial accounts).
Parameters
Words from the facility's name, an alias, its health system, or its city (e.g. 'Mayo Rochester'). Words must appear in this order. Digits also match CCNs.
An exact CCN, such as '050454'; a 5-digit form missing the leading zero also matches.
Two-letter state codes (e.g. ['MN', 'WI']). Omit to search every state.
Facility categories: HOSPITAL, NURSING_HOME, HOME_HEALTH, HOSPICE, DIALYSIS, ASC (ambulatory surgery center), HEALTH_CENTER (FQHC or other HRSA health center), CLINIC, LONG_TERM_CARE, OTHER_CARE, UNCLASSIFIED. Omit to include all.
CMS hospital categories derived from the CCN: 'Short-term (General and Specialty) Hospitals', 'Critical Access Hospitals', 'Children's Hospitals (Excluded from PPS)', 'Psychiatric Hospitals (Excluded from PPS)', 'Rehabilitation Hospitals (Excluded from PPS)', 'Long-Term Hospitals (Excluded from PPS)'. Setting this returns only hospitals that have one of these categories.
Maximum facilities to return, best name matches first. Defaults to 10; at most 50.
Order by licensed beds ('bedCount') or CMS overall star rating ('careQuality', returned as starRating) instead of name match, e.g. the largest hospitals in a state. Facilities without the value come last. Each facility type is rated by its own CMS program, so rank on careQuality within one facilityTypes value. Not available to trial accounts or unauthenticated requests.
Requires sortBy. Defaults to desc, highest first.
Try this tool
Start with an example, adjust its arguments, and run it with your account.
Request
JSON arguments
Response
Not run yet
Run the tool to see its response here.
Sign in to see pricing and run this tool
Find billing codes for a service described in words, or check a code.
Find the billing codes for a service described in words, or check a code you are unsure of.
A code the user typed needs no call here before a rate search: the rate tools search it as given, and their searchNotes say when it is not a billing code or when a generalist cohort does not bill it. A term matches codes whose description or category contains every word in it, or whose code starts with it, so send several short clinical terms (e.g. ['vaginal delivery', 'cesarean'] for a birth) and narrow with codeTypes ('MS-DRG' for inpatient stays, 'CPT' and 'HCPCS' for professional services, 'RC' for facility revenue codes). One service can map to several codes and code systems, and payers may publish it under any of them. A listed code is a catalog entry, not evidence that a payer publishes a rate for it.
Returns
{codes: [{code, type, description, group, typicalTaxonomies}], notFound}, most common code systems first; typicalTaxonomies are the provider taxonomies that bill the code most, the cohort to benchmark it on when no specialty is named. notFound lists five-character terms that are not CPT or HCPCS codes in the catalog, each with the valid codes one swap of two characters away and the nearest valid codes: tell the user the code is not valid and offer those, and do not search rates for it; pass code and type to the rate tools' billingCodeAndTypes as strings, keeping leading zeros.
Parameters
Words from a service description, or codes to check (e.g. ['vaginal delivery', 'cesarean'] or ['99213']), at most 25. A term matches codes whose description or category contains every word in it, or whose code starts with it, so send several short clinical terms rather than one sentence. To describe a list of codes, send them all in one call with limit set to at least their count.
Code systems to search: 'MS-DRG' or 'APR-DRG' for inpatient stays, 'CPT' and 'HCPCS' for procedures, visits, drugs, and supplies, 'RC' for facility revenue codes, 'NDC' for drug packages, 'LOCAL' and 'CSTM-ALL' for payer-specific codes. Omit to search all.
Maximum codes to return, most common code systems first. Defaults to 20; at most 50.
Try this tool
Start with an example, adjust its arguments, and run it with your account.
Request
JSON arguments
Response
Not run yet
Run the tool to see its response here.
Sign in to see pricing and run this tool
Medicare's published fee schedules and reference rates.
Look up Medicare's published fee schedules and reference rates.
Pick one medicareType: 'Physician FFS' (fee-for-service physician rates by HCPCS code and locality), 'Drug ASP' (quarterly Average Sale Price for Part B drug codes), 'Clinical Lab' (national Clinical Laboratory Fee Schedule rates by HCPCS code), 'MS-DRG weight' (inpatient DRG relative weights), 'Anesthesia' (anesthesia conversion factors by state and locality, plus the national factor), 'DMEPOS' (durable medical equipment rates by HCPCS and state - one row per rate_type: non-rural, rural, former competitive bidding area or competitive bidding single payment amount), 'Ambulance' (ambulance rates by HCPCS and carrier/locality - rate_type urban, rural, super-rural or rural miles 1-17), 'OTP' (opioid treatment program bundles by carrier/locality), 'Part D negotiated price' (maximum fair price per unit by 11-digit NDC, effective from year/month), or 'MS-DRG national rate' (weight times the national base rates - a benchmark, not a hospital's payment). Useful as a government-rate baseline when comparing against commercial negotiated rates returned by the other tools. State the schedule, year, locality, and unit with every figure; omitting years returns every year, most recent first.
Returns
{data, total, pagination, url}; page with limit and offset, and cite the url.
Parameters
Required. Which Medicare dataset to query: 'Physician FFS' (Physician Fee Schedule rates by HCPCS code and locality), 'Drug ASP' (Average Sale Price for Part B drug codes), 'Clinical Lab' (national Clinical Laboratory Fee Schedule rates by HCPCS code; mid-year additions carry their effective month), 'MS-DRG weight' (inpatient DRG relative weights), 'Anesthesia' (anesthesia conversion factors by state and locality, plus the national factor; with codes, each code's base units beside its factor), 'DMEPOS' (durable medical equipment, PEN and competitive bidding rates by HCPCS, state and rural/non-rural/former CBA area, quarterly), 'Ambulance' (ambulance base and mileage rates by HCPCS and carrier/locality, urban/rural/super-rural), 'OTP' (opioid treatment program bundles by carrier/locality), 'Part D negotiated price' (Medicare Drug Price Negotiation maximum fair price per unit, by 11-digit NDC), or 'MS-DRG national rate' (MS-DRG weight times the national operating and capital base rates, before wage index and hospital adjustments).
Billing codes to look up - HCPCS/CPT for Physician FFS and Clinical Lab, HCPCS for Drug ASP, DMEPOS, Ambulance and OTP, MS-DRG numbers for MS-DRG weight and MS-DRG national rate, 11-digit NDCs without dashes for Part D negotiated price, anesthesia CPT codes (00100-01999) for Anesthesia to get each code's base units beside its locality factor (omit codes for the factors alone).
Four-digit years to filter by (e.g. [2024, 2025]). Omit to return every year, most recent first; set it when the period matters. History reaches back to 2001 for Clinical Lab, 2002 for Physician FFS, 2005 for Drug ASP and FY2008 for MS-DRG weights.
Two-letter state codes (e.g. 'CA', 'TX'), or 'national' for the Physician FFS national locality. Applies to 'Physician FFS', 'DMEPOS' and 'Anesthesia' (where 'national' or omitting it returns the national factor alongside every locality); ignored for other medicareType values.
Month as 1-12. Applies to 'Drug ASP' (quarterly, indexed by month), 'DMEPOS', 'Ambulance', 'OTP', 'Part D negotiated price' and 'MS-DRG national rate'; ignored for other medicareType values.
Maximum number of rows to return (1-100). Defaults to 50.
Rows to skip. For the next page, pass the previous offset plus limit. Defaults to 0.
Physician FFS only: true returns one row per code and state for the latest period, with the global fee's min, median, and max across the state's localities; false returns every locality row. Defaults to true on the PayerPrice Agent's server and false elsewhere. Ignored when offset is set.
Try this tool
Start with an example, adjust its arguments, and run it with your account.
Request
JSON arguments
Response
Not run yet
Run the tool to see its response here.
Sign in to see pricing and run this tool
Suggest starting filters for a specialty or set of codes, and what to loosen when results are thin.
Return reviewed, specialty-aware default filters for the rate tools: taxonomy codes, billing class, place-of-service codes, modifiers, negotiated types, groupBy, and common codes in {code, type} form, with notes; plus payer notes and the fallback order for a sparse result.
Call it before a market benchmark or market rows search when the specialty, setting, or code family is unclear, instead of asking the user for every dimension, and after an empty or sparse result for the order in which to relax filters. Skip it when the request names the codes and the specialty is named or is the one that plainly bills them (emergency medicine for 99285, orthopedic surgery for 27447, radiology for a lumbar MRI's professional component) and you know that specialty's taxonomy code: search directly, since each call costs a round trip. A typed code with no specialty named is not unclear: search the specialty that typically bills it (family medicine for an office visit), and the rate result's searchNotes say when that cohort does not bill it. For a named provider's fee schedule, use the recommendation's filters except serviceCodes (they describe an office market cohort and would hide facility rates), group by placeOfService instead, and apply the fallback order only after an empty result, one step per call. Pass specialty (words or a NUCC code), billingCodes, or both, and payer for payer notes. No match returns no recommendations and guidance; never invent a preset. Payer notes are observed behavior to check against results, not rules. Static reference data; it searches no rates.
Returns
{recommendations (at most 3, each with matchReason), payerNotes, payerNotesCaveat, fallbackOrder, stopRule, guidance}.
Parameters
Specialty, setting, or provider type in words (e.g. 'cardiology', 'ambulatory surgery center', 'CRNA'), or a NUCC taxonomy code.
Billing codes in the question (e.g. ['99285', '01967']), used to infer the specialty when none is named.
Payer identifier or name (e.g. 'Cigna', 'BCBSTexas') to attach observed payer notes.
Try this tool
Start with an example, adjust its arguments, and run it with your account.
Request
JSON arguments
Response
Not run yet
Run the tool to see its response here.
Sign in to see pricing and run this tool
Find provider groups (TINs) paid above or below a rate, percentile, or percent of Medicare.
Find the provider TINs in a market whose rate passes a threshold: a dollar bound (minRate/maxRate), a percentile rank within their cohort (minPercentileRank/maxPercentileRank, 0-100), or, with comparedTo, a percent of Medicare (minPercentOfMedicare/maxPercentOfMedicare).
Use it for screens such as 'which groups in Texas are paid above 200% of Medicare for 99214' or 'providers above the 75th percentile'. It takes the market tools' filters. Each TIN has one rate per cohort (payer, billingCode, billingCodeType, billingClass, negotiatedTypeGroup): its highest matching rate, the value search_market_percentile_negotiated_rates computes percentiles over when grouped by those fields, so the two tools agree. A percentile-rank bound p keeps TINs at or beyond the cohort's percentile_<p>, the same interpolated value the percentile tool returns (in percent of Medicare when comparedTo is set), and returns it as minPercentileThreshold/maxPercentileThreshold; quote that cutoff. percentileRank (CUME_DIST x 100, the share of the cohort's TINs paid at or below that TIN) is for display. Cohorts under 10 TINs are sparse and a one-TIN cohort passes every percentile bound, so report cohortTinCount. percentOfMedicare uses the national non-facility Physician Fee Schedule amount for the same CPT code and modifier (a 26 or TC rate compares to that component, any other rate to the global amount), as the percentile tool does; it is null for other codes and for institutional rates, which therefore never pass a percent-of-Medicare bound. When negotiatedTypeGroups and negotiatedTypes are omitted only the dollar and derived groups are screened; the percentage and per diem groups allow only percentile-rank bounds. Each row names its TIN (name, address, states, npiCount from the provider index) and gives tinText, the TIN as written on tax forms with leading zeros kept (04-2453032); quote tinText exactly, and call lookup_providers only for a row without a name. This is a screen, not a benchmark: use search_market_percentile_negotiated_rates for market statistics.
Returns
{result: [{payer, billingCode, billingCodeType, billingClass, negotiatedTypeGroup, tin, tinText, name, address, states, npiCount, ratePerTin, percentileRank, percentOfMedicare, cohortTinCount, minPercentileThreshold}], cohorts: [{..., tinCount, matchingTinCount, minPercentileThreshold}], percentileThresholdUnit, totalMatchingRows, totalMatchingTins, hasMore, notes}; page with limit (at most 100) and offset, and report cohort sizes with the matches.
Rate rules
- When no payer is named, use United for a one-code clinician or practice lookup, United, Aetna, Cigna, and BCBS plus the regional payers that list it in network (include
'payers') for a hospital or health system, compare United, Aetna, Cigna, and BCBS for a market question in one to four states, and use United alone for a national question or five or more states, unless the user names a payer set ('top payers', 'major payers','BUCA', 'all payers'), which means United, Aetna, Cigna, and BCBS together at any geography (an initialism of B, U, C, and A names BCBS, United, Cigna, and Aetna letter by letter, so'UAC'is United, Aetna, and Cigna;'UHC'is United); state that assumption in the answer. - Find codes for a described service with search_billing_codes or a provider's
topCodes(search_providers or lookup_providers with include'topCodes'). - A value can be dollars, a percentage, or a per diem (
negotiatedTypeGroup: dollar, derived, per diem, or percentage); never compare or rank different groups together. - Filter rate types with
negotiatedTypeGroups(e.g.['dollar']);negotiatedTypesfilters by raw type; use it only to separate negotiated from fee schedule rates. - Query professional and institutional billing classes separately.
- Without
yearMonthseach payer's latest loaded month is used, and months can differ by payer. - No rows means not observed in the searched scope, not 'no contract' or 'not covered'.
- BCBS pools every Blue plan's file and localizes it only by provider state, so BCBS rows in a state can come from out-of-state Blue plans; they do not show that the state's own Blue plan priced the code.
Parameters
Which rates to include. search_market_percentile_negotiated_rates and search_market_negotiated_rates take the same filters.
Required. Two-letter US state codes that providers must be located in (e.g. ['CA', 'MA', 'TX']).
Five-digit US ZIP codes (e.g. ['02451']). Each is searched as the whole county or counties that contain it, not the ZIP alone, so prefer `counties` when the county is known, and name the area as the county.
Counties providers must be located in, as state and county pairs (e.g. [{state: 'VA', county: 'Fairfax County'}]). Narrows states: each county's state must also be in states.
Metropolitan Statistical Areas providers must be located in, as five-digit metropolitan CBSA codes (e.g. [47900] for Washington-Arlington-Alexandria, [19100] for Dallas-Fort Worth-Arlington). Use the metro area code, not a metropolitan division code such as 47894. Keeps providers whose county belongs to the metro area; narrows states, which must include at least one of its states.
Required. NUCC provider taxonomy codes that identify specialty (e.g. ['207Q00000X'] for Family Medicine). Prefer the general specialty code (ending in 00000X) unless the user names a subspecialty.
'individual' (solo practitioner) or 'group' (organization/group practice). Omit to include both.
Required. Insurance payer identifiers (e.g. ['BCBS', 'United', 'Aetna']). All Blue Cross Blue Shield identifiers query one combined Blues dataset reported as 'BCBS'. When the user names none, use ['United'] for a one-code clinician or practice lookup, ['United', 'Aetna', 'Cigna', 'BCBS'] plus the regional payers that list it in network (include 'payers') for a hospital or health system, ['United', 'Aetna', 'Cigna', 'BCBS'] for a market question in one to four states, and ['United'] for a national question or five or more states; state that assumption in the answer. A payer set the user names ('top payers', 'major payers', 'BUCA', 'all payers') is ['United', 'Aetna', 'Cigna', 'BCBS'] at any geography; an initialism of B, U, C, and A names BCBS, United, Cigna, and Aetna letter by letter, so 'UAC' is ['United', 'Aetna', 'Cigna']; 'UHC' is 'United'.
Exact billing codes and their code system (e.g. [{code: '99213', type: 'CPT'}]); search_billing_codes returns codes in this shape. Codes are strings; keep leading zeros.
'professional' (physician/practitioner billing) or 'institutional' (facility/hospital billing). Query them separately; their rates are different products. A rate the payer published for 'both' classes applies to either one, so either filter keeps it; group by billingClass to tell it apart.
CMS Place of Service codes as two-character strings (e.g. '11' office, '21' inpatient, '22' outpatient hospital, '23' emergency room, '02' telehealth). Rows with no place of service or CSTM-00 apply at every place of service, so a filter always keeps them; group by serviceCode (placeOfService on search_provider_fee_schedule) to tell them apart.
CPT/HCPCS modifiers (e.g. '26' professional component, 'TC' technical component). Global, 26, and TC rates are not interchangeable.
Rate type groups to keep, as Report Data groups them: 'dollar' (negotiated, fee schedule, and every other dollar type), 'derived', 'per diem', or 'percentage' (e.g. ['dollar']). 'per diem' and 'percentage' values are not dollars per service; never compare them with dollar rates. Prefer this to negotiatedTypes.
Raw rate types; prefer negotiatedTypeGroups unless negotiated and fee schedule rates must be separated. When both are set, a rate must match both. Use it only to separate negotiated from fee schedule rates.
Year/month periods, e.g. [{year: 2026, month: 9}]. When omitted, each payer's most recent loaded month is used, which can differ between payers.
Plan names exactly as list_payer_plans returns them (e.g. ['Optum Health WESTERN HEALTH ADVANTAGE WHA HMO SG']); a name matches only a plan with that exact name. For a plan type such as PPO or HMO, pass every listed plan name that contains it, and say which names the figure covers.
Individual (un-normalized) network names, exactly as reported in the payer transparency file (e.g. ['Choice Plus', 'Navigate']).
Keep TINs whose rate is at least this many dollars. A TIN's rate is its highest matching rate in the cohort.
Keep TINs whose rate is at most this many dollars.
Keep TINs whose rate is at or above their cohort's percentile_<p> (0-100), the same interpolated value search_market_percentile_negotiated_rates returns, e.g. 75 for 'above the 75th percentile'. Each row and cohort returns that cutoff as minPercentileThreshold (percent of Medicare when comparedTo is set). Cohorts under 10 TINs are sparse; a one-TIN cohort always passes.
Keep TINs whose rate is at or below their cohort's percentile_<p> (0-100), e.g. 25 for the bottom quarter, returned as maxPercentileThreshold.
Optional 'medicare_<year>': adds percentOfMedicare, the rate as a percent of the national non-facility Medicare Physician Fee Schedule amount for the same CPT code and modifier (26 and TC compare to their own components, other rates to the global amount; 200 means 200%). Institutional rates, and codes or modifiers without that amount, get null and never pass a percent-of-Medicare bound.
Keep TINs paid at least this percent of Medicare (e.g. 200 for 'above 200% of Medicare'). Requires comparedTo.
Keep TINs paid at most this percent of Medicare. Requires comparedTo.
Row order. Defaults to percentileRank; percentOfMedicare requires comparedTo.
Defaults to desc, highest first.
Maximum TIN rows to return. Defaults to 100, the most allowed.
Rows to skip. For the next page, pass the previous offset plus limit. Defaults to 0.
Try this tool
Start with an example, adjust its arguments, and run it with your account.
Request
JSON arguments
Response
Not run yet
Run the tool to see its response here.
Sign in to see pricing and run this tool
List the payers available and the months of data for each.
List the payer identifiers the rate tools accept and the months loaded for each.
To check whether a payer is covered, or which months it has, pass name: matching ignores case and spacing, reads UnitedHealthcare as United and a Blue plan such as Anthem as BCBS, and covers every payer, so no match means the payer is not loaded under that name. Without name, returns payerCount and each payer's latest month and month count. Put the returned payer identifier in the rate tools' payers filter. Every Blue plan is served as BCBS, one combined dataset; localize it with states, which filter by provider state, so a state's BCBS rows can come from out-of-state Blue plans. Free; it searches no rates.
Returns
{payerCount or matchingCount, payers: [{payer, latestYearMonth, monthCount}, or with name {payer, yearMonths, servesBluePlans}], note}.
Parameters
Return only payers matching this name, ignoring case and spacing, with all their available months. A Blue plan such as Anthem returns BCBS, the identifier that serves it.
Try this tool
Start with an example, adjust its arguments, and run it with your account.
Request
JSON arguments
Response
Not run yet
Run the tool to see its response here.
Sign in to see pricing and run this tool
List a payer's plan names, for filtering rates by plan.
List the normalized plan names for one exact payer identifier (from list_payers), most common first.
Call it before filtering a rate tool by planNames when the plan's spelling is uncertain, and pass name to keep plans containing that text. BCBS combines every Blue plan list. An unknown identifier returns an error naming list_payers. Free; it searches no rates.
Returns
{payer, planCount (all plans for the payer), matchingCount, planNames}; limit defaults to 50 (at most 500).
Parameters
One exact payer identifier, as list_payers returns it (e.g. 'United', 'BCBS').
Words of the plan name, in any order, ignoring case. Plans sharing a distinctive word come back closest first (every word present, then the most words shared), so check the top names before filtering on one; a plan of another type (PPO for an HMO query) is left out.
Plan names to return (default 50).
Try this tool
Start with an example, adjust its arguments, and run it with your account.
Request
JSON arguments
Response
Not run yet
Run the tool to see its response here.
Sign in to see pricing and run this tool
Charges a hospital publishes in its own price transparency file, by CCN, NPI, or TIN.
Retrieve the standard charges specific hospitals publish in their own price transparency files: gross charge, discounted cash price, minimum and maximum, and each payer's negotiated dollar amount, percentage, or estimated amount with its methodology.
Use it for what a hospital says it is paid, e.g. 'what does this hospital list for Aetna for MS-DRG 871?'; search_provider_fee_schedule reads the payers' files instead, and the two can differ. Resolve the hospital with search_facilities first; a CCN is the most exact identifier. A payer also matches its Medicare Advantage and Medicaid plans at the hospital. Without filters.yearMonths each hospital's newest file among the latest two months is used, and year and month say which. A negotiatedPercentage is a percent of charges, not dollars, and an empty result does not mean the hospital has no contract.
Returns
{data, total, hasMore}: one row per distinct published charge, its plans listed in plan; page with limit (at most 1000) and offset.
Parameters
Hospitals to return charges for. Provide at least one of npis, tins, or ccns; a CCN is the most exact.
Hospital NPIs, as lookup_providers returns them.
Hospital TINs without dashes.
Hospital CCNs (6 characters, leading zeros kept), as search_facilities returns them.
Which hospital-published charges to include.
Required. Payer identifiers (e.g. ['Aetna', 'United']). A payer also matches the hospital's Medicare Advantage and Medicaid plans of that payer; every Blue identifier reads the hospital's BCBS rates.
Exact billing codes and their code system (e.g. [{code: '99213', type: 'CPT'}]); search_billing_codes returns codes in this shape. Codes are strings; keep leading zeros.
Care settings the hospital published the charge for. 'inpatient' or 'outpatient' also keeps charges published for both settings or with no setting stated, since they can apply to either; 'both' alone keeps only charges published for both. Each row carries its setting.
'institutional' (facility) or 'professional' charges. Either also keeps charges the hospital published for both, and 'institutional' keeps charges with no billing class stated, which are facility charges; 'both' alone keeps only charges published for both. Each row carries its billing class.
How the payer-specific charge is paid: 'feeSchedule', 'caseRate', 'perDiem', 'percentOfTotalBilledCharges', or 'other'.
Hospital file months to search, at most 12, e.g. [{year: 2026, month: 9}]. Omit to use each hospital's newest file among the latest two months, whatever the other filters match.
One sort entry. Order rows by a charge or rate field; rows without the value come last. Not available to trial accounts or unauthenticated requests.
Rows to return, at most 1000. Defaults to 1000.
Rows to skip before the page starts. Defaults to 0.
Try this tool
Start with an example, adjust its arguments, and run it with your account.
Request
JSON arguments
Response
Not run yet
Run the tool to see its response here.
Sign in to see pricing and run this tool
List hospital-published charges across a state's hospitals.
Retrieve a page of the charges every hospital in the given states publishes for the payers and codes you specify, from hospital price transparency files.
Use it for hospital-by-hospital comparisons from the hospitals' own files; use search_market_percentile_hospital_rates for typical values, and never compute medians or percentiles from a page of rows. Without filters.yearMonths each hospital's newest file among the latest two months is used.
Returns
{data, total, hasMore}: one row per distinct published charge with ccn and hospitalName; page with limit (at most 1000) and offset.
Parameters
Which hospitals and charges to include. search_market_hospital_rates and search_market_percentile_hospital_rates take the same filters.
Required. Two-letter US state codes of the hospitals (e.g. ['TX']).
Required. Payer identifiers (e.g. ['Aetna', 'United']). A payer also matches the hospital's Medicare Advantage and Medicaid plans of that payer; every Blue identifier reads the hospital's BCBS rates.
Exact billing codes and their code system (e.g. [{code: '99213', type: 'CPT'}]); search_billing_codes returns codes in this shape. Codes are strings; keep leading zeros.
Care settings the hospital published the charge for. 'inpatient' or 'outpatient' also keeps charges published for both settings or with no setting stated, since they can apply to either; 'both' alone keeps only charges published for both. Each row carries its setting.
'institutional' (facility) or 'professional' charges. Either also keeps charges the hospital published for both, and 'institutional' keeps charges with no billing class stated, which are facility charges; 'both' alone keeps only charges published for both. Each row carries its billing class.
How the payer-specific charge is paid: 'feeSchedule', 'caseRate', 'perDiem', 'percentOfTotalBilledCharges', or 'other'.
Hospital file months to search, at most 12, e.g. [{year: 2026, month: 9}]. Omit to use each hospital's newest file among the latest two months, whatever the other filters match.
One sort entry. Order rows by a charge or rate field; rows without the value come last. Not available to trial accounts or unauthenticated requests.
Rows to return, at most 1000. Defaults to 1000.
Rows to skip before the page starts. Defaults to 0.
Try this tool
Start with an example, adjust its arguments, and run it with your account.
Request
JSON arguments
Response
Not run yet
Run the tool to see its response here.
Sign in to see pricing and run this tool
Benchmark hospital-published charges in a market: percentiles, averages, and ranges.
Compute statistics over the charges hospitals in the given states publish in their price transparency files, for the payers and codes you specify.
Location is by state only, with no county, ZIP, or metro filter: for a city, search its state and say the figure is statewide. metrics.field picks the value (negotiatedDollar by default; also negotiatedPercentage, estimatedAmount, standardChargeGross, standardChargeDiscountedCash) and each hospital counts once per group, at its highest value; report num_hospitals as the sample size. Group by billingCode and setting unless the filters fix them, since inpatient case rates and outpatient fees are different products. Without payer and methodology in groupBy, a group mixes commercial, Medicare Advantage, and Medicaid rates and fee-schedule, per-diem, and case-rate dollars; group by payer and methodology, or filter methodologies, before comparing values. groupBy billingCode returns the requested code and type, combining the CPT/HCPCS and 3- and 4-digit DRG/RC forms hospitals publish.
Returns
{data, total, hasMore}: one row per groupBy combination holding the groupBy values and each requested statistic under its own name.
Parameters
Which hospitals and charges to include. search_market_hospital_rates and search_market_percentile_hospital_rates take the same filters.
Required. Two-letter US state codes of the hospitals (e.g. ['TX']).
Required. Payer identifiers (e.g. ['Aetna', 'United']). A payer also matches the hospital's Medicare Advantage and Medicaid plans of that payer; every Blue identifier reads the hospital's BCBS rates.
Exact billing codes and their code system (e.g. [{code: '99213', type: 'CPT'}]); search_billing_codes returns codes in this shape. Codes are strings; keep leading zeros.
Care settings the hospital published the charge for. 'inpatient' or 'outpatient' also keeps charges published for both settings or with no setting stated, since they can apply to either; 'both' alone keeps only charges published for both. Each row carries its setting.
'institutional' (facility) or 'professional' charges. Either also keeps charges the hospital published for both, and 'institutional' keeps charges with no billing class stated, which are facility charges; 'both' alone keeps only charges published for both. Each row carries its billing class.
How the payer-specific charge is paid: 'feeSchedule', 'caseRate', 'perDiem', 'percentOfTotalBilledCharges', or 'other'.
Hospital file months to search, at most 12, e.g. [{year: 2026, month: 9}]. Omit to use each hospital's newest file among the latest two months, whatever the other filters match.
Value to compute statistics over. Defaults to negotiatedDollar.
Statistics to return under these names (e.g. ['percentile_25', 'percentile_50', 'percentile_75', 'num_hospitals']). Each hospital counts once per group, at its highest value.
Dimensions to return one row per combination of. billingCode returns the requested code and billingCodeType, combining the CPT/HCPCS and 3- or 4-digit DRG/RC forms hospitals publish; methodology returns the request names (feeSchedule, caseRate, ...); ccn also returns hospitalName. Without payer and methodology, a group mixes commercial, Medicare Advantage and Medicaid rates and fee-schedule, per-diem and case-rate dollars.
One sort entry: one of the requested aggregations. Groups without the value come last. Not available to trial accounts or unauthenticated requests.
Groups to return, at most 10000. Defaults to 1000.
Rows to skip before the page starts. Defaults to 0.
Try this tool
Start with an example, adjust its arguments, and run it with your account.
Request
JSON arguments
Response
Not run yet
Run the tool to see its response here.
Sign in to see pricing and run this tool
Direct integration
Building your own MCP client? Connect to the server URL over Streamable HTTP, list the tools you can use with tools/list, and call them with tools/call. Authenticate with OAuth, or send your API key as Authorization: Bearer YOUR_API_KEY. Your key is in the bar at the top of this page; keep it private. Your organization's tool access and credits apply either way. For REST endpoints, see the API Doc.