curo-peptides 0.0.0-stage → 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Curo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,113 @@
-# Temporary Holding Version
+# Curo Peptide Research MCP: PepBank Studies, Peptide Lookup and Lab Reports (COAs)
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+[![MCP Badge](https://lobehub.com/badge/mcp/curo-you-peptides-peptide-research-mcp)](https://lobehub.com/mcp/curo-you-peptides-peptide-research-mcp)
+[![Curo Peptide Research MCP connector](https://glama.ai/mcp/connectors/you.curo/peptide-research/badges/score.svg)](https://glama.ai/mcp/connectors/you.curo/peptide-research)
+[![skills.sh](https://skills.sh/b/curo-you-peptides/peptide-research-mcp)](https://skills.sh/curo-you-peptides/peptide-research-mcp)
+
+Peptide research for your AI: PepBank study findings plus the curo.you peptide catalog and lot COAs.
+
+Curo MCP connects your AI to peptide research and to Curo (https://curo.you). Add it to Claude, ChatGPT, Gemini, Grok, Perplexity or another MCP app. Your AI can then answer peptide questions from PepBank (https://pepbank.io), a free peptide research database, with study summaries, findings and a link to each source. It can also look up peptides in the Curo catalog (https://curo.you/product-catalog), with the third-party lab report for each lot (https://curo.you/coa), prices, stock and shipping. Server address: https://mcp.curo.you. Setup guide: https://curo.you/mcp.
+
+## Server address
+
+```
+https://mcp.curo.you
+```
+
+Transport: Streamable HTTP. The server runs at this address. `https://mcp.curo.you/mcp` reaches the same server. This repository holds its listing files.
+
+## Add it to your AI app
+
+Claude: open Customize, then Connectors. Select Add custom connector. Name it Curo and enter `https://mcp.curo.you`.
+
+ChatGPT: open Plugins. Select +, then Add custom MCP server. Name it Curo and enter `https://mcp.curo.you`.
+
+Claude Code:
+
+```
+claude mcp add --transport http curo https://mcp.curo.you
+```
+
+Codex (`config.toml`):
+
+```toml
+[mcp_servers.curo]
+url = "https://mcp.curo.you"
+```
+
+Gemini CLI (`settings.json`):
+
+```json
+{ "mcpServers": { "curo": { "httpUrl": "https://mcp.curo.you" } } }
+```
+
+Steps for Gemini, Grok, Perplexity, Muse and other apps: https://curo.you/mcp
+
+## Command line and local server (npm)
+
+The `curo-peptides` package runs the same server over stdio for apps that need a local server, and answers from the terminal:
+
+```
+npx curo-peptides research BPC-157
+npx curo-peptides search tendon healing
+npx curo-peptides products
+npx curo-peptides coa <lot number>
+```
+
+Local server config for MCP apps:
+
+```json
+{ "mcpServers": { "curo": { "command": "npx", "args": ["-y", "curo-peptides"] } } }
+```
+
+## Tools
+
+| Tool | What it does |
+|---|---|
+| `peptide_research` | Reads the PepBank summary, main findings, sources and credit for one peptide |
+| `search_research` | Searches PepBank study findings, with sources and credit for each result |
+| `search_products` | Finds Curo products by name, or lists all products |
+| `get_product` | Reads product variants, prices, stock and lot reports |
+| `get_coa` | Reads the lab reports for a lot number or a product |
+| `get_store_info` | Reads shipping, returns, contact and research-use policies |
+| `build_cart` | Makes a cart link. You check out and pay on curo.you |
+
+## Prompts and resources
+
+| Name | Type | What it does |
+|---|---|---|
+| `research_peptide` | Prompt | Asks what the research says about one peptide |
+| `lab_report` | Prompt | Asks for the lab report (COA) of one lot |
+| `curo://store-info` | Resource | Shipping, returns, contact and research-use policies |
+
+## Plugin package
+
+This repository is also a plugin package that connects the server and adds one skill, `skills/curo-peptide-research/SKILL.md`.
+
+- `plugin.json` and `mcp.json`: Agent Plugins format (Hermes Agent)
+- `.claude-plugin/plugin.json` and `.mcp.json`: Claude Code plugin format
+- `.cursor-plugin/plugin.json`: Cursor plugin format
+- `openclaw.plugin.json`: OpenClaw (ClawHub)
+
+Install the skill with the `skills` CLI:
+
+```
+npx skills add curo-you-peptides/peptide-research-mcp
+```
+
+## Questions to try
+
+- What does the research say about TB-500?
+- Show me the lab report for my lot number.
+- Which Curo peptides are in stock right now?
+- How long does shipping take?
+
+## Links
+
+- Curo: https://curo.you
+- Peptide catalog: https://curo.you/product-catalog
+- Lab reports (COAs): https://curo.you/coa
+- PepBank: https://pepbank.io
+- Official MCP Registry entry: [`you.curo/peptide-research`](https://registry.modelcontextprotocol.io/?q=you.curo)
+
+Curo products are for laboratory research use only. Nothing here is medical advice.

package/bin/curo-peptides.mjs

@@ -0,0 +1,130 @@
+#!/usr/bin/env node
+// Curo Peptide Research: a command-line tool and a local (stdio) bridge to the
+// Curo MCP server at https://mcp.curo.you. No dependencies. Node 18 or later.
+import { createInterface } from "node:readline";
+
+const VERSION = "1.0.0";
+const SERVER = process.env.CURO_MCP_URL || "https://mcp.curo.you/mcp";
+const HELP = `curo-peptides ${VERSION}
+Peptide research for your AI: PepBank study findings plus the curo.you peptide catalog and lot COAs.
+
+Usage:
+  curo-peptides                     Run the Curo MCP server over stdio (for MCP apps)
+  curo-peptides research <peptide>  PepBank research brief for one peptide
+  curo-peptides search <words>      Search PepBank study findings
+  curo-peptides products [name]     Curo products, prices and stock
+  curo-peptides coa <lot|product>   Lab reports (COAs) for a lot or product
+  curo-peptides store               Shipping, returns, contact and research-use policies
+  Add --json to print the raw result.
+
+Setup guide: https://curo.you/mcp
+Curo products are for laboratory research use only. Nothing here is medical advice.`;
+
+// One JSON-RPC call to the server. The server answers with JSON or with SSE "data:" lines.
+async function post(message, userAgent) {
+  const response = await fetch(SERVER, {
+    method: "POST",
+    headers: { "content-type": "application/json", accept: "application/json, text/event-stream", "user-agent": userAgent },
+    body: JSON.stringify(message),
+  });
+  const text = await response.text();
+  if (!text.trim()) return [];
+  if (text.trimStart().startsWith("{") || text.trimStart().startsWith("[")) return [].concat(JSON.parse(text));
+  return text.split("\n").filter((line) => line.startsWith("data: ")).map((line) => JSON.parse(line.slice(6)));
+}
+
+// Stdio bridge: each line on stdin is one JSON-RPC message; each reply goes to stdout as one line.
+function bridge() {
+  let userAgent = `curo-peptides/${VERSION}`;
+  const lines = createInterface({ input: process.stdin });
+  lines.on("line", async (line) => {
+    if (!line.trim()) return;
+    let message;
+    try { message = JSON.parse(line); } catch { return; }
+    // Pass the app name on, so Curo can tell which app sent the visit.
+    if (message.method === "initialize" && message.params?.clientInfo?.name) userAgent = `curo-peptides/${VERSION} (${message.params.clientInfo.name})`;
+    try {
+      for (const reply of await post(message, userAgent)) process.stdout.write(`${JSON.stringify(reply)}\n`);
+    } catch (error) {
+      if (message.id !== undefined) process.stdout.write(`${JSON.stringify({ jsonrpc: "2.0", id: message.id, error: { code: -32603, message: `Curo MCP server not reachable: ${error.message}` } })}\n`);
+    }
+  });
+}
+
+async function tool(name, args) {
+  const [reply] = await post({ jsonrpc: "2.0", id: 1, method: "tools/call", params: { name, arguments: args } }, `curo-peptides-cli/${VERSION}`);
+  if (reply?.error) throw new Error(reply.error.message);
+  return JSON.parse(reply.result.content[0].text);
+}
+
+const usd = (price) => `$${price}`;
+const productLine = (p) => `- ${p.name} ${p.variant}: ${usd(p.price)}, ${p.stock === "in_stock" ? "in stock" : "out of stock"}. Each lot has a lab report. ${p.buy_link}`;
+
+function printCuro(curo) {
+  if (!curo?.length) return;
+  console.log("\nAt Curo:");
+  for (const p of curo) console.log(productLine(p));
+}
+
+const commands = {
+  async research(words) {
+    const data = await tool("peptide_research", { peptide: words.join(" ") });
+    if (!data.research && data.note) { console.log(data.note); printCuro(data.curo); return data; }
+    const e = data.evidence_summary ?? {};
+    console.log(`${data.peptide?.preferred_name ?? words.join(" ")}`);
+    console.log(`Evidence: ${e.human?.findings ?? 0} human, ${e.animal?.findings ?? 0} animal and ${e.laboratory?.findings ?? 0} lab findings. ${e.trials?.total ?? 0} registered trials.`);
+    for (const n of data.notices ?? []) console.log(`Note: ${n.text}`);
+    console.log("\nKey findings:");
+    for (const f of data.key_findings ?? []) console.log(`- [${f.evidence_class}] ${f.statement}${f.citation?.url ? ` ${f.citation.url}` : ""}`);
+    if (data.credit?.line) console.log(`\n${data.credit.line}`);
+    printCuro(data.curo);
+    return data;
+  },
+  async search(words) {
+    const data = await tool("search_research", { query: words.join(" ") });
+    for (const r of data.results ?? []) console.log(`- [${r.evidence_class}] ${r.claim?.statement_plain ?? r.claim?.statement}`);
+    if (data.credit?.line) console.log(`\n${data.credit.line}`);
+    printCuro(data.curo);
+    return data;
+  },
+  async products(words) {
+    const data = await tool("search_products", words.length ? { query: words.join(" ") } : {});
+    for (const p of data.products ?? []) console.log(productLine(p));
+    return data;
+  },
+  async coa(words) {
+    const data = await tool("get_coa", { query: words.join(" ") });
+    if (!data.reports?.length) console.log("No lab report found. See all reports: https://curo.you/coa");
+    for (const r of data.reports ?? []) {
+      const results = [r.purityPercent != null && `purity ${r.purityPercent}%`, r.identityStatus && `identity ${r.identityStatus}`, r.resultStatus && r.resultStatus !== "published" && `result ${r.resultStatus}`].filter(Boolean).join(", ");
+      console.log(`- ${r.label ?? r.productId}, lot ${r.lot}, ${r.reportDate}${results ? `: ${results}` : ""}. ${r.report_link ?? ""}`);
+    }
+    return data;
+  },
+  async store() {
+    const data = await tool("get_store_info", {});
+    for (const [key, value] of Object.entries(data)) console.log(`${key.replace(/_/g, " ")}: ${value.link}`);
+    return data;
+  },
+};
+
+const args = process.argv.slice(2);
+const json = args.includes("--json");
+const [command, ...words] = args.filter((a) => a !== "--json");
+
+if (!command || command === "mcp") bridge();
+else if (command === "help" || command === "--help" || command === "-h") console.log(HELP);
+else if (command === "--version" || command === "-v") console.log(VERSION);
+else if (!commands[command]) { console.error(`Unknown command: ${command}\n\n${HELP}`); process.exit(1); }
+else if (command !== "products" && command !== "store" && !words.length) { console.error(`Usage: curo-peptides ${command} <words>`); process.exit(1); }
+else {
+  const log = console.log;
+  if (json) console.log = () => {};
+  try {
+    const data = await commands[command](words);
+    if (json) log(JSON.stringify(data, null, 2));
+  } catch (error) {
+    console.error(`Curo MCP server error: ${error.message}`);
+    process.exit(1);
+  }
+}

package/package.json

@@ -1,6 +1,16 @@
 {
   "name": "curo-peptides",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0",
+  "description": "Peptide research for your AI: PepBank study findings plus the curo.you peptide catalog and lot COAs.",
+  "keywords": ["peptides", "peptide-research", "pepbank", "coa", "lab-reports", "mcp", "mcp-server", "model-context-protocol"],
+  "homepage": "https://curo.you/mcp",
+  "repository": { "type": "git", "url": "git+https://github.com/curo-you-peptides/peptide-research-mcp.git" },
+  "bugs": { "url": "https://github.com/curo-you-peptides/peptide-research-mcp/issues" },
+  "author": { "name": "Curo", "email": "info@curo.you", "url": "https://curo.you" },
+  "license": "MIT",
+  "type": "module",
+  "bin": { "curo-peptides": "bin/curo-peptides.mjs" },
+  "files": ["bin/", "README.md", "LICENSE"],
+  "engines": { "node": ">=18" },
+  "mcpName": "you.curo/peptide-research"
+}