health

Find registry-classified supplements in Aviado's current graph that affect a biomarker. Excludes food_substance, prescription_drug, research_compound, research_nootropic, medical_compound, and unknown IDs. Type labels and graph_status (proven or suspected) are internal taxonomy/eligibility metadata, not independent clinical verification. Results are partial and non-exhaustive; pathway_tags are raw graph metadata, not validated mechanisms. Use dose_value with dose_unit; legacy dose_mg is populated only for literal mg rows.

{
  "type": "object",
  "properties": {
    "biomarker": {
      "type": "string",
      "minLength": 1,
      "maxLength": 512,
      "description": "Biomarker name, abbreviation, or LOINC code"
    },
    "limit": {
      "default": 25,
      "description": "Max results (default 25, max 100)",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "required": [
    "biomarker"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Find mixed interventions in Aviado's current graph that affect a biomarker, labeled with the exact intervention_type value supplement, food_substance, prescription_drug, research_compound, research_nootropic, medical_compound, or unknown. graph_status is the exact internal proven/suspected eligibility label, not independent clinical validation. Coverage is partial and non-exhaustive; absence is not evidence of no effect. pathway_tags are raw graph metadata, not validated mechanisms, and dose/pathway details are suppressed for non-supplement and unknown rows. Use dose_value with dose_unit; legacy dose_mg is populated only for literal mg rows.

{
  "type": "object",
  "properties": {
    "biomarker": {
      "type": "string",
      "minLength": 1,
      "maxLength": 512,
      "description": "Biomarker name, abbreviation, or LOINC code"
    },
    "limit": {
      "default": 25,
      "description": "Max results (default 25, max 100)",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "required": [
    "biomarker"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Find which biomarkers are affected by a given supplement. Returns direction (up/down), confidence, dose, and health goal mapping.

{
  "type": "object",
  "properties": {
    "supplement": {
      "type": "string",
      "minLength": 1,
      "maxLength": 512,
      "description": "Supplement name (e.g., 'fish oil', 'curcumin', 'vitamin D3')"
    },
    "limit": {
      "default": 25,
      "description": "Max results (default 25, max 100)",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "required": [
    "supplement"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Get comprehensive information about a supplement: what it is, what it does, which biomarkers it affects, mechanism of action, and safety contraindications.

{
  "type": "object",
  "properties": {
    "supplement": {
      "type": "string",
      "minLength": 1,
      "maxLength": 512,
      "description": "Supplement name"
    }
  },
  "required": [
    "supplement"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Find supplement-supplement interactions (765 pairs from clinical evidence) and drug-supplement interactions (1,626 FDA-validated pairs). Returns synergies, antagonisms, absorption conflicts, and timing recommendations.

{
  "type": "object",
  "properties": {
    "supplement": {
      "type": "string",
      "minLength": 1,
      "maxLength": 512,
      "description": "Supplement name"
    },
    "include_drug_interactions": {
      "default": true,
      "description": "Include FDA drug-supplement interactions",
      "type": "boolean"
    }
  },
  "required": [
    "supplement"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Find the highest-quality brands for a supplement, ranked by ProofMark (Aviado's quality score: third-party testing, certifications, and quality metrics).

{
  "type": "object",
  "properties": {
    "supplement": {
      "type": "string",
      "minLength": 1,
      "maxLength": 512,
      "description": "Supplement name"
    },
    "limit": {
      "default": 5,
      "description": "Number of results (max 20)",
      "type": "integer",
      "minimum": 1,
      "maximum": 20
    }
  },
  "required": [
    "supplement"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Resolve a supplement identity. Use mode='supplement_retail' only for raw retail product titles; it invokes the fail-closed retail front door. Identity mode is the default.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "maxLength": 512,
      "description": "Supplement identity or raw retail product title"
    },
    "mode": {
      "default": "identity",
      "description": "Explicit routing mode; retail titles require supplement_retail",
      "type": "string",
      "enum": [
        "identity",
        "supplement_retail"
      ]
    }
  },
  "required": [
    "query"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Search for a health condition by name with fuzzy matching. Use this to resolve ambiguous condition names before calling get_supplements_for_condition.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "maxLength": 512,
      "description": "Search query (e.g., 'sleep', 'anxiety', 'brain fog', 'joint pain')"
    }
  },
  "required": [
    "query"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Find which supplements help with a health condition or goal (e.g., 'sleep', 'anxiety', 'joint pain'). Returns evidence-graded supplement recommendations with dosages.

{
  "type": "object",
  "properties": {
    "condition": {
      "type": "string",
      "minLength": 1,
      "maxLength": 512,
      "description": "Health condition, symptom, or goal (e.g., 'insomnia', 'anxiety', 'brain fog', 'joint pain')"
    },
    "min_grade": {
      "default": "D",
      "description": "Minimum evidence grade to include (default: D = all)",
      "type": "string",
      "enum": [
        "A",
        "B",
        "C",
        "D"
      ]
    },
    "limit": {
      "default": 25,
      "description": "Max supplements to return, ranked by evidence (default: 25, max: 50)",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "required": [
    "condition"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}