canli-validation-mcp 0.3.1 → 0.4.0

package/README.md

@@ -1,11 +1,12 @@
 # canli-validation-mcp
 
 An MCP (Model Context Protocol) server over canlicapital.com's free, keyed validation API. It
-gives a coding agent eight tools: issue a free key, run the four validators (deflated Sharpe,
-CSCV overfitting, paper-evidence conformance, breadth ceiling), fetch a stored receipt, read
-service status, and read a company's reported financial history from SEC filings. Every tool
-returns the full API envelope as its result text, success or error, so the agent cannot see a
-number without the sentences beside it that say what the number does not establish.
+gives a coding agent nine tools: issue a free key, run the five validators (deflated Sharpe,
+CSCV overfitting, paper-evidence conformance, breadth ceiling, minimum track record length),
+fetch a stored receipt, read service status, and read a company's reported financial history
+from SEC filings. Every tool returns the full API envelope as its result text, success or error,
+so the agent cannot see a number without the sentences beside it that say what the number does
+not establish.
 
 This package is published to npm as [`canli-validation-mcp`](https://www.npmjs.com/package/canli-validation-mcp).
 Also listed on the official MCP Registry (`io.github.arhancanli/canli-validation-mcp`) and
@@ -33,6 +34,7 @@ repository for the full design.
 | `validate_overfitting` | `POST /api/v1/validate/overfitting` | yes |
 | `validate_paper_evidence` | `POST /api/v1/validate/paper-evidence` | yes |
 | `validate_breadth` | `POST /api/v1/validate/breadth` | yes |
+| `validate_track_record` | `POST /api/v1/validate/track-record` | yes |
 | `get_receipt` | `GET /api/v1/receipts/{id}` | no |
 | `service_status` | `GET /api/v1/validate/status` | no |
 | `company_financial_history` | `GET /company-data/{cik}.json` | no |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "canli-validation-mcp",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "description": "MCP server for canlicapital.com's free validation API: deflated Sharpe, CSCV overfitting, paper-evidence conformance, and breadth ceiling, each returned as the full API envelope so the boundary language cannot be dropped.",
   "private": false,
   "type": "module",

package/src/schemas.mjs

@@ -92,6 +92,22 @@ export const breadthInput = z
   })
   .strict();
 
+// ---------------------------------------------------------------------------------------------
+// validate_track_record
+// ---------------------------------------------------------------------------------------------
+
+export const trackRecordInput = z
+  .object({
+    observed_sharpe_annualized: z.number().min(-10).max(10),
+    periods_per_year: z.number().min(1).max(10000),
+    skew: z.number().min(-20).max(20),
+    non_excess_kurtosis: z.number().min(1).max(100),
+    benchmark_sharpe_annualized: z.number().min(-10).max(10).optional(),
+    confidence: z.number().gt(0).lt(1).optional(),
+    observations: z.number().int().min(2).max(1000000).optional(),
+  })
+  .strict();
+
 // ---------------------------------------------------------------------------------------------
 // get_key / get_receipt
 // ---------------------------------------------------------------------------------------------
@@ -151,6 +167,7 @@ export const TOOL_DESCRIPTIONS = Object.freeze({
   validate_deflated_sharpe: `Probabilistic and deflated Sharpe from the seven contract inputs, or from a return series plus the trials and dispersion behind it, never both. ${LIMITS_SENTENCES.notAdmission}`,
   validate_overfitting: `Probability of backtest overfitting by CSCV over the returns of every variant tried. ${LIMITS_SENTENCES.notAdmission}`,
   validate_paper_evidence: `Conformance of a performance record against the canli.paper-evidence.v0 standard. ${LIMITS_SENTENCES.scope}`,
+  validate_track_record: `Minimum track record length for an observed Sharpe to clear a benchmark Sharpe (default 0) at a confidence level (default 0.95), and, when observations is sent, the probabilistic Sharpe of that record against the benchmark. ${LIMITS_SENTENCES.notAdmission}`,
   validate_breadth: `Book Sharpe ceiling from per-sleeve quality and average pairwise correlation, and the sleeves a target needs. ${LIMITS_SENTENCES.scope}`,
   get_receipt: `Fetch a stored verdict by its content-hash id (GET /api/v1/receipts/{id}), immutable and cacheable. ${LIMITS_SENTENCES.unsigned}`,
   service_status: `Service, store and quota constants for the validation API (GET /api/v1/validate/status); no key required. ${LIMITS_SENTENCES.scope}`,

package/src/server.mjs

@@ -12,6 +12,7 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import {
   breadthInput,
+  trackRecordInput,
   companyHistoryInput,
   deflatedSharpeInput,
   deflatedSharpeToolShape,
@@ -168,6 +169,12 @@ export async function toolValidateBreadth(session, args) {
   return asText(response.envelope, response.failed);
 }
 
+export async function toolValidateTrackRecord(session, args) {
+  const body = parseOrThrow(trackRecordInput, args, "validate_track_record");
+  const response = await callApi(session, { path: "/api/v1/validate/track-record", method: "POST", body });
+  return asText(response.envelope, response.failed);
+}
+
 export async function toolGetReceipt(session, args) {
   const { id } = parseOrThrow(getReceiptInput, args, "get_receipt");
   const response = await callApi(session, { path: `/api/v1/receipts/${id}` });
@@ -282,6 +289,11 @@ export function registerTools(server, session) {
     { title: "Validate breadth ceiling", annotations: { title: "Validate breadth ceiling", ...WRITES_RECEIPT }, description: TOOL_DESCRIPTIONS.validate_breadth, inputSchema: breadthInput },
     (args) => toolValidateBreadth(session, args),
   );
+  server.registerTool(
+    "validate_track_record",
+    { title: "Minimum track record length", annotations: { title: "Minimum track record length", ...WRITES_RECEIPT }, description: TOOL_DESCRIPTIONS.validate_track_record, inputSchema: trackRecordInput },
+    (args) => toolValidateTrackRecord(session, args),
+  );
   server.registerTool(
     "get_receipt",
     { title: "Get a receipt", annotations: { title: "Get a receipt", ...READ_ONLY }, description: TOOL_DESCRIPTIONS.get_receipt, inputSchema: getReceiptInput },