README.md
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_claimsLists all claims associated with a specific member.get_claim_detailRetrieves detailed information for a specific claim.get_member_benefitsFetches benefit information for a specific member.estimate_member_responsibilityCalculates the estimated financial responsibility for a member.search_providersSearches for healthcare providers based on criteria.create_prior_authorizationSubmits a request for prior authorization.get_prior_authorization_statusChecks the status of a prior authorization request.submit_claim_inquirySubmits an inquiry regarding a specific claim.Environment Variables
MCP_TRANSPORTSets the transport protocol (e.g., streamable-http).FASTMCP_HOSTHost address for the server.FASTMCP_PORTPort number for the server.FASTMCP_STREAMABLE_HTTP_PATHPath for the streamable HTTP endpoint.Try it
→List all recent claims for member ID 12345.
→What are the current benefits for member 98765?
→Search for primary care providers in the 90210 area.
→Check the status of my prior authorization request #PA-5544.
→Estimate the member responsibility for a standard office visit.