MCP-Server

Vitals Vault

io.github.vitalsvault/vitals-vault
Commerce & Retail Gesundheitswesen Öffentlich und erreichbar MCP 2025-11-25

Was dieses MCP kann

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