browse_biomarkers

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

Argument	Type	Description
limit	integer	Maximum biomarkers to return (default 20, max 50).
cursor	string	Opaque pagination cursor from a prior response.
gender	string	Optional applicability filter; defaults to all.
category	string	Optional public category slug.

Input schema (JSON)

{
  "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
}

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

Argument	Type	Description
competitor	string	Optional competitor slug from the public comparison registry.

Input schema (JSON)

{
  "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
}

create_checkout_link

Builds a vitalsvault.com checkout URL prefilled with an optional Essential, Advanced, or Max base panel and exact catalog handles, each revalidated for current price and orderability without substitution. The response lists items, live prices, and the subtotal before automatic promotions or promo codes. It is only a URL: no cart, session, account, order, or payment is created, and the person reviews, edits, and pays on the website. Identity, PHI, and free-text symptoms are outside the input contract.

read-only

Argument	Type	Description
handles	array	Exact public catalog handles to prefill. Without a base panel they open as a Build Your Own Panel; with one they are removable add-ons.
assistant	string	Optional assistant surface for link attribution (utm_source); other or omitted falls back to the MCP client.
basePackage	string	Optional base panel slug: essential, advanced, or max.

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {
    "handles": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 128,
        "minLength": 1
      },
      "maxItems": 20,
      "minItems": 0,
      "description": "Exact public catalog handles to prefill. Without a base panel they open as a Build Your Own Panel; with one they are removable add-ons.",
      "uniqueItems": true
    },
    "assistant": {
      "enum": [
        "chatgpt",
        "claude",
        "perplexity",
        "other"
      ],
      "type": "string",
      "description": "Optional assistant surface for link attribution (utm_source); other or omitted falls back to the MCP client."
    },
    "basePackage": {
      "enum": [
        "essential",
        "advanced",
        "max"
      ],
      "type": "string",
      "maxLength": 32,
      "description": "Optional base panel slug: essential, advanced, or max."
    }
  },
  "additionalProperties": false
}

fetch

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

Argument	Type	Description
id*	string	Stable public identifier such as biomarker:apolipoprotein-b or doc:developers.

Input schema (JSON)

{
  "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
}

get_biomarker

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

Argument	Type	Description
slug*	string	Biomarker slug such as apolipoprotein-b.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "slug"
  ],
  "properties": {
    "slug": {
      "type": "string",
      "maxLength": 160,
      "minLength": 1,
      "description": "Biomarker slug such as apolipoprotein-b."
    }
  },
  "additionalProperties": false
}

get_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

Argument	Type	Description
slug*	string	Exact public category slug, such as heart-cardiovascular or energy-metabolism.

Input schema (JSON)

{
  "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
}

get_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

Argument	Type	Description
slugs*	array	One to 20 exact public biomarker slugs.

Input schema (JSON)

{
  "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
}

get_lab_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

Argument	Type	Description
handle*	string	Exact public catalog handle.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "handle"
  ],
  "properties": {
    "handle": {
      "type": "string",
      "maxLength": 128,
      "minLength": 1,
      "description": "Exact public catalog handle."
    }
  },
  "additionalProperties": false
}

get_lab_package

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

Argument	Type	Description
slug*	string	Package slug: essential, advanced, or max.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "slug"
  ],
  "properties": {
    "slug": {
      "enum": [
        "essential",
        "advanced",
        "max"
      ],
      "type": "string",
      "maxLength": 32,
      "description": "Package slug: essential, advanced, or max."
    }
  },
  "additionalProperties": false
}

get_page_as_markdown

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

Argument	Type	Description
path*	string	Site path beginning with / such as /developers or /biomarkers.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "path"
  ],
  "properties": {
    "path": {
      "type": "string",
      "maxLength": 2048,
      "minLength": 1,
      "description": "Site path beginning with / such as /developers or /biomarkers."
    }
  },
  "additionalProperties": false
}

list_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

No arguments.

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {},
  "additionalProperties": false
}

list_lab_packages

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

No arguments.

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {},
  "additionalProperties": false
}

recommend_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

Argument	Type	Description
sex	string	Optional controlled biological-sex context for public catalog applicability; not_specified represents an omitted value.
goal*	string	What the person is trying to accomplish.
budget	string	Legacy package price bucket. Exact hard ceilings are represented by maxBudgetUsd.
ageBand	string	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*	string	Controlled high-level concern; urgent_symptoms returns a safety-suppressed response.
maxBudgetUsd	number	Exact hard ceiling in US dollars. Required when packagePreference is custom_only; the returned total never exceeds it.

search

Provides broad connector discovery across public Vitals Vault biomarkers, panels, developer documentation, and comparisons. Results contain stable identifiers for exact public retrieval.

read-only

Argument	Type	Description
query*	string	Search text such as ApoB, OAuth, Advanced, or Function Health.

Input schema (JSON)

{
  "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
}

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

Argument	Type	Description
limit	integer	Maximum results to return (default 10, max 25).
query*	string	Search text such as ApoB or vitamin D.

Input schema (JSON)

{
  "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
}

search_lab_catalog

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

Argument	Type	Description
page	integer	One-based public catalog page; defaults to 1.
limit	integer	Maximum results per page; defaults to 20.
query	string	Optional customer-facing test or panel name, such as ApoB or thyroid.
gender	string	Public catalog applicability filter; defaults to all.
category	string	Optional public checkout category slug.
itemType	string	Catalog item filter for panels, individual tests, or both; defaults to all.

Input schema (JSON)

{
  "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
}

start_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

No arguments.

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {},
  "additionalProperties": false
}

Vitals Vault

Try it

browse_biomarkers Read-only

Vitals Vault

Try it

browse_biomarkers Read-only

Tools (17)