Serveur MCP

Vitals Vault

io.github.vitalsvault/vitals-vault
Commerce et retail Santé Public et accessible MCP 2025-11-25

Ce que fait ce MCP

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.
Lecture seule Idempotent
Schéma d’entrée
{'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}
Schéma de sortie
{'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.
Lecture seule Idempotent
Schéma d’entrée
{'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}
Schéma de sortie
{'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.
Lecture seule Idempotent
Schéma d’entrée
{'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}
Schéma de sortie
{'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.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', 'required': ['slug'], 'properties': {'slug': {'type': 'string', 'maxLength': 160, 'minLength': 1, 'description': 'Biomarker slug such as apolipoprotein-b.'}}, 'additionalProperties': False}
Schéma de sortie
{'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.
Lecture seule Idempotent
Schéma d’entrée
{'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}
Schéma de sortie
{'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.
Lecture seule Idempotent
Schéma d’entrée
{'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}
Schéma de sortie
{'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.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', 'required': ['handle'], 'properties': {'handle': {'type': 'string', 'maxLength': 128, 'minLength': 1, 'description': 'Exact public catalog handle.'}}, 'additionalProperties': False}
Schéma de sortie
{'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.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', 'required': ['slug'], 'properties': {'slug': {'enum': ['essential', 'advanced', 'max'], 'type': 'string', 'maxLength': 32, 'description': 'Package slug: essential, advanced, or max.'}}, 'additionalProperties': False}
Schéma de sortie
{'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.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', 'required': ['path'], 'properties': {'path': {'type': 'string', 'maxLength': 2048, 'minLength': 1, 'description': 'Site path beginning with / such as /developers or /biomarkers.'}}, 'additionalProperties': False}
Schéma de sortie
{'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.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', 'required': [], 'properties': {}, 'additionalProperties': False}
Schéma de sortie
{'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.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', 'required': [], 'properties': {}, 'additionalProperties': False}
Schéma de sortie
{'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.
Lecture seule Idempotent
Schéma d’entrée
{'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}
Schéma de sortie
{'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.
Lecture seule Idempotent
Schéma d’entrée
{'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}
Schéma de sortie
{'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.
Lecture seule Idempotent
Schéma d’entrée
{'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}
Schéma de sortie
{'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.
Lecture seule Idempotent
Schéma d’entrée
{'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}
Schéma de sortie
{'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.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', 'required': [], 'properties': {}, 'additionalProperties': False}
Schéma de sortie
{'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}
Ajouté
fetch
17 September 2026 12:53
Ajouté
search
17 September 2026 12:53
Ajouté
get_page_as_markdown
17 September 2026 12:53
Ajouté
compare_blood_testing_services
17 September 2026 12:53
Ajouté
start_guided_panel_builder
17 September 2026 12:53
Ajouté
recommend_panel
17 September 2026 12:53
Ajouté
get_lab_catalog_item
17 September 2026 12:53
Ajouté
search_lab_catalog
17 September 2026 12:53
Ajouté
get_lab_package
17 September 2026 12:53
Ajouté
list_lab_packages
17 September 2026 12:53
Ajouté
get_biomarkers
17 September 2026 12:53
Ajouté
browse_biomarkers
17 September 2026 12:53
Ajouté
get_biomarker
17 September 2026 12:53
Ajouté
search_biomarkers
17 September 2026 12:53
Ajouté
get_biomarker_category
17 September 2026 12:53
Ajouté
list_biomarker_categories
17 September 2026 12:53