Back to TestWell Lab Tests
Card snapshot
test-well.com
·
2026-10-02 05:33:41 UTC
·
989d941b0c505e1c5f233f47b5ea298985bea7dfa8109112bd5cb887cc1394d3
This is a frozen copy of the agent's agent-card.json as we observed it at the timestamp above. We capture a new snapshot every time the card's content hash changes. Useful for: forensic drift analysis, verifying downstream callers see the right version, reproducing routing decisions made historically.
{
"name": "TestWell Lab Tests",
"description": "Cash-pay lab tests without insurance: search TestWell's catalog, get all-in quotes by state (Quest, Labcorp, BioReference in NY/NJ), find draw sites by ZIP, look up physician-reviewed reference ranges, convert units, calculate free testosterone, compare providers and read guides. Read-only; purchases complete on test-well.com.",
"url": "https://www.test-well.com/api/agent",
"preferredTransport": "HTTP+JSON",
"additionalInterfaces": [
{
"url": "https://www.test-well.com/api/agent",
"transport": "HTTP+JSON"
},
{
"url": "https://www.test-well.com/mcp",
"transport": "MCP"
}
],
"provider": {
"organization": "TestWell",
"url": "https://www.test-well.com"
},
"version": "1.2.0",
"protocolVersion": "0.3.0",
"documentationUrl": "https://www.test-well.com/developers",
"iconUrl": "https://www.test-well.com/logo-mark.svg",
"capabilities": {
"streaming": false,
"pushNotifications": false,
"stateTransitionHistory": false
},
"securitySchemes": {},
"security": [],
"defaultInputModes": [
"application/json",
"text/plain"
],
"defaultOutputModes": [
"application/json",
"text/markdown"
],
"skills": [
{
"id": "search_tests",
"name": "Search the TestWell catalog",
"description": "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).",
"tags": [
"catalog",
"lab-tests",
"healthcare",
"pricing"
],
"inputModes": [
"application/json"
],
"outputModes": [
"application/json"
]
},
{
"id": "get_test",
"name": "Get a test or panel",
"description": "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.",
"tags": [
"catalog",
"lab-tests",
"healthcare",
"pricing"
],
"inputModes": [
"application/json"
],
"outputModes": [
"application/json"
]
},
{
"id": "list_panels",
"name": "List panels",
"description": "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.",
"tags": [
"catalog",
"lab-tests",
"healthcare",
"pricing"
],
"inputModes": [
"application/json"
],
"outputModes": [
"application/json"
]
},
{
"id": "recommend_tests",
"name": "Recommend tests for goals or symptoms",
"description": "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.",
"tags": [
"catalog",
"lab-tests",
"healthcare",
"pricing"
],
"inputModes": [
"application/json"
],
"outputModes": [
"application/json"
]
},
{
"id": "quote_order",
"name": "All-in order quote",
"description": "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.",
"tags": [
"quote",
"lab-tests",
"healthcare",
"pricing"
],
"inputModes": [
"application/json"
],
"outputModes": [
"application/json"
]
},
{
"id": "create_checkout",
"name": "Create a checkout session",
"description": "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 \u2014 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.",
"tags": [
"checkout",
"lab-tests",
"healthcare",
"pricing"
],
"inputModes": [
"application/json"
],
"outputModes": [
"application/json"
]
},
{
"id": "update_checkout",
"name": "Update a checkout session",
"description": "Change items, state or buyer details on an open checkout session and get it re-priced. Returns the same session object as create_checkout.",
"tags": [
"checkout",
"lab-tests",
"healthcare",
"pricing"
],
"inputModes": [
"application/json"
],
"outputModes": [
"application/json"
]
},
{
"id": "get_checkout",
"name": "Read a checkout session",
"description": "Current state of a checkout session (status, line items, totals, messages, order once paid). Read-only.",
"tags": [
"checkout",
"lab-tests",
"healthcare",
"pricing"
],
"inputModes": [
"application/json"
],
"outputModes": [
"application/json"
]
},
{
"id": "cancel_checkout",
"name": "Cancel a checkout session",
"description": "Cancel an open (unpaid) checkout session. Paid sessions cannot be canceled here \u2014 the patient's complete-details email explains refunds.",
"tags": [
"checkout",
"lab-tests",
"healthcare",
"pricing"
],
"inputModes": [
"application/json"
],
"outputModes": [
"application/json"
]
},
{
"id": "complete_checkout",
"name": "Pay and place the order",
"description": "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_\u2026); 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 \u2014 the lab requisition is issued when that is done.",
"tags": [
"checkout",
"lab-tests",
"healthcare",
"pricing"
],
"inputModes": [
"application/json"
],
"outputModes": [
"application/json"
]
},
{
"id": "find_draw_sites",
"name": "Find draw sites near a ZIP",
"description": "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.",
"tags": [
"locations",
"lab-tests",
"healthcare",
"pricing"
],
"inputModes": [
"application/json"
],
"outputModes": [
"application/json"
]
},
{
"id": "lookup_reference_range",
"name": "Reference range for a biomarker",
"description": "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.",
"tags": [
"reference",
"lab-tests",
"healthcare",
"pricing"
],
"inputModes": [
"application/json"
],
"outputModes": [
"application/json"
]
},
{
"id": "compare_prices",
"name": "Compare all-in prices across providers for a test",
"description": "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 \u2014 JustLabs, Quest, Labcorp OnDemand, Ulta Lab Tests, Walk-In Lab, HealthLabs and more \u2014 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).",
"tags": [
"compare",
"lab-tests",
"healthcare",
"pricing"
],
"inputModes": [
"application/json"
],
"outputModes": [
"application/json"
]
},
{
"id": "interpret_results",
"name": "Explain lab results against reviewed reference ranges",
"description": "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 \u2014 values are not stored or logged. Educational, not a diagnosis; the user's own report range takes precedence.",
"tags": [
"reference",
"lab-tests",
"healthcare",
"pricing"
],
"inputModes": [
"application/json"
],
"outputModes": [
"application/json"
]
},
{
"id": "convert_units",
"name": "Convert lab units",
"description": "Convert a lab value between US conventional and SI units for 30 common analytes (glucose, cholesterol, testosterone, vitamin D, \u2026) using published factors; hemoglobin A1c uses the NGSP\u2194IFCC master equation and also returns estimated average glucose.",
"tags": [
"reference",
"lab-tests",
"healthcare",
"pricing"
],
"inputModes": [
"application/json"
],
"outputModes": [
"application/json"
]
},
{
"id": "calculate_free_testosterone",
"name": "Calculate free testosterone (Vermeulen)",
"description": "Calculate free and bioavailable testosterone from total testosterone, SHBG and albumin using the Vermeulen (1999) mass-action equation \u2014 the method behind lab-reported 'calculated free testosterone'. Educational; not a diagnosis.",
"tags": [
"reference",
"lab-tests",
"healthcare",
"pricing"
],
"inputModes": [
"application/json"
],
"outputModes": [
"application/json"
]
},
{
"id": "compare_provider",
"name": "Compare TestWell with another lab-testing service",
"description": "Honest side-by-side of TestWell and another direct-to-consumer lab service (Quest Direct, Labcorp OnDemand, Function Health, JustLabs, Ulta Lab Tests, \u2026): 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.",
"tags": [
"compare",
"lab-tests",
"healthcare",
"pricing"
],
"inputModes": [
"application/json"
],
"outputModes": [
"application/json"
]
},
{
"id": "get_guide",
"name": "Get a guide, condition or answer page as Markdown",
"description": "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.",
"tags": [
"content",
"lab-tests",
"healthcare",
"pricing"
],
"inputModes": [
"application/json"
],
"outputModes": [
"application/json"
]
}
],
"supportsAuthenticatedExtendedCard": false,
"alternates": {
"mcpServerCard": "https://www.test-well.com/.well-known/mcp/server-card.json",
"openapi": "https://www.test-well.com/openapi.json",
"agentSkills": "https://www.test-well.com/.well-known/agent-skills/index.json",
"llmsTxt": "https://www.test-well.com/llms.txt"
},
"trust": {
"verifiedReviews": 87,
"averageRating": 4.9,
"source": "First-party reviews tied to real, moderated orders"
}
}