Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| FHIR_MCP_HOST | No | The hostname or IP address the MCP server should bind to (e.g., localhost for local-only access, or 0.0.0.0 for all interfaces). | localhost |
| FHIR_MCP_PORT | No | The port on which the MCP server will listen for incoming client requests (e.g., 8000). | 8000 |
| FHIR_SERVER_SCOPES | No | A space-separated list of OAuth2 scopes to request from the FHIR authorization server (e.g., user/Patient.read user/Observation.read). Add fhirUser openid to enable retrieval of user context for the get_user tool. | |
| FHIR_MCP_SERVER_URL | No | If set, this value will be used as the server's base URL instead of generating it from host and port. Useful for custom URL configurations or when behind a proxy. | |
| FHIR_SERVER_BASE_URL | No | The base URL of the FHIR server (e.g., https://hapi.fhir.org/baseR4). This is used to generate tool URIs and to route FHIR requests. | |
| FHIR_SERVER_CLIENT_ID | No | The OAuth2 client ID used to authorize MCP clients with the FHIR server. | |
| FHIR_MCP_REQUEST_TIMEOUT | No | Timeout duration in seconds for requests from the MCP server to the FHIR server. | 30 |
| FHIR_SERVER_ACCESS_TOKEN | No | The access token to use for authenticating requests to the FHIR server. If this variable is set, the server will bypass the OAuth2 authorization flow and use this token directly for all requests. | |
| FHIR_SERVER_CLIENT_SECRET | No | The client secret corresponding to the FHIR client ID. Used during token exchange. |
Schema
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
No tools | |