TestWell Lab Tests

com.test-wellPublished by test-well.comOfficial publisherv1.2.0Updated Oct 24, 2026

Cash-pay lab tests: catalog search, all-in quotes by state, draw sites by ZIP, reviewed ranges.

VerifiedStreamable HTTPWeb executableLocation & LifestyleFinanceBusiness & Commerce

Overview

AI-generated overview

Lets an assistant search cash-pay lab tests, quote all-in prices by US state, find draw sites by ZIP, and start or pay a checkout.

What you can do
It exposes TestWell's public lab-test catalog: keyword, biomarker or CPT search, full test and panel detail, bundled panels, and goal- or symptom-based suggestions. It prices a set of tests exactly as checkout would, including the per-order lab fee and state-based lab routing, and can create, update, read, cancel or complete a checkout session. Supporting tools find Quest, Labcorp and BioReference draw sites near a ZIP, look up physician-reviewed reference ranges, interpret pasted results, convert units, calculate free testosterone, compare prices and providers, and return educational guides.
When to use it
Use it when someone wants to research or buy direct-to-consumer blood tests in the US: comparing all-in prices across providers, choosing panels for a health goal, locating a draw site, or understanding what a lab value means. It is educational matching and reference material, not a diagnosis.
Requirements
A remote streamable HTTP endpoint; no local runtime, package, environment variables or headers are declared. Checkout tools need a US state, buyer name, email and phone, and complete_checkout expects a Stripe shared payment token supplied by the platform's payment flow. Some states are not served or route to a specific lab.
Before you install
create_checkout, update_checkout and complete_checkout act on a real order, and complete_checkout charges the payment credential, so money is spent. Buyer name, email and phone are sent to TestWell, and pasted lab values are sent for interpretation. Paid sessions cannot be cancelled through cancel_checkout. Prices are stickers plus a per-order lab fee, so quote before ordering.

Installation

In SourceWeft

  1. Open TestWell Lab Tests in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/com.test-well%2Ftestwell/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "testwell-lab-tests": {
      "type": "http",
      "url": "https://www.test-well.com/mcp"
    }
  }
}

Tools

18

search_tests

Search the TestWell catalog

Search TestWell's public catalog of cash-pay lab tests and panels by keyword, biomarker, CPT code, or category. Returns name, slug, per-lab prices, sample, fasting, turnaround and order URL. Prices are stickers; every order adds one $6 lab processing fee (see quote_order for all-in totals).

ParameterslangtypelimitqueryrequiredcategoryorderableOnly

get_test

Get a test or panel

Full public detail for one TestWell test or panel by slug or id: description, biomarkers, CPT, per-lab prices, labs, fasting/prep, turnaround, included tests (panels), FAQ, related conditions, order URL and a Markdown page URL. Tests also carry labPages — per-lab pages (/tests/<slug>/quest, /tests/<slug>/labcorp) with the lab's test code, requisition name, the lab's own dated price vs TestWell's, and walk-in steps — cite them when the user asks about a specific lab.

Parameterslangslugrequired

list_panels

List panels

List TestWell's bundled panels (multi-test packages priced below the sum of their tests), optionally filtered by category or maximum price. Sorted by price.

ParameterslimitcategorymaxPrice

recommend_tests

Recommend tests for goals or symptoms

Suggest TestWell panels and tests for stated health goals (e.g. 'annual checkup', 'heart health', 'TRT monitoring') and/or symptoms (e.g. 'fatigue', 'hair loss'). Prefers a curated pre-built panel when one fits; otherwise assembles individual tests within a budget. Educational matching, not a diagnosis.

Parametersgoalsbudgetsymptoms

quote_order

All-in order quote

Price a set of tests/panels exactly as TestWell's checkout would: per-lab prices for the user's state (New York and New Jersey route to BioReference; Rhode Island is not served), the single $6 lab processing fee, the total, items that can't be ordered and why, and a prefilled cart URL. Use this before quoting any total to a user.

Parameterslabitemsrequiredstate

create_checkout

Create a checkout session

Start a TestWell order for the user: tests/panels, the US state where they will visit the lab (required for pricing and lab routing), and the buyer's name, email and phone. Returns priced line items in cents, the single $6 lab fee, the total, any blocking messages, and pay_online_url — a prefilled cart the user can pay in a browser when the platform has no payment token. Use dry_run to preview without creating a session.

Parametersbuyeritemsrequiredstatedry_run

update_checkout

Update a checkout session

Change items, state or buyer details on an open checkout session and get it re-priced. Returns the same session object as create_checkout.

