Developers
Healthcare price transparency data for developers and AI agents
Query commercial negotiated rates, provider fee schedules, and Medicare benchmarks through a REST API, an MCP server, or SQL in Snowflake and Databricks.
Choose how to connect
REST API quickstart
- Sign up or log in to PayerPrice and copy your API key from the API documentation page.
- Send the key as a Bearer token over HTTPS. Start by listing the payers and data periods available to you.
- Use a returned payer and period to request market benchmarks for a comparable market, or provider rates for a specific NPI, TIN, or CCN. Requests made with an API key can consume credits.
curl https://api.payerprice.com/api/v1/payers \ -H 'Authorization: Bearer YOUR_API_KEY'
| Group | Endpoint | What it does |
|---|---|---|
| Payer APIs | GET /api/v1/payers | List available payers |
| Payer APIs | POST /api/v1/payer/plans | List plans for a payer |
| Provider APIs | POST /api/v1/npis | Look up providers by NPI |
| Provider APIs | POST /api/v1/npiSearch | Search NPIs by name |
| Provider APIs | POST /api/v1/ccns | Look up hospitals by CCN |
| Provider APIs | POST /api/v1/ccnSearch | Search hospitals by name or CCN |
| Provider APIs | POST /api/v1/tins | Look up providers by TIN |
| Provider APIs | POST /api/v1/tinSearch | Search TINs by name |
| Pricing APIs | POST /api/v1/market/benchmarks | Get market rate benchmarks |
| Pricing APIs | POST /api/v1/provider/rates | Get provider negotiated rates |
Connect an AI assistant with MCP
The PayerPrice MCP server uses Streamable HTTP and OAuth. Add the server URL to your client, approve access when PayerPrice opens, and your assistant can query PayerPrice data directly.
Get access: log in or sign up for PayerPrice.
https://api.payerprice.com/api/v1/open/mcp
Claude Desktop
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.
Claude Code
To add this MCP to Claude Code, run this command in your terminal:
claude mcp add --transport http payerprice https://api.payerprice.com/api/v1/open/mcp
Run claude mcp list to verify the server, then use /mcp in Claude Code to sign in.
Claude.ai
In Claude.ai, open Customize → Connectors, select + → Add custom connector, and enter the MCP 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.
Gemini Enterprise
Ask PayerPrice support for a Client ID and secret registered with https://vertexaisearch.cloud.google.com/oauth-redirect. In Google Cloud, create a Gemini Enterprise Custom MCP Server data store and enter:
MCP Server URL: https://api.payerprice.com/api/v1/open/mcp Authorization URL: https://api.payerprice.com/oauth/authorize Token URL: https://api.payerprice.com/oauth/token Client ID: <provided by PayerPrice> Client Secret: <provided by PayerPrice> Scopes: payerprice:mcp:read Enable PKCE Support: Yes (required)
Select Enable PKCE Support, click Verify Auth, and sign in to PayerPrice. Then continue creating the data store and enable the PayerPrice actions you want to use.
Codex
Add PayerPrice as a Streamable HTTP MCP server from your terminal:
codex mcp add payerprice --url https://api.payerprice.com/api/v1/open/mcp
Then start OAuth authorization and sign in to PayerPrice:
codex mcp login payerprice
Cursor
To add this MCP to Cursor, update your ~/.cursor/mcp.json.
{
"mcpServers": {
"PayerPrice": {
"url": "https://api.payerprice.com/api/v1/open/mcp"
}
}
}Save the file and restart Cursor. Complete OAuth sign-in when prompted.
VS Code
To add this MCP to VS Code, update your .vscode/mcp.json.
{
"servers": {
"PayerPrice": {
"type": "http",
"url": "https://api.payerprice.com/api/v1/open/mcp"
}
}
}Start PayerPrice with MCP: List Servers, then complete OAuth sign-in in your browser.
Tools
search_market_percentile_negotiated_ratesAggregate statistics over commercial negotiated rates in a market.
search_market_negotiated_ratesIndividual negotiated-rate rows across providers in a market.
search_provider_fee_scheduleNegotiated rates for specific providers identified by NPI, TIN, or CCN.
search_providersLook up healthcare providers by name, specialty, or state.
search_medicare_ratesMedicare's published fee schedules and reference rates.
Example prompts
- “What do BCBS and United typically pay cardiologists in Texas for CPT 99213?”
- “What rates has Mayo Clinic negotiated with Aetna for office visits?”
- “How do commercial rates for CPT 90837 in Ohio compare with the Medicare physician fee schedule?”
Machine-readable resources
Point coding agents and LLM tools at these files to work with the API and MCP server without reading the web docs.
- API referenceInteractive REST API documentationhttps://api.payerprice.com/api/doc
- Markdown API docsThe full API reference as one Markdown filehttps://api.payerprice.com/api/doc.md
- OpenAPI specificationOpenAPI JSON for client generation and agentshttps://api.payerprice.com/openapi.json
- API llms.txtEndpoint index for LLMs and coding agentshttps://api.payerprice.com/llms.txt
- MCP documentationMCP server setup, tools, and authorizationhttps://api.payerprice.com/mcp/doc
- Markdown MCP docsMCP setup and tool parameters as Markdownhttps://api.payerprice.com/mcp/doc.md
Need bulk data or a custom delivery?
Talk to us about data shares, volume pricing, and coverage for your use case.