Prepare the server locally
Run this once before adding it to Claude Code.
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txtRegister it in Claude Code
claude mcp add healthcare-mcp -- python /path/to/server.pyReplace any placeholder paths in the command with the real path on your machine.
Make your agent remember this setup
healthcare-mcp's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session.
npx conare@latestFree · one command · indexes the sessions already on disk. Set up in the browser instead →
What it does
- Provides a mock interface for health insurance operations.
- Supports claims processing and benefit inquiries.
- Enables provider search functionality.
- Handles prior authorization requests and status checks.
- Uses synthetic data for safe testing of healthcare workflows.
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
Original README from immannan/healthcare-mcp
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.