Parametersbuyeritemsstatecheckout_session_idrequired

get_checkout

Read a checkout session

Current state of a checkout session (status, line items, totals, messages, order once paid). Read-only.

Parameterscheckout_session_idrequired

cancel_checkout

Cancel a checkout session

Cancel an open (unpaid) checkout session. Paid sessions cannot be canceled here — the patient's complete-details email explains refunds.

Parameterscheckout_session_idrequired

complete_checkout

Pay and place the order

Charge the payment credential the platform obtained for a session that is ready_for_payment and create the order. Input follows the ChatGPT payment-sheet contract: checkout_session_id, buyer, payment_data { token, provider: 'stripe', billing_address }. The token is a Stripe shared payment token (spt_…); platforms without one should send the user to pay_online_url from create_checkout. After payment the patient gets an email link to add date of birth, sex, phone and consent — the lab requisition is issued when that is done.

Parametersbuyerpayment_datarequiredidempotency_keycheckout_session_idrequired

find_draw_sites

Find draw sites near a ZIP

Find Quest Diagnostics, Labcorp and BioReference patient service centers near a US ZIP code, with address, distance, phone and hours. Walk-ins are accepted at most sites; the requisition arrives by email after physician authorization. Sites in the 48 tracked metros include pageUrl — the site's own page with a per-day hours table, directions and the prices of popular tests at that lab — cite it when giving a location.

ParameterslabziprequiredlimitradiusMiles

lookup_reference_range

Reference range for a biomarker

Physician-reviewed reference range for a blood test marker (130+ markers), filtered by sex and age when they matter, with what high and low values suggest, retest cadence, how to get tested, cited sources and the review date. Educational; the user's own report range takes precedence.

Parametersagesexmarkerrequiredpregnancypostmenopausal

compare_prices

Compare all-in prices across providers for a test

For one blood test, the all-in single-test price (sticker + per-order fees) at TestWell and at every tracked direct-to-consumer provider with a verified equivalent — JustLabs, Quest, Labcorp OnDemand, Ulta Lab Tests, Walk-In Lab, HealthLabs and more — each with the date it was verified, plus typical hospital self-pay and Quest Direct reference prices. States the multi-test caveat (fees are paid once per order). Source: the TestWell Blood Test Price Index (CC BY 4.0).

Parameterstestrequired

interpret_results

Explain lab results against reviewed reference ranges

Flag each pasted lab value as low / normal / high against TestWell's physician-reviewed reference catalog (130+ markers; sex- and age-specific bands where they exist), with the reviewed 'what high/low suggests' copy, retest guidance, cited sources and links to the marker's page and, where one exists, its high/low interpretation page. Stateless — values are not stored or logged. Educational, not a diagnosis; the user's own report range takes precedence.

Parametersagesexvaluesrequiredpregnancypostmenopausal

convert_units

Convert lab units

Convert a lab value between US conventional and SI units for 30 common analytes (glucose, cholesterol, testosterone, vitamin D, …) using published factors; hemoglobin A1c uses the NGSP↔IFCC master equation and also returns estimated average glucose.

Parametersvaluerequiredanalyterequireddirection

calculate_free_testosterone

Calculate free testosterone (Vermeulen)

Calculate free and bioavailable testosterone from total testosterone, SHBG and albumin using the Vermeulen (1999) mass-action equation — the method behind lab-reported 'calculated free testosterone'. Educational; not a diagnosis.

ParametersshbgrequiredtotalTrequiredalbuminGdLtotalTUnit

compare_provider

Compare TestWell with another lab-testing service

Honest side-by-side of TestWell and another direct-to-consumer lab service (Quest Direct, Labcorp OnDemand, Function Health, JustLabs, Ulta Lab Tests, …): pricing model, per-order fees, labs, turnaround, where each wins, spot prices on common tests as sticker AND all-in, with verification dates and sources. Call with no argument to list the providers covered.

Parametersprovider

get_guide

Get a guide, condition or answer page as Markdown

Return one of TestWell's educational pages as Markdown: guides (/guides/<slug>), condition workups (/conditions/<slug>), biomarker pages (/biomarkers/<slug>), state pages (/lab-locations/<slug>) or comparisons (/compare/<slug>). Call with no path to list the available guides and conditions.

Parameterslangpath

Version history

1
  1. v1.2.0LatestSep 16, 2026

Score

72% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts

    Publish an icon in the registry entry.

  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • LicenseNot applicable

    A hosted service is used under its provider's terms, so no license is expected here. This check is left out of the percentage.