Skip to main content
Glama
README.md
# PeptideCalc MCP Server

The official Model Context Protocol (MCP) server for [PeptideCalculatorOnline.com](https://peptidecalculatoronline.com). 

This server empowers AI assistants (like Claude, Cursor, and ChatGPT) with precise, clinical-grade mathematical logic for calculating peptide reconstitution matrices, avoiding the dangerous "hallucination" of dosages by LLMs.

## 🚀 Key Features

* **Absolute Math Accuracy:** Replaces LLM guess-work with the deterministic algebraic mapping used on our official calculator ($V_{draw} = \frac{D}{C}$).
* **U-100 Syringe Mapping:** Automatically converts complex dosages into exact "Unit" pulls for standard U-100 insulin syringes.
* **Standard Protocols:** Instant access to widely accepted laboratory research protocols for compounds like Semaglutide, BPC-157, TB-500, Tirzepatide, etc.
* **Plunger Parallax Guidelines:** Educates researchers on volumetric resolution and how to avoid hyper-condensed solutions.

## 🔗 Official Links

* **Website:** [https://peptidecalculatoronline.com](https://peptidecalculatoronline.com)
* **Interactive Calculators:** [Semaglutide](https://peptidecalculatoronline.com/semaglutide-reconstitution-calculator/), [BPC-157](https://peptidecalculatoronline.com/bpc-157-dosage-calculator/), [TB-500](https://peptidecalculatoronline.com/tb-500-dosage-calculator/)
* **Custom Protocol Planner:** [4-Week Injection Schedule Generator](https://peptidecalculatoronline.com/peptide-protocol-planner/)

## 🛠 Available Tools

1. `calculate_reconstitution_dose`: Input peptide (mg), bacteriostatic water (ml), and desired dose (mg). Returns the exact concentration (mg/ml) and U-100 syringe units.
2. `get_peptide_protocol`: Input a standard analog name (e.g., `semaglutide`, `bpc-157`) to receive standard starting titrations and matrices.
3. `get_syringe_mechanics_guide`: Learn about standard operating procedures to reduce dosage errors.

## 💻 Installation

### For Claude Desktop

Add the following to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "peptidecalc": {
      "command": "npx",
      "args": [
        "-y",
        "peptidecalc-mcp"
      ]
    }
  }
}
```

### For Cursor

1. Open Cursor Settings.
2. Navigate to **Features** -> **MCP**.
3. Click **Add New MCP Server**.
4. Type: `stdio`
5. Command: `npx -y peptidecalc-mcp`

## 🏗 Development

```bash
# Install dependencies
npm install

# Build the project
npm run build

# Run locally for testing (MCP Inspector)
npx @modelcontextprotocol/inspector node build/index.js
```

## ⚠️ Disclaimer
**Research Use Only.** The mathematical outputs provided by this MCP server are strictly for educational and laboratory research purposes. Not for human consumption. Always consult a licensed medical professional.

TDQS

A3.7/5.0

Scored across 3 tools

Disambiguation5/5

Each tool targets a distinct aspect: reconstitution calculation, protocol reference, and syringe mechanics. There is no overlap or ambiguity between them.

Naming Consistency5/5

All tool names follow a consistent verb_noun pattern (calculate_, get_, get_), using lowercase with underscores throughout.

Tool Count5/5

Three tools is well-scoped for a focused peptide calculation server, each earning its place without being too few or too many.

Completeness4/5

The surface covers the core workflow of reconstitution dosing, protocol lookup, and syringe accuracy. Minor gaps like peptide storage or molecular weight calculation exist but are not critical to the stated purpose.

Maintenance

ActivityMaintained
ResponsivenessSyncing