Aviado Health MCP · Aviado

{
  "name": "get_supplements_for_biomarker",
  "description": "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.",
  "inputSchema": {
    "$schema": "http://json-schema.org/draft-07/schema#",
    "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"
    ]
  }
}

{
  "name": "get_interventions_for_biomarker",
  "description": "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.",
  "inputSchema": {
    "$schema": "http://json-schema.org/draft-07/schema#",
    "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"
    ]
  }
}

{
  "name": "get_biomarkers_for_supplement",
  "description": "Find which biomarkers are affected by a given supplement. Returns direction (up/down), confidence, dose, and health goal mapping.",
  "inputSchema": {
    "$schema": "http://json-schema.org/draft-07/schema#",
    "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"
    ]
  }
}

{
  "name": "get_supplement_info",
  "description": "Get comprehensive information about a supplement: what it is, what it does, which biomarkers it affects, mechanism of action, and safety contraindications.",
  "inputSchema": {
    "$schema": "http://json-schema.org/draft-07/schema#",
    "type": "object",
    "properties": {
      "supplement": {
        "type": "string",
        "minLength": 1,
        "maxLength": 512,
        "description": "Supplement name"
      }
    },
    "required": [
      "supplement"
    ]
  }
}

{
  "name": "get_supplement_interactions",
  "description": "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.",
  "inputSchema": {
    "$schema": "http://json-schema.org/draft-07/schema#",
    "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"
    ]
  }
}

{
  "name": "get_top_brands",
  "description": "Find the highest-quality brands for a supplement, ranked by ProofMark (Aviado's quality score: third-party testing, certifications, and quality metrics).",
  "inputSchema": {
    "$schema": "http://json-schema.org/draft-07/schema#",
    "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"
    ]
  }
}

{
  "name": "search_supplements",
  "description": "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.",
  "inputSchema": {
    "$schema": "http://json-schema.org/draft-07/schema#",
    "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"
    ]
  }
}

{
  "name": "search_conditions",
  "description": "Search for a health condition by name with fuzzy matching. Use this to resolve ambiguous condition names before calling get_supplements_for_condition.",
  "inputSchema": {
    "$schema": "http://json-schema.org/draft-07/schema#",
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "minLength": 1,
        "maxLength": 512,
        "description": "Search query (e.g., 'sleep', 'anxiety', 'brain fog', 'joint pain')"
      }
    },
    "required": [
      "query"
    ]
  }
}

{
  "name": "get_supplements_for_condition",
  "description": "Find which supplements help with a health condition or goal (e.g., 'sleep', 'anxiety', 'joint pain'). Returns evidence-graded supplement recommendations with dosages.",
  "inputSchema": {
    "$schema": "http://json-schema.org/draft-07/schema#",
    "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"
    ]
  }
}