FinchNode Synthetic Health Records

Working

com.finchnode/health-records-demov1.0.0 Domain verified

Synthetic EHR: medications, labs, conditions, allergies, immunizations, FHIR R4. No API key.

Health & Science

Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://api.finchnode.com/demo/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

get_demo_allergies Read-only

Use this to get only the allergies of baseline-adult, one of FinchNode's 12 synthetic scenarios from Northstar Health System (Synthetic) and Quillhaven Medical Group (Synthetic): Allergies and intolerances, normalized from FHIR R4 AllergyIntolerance. No account or API key. To get allergies together with other categories, call get_demo_health_record once instead of calling several of these tools.

This tool takes no arguments.

Tools (14)

get_demo_allergies

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

get_demo_conditions

Use this to get only the conditions of baseline-adult, one of FinchNode's 12 synthetic scenarios from Northstar Health System (Synthetic) and Quillhaven Medical Group (Synthetic): Diagnoses and problem list, normalized from FHIR R4 Condition. No account or API key. To get conditions together with other categories, call get_demo_health_record once instead of calling several of these tools.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

get_demo_demographics

Use this to get only the basic details (demographics) of baseline-adult, one of FinchNode's 12 synthetic scenarios from Northstar Health System (Synthetic) and Quillhaven Medical Group (Synthetic): Name, birth date, sex, contact information, normalized from FHIR R4 Patient. No account or API key. To get basic details together with other categories, call get_demo_health_record once instead of calling several of these tools.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

get_demo_encounters

Use this to get only the visits (encounters) of baseline-adult, one of FinchNode's 12 synthetic scenarios from Northstar Health System (Synthetic) and Quillhaven Medical Group (Synthetic): Encounters, appointments, and care teams, normalized from FHIR R4 Encounter, Appointment, CareTeam. No account or API key. To get visits together with other categories, call get_demo_health_record once instead of calling several of these tools.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

get_demo_fhir_bundle

Use this when a prototype or test needs the complete fictional FinchNode FHIR R4 Bundle for one scenario and its resource references. Behaviors apply to record reads only, so every scenario returns its Bundle.

read-only

Argument	Type	Description
scenario	string	Optional scenario id from list_demo_scenarios. Omitted means baseline-adult.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "scenario": {
      "enum": [
        "baseline-adult",
        "polypharmacy-senior",
        "pediatric-asthma",
        "multi-source-overlap",
        "sparse-record",
        "messy-coding",
        "rate-limited",
        "consent-revoked",
        "consent-partial",
        "source-unavailable"
      ],
      "type": "string",
      "description": "Optional scenario id from list_demo_scenarios. Omitted means baseline-adult."
    }
  }
}

get_demo_health_record

Get any mix of demographics, medications, conditions, labs, vitals, allergies, immunizations, encounters in one call — prefer this over several single-category tools. Builds a record view using the authenticated API normalized data shape (schemaVersion 2). Fictional patients only; pick one with scenario. Consent and sync are simulated, with no usable change cursor. Empty categories describe the fixture only.

read-only

Argument	Type	Description
scenario	string	Optional scenario id from list_demo_scenarios. Omitted means baseline-adult. Behavior scenarios (rate-limited, consent-revoked, consent-partial, source-unavailable) answer with the same scripted error or partial result as the REST demo.
categories	array

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "scenario": {
      "enum": [
        "baseline-adult",
        "polypharmacy-senior",
        "pediatric-asthma",
        "multi-source-overlap",
        "sparse-record",
        "messy-coding",
        "rate-limited",
        "consent-revoked",
        "consent-partial",
        "source-unavailable"
      ],
      "type": "string",
      "description": "Optional scenario id from list_demo_scenarios. Omitted means baseline-adult. Behavior scenarios (rate-limited, consent-revoked, consent-partial, source-unavailable) answer with the same scripted error or partial result as the REST demo."
    },
    "categories": {
      "type": "array",
      "items": {
        "enum": [
          "demographics",
          "medications",
          "conditions",
          "labs",
          "vitals",
          "allergies",
          "immunizations",
          "encounters",
          "documents",
          "claims"
        ],
        "type": "string"
      },
      "minItems": 1
    }
  }
}

get_demo_immunizations

Use this to get only the immunizations of baseline-adult, one of FinchNode's 12 synthetic scenarios from Northstar Health System (Synthetic) and Quillhaven Medical Group (Synthetic): Vaccination history, normalized from FHIR R4 Immunization. No account or API key. To get immunizations together with other categories, call get_demo_health_record once instead of calling several of these tools.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

get_demo_labs

Use this to get only the lab results (labs) of baseline-adult, one of FinchNode's 12 synthetic scenarios from Northstar Health System (Synthetic) and Quillhaven Medical Group (Synthetic): Laboratory observations and reports, normalized from FHIR R4 Observation, DiagnosticReport. No account or API key. To get lab results together with other categories, call get_demo_health_record once instead of calling several of these tools.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

get_demo_medications

Use this to get only the medications of baseline-adult, one of FinchNode's 12 synthetic scenarios from Northstar Health System (Synthetic) and Quillhaven Medical Group (Synthetic): Active and past prescriptions, normalized from FHIR R4 MedicationRequest, MedicationDispense, MedicationAdministration. No account or API key. To get medications together with other categories, call get_demo_health_record once instead of calling several of these tools.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

