MCP Server

Vitals Vault

io.github.vitalsvault/vitals-vault
Commerce & Retail Healthcare Public & reachable MCP 2025-11-25

What this MCP does

Provides public biomarker education, blood-test and panel catalogs, price comparisons, and controlled panel recommendations without accessing private health records or placing orders.

browse_biomarkers
Browse What We Test
Returns the public What We Test collection with stable cursor pagination and optional category or sex-applicability filters. The response excludes diagnosis and private lab results.
Read only Idempotent
Input schema
{'type': 'object', 'required': [], 'properties': {'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Maximum biomarkers to return (default 20, max 50).'}, 'cursor': {'type': 'string', 'maxLength': 256, 'minLength': 1, 'description': 'Opaque pagination cursor from a prior response.'}, 'gender': {'enum': ['all', 'male', 'female'], 'type': 'string', 'description': 'Optional applicability filter; defaults to all.'}, 'category': {'type': 'string', 'maxLength': 120, 'minLength': 1, 'description': 'Optional public category slug.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['biomarkers', 'pagination'], 'properties': {'biomarkers': {'type': 'array', 'items': {'type': 'object', 'required': ['slug', 'name', 'publicUrl'], 'properties': {'name': {'type': 'string'}, 'slug': {'type': 'string'}, 'unit': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'causes': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'summary': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'symptoms': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'loincCode': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'loincName': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'publicUrl': {'type': 'string', 'format': 'uri'}, 'hasContent': {'type': 'boolean'}, 'keyInsights': {'type': 'array', 'items': {'type': 'string'}}, 'categorySlug': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'significance': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'metaDescription': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'applicableGender': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'includedInPanels': {'type': 'array', 'items': {'type': 'string'}}, 'lastMedicalReview': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'medicalReviewStatus': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': False}}, 'pagination': {'type': 'object', 'required': ['limit', 'totalCount', 'hasMore', 'nextCursor'], 'properties': {'limit': {'type': 'integer'}, 'hasMore': {'type': 'boolean'}, 'nextCursor': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'totalCount': {'type': 'integer'}}, 'additionalProperties': False}}, 'additionalProperties': False}
compare_blood_testing_services
Compare blood testing services
Returns a factual side-by-side comparison of Vitals Vault and a supported blood-testing service using public master-table facts and methodology. It excludes medical advice and unsupported superiority claims.
Read only Idempotent
Input schema
{'type': 'object', 'required': [], 'properties': {'competitor': {'enum': ['superpower', 'lab-marketplaces', 'function-health', 'insidetracker', 'hims'], 'type': 'string', 'maxLength': 80, 'description': 'Optional competitor slug from the public comparison registry.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['rows', 'note', 'methodology'], 'properties': {'note': {'type': 'string'}, 'rows': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'slug', 'biomarkers', 'startingPrice', 'subscription', 'labLocations', 'clinicianReview', 'personalizedActionPlan', 'biologicalAge', 'reportDepth', 'healthProtocols', 'uploadPastLabs', 'dataOwnership', 'hsaFsa', 'customPanelBuilder'], 'properties': {'name': {'type': 'string'}, 'slug': {'type': 'string'}, 'hsaFsa': {'type': 'string'}, 'biomarkers': {'type': 'string'}, 'reportDepth': {'type': 'string'}, 'labLocations': {'type': 'string'}, 'subscription': {'type': 'string'}, 'biologicalAge': {'type': 'string'}, 'dataOwnership': {'type': 'string'}, 'startingPrice': {'type': 'string'}, 'uploadPastLabs': {'type': 'string'}, 'clinicianReview': {'type': 'string'}, 'healthProtocols': {'type': 'string'}, 'customPanelBuilder': {'type': 'string'}, 'personalizedActionPlan': {'type': 'string'}}, 'additionalProperties': False}}, 'methodology': {'type': 'object', 'required': ['lastReviewed', 'url', 'sourceHierarchy'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'lastReviewed': {'type': 'string'}, 'sourceHierarchy': {'type': 'array', 'items': {'type': 'object', 'required': ['title', 'description'], 'properties': {'title': {'type': 'string'}, 'description': {'type': 'string'}}, 'additionalProperties': False}}}, 'additionalProperties': False}}, 'additionalProperties': False}
fetch
Fetch a Vitals Vault result
Fetches one public biomarker, panel, document, or comparison result by stable connector identifier. The response contains public data only and does not access private records.
Read only Idempotent
Input schema
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'maxLength': 300, 'minLength': 1, 'description': 'Stable public identifier such as biomarker:apolipoprotein-b or doc:developers.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['id', 'title', 'text', 'url', 'metadata'], 'properties': {'id': {'type': 'string'}, 'url': {'type': 'string', 'format': 'uri'}, 'text': {'type': 'string'}, 'title': {'type': 'string'}, 'metadata': {'type': 'object', 'required': [], 'properties': {}, 'additionalProperties': True}}, 'additionalProperties': False}
get_biomarker
Get biomarker details
Returns public educational units and existing content for one exact biomarker slug. Standard and optimal range arrays remain present for compatibility but may be empty without a reviewed public range source. This is not medical advice.
Read only Idempotent
Input schema
{'type': 'object', 'required': ['slug'], 'properties': {'slug': {'type': 'string', 'maxLength': 160, 'minLength': 1, 'description': 'Biomarker slug such as apolipoprotein-b.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['slug', 'name', 'publicUrl', 'ranges', 'existingContent'], 'properties': {'name': {'type': 'string'}, 'slug': {'type': 'string'}, 'unit': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'units': {}, 'causes': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'ranges': {'type': 'array', 'items': {'type': 'object', 'required': [], 'properties': {'unit': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'notes': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'methodology': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'whatLowMeans': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'standardRange': {}, 'whatHighMeans': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'functionalOptimalRange': {}}, 'additionalProperties': False}}, 'summary': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'category': {'oneOf': [{'type': 'object', 'required': [], 'properties': {'name': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'slug': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'shortName': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': False}, {'type': 'null'}]}, 'symptoms': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'loincCode': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'loincName': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'publicUrl': {'type': 'string', 'format': 'uri'}, 'hasContent': {'type': 'boolean'}, 'keyInsights': {'type': 'array', 'items': {'type': 'string'}}, 'categorySlug': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'significance': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'whatLowMeans': {'type': 'array', 'items': {}}, 'whatHighMeans': {'type': 'array', 'items': {}}, 'existingContent': {'type': 'object', 'required': ['summary', 'significance', 'symptoms', 'causes', 'keyInsights'], 'properties': {'causes': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'summary': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'symptoms': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'keyInsights': {'type': 'array', 'items': {'type': 'string'}}, 'significance': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': False}, 'metaDescription': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'applicableGender': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'includedInPanels': {'type': 'array', 'items': {'type': 'string'}}, 'lastMedicalReview': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'medicalReviewStatus': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': False}
get_biomarker_category
Get a biomarker category
Returns the biomarkers in one exact public category slug. Unknown slugs produce a stable not-found result, and the educational response excludes diagnosis and private data.
Read only Idempotent
Input schema
{'type': 'object', 'required': ['slug'], 'properties': {'slug': {'type': 'string', 'maxLength': 120, 'minLength': 1, 'description': 'Exact public category slug, such as heart-cardiovascular or energy-metabolism.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['slug', 'name', 'biomarkers'], 'properties': {'name': {'type': 'string'}, 'slug': {'type': 'string'}, 'priority': {'oneOf': [{'type': 'number'}, {'type': 'null'}]}, 'shortName': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'biomarkers': {'type': 'array', 'items': {'type': 'object', 'required': ['slug', 'name', 'publicUrl'], 'properties': {'name': {'type': 'string'}, 'slug': {'type': 'string'}, 'unit': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'causes': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'summary': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'symptoms': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'loincCode': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'loincName': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'publicUrl': {'type': 'string', 'format': 'uri'}, 'hasContent': {'type': 'boolean'}, 'keyInsights': {'type': 'array', 'items': {'type': 'string'}}, 'categorySlug': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'significance': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'metaDescription': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'applicableGender': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'includedInPanels': {'type': 'array', 'items': {'type': 'string'}}, 'lastMedicalReview': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'medicalReviewStatus': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': False}}, 'description': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'biomarkerCount': {'oneOf': [{'type': 'number'}, {'type': 'null'}]}, 'fullDescription': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': False}
get_biomarkers
Compare exact biomarkers
Resolves known public biomarker slugs in request order for factual comparison and reports missing slugs without substitution. Private lab results are outside this tool’s data boundary.
Read only Idempotent
Input schema
{'type': 'object', 'required': ['slugs'], 'properties': {'slugs': {'type': 'array', 'items': {'type': 'string', 'maxLength': 128, 'minLength': 1}, 'maxItems': 20, 'minItems': 1, 'description': 'One to 20 exact public biomarker slugs.', 'uniqueItems': True}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['biomarkers', 'missingSlugs', 'requestedCount', 'foundCount'], 'properties': {'biomarkers': {'type': 'array', 'items': {'type': 'object', 'required': ['slug', 'name', 'publicUrl'], 'properties': {'name': {'type': 'string'}, 'slug': {'type': 'string'}, 'unit': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'causes': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'summary': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'symptoms': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'loincCode': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'loincName': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'publicUrl': {'type': 'string', 'format': 'uri'}, 'hasContent': {'type': 'boolean'}, 'keyInsights': {'type': 'array', 'items': {'type': 'string'}}, 'categorySlug': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'significance': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'metaDescription': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'applicableGender': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'includedInPanels': {'type': 'array', 'items': {'type': 'string'}}, 'lastMedicalReview': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'medicalReviewStatus': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': False}}, 'foundCount': {'type': 'integer'}, 'missingSlugs': {'type': 'array', 'items': {'type': 'string'}}, 'requestedCount': {'type': 'integer'}}, 'additionalProperties': False}
get_lab_catalog_item
Get an orderable catalog item
Revalidates one exact public catalog handle for current price and orderability under the website checkout policy. It never fuzzy-substitutes and returns a safe not-found result for ineligible items.
Read only Idempotent
Input schema
{'type': 'object', 'required': ['handle'], 'properties': {'handle': {'type': 'string', 'maxLength': 128, 'minLength': 1, 'description': 'Exact public catalog handle.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['handle', 'name', 'price', 'selectionSummary', 'description', 'category', 'itemType', 'biomarkerCount', 'specimenType', 'turnaroundDays', 'fastingRequired', 'orderable', 'availabilityNote', 'publicUrl', 'humanCheckoutUrl', 'discovery'], 'properties': {'name': {'type': 'string'}, 'price': {'type': 'object', 'required': ['amount', 'currency', 'display'], 'properties': {'amount': {'type': 'number'}, 'display': {'type': 'string'}, 'currency': {'type': 'string', 'const': 'USD'}}, 'additionalProperties': False}, 'handle': {'type': 'string'}, 'category': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'itemType': {'enum': ['panel', 'individual_test'], 'type': 'string'}, 'discovery': {'type': 'object', 'required': ['document', 'match'], 'properties': {'match': {'oneOf': [{'type': 'object', 'required': ['matchedFields', 'matchedTerms', 'explanation'], 'properties': {'explanation': {'type': 'string'}, 'matchedTerms': {'type': 'array', 'items': {'type': 'string'}}, 'matchedFields': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': False}, {'type': 'null'}]}, 'document': {'type': 'object', 'required': ['version', 'name', 'aliases', 'categories', 'includedBiomarkers', 'includedTests', 'intendedAudience', 'description'], 'properties': {'name': {'type': 'string'}, 'aliases': {'type': 'array', 'items': {'type': 'string'}}, 'version': {'type': 'string'}, 'categories': {'type': 'array', 'items': {'type': 'string'}}, 'description': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'includedTests': {'type': 'array', 'items': {'type': 'string'}}, 'intendedAudience': {'type': 'array', 'items': {'type': 'string'}}, 'includedBiomarkers': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'orderable': {'type': 'boolean', 'const': True}, 'publicUrl': {'type': 'string', 'format': 'uri'}, 'description': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'specimenType': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'biomarkerCount': {'oneOf': [{'type': 'number'}, {'type': 'null'}]}, 'turnaroundDays': {'oneOf': [{'type': 'string'}, {'type': 'number'}, {'type': 'null'}]}, 'fastingRequired': {'oneOf': [{'type': 'boolean'}, {'type': 'null'}]}, 'availabilityNote': {'type': 'string'}, 'humanCheckoutUrl': {'type': 'string', 'format': 'uri'}, 'selectionSummary': {'type': 'object', 'required': ['headline', 'priceLabel', 'whyMatched', 'relevantIncludes', 'categoryContext', 'audienceContext', 'medicalBoundary', 'availabilityLabel', 'nextStep'], 'properties': {'headline': {'type': 'string'}, 'nextStep': {'type': 'string'}, 'priceLabel': {'type': 'string'}, 'whyMatched': {'type': 'string'}, 'audienceContext': {'type': 'array', 'items': {'type': 'string'}}, 'categoryContext': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'medicalBoundary': {'type': 'string'}, 'relevantIncludes': {'type': 'array', 'items': {'type': 'string'}}, 'availabilityLabel': {'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}
get_lab_package
Get a Vitals Vault panel
Resolves the exact Essential, Advanced, or Max legacy package slug to its current public panel price, biomarker count, features, and human URL. The tool never creates an order.
Read only Idempotent
Input schema
{'type': 'object', 'required': ['slug'], 'properties': {'slug': {'enum': ['essential', 'advanced', 'max'], 'type': 'string', 'maxLength': 32, 'description': 'Package slug: essential, advanced, or max.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['slug', 'name', 'title', 'priceUsd', 'biomarkerCount', 'biomarkerCountLabel', 'biomarkerCountIsMinimum', 'description', 'features', 'checkoutPath', 'aLaCarte'], 'properties': {'name': {'type': 'string'}, 'slug': {'enum': ['essential', 'advanced', 'max'], 'type': 'string'}, 'title': {'type': 'string'}, 'aLaCarte': {'type': 'string'}, 'features': {'type': 'array', 'items': {'type': 'string'}}, 'priceUsd': {'type': 'number'}, 'description': {'type': 'string'}, 'checkoutPath': {'type': 'string'}, 'biomarkerCount': {'type': 'integer'}, 'biomarkerCountLabel': {'type': 'string'}, 'biomarkerCountIsMinimum': {'type': 'boolean'}}, 'additionalProperties': False}
get_page_as_markdown
Read a public Vitals Vault page
Returns a markdown representation of an allowlisted public Vitals Vault page under the protected-route policy. Checkout, account, result, and other private pages are unavailable.
Read only Idempotent
Input schema
{'type': 'object', 'required': ['path'], 'properties': {'path': {'type': 'string', 'maxLength': 2048, 'minLength': 1, 'description': 'Site path beginning with / such as /developers or /biomarkers.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['path', 'markdown'], 'properties': {'path': {'type': 'string'}, 'markdown': {'type': 'string'}}, 'additionalProperties': False}
list_biomarker_categories
Browse biomarker categories
Returns public educational biomarker category slugs and marker counts for collection browsing. The content excludes diagnosis, private lab results, and other protected data.
Read only Idempotent
Input schema
{'type': 'object', 'required': [], 'properties': {}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['categories', 'totalCount'], 'properties': {'categories': {'type': 'array', 'items': {'type': 'object', 'required': ['slug', 'name'], 'properties': {'name': {'type': 'string'}, 'slug': {'type': 'string'}, 'priority': {'oneOf': [{'type': 'number'}, {'type': 'null'}]}, 'shortName': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'description': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'biomarkerCount': {'oneOf': [{'type': 'number'}, {'type': 'null'}]}, 'fullDescription': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': False}}, 'totalCount': {'type': 'integer'}}, 'additionalProperties': False}
list_lab_packages
Compare Essential, Advanced, and Max
Compares Essential, Advanced, and Max using current public prices, biomarker counts, included reporting value, and individual-test availability. The tool never creates a cart.
Read only Idempotent
Input schema
{'type': 'object', 'required': [], 'properties': {}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['packages', 'aLaCarte', 'note', 'includedPlatform', 'proofLoop'], 'properties': {'note': {'type': 'string'}, 'aLaCarte': {'type': 'string'}, 'packages': {'type': 'array', 'items': {'type': 'object', 'required': ['slug', 'name', 'title', 'priceUsd', 'biomarkerCount', 'biomarkerCountLabel', 'biomarkerCountIsMinimum', 'description', 'features', 'checkoutPath'], 'properties': {'name': {'type': 'string'}, 'slug': {'enum': ['essential', 'advanced', 'max'], 'type': 'string'}, 'title': {'type': 'string'}, 'features': {'type': 'array', 'items': {'type': 'string'}}, 'priceUsd': {'type': 'number'}, 'description': {'type': 'string'}, 'checkoutPath': {'type': 'string'}, 'biomarkerCount': {'type': 'integer'}, 'biomarkerCountLabel': {'type': 'string'}, 'biomarkerCountIsMinimum': {'type': 'boolean'}}, 'additionalProperties': False}}, 'proofLoop': {'type': 'array', 'items': {'type': 'string'}}, 'includedPlatform': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': False}
recommend_panel
Recommend a Vitals Vault panel
Returns a controlled educational Essential, Advanced, Max, or exact-budget Build Your Own Panel starting point. A custom_only request with maxBudgetUsd excludes standard panels. Every selection is revalidated against the complete eligible catalog. Inputs exclude free-text symptoms, identity, private results, and PHI; the tool never diagnoses, stores a health record, or creates a cart.
Read only Idempotent
Input schema
{'type': 'object', 'required': ['concern', 'goal'], 'properties': {'sex': {'enum': ['female', 'male', 'not_specified'], 'type': 'string', 'description': 'Optional controlled biological-sex context for public catalog applicability; not_specified represents an omitted value.'}, 'goal': {'enum': ['build_baseline', 'investigate_concern', 'monitor_progress', 'retest', 'find_specific_test'], 'type': 'string', 'description': 'What the person is trying to accomplish.'}, 'budget': {'enum': ['under_100', 'under_200', 'under_400', 'flexible'], 'type': 'string', 'description': 'Legacy package price bucket. Exact hard ceilings are represented by maxBudgetUsd.'}, 'ageBand': {'enum': ['18_29', '30_39', '40_49', '50_59', '60_plus', 'not_specified'], 'type': 'string', 'description': 'Reserved broad age-band context that is not currently used to select tests. Birth dates and exact ages are outside the input contract; the value is not persisted or logged.'}, 'concern': {'enum': ['general_baseline', 'fatigue_energy', 'thyroid', 'hormone_balance', 'heart_risk', 'metabolic_health', 'vitamin_nutrient', 'inflammation', 'healthy_aging', 'athletic_performance', 'sleep_stress', 'specific_tests', 'urgent_symptoms'], 'type': 'string', 'description': 'Controlled high-level concern; urgent_symptoms returns a safety-suppressed response.'}, 'maxBudgetUsd': {'type': 'number', 'maximum': 2000, 'minimum': 2, 'description': 'Exact hard ceiling in US dollars. Required when packagePreference is custom_only; the returned total never exceeds it.'}, 'biomarkerSlugs': {'type': 'array', 'items': {'type': 'string', 'maxLength': 128, 'minLength': 1}, 'maxItems': 5, 'minItems': 1, 'description': 'Optional exact public slugs for find_specific_test or retest goals.', 'uniqueItems': True}, 'packagePreference': {'enum': ['allow_packages', 'custom_only'], 'type': 'string', 'description': 'allow_packages compares the standard panels; custom_only excludes Essential, Advanced, and Max and builds only from checkout-eligible BYOP items.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['disposition'], 'properties': {'reason': {'type': 'string'}, 'rationale': {'type': 'string'}, 'disposition': {'enum': ['urgent_care', 'specific_test', 'build_your_own_panel', 'standard_panel', 'guided_builder'], 'type': 'string'}, 'inputPolicy': {'type': 'object', 'required': ['controlledInputsOnly', 'noFreeTextAccepted', 'persisted', 'logged'], 'properties': {'logged': {'type': 'boolean'}, 'persisted': {'type': 'boolean'}, 'noFreeTextAccepted': {'type': 'boolean'}, 'controlledInputsOnly': {'type': 'boolean'}}, 'additionalProperties': False}, 'medicalBoundary': {'type': 'string'}}, 'additionalProperties': True}
search
Search Vitals Vault
Provides broad connector discovery across public Vitals Vault biomarkers, panels, developer documentation, and comparisons. Results contain stable identifiers for exact public retrieval.
Read only Idempotent
Input schema
{'type': 'object', 'required': ['query'], 'properties': {'query': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Search text such as ApoB, OAuth, Advanced, or Function Health.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['results'], 'properties': {'results': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'title', 'url'], 'properties': {'id': {'type': 'string'}, 'url': {'type': 'string', 'format': 'uri'}, 'title': {'type': 'string'}}, 'additionalProperties': False}}}, 'additionalProperties': False}
search_biomarkers
Search biomarkers
Searches public educational biomarkers by name, alias, LOINC, or keyword and explains Vitals Vault coverage. Private lab results are outside this tool’s data boundary.
Read only Idempotent
Input schema
{'type': 'object', 'required': ['query'], 'properties': {'limit': {'type': 'integer', 'maximum': 25, 'minimum': 1, 'description': 'Maximum results to return (default 10, max 25).'}, 'query': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Search text such as ApoB or vitamin D.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['query', 'results', 'totalCount'], 'properties': {'query': {'type': 'string'}, 'results': {'type': 'array', 'items': {'type': 'object', 'required': ['slug', 'name', 'publicUrl'], 'properties': {'name': {'type': 'string'}, 'slug': {'type': 'string'}, 'unit': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'causes': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'summary': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'symptoms': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'loincCode': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'loincName': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'publicUrl': {'type': 'string', 'format': 'uri'}, 'hasContent': {'type': 'boolean'}, 'keyInsights': {'type': 'array', 'items': {'type': 'string'}}, 'categorySlug': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'significance': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'metaDescription': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'applicableGender': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'includedInPanels': {'type': 'array', 'items': {'type': 'string'}}, 'lastMedicalReview': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'medicalReviewStatus': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': False}}, 'totalCount': {'type': 'integer'}}, 'additionalProperties': False}
search_lab_catalog
Search orderable tests and panels
Searches currently orderable Vitals Vault tests and panels with customer-safe prices and stable pagination. Results come from a versioned public search document with match provenance and are revalidated against website checkout eligibility. Identity, account data, private results, and PHI are outside the input contract.
Read only Idempotent
Input schema
{'type': 'object', 'required': [], 'properties': {'page': {'type': 'integer', 'maximum': 1000, 'minimum': 1, 'description': 'One-based public catalog page; defaults to 1.'}, 'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Maximum results per page; defaults to 20.'}, 'query': {'type': 'string', 'maxLength': 120, 'minLength': 2, 'description': 'Optional customer-facing test or panel name, such as ApoB or thyroid.'}, 'gender': {'enum': ['all', 'male', 'female'], 'type': 'string', 'description': 'Public catalog applicability filter; defaults to all.'}, 'category': {'type': 'string', 'maxLength': 120, 'minLength': 1, 'description': 'Optional public checkout category slug.'}, 'itemType': {'enum': ['all', 'panel', 'individual_test'], 'type': 'string', 'description': 'Catalog item filter for panels, individual tests, or both; defaults to all.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['query', 'filters', 'items', 'pagination', 'source', 'humanCheckoutOnly'], 'properties': {'items': {'type': 'array', 'items': {'type': 'object', 'required': ['handle', 'name', 'price', 'selectionSummary', 'description', 'category', 'itemType', 'biomarkerCount', 'specimenType', 'turnaroundDays', 'fastingRequired', 'orderable', 'availabilityNote', 'publicUrl', 'humanCheckoutUrl', 'discovery'], 'properties': {'name': {'type': 'string'}, 'price': {'type': 'object', 'required': ['amount', 'currency', 'display'], 'properties': {'amount': {'type': 'number'}, 'display': {'type': 'string'}, 'currency': {'type': 'string', 'const': 'USD'}}, 'additionalProperties': False}, 'handle': {'type': 'string'}, 'category': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'itemType': {'enum': ['panel', 'individual_test'], 'type': 'string'}, 'discovery': {'type': 'object', 'required': ['document', 'match'], 'properties': {'match': {'oneOf': [{'type': 'object', 'required': ['matchedFields', 'matchedTerms', 'explanation'], 'properties': {'explanation': {'type': 'string'}, 'matchedTerms': {'type': 'array', 'items': {'type': 'string'}}, 'matchedFields': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': False}, {'type': 'null'}]}, 'document': {'type': 'object', 'required': ['version', 'name', 'aliases', 'categories', 'includedBiomarkers', 'includedTests', 'intendedAudience', 'description'], 'properties': {'name': {'type': 'string'}, 'aliases': {'type': 'array', 'items': {'type': 'string'}}, 'version': {'type': 'string'}, 'categories': {'type': 'array', 'items': {'type': 'string'}}, 'description': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'includedTests': {'type': 'array', 'items': {'type': 'string'}}, 'intendedAudience': {'type': 'array', 'items': {'type': 'string'}}, 'includedBiomarkers': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'orderable': {'type': 'boolean', 'const': True}, 'publicUrl': {'type': 'string', 'format': 'uri'}, 'description': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'specimenType': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'biomarkerCount': {'oneOf': [{'type': 'number'}, {'type': 'null'}]}, 'turnaroundDays': {'oneOf': [{'type': 'string'}, {'type': 'number'}, {'type': 'null'}]}, 'fastingRequired': {'oneOf': [{'type': 'boolean'}, {'type': 'null'}]}, 'availabilityNote': {'type': 'string'}, 'humanCheckoutUrl': {'type': 'string', 'format': 'uri'}, 'selectionSummary': {'type': 'object', 'required': ['headline', 'priceLabel', 'whyMatched', 'relevantIncludes', 'categoryContext', 'audienceContext', 'medicalBoundary', 'availabilityLabel', 'nextStep'], 'properties': {'headline': {'type': 'string'}, 'nextStep': {'type': 'string'}, 'priceLabel': {'type': 'string'}, 'whyMatched': {'type': 'string'}, 'audienceContext': {'type': 'array', 'items': {'type': 'string'}}, 'categoryContext': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'medicalBoundary': {'type': 'string'}, 'relevantIncludes': {'type': 'array', 'items': {'type': 'string'}}, 'availabilityLabel': {'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'query': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'source': {'type': 'string'}, 'filters': {'type': 'object', 'required': ['category', 'itemType', 'gender'], 'properties': {'gender': {'enum': ['all', 'male', 'female'], 'type': 'string'}, 'category': {'oneOf': [{'type': 'string'}, {'type': 'null'}]}, 'itemType': {'enum': ['all', 'panel', 'individual_test'], 'type': 'string'}}, 'additionalProperties': False}, 'pagination': {'type': 'object', 'required': ['page', 'limit', 'total', 'hasMore', 'nextPage'], 'properties': {'page': {'type': 'integer'}, 'limit': {'type': 'integer'}, 'total': {'type': 'integer'}, 'hasMore': {'type': 'boolean'}, 'nextPage': {'oneOf': [{'type': 'integer'}, {'type': 'null'}]}}, 'additionalProperties': False}, 'humanCheckoutOnly': {'type': 'boolean', 'const': True}}, 'additionalProperties': False}
start_guided_panel_builder
Open the guided panel builder
Returns the canonical entry for the full human-controlled Vitals Vault consultation, with no health answers in the URL. It creates no session, cart, account, order, or payment.
Read only Idempotent
Input schema
{'type': 'object', 'required': [], 'properties': {}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['disposition', 'message'], 'properties': {'message': {'type': 'string'}, 'disposition': {'type': 'string', 'const': 'guided_builder'}, 'medicalBoundary': {'type': 'string'}, 'humanCheckoutUrl': {'type': 'string'}, 'humanCheckoutOnly': {'type': 'boolean', 'const': True}}, 'additionalProperties': True}
Added
fetch
Sept. 17, 2026, 12:53 p.m.
Added
search
Sept. 17, 2026, 12:53 p.m.
Added
get_page_as_markdown
Sept. 17, 2026, 12:53 p.m.
Added
compare_blood_testing_services
Sept. 17, 2026, 12:53 p.m.
Added
start_guided_panel_builder
Sept. 17, 2026, 12:53 p.m.
Added
recommend_panel
Sept. 17, 2026, 12:53 p.m.
Added
get_lab_catalog_item
Sept. 17, 2026, 12:53 p.m.
Added
search_lab_catalog
Sept. 17, 2026, 12:53 p.m.
Added
get_lab_package
Sept. 17, 2026, 12:53 p.m.
Added
list_lab_packages
Sept. 17, 2026, 12:53 p.m.
Added
get_biomarkers
Sept. 17, 2026, 12:53 p.m.
Added
browse_biomarkers
Sept. 17, 2026, 12:53 p.m.
Added
get_biomarker
Sept. 17, 2026, 12:53 p.m.
Added
search_biomarkers
Sept. 17, 2026, 12:53 p.m.
Added
get_biomarker_category
Sept. 17, 2026, 12:53 p.m.
Added
list_biomarker_categories
Sept. 17, 2026, 12:53 p.m.