Give your AI the real JustLabs prices.

The pricing rule

An order costs the sum of its test and panel prices plus ONE $18 lab & physician order fee (Quest blood draw + independent physician order), charged once per order however many items it holds. Orders are not accepted from NY, NJ, RI or HI.

MCP App

Remote MCP server, StreamableHTTP transport, no authentication: https://mcp.justlabs.health/mcp. In MCP Apps-capable clients such as Claude and ChatGPT, every tool also renders an interactive widget — test cards, panel comparisons and a cart that hands off to justlabs.health. Other clients get the same data as text.

claude mcp add --transport http justlabs https://mcp.justlabs.health/mcp

{
  "mcpServers": {
    "justlabs": {
      "type": "http",
      "url": "https://mcp.justlabs.health/mcp"
    }
  }
}

{
  "mcpServers": {
    "justlabs": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.justlabs.health/mcp"
      ]
    }
  }
}

Tools

The older npm stdio package justlabs-mcp-server has a different, legacy tool set and does not compute all-in totals. Prefer the MCP App.

HTTP endpoints

Base URL https://justlabs.health. CORS open, JSON, cached briefly.

• GET/api/public/v1/quote?items=…&state=…

  All-in price of a basket: item prices, the single $18 per-order fee and the total, in integer cents — computed by the same code checkout charges with. Optional state availability and a prefilled cart link.

  Spec

• GET/api/public/v1/availability?state=…&item=…

  Whether JustLabs accepts orders from a state and, with item, whether that test or panel is offered there.

  Spec

• GET/api/catalog

  Compact catalogue for LLM grounding: id, name, price, biomarkers, category, url and a short description per test and panel. Supports ?locale=es and ?utm_medium=<tool>.

• GET/api/tests

  The full public catalogue: every test and panel with its public fields.

  Spec

• GET/cart/handoff?items=…

  Not an API: a link that opens the JustLabs cart prefilled with these ids. Keep utm_source / utm_medium on it for attribution.

• GET/<any public page> with Accept: text/markdown

  A clean Markdown version of the same page: tests, panels, categories, guides, blog articles. Protected pages (dashboard, checkout, login, admin) always return HTML.

Examples

curl -s 'https://justlabs.health/api/public/v1/quote?items=tsh,vitamin-d&state=CA'

curl -s 'https://justlabs.health/api/public/v1/availability?state=NY&item=tsh'

curl -s -H 'Accept: text/markdown' 'https://justlabs.health/tests/tsh'

https://justlabs.health/cart/handoff?items=tsh,vitamin-d&utm_source=ai&utm_medium=<your-tool>

Discovery files

• llms.txt — Plain-language map of the site for language models.
• MCP server card — The MCP App: transport, URL and tools.
• Agent skills index — One SHA-256-addressed SKILL.md per MCP tool.
• API catalog (RFC 9727) — Linkset of the public APIs and their specs.
• OpenAPI: quote & availability — OpenAPI 3.1 for the two /api/public/v1 endpoints.
• OpenAPI: catalogue — OpenAPI 3.1 for /api/tests.

Ordering for patients?

Everything above reads the catalogue and prices. To place Quest lab orders for your users or patients — EHRs, telehealth, clinics, health apps — use the authenticated partner API: create, track and cancel orders, with signed webhooks for requisitions and results, under a signed BAA.

Ground rules

• Read-only. Nothing here places an order or takes a payment; checkout happens on justlabs.health.
• Public catalogue data only. Send catalogue ids and an optional state — never names, contact details, symptoms or lab results.
• Prices are live. Quote the total from the quote endpoint or get-pricing rather than adding the fee by hand.
• Educational, not diagnostic. Symptom → test mappings and test descriptions are not medical advice.
• Rate limited per client IP (60-request burst, about 60 a minute sustained; HTTP 429 with Retry-After). Need more? Email support@justlabs.health.
• Content signals in robots.txt: search=yes, ai-input=yes, ai-train=no. Grounding and citation are welcome; training on the content is not.