MCP Server

ClaimRev provides a Model Context Protocol (MCP) server that lets AI assistants such as Claude, ChatGPT, and Copilot search payer data directly. Use it for AI-assisted payer lookup, eligibility routing, and cross-referencing payer IDs between ClaimRev and SharpRevenue.

The MCP server is hosted alongside the ClaimRev API. The payer search tools do not require authentication, so there is no client id, secret, or bearer token to configure.

Endpoint

Environment	URL
Production	https://api.claimrev.com/mcp

The server uses the Streamable HTTP transport.

Available tools

search_claimrev_payers

Searches ClaimRev's payer database for healthcare payers that support electronic transactions.

Parameters (all optional):

Parameter	Type	Description
payerName	string	Payer name, substring match (e.g. Aetna, Blue Cross)
payerNumber	string	Payer number, substring match (e.g. 60054)
payerState	string	Two-letter state code (e.g. TX, CA)
transactionTypeIds	int[]	Filter by transaction type: 1 Professional, 2 Institutional, 3 Dental, 4 Eligibility, 6 Batch Claim Status, 7 Real-time Claim Status
payerTypeIds	int[]	Filter by payer type

Response fields (one object per payer):

Field	Description
inboundPayerNumber	ClaimRev payer ID. Use this for claim submission.
payerId	ClaimRev internal payer record id
payerName	Primary payer name
payerTypeId	Payer type id (the value payerTypeIds filters on)
payerTypeName	Payer type name (Commercial, Medicare, Blue, etc.)
supportsProfessional	Supports 837P professional claims
supportsInstitutional	Supports 837I institutional claims
supportsDental	Supports 837D dental claims
supportsEligibility	Supports 270/271 eligibility verification
supportsRtClaimStatus	Supports real-time 276/277 claim status
supportsBatchClaimStatus	Supports batch 276/277 claim status
enrollmentRequired	Provider enrollment is required before submitting
alternateNames	Other names this payer is known by. Useful for cross-referencing between systems.
sharpRevenuePayerId	The outbound payer ID sent to the eligibility gateway (SharpRevenue). Only populated when eligibility is supported. Medicare payers typically route to CMS (payer 00472) regardless of the specific Medicare plan.

search_sharp_revenue_payers

Searches the SharpRevenue master payer list used for eligibility routing. Payer IDs and names here differ from ClaimRev's.

Parameters:

Parameter	Type	Description
searchText	string	Searches both payer name and payer number. Leave empty to return all payers.

Response fields:

Field	Description
payerId	SharpRevenue internal payer ID
payerName	Payer name (often different from the ClaimRev name)
payerNumber	SharpRevenue payer number. This is the value that appears in sharpRevenuePayerId on ClaimRev payer results.
downDate	If set, the date the payer was reported down in SharpRevenue
removeGuarantor	Whether the guarantor is stripped from eligibility requests for this payer
serviceTypeCodeAllowedList	Service type codes this payer accepts on eligibility requests

Connecting to the MCP server

Claude Code

Run from your project directory:

claude mcp add --transport http claimrev-payers https://api.claimrev.com/mcp

Claude Desktop and claude.ai

Open Settings → Connectors → Add custom connector and enter https://api.claimrev.com/mcp as the URL. No OAuth settings are needed.

Other MCP clients

Any MCP-compatible client can connect using the Streamable HTTP transport at the endpoint above. Clients that only speak stdio can bridge to it with mcp-remote:

{
  "mcpServers": {
    "claimrev-payers": {
      "command": "npx",
      "args": ["mcp-remote", "https://api.claimrev.com/mcp"]
    }
  }
}

Common use cases

Find a payer by name

"Find the ClaimRev payer ID for Aetna and tell me if it supports eligibility."

Cross-reference payer IDs between systems

"I have payer ID 7450 in my system for Anthem Blue Cross. What's the matching ClaimRev payer ID?"

The assistant searches ClaimRev by name, finds BCBS Montana (00751), and shows the SharpRevenue ID (00098) used for eligibility routing.

Bulk payer mapping

Paste a list of payer IDs and names and ask:

"Which of these payers support eligibility in ClaimRev, and what IDs should I use?"

The assistant cross-references both the ClaimRev and SharpRevenue payer lists, matching by name, ID, and alternate names.

Find eligibility routing

"Where does eligibility for Medicare Railroad get routed?"

The assistant finds that Medicare Railroad (00882) routes to CMS (SharpRevenue 00472) via HETS, the same as all Medicare payers.