canli-validation-mcp 0.1.0 → 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +28 -20
  2. package/package.json +3 -2
package/README.md CHANGED
@@ -7,7 +7,9 @@ service status. Every tool returns the full API envelope as its result text, suc
7
7
  so the agent cannot see a number without the sentences beside it that say what the number does
8
8
  not establish.
9
9
 
10
- This package is not published to npm. Run it from a local checkout, as shown below.
10
+ This package is published to npm as [`canli-validation-mcp`](https://www.npmjs.com/package/canli-validation-mcp).
11
+ Run it with `npx`, no install step, as shown below. A local checkout is only needed to develop or
12
+ test this package itself; see "Local checkout" near the bottom.
11
13
 
12
14
  ## What the API is (and is not)
13
15
 
@@ -54,10 +56,9 @@ disk.
54
56
 
55
57
  ## Install
56
58
 
57
- ```bash
58
- cd mcp
59
- npm ci
60
- ```
59
+ No install step. `npx` fetches the published package on first run, so every client config below
60
+ just spawns `npx -y canli-validation-mcp`. See "Local checkout" near the bottom to develop or test
61
+ this package itself instead of running the published one.
61
62
 
62
63
  ## Claude Desktop
63
64
 
@@ -66,30 +67,24 @@ Add to `claude_desktop_config.json` (Settings, Developer, Edit Config):
66
67
  ```json
67
68
  {
68
69
  "mcpServers": {
69
- "canlicapital-validation": {
70
- "command": "node",
71
- "args": ["/absolute/path/to/meridian/mcp/src/server.mjs"],
72
- "env": {
73
- "CANLI_API_BASE": "https://canlicapital.com"
74
- }
70
+ "canli": {
71
+ "command": "npx",
72
+ "args": ["-y", "canli-validation-mcp"]
75
73
  }
76
74
  }
77
75
  }
78
76
  ```
79
77
 
80
- Replace `/absolute/path/to/meridian` with the real path to this checkout, then restart Claude
81
- Desktop.
78
+ Restart Claude Desktop afterward. Add an `"env"` object with `CANLI_API_BASE` to point this at a
79
+ preview deployment instead of the default.
82
80
 
83
81
  ## Claude Code
84
82
 
85
83
  ```bash
86
- claude mcp add canlicapital-validation \
87
- --env CANLI_API_BASE=https://canlicapital.com \
88
- -- node /absolute/path/to/meridian/mcp/src/server.mjs
84
+ claude mcp add canli -- npx -y canli-validation-mcp
89
85
  ```
90
86
 
91
- Run `claude mcp list` to confirm it is registered, and `claude mcp remove canlicapital-validation`
92
- to remove it.
87
+ Run `claude mcp list` to confirm it is registered, and `claude mcp remove canli` to remove it.
93
88
 
94
89
  ## Generic stdio client
95
90
 
@@ -101,8 +96,8 @@ import { Client } from "@modelcontextprotocol/sdk/client/index.js";
101
96
  import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
102
97
 
103
98
  const transport = new StdioClientTransport({
104
- command: "node",
105
- args: ["/absolute/path/to/meridian/mcp/src/server.mjs"],
99
+ command: "npx",
100
+ args: ["-y", "canli-validation-mcp"],
106
101
  env: { ...process.env, CANLI_API_BASE: "https://canlicapital.com" },
107
102
  });
108
103
 
@@ -147,6 +142,19 @@ Each tool's description also states one of these sentences, so an agent sees the
147
142
  it calls the tool, not only after. No tool in this server strips `limits` or `receipt.url` from
148
143
  a response; the full envelope is always the result text.
149
144
 
145
+ ## Local checkout
146
+
147
+ Only needed to develop or test this package itself, not to run the published one.
148
+
149
+ ```bash
150
+ cd mcp
151
+ npm ci
152
+ node src/server.mjs
153
+ ```
154
+
155
+ Point a client at the checkout instead of npm by spawning `node /absolute/path/to/meridian/mcp/src/server.mjs`
156
+ in place of `npx -y canli-validation-mcp` in any config above.
157
+
150
158
  ## Testing
151
159
 
152
160
  ```bash
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "canli-validation-mcp",
3
- "version": "0.1.0",
3
+ "version": "0.1.1",
4
4
  "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.",
5
5
  "private": false,
6
6
  "type": "module",
@@ -21,5 +21,6 @@
21
21
  "dependencies": {
22
22
  "@modelcontextprotocol/sdk": "1.30.0",
23
23
  "zod": "4.5.4"
24
- }
24
+ },
25
+ "mcpName": "io.github.arhancanli/canli-validation-mcp"
25
26
  }