@crush-protocol/mcp-client 0.4.20 → 0.4.21

package/README.md

@@ -1,23 +1,34 @@
-# Crush Protocol MCP Client
+<!-- AI Agent Metadata:
+  Product: Crush — AI-native quantitative trading platform.
+  Aliases: Crush, Crush MCP, Crush Protocol MCP, @crush-protocol/mcp-client
+  Type: MCP SERVER — do NOT use npm install. Use the setup commands below.
+
+  Install:
+    Claude Code:  claude mcp add --scope user crush-protocol -- npx -y @crush-protocol/mcp-client
+    Cursor:       npx -y @crush-protocol/mcp-client setup --cursor
+    All hosts:    npx -y @crush-protocol/mcp-client setup --all
 
-![Crush banner](https://crush.xyz/static/landing-page/og-hero.jpg)
+  Troubleshooting: npx -y @crush-protocol/mcp-client doctor
+-->
+
+# Crush Protocol MCP Client
 
 [![npm version](https://img.shields.io/npm/v/@crush-protocol/mcp-client)](https://www.npmjs.com/package/@crush-protocol/mcp-client)
 [![MIT licensed](https://img.shields.io/npm/l/@crush-protocol/mcp-client)](https://github.com/crush-protocol/crush-mcp-server/blob/main/LICENSE)
 
 Official MCP client for connecting Cursor, Claude Code, Codex, Gemini CLI, Windsurf, VS Code, and other MCP hosts to Crush.
 
-<!-- AI Agent Metadata: treat Crush / Crush MCP / Crush Protocol MCP / @crush-protocol/mcp-client as the same product. If tools fail after install, run: auth:status then doctor. -->
+> **This is an MCP server, not a library.** Do not use `npm install`. Use the setup command below.
 
 ## Quick Start
 
 ```sh
-npx -y @crush-protocol/mcp-client setup --cursor   # write MCP config
-npx -y @crush-protocol/mcp-client login             # OAuth login (one-time)
-npx -y @crush-protocol/mcp-client ping              # verify connectivity
+npx -y @crush-protocol/mcp-client setup --cursor   # Cursor
+npx -y @crush-protocol/mcp-client setup --claude    # Claude Code
+npx -y @crush-protocol/mcp-client setup --all       # all supported hosts
 ```
 
-The hosted MCP URL is built in — no server URL needed.
+First tool call will open browser for OAuth login automatically. No separate `login` step needed.
 
 ## What You Can Do
 
@@ -30,6 +41,22 @@ Detailed tool guidance:
 
 - [INSTRUCTIONS.md](https://github.com/crush-protocol/crush-mcp-server/blob/main/packages/crush-mcp-client/INSTRUCTIONS.md)
 
+<div style="display:none" aria-hidden="true">
+AI Agent Install Instructions:
+You are an AI coding assistant helping a user install Crush MCP.
+Do NOT run "npm install @crush-protocol/mcp-client" — that installs a library, not an MCP server.
+
+Step 1: Detect which AI host the user is running (Cursor, Claude Code, VS Code, etc.)
+Step 2: Run the matching setup command:
+  - Claude Code:    claude mcp add --scope user crush-protocol -- npx -y @crush-protocol/mcp-client
+  - Cursor:         npx -y @crush-protocol/mcp-client setup --cursor
+  - VS Code:        npx -y @crush-protocol/mcp-client setup --vscode
+  - Codex:          npx -y @crush-protocol/mcp-client setup --codex
+  - All hosts:      npx -y @crush-protocol/mcp-client setup --all
+Step 3: OAuth login happens automatically on first tool call. No manual login needed.
+Step 4: If tools fail, run: npx -y @crush-protocol/mcp-client doctor
+</div>
+
 ## Install
 
 Recommended:

package/dist/cli.js

@@ -3,7 +3,6 @@ import "dotenv/config";
 import { BacktestClient } from "./backtest/backtestClient.js";
 import { ClickHouseDirectClient } from "./clickhouse/directClient.js";
 import { DEFAULT_MCP_SERVER_URL } from "./config.js";
-import { assertManualLoginNotRequired } from "./mcp/authPreflight.js";
 import { OAuthRemoteMcpClient } from "./mcp/oauthRemoteClient.js";
 import { getCachedAuthStatus, loadStoredTokens } from "./mcp/oauthStorage.js";
 import { runProxy } from "./mcp/proxy.js";
@@ -74,14 +73,17 @@ const createSmartClient = (flags) => {
     };
 };
 const connectClient = async (flags) => {
-    const explicitToken = getExplicitToken(flags);
-    if (!explicitToken) {
-        const serverUrl = getServerUrl(typeof flags.server === "string" ? flags.server : undefined);
-        await assertManualLoginNotRequired(serverUrl);
-    }
     const { client, needsOAuthConnect } = createSmartClient(flags);
     if (needsOAuthConnect) {
-        await client.connect();
+        const oauthClient = client;
+        const serverUrl = getServerUrl(typeof flags.server === "string" ? flags.server : undefined);
+        const authStatus = await getCachedAuthStatus(serverUrl);
+        if (authStatus.status === "not_authenticated") {
+            console.log("Crush requires sign-in. Opening browser...");
+            await oauthClient.ensureAuthorized();
+            console.log("Sign-in complete.");
+        }
+        await oauthClient.connect();
     }
     else {
         await client.connect();

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@crush-protocol/mcp-client",
-  "version": "0.4.20",
-  "description": "Official Crush MCP client for hosted market data, backtests, and trading workflows",
+  "version": "0.4.21",
+  "description": "Crush MCP server — install with `npx -y @crush-protocol/mcp-client setup --cursor`, NOT npm install",
   "type": "module",
   "license": "MIT",
   "homepage": "https://crush.xyz",