fhir-sdc-tools

fhir-sdc-tools

Composable Python library and CLI for building FHIR SDC Questionnaires, with an MCP server for interactive previews.

Quick start: Claude Code plugin

Install everything (MCP server + skill + CLI) as a plugin. Inside Claude Code:

/plugin marketplace add Tiro-health/fhir-sdc-tools
/plugin install fhir-sdc-tools

This gives you:

• render-questionnaire MCP tool for interactive previews
• sdc-builder skill that teaches Claude to build questionnaires using the Python API
• sdc CLI for shell-based workflows

Quick start: Claude Desktop / claude.ai

Add to your Claude Desktop config (claude_desktop_config.json):

{
  "mcpServers": {
    "Tiro.health FHIR SDC tools": {
      "command": "uvx",
      "args": ["--from", "fhir-sdc-tools[mcp]", "fhir-sdc-mcp"]
    }
  }
}

Restart Claude Desktop. The render-questionnaire tool will appear in the tools menu.

Prerequisite: uv must be installed.

Quick start: Claude Code

claude mcp add "Tiro.health FHIR SDC tools" -- uvx --from "fhir-sdc-tools[mcp]" fhir-sdc-mcp

Python library

pip install fhir-sdc-tools

from sdc import (
    Questionnaire, QuestionnaireItem, QuestionnaireItemType,
    FhirVersion, add_item, set_fhir_version, validate,
)

q = Questionnaire(url="http://example.org/intake", title="Intake Form")
q = set_fhir_version(q, FhirVersion.R5)
q = add_item(q, QuestionnaireItem(link_id="name", text="Full name", type=QuestionnaireItemType.STRING))
q = add_item(q, QuestionnaireItem(link_id="dob", text="Date of birth", type=QuestionnaireItemType.DATE))

warnings = validate(q)
print(q.model_dump_json(by_alias=True, exclude_none=True, indent=2))

CLI

pip install fhir-sdc-tools

sdc init --url http://example.org/q1 --title "My Form" --name MyForm \
  | sdc item add --link-id 1 --text "Name" --type string \
  | sdc item add --link-id 2 --text "Age" --type integer \
  | sdc validate

--name sets an optional computer-friendly identifier (Questionnaire.name), distinct from --title (the human-readable label). Use it when you need a stable, machine-readable name for programmatic look-up. Both sdc init and sdc meta accept this flag.

Extensions (SDC shortcuts and custom URLs):

sdc init --url http://example.org/q1 --title "My Form" \
  | sdc item add --link-id 1 --text "Name" --type string \
  | sdc extension add custom --link-id 1 \
      --url "http://example.org/ext" --value-string "hello" \
  | sdc validate

Install options

Install	Gets you
pip install fhir-sdc-tools	Python library + sdc CLI
pip install fhir-sdc-tools[mcp]	Above + fhir-sdc-mcp server with render-questionnaire tool

Feedback & Issues

Found a bug or have a feature idea? Open an issue on GitHub:

• Report a bug
• Request a feature
• Browse existing issues

License

MIT