Skip to main content
Glama

HRT PK MCP

Hormone Replacement Therapy (HRT) pharmacokinetic blood concentration monitoring MCP tool

Agents can record dosing times through tools and query fitted blood concentrations based on PK algorithms at any time

References the algorithm and data fitting implementation of HRT-Recorder-PKcomponent-Test

Supports multiple administration routes for Estradiol and Testosterone

Quick Start

git clone https://github.com/lfcypo/hrt-pk-mcp
uv sync

uv run hrt-pk-mcp
# 或
python -m pk_mcp

Related MCP server: Personal Agent Intermittent Fasting Autophagy Window Skill

MCP Tools

Tool

Description

log_dose

Record a dose event

query_concentration

Query predicted blood concentration at a specified time point

list_dose_events

List all recorded dose events

remove_event

Delete a specified event by ID

clear_all_events

Clear all dose events

log_dose - Record a dose event

Records a hormone medication event. Each event is persisted and included in the calculation of all subsequent concentration queries.

Parameter

Type

Description

compound

str

Drug compound: E2, EB, EV, EC, EN, T, TC, TE, TU

route

str

Administration route: injection, gel, patch_apply, patch_remove, oral, sublingual

time_h

float

Administration time (hours from the reference start point)

dose_mg

float

Dose (active hormone equivalent, milligrams)

release_rate_ug_per_day

float?

Patch zero-order release rate (µg/d), only used for patch_apply

area_cm2

float?

Gel application area (cm²), only used for gel

sublingual_theta

float?

Proportion of transmucosal fast-pathway absorption for sublingual administration [0-1], only used for sublingual

query_concentration - Query predicted blood concentration at a specified time point

Parameter

Type

Description

time_h

float

Query time point (hours from the reference start point)

hormone

str

Target hormone: estradiol or testosterone

body_weight_kg

float

Body weight (kg, default 70.0; affects distribution volume Vd)

Data Storage

Dose events are persisted in JSON format in the .hrt-pk-data/dose_events.json file in the project directory

Can be inspected, backed up, or migrated across sessions

Pharmacokinetic Algorithm

The pharmacokinetic algorithm and constants in this project reference HRT-Recorder-PKcomponent-Test

For detailed PK algorithms, complete parameter derivation, calibration sources, etc., please refer to HRT-Recorder and pk_research

Supported Compounds and Administration Routes

Estradiol

Compound

Injection

Oral

Sublingual

Gel

Patch

E2 (Estradiol)

—

✓

✓

✓

✓

EB (Estradiol Benzoate)

✓

—

—

—

—

EV (Estradiol Valerate)

✓

✓

✓

—

—

EC (Estradiol Cypionate)

✓

—

—

—

—

EN (Estradiol Enanthate)

✓

—

—

—

—

Testosterone

Compound

Injection

Oral

Gel

Patch

T (Testosterone)

—

—

✓

✓

TC (Testosterone Cypionate)

✓

—

—

—

TE (Testosterone Enanthate)

✓

—

—

—

TU (Testosterone Undecanoate)

✓

✓

—

—

Output Units

  • Estradiol pg/mL pmol/L

  • Testosterone ng/dL ng/mL nmol/L

Cross-validation of Migration

This project has undergone simulated data cross-validation experiments; the results of this project are numerically consistent with the source project's results

python ./test/cross_validate.py

License

This project complies with the MIT License

Acknowledgments

Correction Contact

If you have any questions or suggestions about the pharmacokinetic algorithm part of the project, please file an issue or contact the academic correspondence email research@lfcypo.com

Serious Warning

This project is developed for educational purposes and is only recommended for pharmacokinetic model research, algorithm validation, and data analysis

The blood concentration results output by this project are derived from mathematical model fitting and theoretical parameter calculations, and are not equivalent to real individual blood concentration test results, nor can they replace clinical laboratory testing, pharmacokinetic research, or professional medical evaluation

Not recommended for any clinical medical use, including but not limited to:

  • Guiding users to start, stop, adjust, or change hormone treatment plans;

  • Determining doses of estradiol, testosterone, or other sex hormone medications;

  • Judging whether drug treatment is safe, effective, or achieves treatment goals;

  • Replacing doctors in prescribing, diagnosis, or medical decision-making;

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      B
      maintenance
      Enables AI assistants like Claude to log and delete period and ovulation records, review cycle history and averages, and check the current cycle phase with predictions of the next period and ovulation window. Records are kept in the user's own Supabase instance behind key or OAuth authentication.
      -
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables computing MCTQ mid-sleep chronotype and social jetlag from workday and free-day sleep schedules, then projecting circadian biological phase windows such as CAR peak, focus periods, caffeine cutoff, DLMO, and sleep gate from a target wake time.
      7
      MIT
    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      Enables users to model two-compartment caffeine elimination, estimate adenosine A1/A2A receptor occupancy and slow-wave sleep suppression, and schedule intake windows and cutoffs from wake and bedtime.
      MIT