get_demo_record

Legacy categorized FHIR response. Kept compatible for existing prototypes. For normalized platform-shaped data, use get_demo_health_record. Fictional patients only; pick one with scenario.

read-only

Argument	Type	Description
scenario	string	Optional scenario id from list_demo_scenarios. Omitted means baseline-adult. Behavior scenarios (rate-limited, consent-revoked, consent-partial, source-unavailable) answer with the same scripted error or partial result as the REST demo.
categories	array	Optional subset of normalized record categories.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "scenario": {
      "enum": [
        "baseline-adult",
        "polypharmacy-senior",
        "pediatric-asthma",
        "multi-source-overlap",
        "sparse-record",
        "messy-coding",
        "rate-limited",
        "consent-revoked",
        "consent-partial",
        "source-unavailable"
      ],
      "type": "string",
      "description": "Optional scenario id from list_demo_scenarios. Omitted means baseline-adult. Behavior scenarios (rate-limited, consent-revoked, consent-partial, source-unavailable) answer with the same scripted error or partial result as the REST demo."
    },
    "categories": {
      "type": "array",
      "items": {
        "enum": [
          "demographics",
          "medications",
          "conditions",
          "labs",
          "vitals",
          "allergies",
          "immunizations",
          "encounters"
        ],
        "type": "string"
      },
      "minItems": 1,
      "description": "Optional subset of normalized record categories."
    }
  }
}

get_demo_vitals

Use this to get only the vital signs (vitals) of baseline-adult, one of FinchNode's 12 synthetic scenarios from Northstar Health System (Synthetic) and Quillhaven Medical Group (Synthetic): Blood pressure, heart rate, weight, and similar measures, normalized from FHIR R4 Observation. No account or API key. To get vital signs together with other categories, call get_demo_health_record once instead of calling several of these tools.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

list_demo_scenarios

Use this first to choose a fictional scenario: 12 record, behavior (consent, rate-limit, and source-failure errors), and Connect session cases, each with its subject, categories, what it exercises, and links. Pass an id as scenario to the other demo tools. No clinical data. The controls and exercises fields describe the authenticated FinchNode sandbox; this accountless demo cannot perform them.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

search_demo_fhir

Use this to get all resources of one FHIR R4 type for one synthetic scenario's patient (baseline-adult unless patient_id names another).

read-only

Argument	Type	Description
patient_id	string	Optional scenario subject from list_demo_scenarios. Omitted searches the baseline-adult Bundle only.
resource_type*	string	FHIR R4 resource type present in the synthetic scenario Bundles.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "resource_type"
  ],
  "properties": {
    "patient_id": {
      "enum": [
        "patient-demo-001",
        "patient-demo-polypharmacy",
        "patient-demo-pediatric-asthma",
        "patient-demo-multi-source",
        "patient-demo-sparse",
        "patient-demo-messy-coding",
        "patient-demo-rate-limited",
        "patient-demo-consent-revoked",
        "patient-demo-consent-partial",
        "patient-demo-source-unavailable"
      ],
      "type": "string",
      "description": "Optional scenario subject from list_demo_scenarios. Omitted searches the baseline-adult Bundle only."
    },
    "resource_type": {
      "enum": [
        "AllergyIntolerance",
        "Appointment",
        "CareTeam",
        "Condition",
        "Coverage",
        "DiagnosticReport",
        "DocumentReference",
        "Encounter",
        "ExplanationOfBenefit",
        "Immunization",
        "MedicationAdministration",
        "MedicationDispense",
        "MedicationRequest",
        "Observation",
        "Organization",
        "Patient",
        "Practitioner",
        "Provenance"
      ],
      "type": "string",
      "description": "FHIR R4 resource type present in the synthetic scenario Bundles."
    }
  }
}

simulate_demo_connect

Use this to prototype the FinchNode connection journey. Returns a non-persistent synthetic session: complete for a record or behavior scenario, or the connect-cancelled or connect-failed outcome with no patient.

read-only

Argument	Type	Description
scenario	string	Optional scenario id from list_demo_scenarios. Omitted means baseline-adult; connect-cancelled and connect-failed end without a patient.
categories	array	Requested fictional record categories.
external_user_id	string	Optional non-sensitive prototype identifier. Never send a real patient identifier.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "scenario": {
      "enum": [
        "baseline-adult",
        "polypharmacy-senior",
        "pediatric-asthma",
        "multi-source-overlap",
        "sparse-record",
        "messy-coding",
        "rate-limited",
        "consent-revoked",
        "consent-partial",
        "source-unavailable",
        "connect-cancelled",
        "connect-failed"
      ],
      "type": "string",
      "description": "Optional scenario id from list_demo_scenarios. Omitted means baseline-adult; connect-cancelled and connect-failed end without a patient."
    },
    "categories": {
      "type": "array",
      "items": {
        "enum": [
          "demographics",
          "medications",
          "conditions",
          "labs",
          "vitals",
          "allergies",
          "immunizations",
          "encounters"
        ],
        "type": "string"
      },
      "minItems": 1,
      "description": "Requested fictional record categories."
    },
    "external_user_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9._:-]+$",
      "maxLength": 100,
      "description": "Optional non-sensitive prototype identifier. Never send a real patient identifier."
    }
  }
}