Documentación

Cómo usar biomarkers.sh desde tu navegador o vía MCP.

Primeros pasos

Regístrate y configura biomarkers.sh como servidor MCP en el cliente de tu preferencia.

1. Regístrate

Ejecuta el siguiente comando para autenticarte con tu email:

terminal

npx biomarkers-sh signup

2. Configura tu cliente MCP

Auto-configura tu cliente MCP, o agrega manualmente:

terminal

npx biomarkers-sh setup-mcp

Agrega lo siguiente a tu archivo de configuración MCP:

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

Autenticación

El servidor usa un modelo de acceso de dos niveles. Las herramientas de solo lectura (list_studies, get_study_details) son públicas. Las herramientas de escritura (create_checkout, get_order_status) requieren un token Bearer.

Público

list_studiesget_study_detailsbiomarkers://catalog

Auth requerido

create_checkoutget_order_status

Herramientas disponibles

Herramientas expuestas por el servidor MCP de biomarkers.sh.

list_studiesExplorar el catálogo de estudios

Parámetros:

category string? — Filtrar por categoríasearch string? — Buscar por nombre o biomarcadorlimit number? — Máximo de resultados (por defecto 20)offset number? — Desplazamiento de paginación

get_study_detailsInformación completa del estudio incluyendo todos los biomarcadores

Parámetros:

slug string — Identificador slug del estudio

create_checkoutCrear una sesión de pago con datos del paciente (auth requerido)

Parámetros:

study_ids string[] — Array de IDs de estudios a compraremail string? — Email del cliente (usa el email autenticado por defecto)first_name string — Nombre(s) del pacientepaternal_surname string — Apellido paterno del pacientematernal_surname string — Apellido materno del pacientedate_of_birth string — Fecha de nacimiento (YYYY-MM-DD)phone_number string — Número de teléfono del paciente

get_order_statusRastrear una orden existente

Parámetros:

order_id string? — ID interno de la ordensession_id string? — ID de sesión de Stripe checkout

Ejemplo de uso

Un flujo de conversación típico de un agente usando las herramientas MCP.

conversation example

Usuario:

¿Qué paneles de tiroides tienen?

El agente llama: list_studies({ category: "thyroid" })

Agente:

Encontré el Panel Tiroideo ($69.99) que incluye TSH, T3 Libre, T4 Libre, Captación de T3 y Anticuerpos Peroxidasa Tiroidea. Resultados en 3–5 días. ¿Quieres que configure una compra?

Usuario:

Sí, me llamo Juan García López, nacido el 15 de marzo de 1990. Usa john@example.com

El agente llama:

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

Agente:

Tu enlace de pago está listo: https://checkout.stripe.com/...

Recursos

Recursos MCP expuestos por el servidor.

biomarkers://catalogCatálogo completo de estudios como datos estructurados

Un recurso JSON legible por máquinas que contiene todos los estudios disponibles, sus biomarcadores, precios y metadatos. Útil para agentes que necesitan razonar sobre el catálogo completo antes de hacer llamadas a herramientas.