Dashboard
PayerPrice MCP Documentation
Connect an AI assistant to PayerPrice data using the Model Context Protocol (MCP).
Get access
- Checking your account…
- Add the server URL below to your MCP client. Choose a client in the setup section for exact steps.
- Approve access when your MCP client opens PayerPrice authorization. Sign in there if prompted, then use one of the available tools.
Authorization and API keys
Compatible clients use OAuth to connect to PayerPrice. Being signed in to this page does not connect an MCP client; approve its authorization request separately. Direct integrations can instead send an active API key in the Authorization: Bearer YOUR_API_KEY header. Find your assigned key below. Keep keys private. Your organization's tool access and API/MCP credits still apply.
Methods and tools
The server uses Streamable HTTP. Your MCP client discovers permitted tools with tools/list and invokes them with tools/call. Each tool below documents its inputs and purpose. For REST endpoints and HTTP methods, see the API Doc.
Your MCP Auth Keys
Loading account…
Monitor your MCP usage
Track MCP tool calls, recent activity, costs, and your shared API/MCP credit balance in the usage dashboard.
MCP Server URL
https://api.payerprice.com/api/v1/open/mcp
Connect your AI assistant
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.
Available tools
Prices apply to successful calls. Each tool shows its description and inputs; collapse sections you do not need.
Aggregate statistics over commercial negotiated rates in a market.
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. Use search_market_negotiated_rates for individual rows across a market or search_provider_fee_schedule for identified providers.
Parameters
Required. Two-letter US state codes that providers must be located in (e.g. ['CA', 'MA', 'TX']).
Five-digit US ZIP codes to further restrict provider location (e.g. ['02451', '90210']).
Required. NUCC provider taxonomy codes that identify specialty (e.g. ['207Q00000X'] for Family Medicine). Narrow to at least one specialty.
Entity type to filter providers by: 'individual' (solo practitioner) or 'group' (organization/group practice). Omit to include both.
Required. Insurance payer identifiers (e.g. ['BCBS', 'United', 'Aetna']). Many BCBS affiliates are state-specific - see the 'search-rates-options-payers' resource for the full list.
Exact billing codes and their code system (e.g. [{ code: '99213', type: 'CPT' }]).
Rate source: 'professional' (physician/practitioner billing) or 'institutional' (facility/hospital billing).
CMS Place of Service codes as two-character strings (e.g. '11' for office, '22' for outpatient hospital, '02' for telehealth).
CPT/HCPCS modifiers to narrow results (e.g. '25', '59', 'LT').
How the rate is expressed (e.g. 'negotiated', 'fee schedule', 'per diem', 'percentage', 'derived'). See the 'search-rates-options-negotiated-types' resource for all values.
Specific year/month periods to filter by, e.g. [{ year: 2024, month: 10 }]. Leave empty to use the most recently available data.
Normalized insurance plan types to filter by (e.g. ['HMO', 'PPO', 'EPO']).
Individual (un-normalized) network names to filter rates by, exactly as reported in the payer transparency file (e.g. ['Choice Plus', 'Navigate']).
Statistical aggregates to compute over the rates that match the filters above (e.g. ['percentile_50', 'percentile_75', 'percentile_90']). See the 'search-rates-options-aggregations' resource for all supported values.
Optional Medicare comparison baseline for the benchmark 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.
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
Individual negotiated-rate rows across providers 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. Use search_market_percentile_negotiated_rates for typical rates, averages, medians, or percentiles. The limit.offset page size cannot exceed 100. aggregatedColumns collapses listed fields within rows; it is not a group-by setting.
Parameters
US state codes (e.g., CA, MA, TX) to search for.
5-digit US ZIP codes to filter results by provider location (e.g., 02451, 90210).
Provider taxonomy codes to search for.
Provider entity types to search for.
Insurance payer names (e.g., BCBS, United, Aetna) to search.
Specific billing codes to search for.
Professional vs institutional.
Place of service codes (e.g., 11 for office, 21 for hospital) to search for.
CPT modifiers to search for.
Rate negotiation types to search for.
Time periods to search for. Omit or use an empty array [] to include all time periods (no filter).
Normalized plan names to filter by (e.g., 'HMO', 'PPO', 'EPO'). These filter rates to specific insurance plan types.
Individual (un-normalized) network names to filter rates by, 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.
Method used to aggregate negotiated rates.
Server-side sorting applied before pagination.
Pagination limit with offset.
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?'. Use search_market_negotiated_rates for individual rates across a market or search_market_percentile_negotiated_rates for market statistics.
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 (9-digit numbers) whose negotiated rates to retrieve.
CCNs (CMS Certification Numbers, 6 characters) whose negotiated rates to retrieve.
Required. Insurance payer identifiers (e.g. ['BCBS', 'United', 'Aetna']). See the 'search-rates-options-payers' resource for the full list, including state-specific BCBS affiliates.
Exact billing codes and their code system (e.g. [{ code: '99213', type: 'CPT' }]).
Rate source: 'professional' (physician/practitioner billing) or 'institutional' (facility/hospital billing).
CMS Place of Service codes as two-character strings (e.g. '11' for office, '22' for outpatient hospital, '02' for telehealth).
CPT/HCPCS modifiers to narrow results (e.g. '25', '59', 'LT').
How the rate is expressed (e.g. 'negotiated', 'fee schedule', 'per diem', 'percentage', 'derived'). See the 'search-rates-options-negotiated-types' resource for all values.
Specific year/month periods to filter by, e.g. [{ year: 2024, month: 10 }]. Leave empty to use the most recently available data.
Normalized insurance plan types to filter by (e.g. ['HMO', 'PPO', 'EPO']).
Individual (un-normalized) network names to filter rates by, exactly as reported in the payer transparency file (e.g. ['Choice Plus', 'Navigate']).
Dimensions to group provider-rate results by. Network and planName are returned as deduplicated arrays instead of splitting otherwise identical rate rows. Include at least 'payer' and 'billingCode' in most cases - without them, rates are pooled across payers/codes and are usually not interpretable.
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, states, taxonomy codes, entity type, and in-network payers. 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.
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. Omit to return matches of all three types.
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.
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), 'MS-DRG weight' (inpatient DRG relative weights), or 'Anesthesia' (national anesthesia conversion factors by year/month). Useful as a government-rate baseline when comparing against commercial negotiated rates returned by the other tools.
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), 'MS-DRG weight' (inpatient DRG relative weights), or 'Anesthesia' (national anesthesia conversion factors).
Billing codes to look up - HCPCS/CPT for Physician FFS, HCPCS for Drug ASP, MS-DRG numbers for MS-DRG weight. Not applicable to Anesthesia (omit for that type).
Four-digit years to filter by (e.g. [2024, 2025]). Omit to get the most recent available year. History reaches back to 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. Only applies to 'Physician FFS'; ignored for other medicareType values.
Month as 1-12. Only applies to 'Drug ASP' (pricing is quarterly but indexed by month).
Maximum number of rows to return (1-100). Defaults to 100.
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
All rights reserved.