TestWell Lab Tests

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