Documentation

How to use biomarkers.sh from your browser or via MCP.

Getting Started

1. Sign up

Run the following command to authenticate with your email:

terminal

npx biomarkers-sh signup

2. Configure your MCP client

Auto-configure your MCP client, or add manually:

terminal

npx biomarkers-sh setup-mcp

Add the following to your MCP configuration file:

Claude Desktop — claude_desktop_config.json

{
  "mcpServers": {
    "biomarkers": {
      "url": "https://biomarkers.sh/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Cursor — .cursor/mcp.json

{
  "mcpServers": {
    "biomarkers": {
      "url": "https://biomarkers.sh/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Claude Code — ~/.claude.json

{
  "mcpServers": {
    "biomarkers": {
      "url": "https://biomarkers.sh/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Authentication

The server uses a two-tier access model. Read-only tools (list_studies, get_study_details) are public. Write tools (create_checkout, get_order_status) require a Bearer token.

Public

list_studiesget_study_detailsbiomarkers://catalog

Auth required

create_checkoutget_order_status

Available Tools

Tools exposed by the biomarkers.sh MCP server.

list_studiesBrowse the study catalog

Parameters:

category string? — Filter by categorysearch string? — Search by name or biomarkerlimit number? — Max results (default 20)offset number? — Pagination offset

get_study_detailsFull study info including all biomarkers

Parameters:

slug string — Study slug identifier

create_checkoutCreate a checkout session with patient data (auth required)

Parameters:

study_ids string[] — Array of study IDs to purchaseemail string? — Customer email (defaults to authenticated email)first_name string — Patient first name(s)paternal_surname string — Patient paternal surnamematernal_surname string — Patient maternal surnamedate_of_birth string — Date of birth (YYYY-MM-DD)phone_number string — Patient phone number

get_order_statusTrack an existing order

Parameters:

order_id string? — Internal order IDsession_id string? — Stripe checkout session ID

Example Usage

A typical agent conversation flow using the MCP tools.

conversation example

User:

What thyroid panels do you have?

Agent calls: list_studies({ category: "thyroid" })

Agent:

I found the Thyroid Panel ($69.99) which includes TSH, Free T3, Free T4, T3 Uptake, and Thyroid Peroxidase Antibodies. Results in 3–5 days. Want me to set up a purchase?

User:

Yes, my name is Juan Garcia Lopez, born March 15, 1990. Use john@example.com

Agent calls:

create_checkout({
  study_ids: ["thyroid-panel-uuid"],
  first_name: "Juan",
  paternal_surname: "Garcia",
  maternal_surname: "Lopez",
  date_of_birth: "1990-03-15",
  phone_number: "5551234567",
  email: "john@example.com"
})

Agent:

Your checkout link is ready: https://checkout.stripe.com/...

Resources

MCP resources exposed by the server.

biomarkers://catalogFull study catalog as structured data

A machine-readable JSON resource containing all available studies, their biomarkers, pricing, and metadata. Useful for agents that need to reason over the full catalog before making tool calls.