README.md
Sample MCP server for the health insurance claims domain.
Health Claims FastMCP (Mock)
Sample MCP server for the health insurance claims domain. This server uses FastMCP and exposes multiple mock tools for claims, benefits, providers, and prior authorizations. All data is synthetic and for demo use only.
Setup
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
Run (stdio)
python server.py
Run (streamable HTTP)
FastMCP supports streamable-http and sse transports. Use env vars to switch
transport and control host/port.
export MCP_TRANSPORT=streamable-http
export FASTMCP_HOST=127.0.0.1
export FASTMCP_PORT=8000
python server.py
The Streamable HTTP endpoint defaults to:
http://127.0.0.1:8000/mcp
You can override it via FASTMCP_STREAMABLE_HTTP_PATH.
export FASTMCP_STREAMABLE_HTTP_PATH=/mcp
Tools
list_member_claimsget_claim_detailget_member_benefitsestimate_member_responsibilitysearch_providerscreate_prior_authorizationget_prior_authorization_statussubmit_claim_inquiry
MCP Inspector (start/stop)
Install and run via npm scripts:
npm install
npm start
Notes
- The server uses FastMCP (
mcp.server.fastmcp.FastMCP) with@mcp.tool()decorators as described in the MCP build-server docs. - The mock logic is deterministic and in-memory; no external calls or PHI.
Tools (8)
list_member_claimsList member claimsget_claim_detailGet claim detailget_member_benefitsGet member benefitsestimate_member_responsibilityEstimate member responsibilitysearch_providersSearch providerscreate_prior_authorizationCreate prior authorizationget_prior_authorization_statusGet prior authorization statussubmit_claim_inquirySubmit claim inquiryEnvironment Variables
MCP_TRANSPORTSwitch transport (e.g. streamable-http, sse)FASTMCP_HOSTControl hostFASTMCP_PORTControl portFASTMCP_STREAMABLE_HTTP_PATHOverride streamable HTTP pathConfiguration
claude_desktop_config.json
{
"mcpServers": {
"healthcare-mcp": {
"command": "python",
"args": ["server.py"]
}
}
}Try it
→List my recent health insurance claims using list_member_claims.
→Get details for claim ID 12345 with get_claim_detail.
→Search for cardiology providers near New York using search_providers.
→Create a prior authorization request for MRI scan.
→Estimate my responsibility for this medical bill.