@hormonaly/mcp-server 1.0.1

package/dist/tools.d.ts

@@ -0,0 +1,460 @@
+/**
+ * All MCP tool definitions and handlers for the Hormonaly platform.
+ */
+import { HoromnalyClient } from "./client.js";
+export declare const TOOL_DEFINITIONS: readonly [{
+    readonly name: "helix_query";
+    readonly description: "Query the Helix AI engine with a clinical question about peptides, hormones, longevity, or aesthetics. Returns an evidence-based answer with GRADE rating, confidence score, citations, and related protocols. Requires a Helix API key.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly question: {
+                readonly type: "string";
+                readonly description: "The clinical question to answer (e.g. 'What is the optimal BPC-157 dose for gut repair?')";
+                readonly maxLength: 10000;
+            };
+            readonly language: {
+                readonly type: "string";
+                readonly enum: readonly ["en", "ar"];
+                readonly default: "en";
+                readonly description: "Response language";
+            };
+            readonly detail_level: {
+                readonly type: "string";
+                readonly enum: readonly ["clinical", "summary"];
+                readonly default: "clinical";
+                readonly description: "Level of detail: 'clinical' for full analysis, 'summary' for a concise overview";
+            };
+            readonly include_citations: {
+                readonly type: "boolean";
+                readonly default: true;
+                readonly description: "Include PubMed citation list in the response";
+            };
+            readonly include_three_lens: {
+                readonly type: "boolean";
+                readonly default: false;
+                readonly description: "Include Three-Lens analysis (longevity / health-disease / performance scoring)";
+            };
+            readonly api_key: {
+                readonly type: "string";
+                readonly description: "Helix API key (overrides HORMONALY_API_KEY env var)";
+            };
+        };
+        readonly required: readonly ["question"];
+    };
+}, {
+    readonly name: "helix_compare";
+    readonly description: "Compare 2–3 compounds head-to-head using the Helix AI engine. Returns a structured comparison with key differences, best-for use cases, and a recommendation. Requires Professional or Enterprise tier Helix API key — Starter keys are blocked with 403 tier_insufficient.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly compounds: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly minItems: 2;
+                readonly maxItems: 3;
+                readonly description: "List of 2 or 3 compound names to compare (e.g. ['semaglutide', 'tirzepatide'])";
+            };
+            readonly indication: {
+                readonly type: "string";
+                readonly default: "General comparison";
+                readonly description: "Clinical indication or context for the comparison";
+            };
+            readonly language: {
+                readonly type: "string";
+                readonly enum: readonly ["en", "ar"];
+                readonly default: "en";
+            };
+            readonly api_key: {
+                readonly type: "string";
+                readonly description: "Helix API key (overrides HORMONALY_API_KEY env var)";
+            };
+        };
+        readonly required: readonly ["compounds"];
+    };
+}, {
+    readonly name: "helix_protocol";
+    readonly description: "Retrieve all protocols for a specific compound from the Helix API. Returns titles, evidence grades, FDA status, and summaries. Requires a Helix API key.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly compound: {
+                readonly type: "string";
+                readonly description: "Compound name (e.g. 'semaglutide', 'BPC-157', 'testosterone')";
+                readonly maxLength: 200;
+            };
+            readonly language: {
+                readonly type: "string";
+                readonly enum: readonly ["en", "ar"];
+                readonly default: "en";
+            };
+            readonly api_key: {
+                readonly type: "string";
+                readonly description: "Helix API key (overrides HORMONALY_API_KEY env var)";
+            };
+        };
+        readonly required: readonly ["compound"];
+    };
+}, {
+    readonly name: "helix_dossier_start";
+    readonly description: "Start generating a full evidence dossier for a compound (async job). Returns a job_id to poll with helix_dossier_status. Requires Professional or Enterprise tier — Starter keys are blocked with 403 tier_insufficient.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly compound: {
+                readonly type: "string";
+                readonly description: "Compound name";
+                readonly maxLength: 500;
+            };
+            readonly language: {
+                readonly type: "string";
+                readonly enum: readonly ["en", "ar"];
+                readonly default: "en";
+            };
+            readonly api_key: {
+                readonly type: "string";
+                readonly description: "Helix API key (overrides HORMONALY_API_KEY env var)";
+            };
+        };
+        readonly required: readonly ["compound"];
+    };
+}, {
+    readonly name: "helix_dossier_status";
+    readonly description: "Check the status of a dossier generation job started with helix_dossier_start. Returns status (processing/completed/failed) and the dossier data when complete.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly job_id: {
+                readonly type: "string";
+                readonly description: "Job ID returned by helix_dossier_start";
+            };
+            readonly api_key: {
+                readonly type: "string";
+                readonly description: "Helix API key (overrides HORMONALY_API_KEY env var)";
+            };
+        };
+        readonly required: readonly ["job_id"];
+    };
+}, {
+    readonly name: "run_clinical_workflow";
+    readonly description: "Run a full multi-agent clinical reasoning workflow on a complex question. This triggers the supervisor/worker pattern: the supervisor decomposes the question, spawns specialized sub-agents (evidence, safety, dosing, regulatory), then synthesizes all findings. Best for complex queries involving multiple compounds, stacking protocols, or high-stakes clinical decisions. Returns the synthesized answer plus sub-agent contributions and orchestration steps.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly question: {
+                readonly type: "string";
+                readonly description: "The complex clinical question (e.g. 'What is the optimal BPC-157 + TB-500 stack for accelerated tendon repair in athletes, accounting for safety and interactions?')";
+                readonly maxLength: 10000;
+            };
+            readonly patient_context: {
+                readonly type: "string";
+                readonly description: "Optional patient context (age, sex, conditions, medications) to personalize the workflow";
+            };
+            readonly language: {
+                readonly type: "string";
+                readonly enum: readonly ["en", "ar"];
+                readonly default: "en";
+            };
+            readonly api_key: {
+                readonly type: "string";
+                readonly description: "Helix API key (overrides HORMONALY_API_KEY env var)";
+            };
+        };
+        readonly required: readonly ["question"];
+    };
+}, {
+    readonly name: "helix_deep_analysis";
+    readonly description: "Run an extended deep analysis on a clinical topic using the highest-capability model with full RAG pipeline, three-lens scoring, and citation verification. Returns a comprehensive clinical synthesis with evidence grade, confidence score, PMID citations, and three-lens analysis (longevity / health-disease / performance). Use this for research synthesis, systematic review preparation, or comprehensive protocol evaluation. Requires Enterprise Helix API key.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly topic: {
+                readonly type: "string";
+                readonly description: "Clinical topic or question for deep analysis (e.g. 'Comprehensive analysis of semaglutide for longevity and metabolic optimization')";
+                readonly maxLength: 10000;
+            };
+            readonly language: {
+                readonly type: "string";
+                readonly enum: readonly ["en", "ar"];
+                readonly default: "en";
+            };
+            readonly api_key: {
+                readonly type: "string";
+                readonly description: "Helix API key (overrides HORMONALY_API_KEY env var)";
+            };
+        };
+        readonly required: readonly ["topic"];
+    };
+}, {
+    readonly name: "monitor_protocol_updates";
+    readonly description: "Check if any of the user's saved protocols have new evidence updates or recommendations available. Returns a list of protocols with their last-updated date, current evidence grade, and whether a review is recommended. Requires user session token.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly session_token: {
+                readonly type: "string";
+                readonly description: "User session token (from /api/auth/session or Settings → API Keys)";
+            };
+            readonly compound_filter: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly description: "Optional: filter to specific compounds (e.g. ['BPC-157', 'semaglutide'])";
+            };
+        };
+        readonly required: readonly [];
+    };
+}, {
+    readonly name: "protocol_search";
+    readonly description: "Search the Hormonaly protocol library by compound name, category, or condition. Returns a list of matching protocols with titles, evidence grades, and categories. No authentication required.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly query: {
+                readonly type: "string";
+                readonly description: "Search query (compound name, condition, or category)";
+            };
+            readonly category: {
+                readonly type: "string";
+                readonly description: "Filter by category slug (e.g. 'weight-loss', 'longevity', 'hormones')";
+            };
+            readonly limit: {
+                readonly type: "number";
+                readonly default: 10;
+                readonly description: "Maximum number of results (max 20)";
+            };
+        };
+        readonly required: readonly ["query"];
+    };
+}, {
+    readonly name: "protocol_get";
+    readonly description: "Get the full details of a protocol by its ID or slug. Returns dosing tables, mechanism steps, safety considerations, citations, and all enriched data.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly id: {
+                readonly type: "string";
+                readonly description: "Protocol ID or slug (e.g. 'semaglutide-glp1', 'bpc-157-gut')";
+            };
+        };
+        readonly required: readonly ["id"];
+    };
+}, {
+    readonly name: "protocol_list_categories";
+    readonly description: "List all protocol categories available in the Hormonaly library with their slugs and protocol counts.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {};
+    };
+}, {
+    readonly name: "protocol_get_interactions";
+    readonly description: "Check for known drug/compound interactions between a set of compounds. Returns severity, mechanism, clinical effect, and recommendations.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly compounds: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly minItems: 2;
+                readonly description: "List of compound slugs to check interactions for (e.g. ['semaglutide', 'metformin'])";
+            };
+        };
+        readonly required: readonly ["compounds"];
+    };
+}, {
+    readonly name: "evidence_search";
+    readonly description: "Search PubMed for research papers on a compound or condition. Returns paper titles, PMIDs, abstracts, and publication dates.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly compound: {
+                readonly type: "string";
+                readonly description: "Compound or peptide name to search for";
+            };
+            readonly max_results: {
+                readonly type: "number";
+                readonly default: 10;
+                readonly description: "Maximum number of papers to return";
+            };
+        };
+        readonly required: readonly ["compound"];
+    };
+}, {
+    readonly name: "evidence_get";
+    readonly description: "Get full evidence details for a specific evidence record by ID.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly id: {
+                readonly type: "string";
+                readonly description: "Evidence record ID";
+            };
+        };
+        readonly required: readonly ["id"];
+    };
+}, {
+    readonly name: "evidence_grade";
+    readonly description: "Fetch GRADE-methodology evidence ratings for a set of evidence record IDs. Returns each record's study type, evidence grade (A/B/C/D), confidence level, PMID, and clinical relevance summary. Use this to programmatically evaluate the strength of evidence behind a set of references.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly ids: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly minItems: 1;
+                readonly maxItems: 20;
+                readonly description: "Evidence record IDs to grade (returned by evidence_search or evidence_get)";
+            };
+        };
+        readonly required: readonly ["ids"];
+    };
+}, {
+    readonly name: "compound_search";
+    readonly description: "Search the Hormonaly compound database by name or category. Returns compound names, categories, and slugs.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly query: {
+                readonly type: "string";
+                readonly description: "Compound name or partial name to search for";
+            };
+            readonly category: {
+                readonly type: "string";
+                readonly description: "Filter by compound category";
+            };
+        };
+        readonly required: readonly ["query"];
+    };
+}, {
+    readonly name: "compound_get_interactions";
+    readonly description: "Get all known interactions for a specific compound.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly slug: {
+                readonly type: "string";
+                readonly description: "Compound slug (e.g. 'semaglutide', 'bpc-157')";
+            };
+        };
+        readonly required: readonly ["slug"];
+    };
+}, {
+    readonly name: "compound_get_dosing";
+    readonly description: "Get evidence-based dosing ranges, administration routes, frequency, and cycle guidance for a compound. Returns the full dosing table from the protocol library including dose ranges, units, frequency, and clinical notes. No authentication required.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly slug: {
+                readonly type: "string";
+                readonly description: "Compound slug or protocol ID (e.g. 'semaglutide', 'bpc-157', 'testosterone-cypionate')";
+            };
+        };
+        readonly required: readonly ["slug"];
+    };
+}, {
+    readonly name: "user_get_profile";
+    readonly description: "Get the current authenticated user's profile including name, role, subscription status, and onboarding state. Requires session authentication.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly session_token: {
+                readonly type: "string";
+                readonly description: "Session token (overrides HORMONALY_SESSION_TOKEN env var)";
+            };
+        };
+    };
+}, {
+    readonly name: "user_get_usage";
+    readonly description: "Get AI usage statistics for the current user (tokens consumed, cost breakdown, request counts). Requires session authentication.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly session_token: {
+                readonly type: "string";
+                readonly description: "Session token (overrides HORMONALY_SESSION_TOKEN env var)";
+            };
+        };
+    };
+}, {
+    readonly name: "user_get_saved_protocols";
+    readonly description: "Get the list of protocols saved by the current user. Requires session authentication.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly session_token: {
+                readonly type: "string";
+                readonly description: "Session token (overrides HORMONALY_SESSION_TOKEN env var)";
+            };
+        };
+    };
+}, {
+    readonly name: "admin_get_stats";
+    readonly description: "Get platform-wide statistics: user counts, protocol counts, AI usage totals, revenue metrics. Requires admin session.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly admin_session_token: {
+                readonly type: "string";
+                readonly description: "Admin session token (overrides HORMONALY_ADMIN_SESSION_TOKEN env var)";
+            };
+        };
+    };
+}, {
+    readonly name: "admin_list_users";
+    readonly description: "List platform users with optional filters. Returns user emails, signup dates, subscription status, and usage stats. Requires admin session.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly limit: {
+                readonly type: "number";
+                readonly default: 20;
+                readonly description: "Number of users to return";
+            };
+            readonly offset: {
+                readonly type: "number";
+                readonly default: 0;
+                readonly description: "Pagination offset";
+            };
+            readonly search: {
+                readonly type: "string";
+                readonly description: "Search by email or name";
+            };
+            readonly admin_session_token: {
+                readonly type: "string";
+                readonly description: "Admin session token (overrides HORMONALY_ADMIN_SESSION_TOKEN env var)";
+            };
+        };
+    };
+}, {
+    readonly name: "admin_get_ai_costs";
+    readonly description: "Get AI cost breakdown by model, endpoint, and time period. Requires admin session.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly days: {
+                readonly type: "number";
+                readonly default: 30;
+                readonly description: "Number of days to include in the report";
+            };
+            readonly admin_session_token: {
+                readonly type: "string";
+                readonly description: "Admin session token (overrides HORMONALY_ADMIN_SESSION_TOKEN env var)";
+            };
+        };
+    };
+}];
+export declare function handleTool(name: string, args: Record<string, unknown>, client: HoromnalyClient): Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAc,MAAM,aAAa,CAAC;AAc1D,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsgBnB,CAAC;AAIX,wBAAsB,UAAU,CAC9B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAiThF"}