SSyncDev

FHIR MCP Server

FHIR MCP Server – helping you expose any FHIR Server or API as a MCP Server.

Local serverstdioPython

What is the FHIR MCP Server?

FHIR MCP Server – helping you expose any FHIR Server or API as a MCP Server.

What you get

The FHIR MCP Server is a Model Context Protocol (MCP) server that provides seamless integration with FHIR APIs. Designed for developers, integrators, and healthcare innovators, this server acts as a bridge between modern AI/LLM tools and healthcare data, making it easy to search, retrieve, and analyze clinical information.

Configuration and credentials

  • Python 3.8+ - uv (for dependency management) - An accessible FHIR API server.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
get_capabilitiesRetrieves metadata about a specified FHIR resource type, including its supported search parameters and custom operations.
searchExecutes a standard FHIR search interaction on a given resource type, returning a bundle or list of matching resources.
searchParamA mapping of FHIR search parameter names to their desired values (e.g., {"family":"Simpson","birthdate":"1956-05-12"}).
response_filter_fhirpaths(Optional) An array of FHIRPath expressions (e.g., ["Patient.name", "Patient.birthDate", "Bundle.link.where(relation='next').url"]) to apply to the resources in the response bundle.
readPerforms a FHIR "read" interaction to retrieve a single resource instance by its type and resource ID, optionally refining the response with search parameters or custom operations.
operationThe name of a custom FHIR operation or extended query defined for the resource (e.g., "$everything").
createExecutes a FHIR "create" interaction to persist a new resource of the specified type.
payloadA JSON object representing the full FHIR resource body to be created.
updatePerforms a FHIR "update" interaction by replacing an existing resource instance's content with the provided payload.
deleteExecute a FHIR "delete" interaction on a specific resource instance.
get_userRetrieves the currently authenticated user's FHIR resource (for example the linked Patient resource) and returns a concise profile containing available demographic fields such as id, name, and birthDate.

How to install the FHIR MCP Server

{
    "mcpServers": {
        "fhir": {
            "command": "npx",
            "args": [
                "-y",
                "mcp-remote",
                "http://localhost:8000/mcp"
            ]
        }
    }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

  • Python 3.8+ - uv (for dependency management) - An accessible FHIR API server.
VariableDescriptionRequired
FHIR_SERVER_ACCESS_TOKENCredential the server authenticates with.Yes
FHIR_SERVER_BASE_URLEndpoint or connection string the server talks to.Yes
FHIR_SERVER_CLIENT_IDConfiguration value read at startup.Optional
FHIR_SERVER_CLIENT_SECRETCredential the server authenticates with.Yes
FHIR_SERVER_SCOPESConfiguration value read at startup.Optional
FHIR_MCP_HOSTEndpoint or connection string the server talks to.Optional
FHIR_MCP_PORTConfiguration value read at startup.Optional
FHIR_MCP_SERVER_URLEndpoint or connection string the server talks to.Yes

Example prompts to try

  • “Use FHIR to get capabilities.”
  • “Use FHIR to type.”
  • “Use FHIR to search.”

Frequently asked questions

FHIR MCP Server – helping you expose any FHIR Server or API as a MCP Server. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.