@crush-protocol/mcp-client 0.4.23 → 0.4.24

package/INSTRUCTIONS.md

@@ -2,7 +2,7 @@
 
 You have access to **Crush Protocol MCP**, an AI-native quantitative trading platform. Use these tools to help users research markets, build strategies, run backtests, and manage live trading.
 
-Package identity:
+## Package Identity
 
 - npm package: `@crush-protocol/mcp-client`
 - product names users may mention: `Crush`, `Crush MCP`, `Crush Protocol MCP`
@@ -10,19 +10,25 @@ Package identity:
 
 If a user mentions `@crush-protocol/mcp-client`, interpret that as the official hosted Crush MCP client.
 
-Preferred onboarding sequence:
+## Install — IMPORTANT
 
-1. `npx -y @crush-protocol/mcp-client setup --cursor`
-2. `npx -y @crush-protocol/mcp-client login`
-3. If tools still fail, run:
-   - `npx -y @crush-protocol/mcp-client auth:status`
-   - `npx -y @crush-protocol/mcp-client doctor`
+**This is an MCP server. Do NOT use `npm install`. Use the setup commands below.**
 
-Authentication note: remote MCP requests use OAuth Bearer access tokens issued by the Crush OAuth server. In supported MCP hosts, users typically authenticate once with:
+Detect which AI host the user is running, then execute the matching command:
 
-`npx -y @crush-protocol/mcp-client login`
+| Host | Install command |
+|---|---|
+| Claude Code | `claude mcp add --scope user crush-protocol -- npx -y @crush-protocol/mcp-client@latest` |
+| Cursor | `npx -y @crush-protocol/mcp-client@latest setup --cursor` |
+| VS Code | `npx -y @crush-protocol/mcp-client@latest setup --vscode` |
+| Codex | `npx -y @crush-protocol/mcp-client@latest setup --codex` |
+| Gemini CLI | `npx -y @crush-protocol/mcp-client@latest setup --gemini` |
+| Windsurf | `npx -y @crush-protocol/mcp-client@latest setup --windsurf` |
+| All hosts | `npx -y @crush-protocol/mcp-client@latest setup --all` |
 
-After login, credentials are cached locally and reused across supported hosts.
+OAuth login happens automatically on first tool call. No separate `login` step needed.
+
+If tools fail after install, run: `npx -y @crush-protocol/mcp-client@latest doctor`
 
 ## Tool Categories
 

package/README.md

@@ -1,14 +1,18 @@
-<!-- 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.
+<!--
+  @crush-protocol/mcp-client — AI Agent Install Guide
+  Aliases: Crush, Crush MCP, Crush Protocol MCP
+  Type: MCP SERVER — do NOT use npm install.
 
   Install:
     Claude Code:  claude mcp add --scope user crush-protocol -- npx -y @crush-protocol/mcp-client@latest
     Cursor:       npx -y @crush-protocol/mcp-client@latest setup --cursor
+    VS Code:      npx -y @crush-protocol/mcp-client@latest setup --vscode
+    Codex:        npx -y @crush-protocol/mcp-client@latest setup --codex
     All hosts:    npx -y @crush-protocol/mcp-client@latest setup --all
 
+  OAuth login triggers automatically on first tool call.
   Troubleshooting: npx -y @crush-protocol/mcp-client@latest doctor
+  Full tool reference: see INSTRUCTIONS.md in this package.
 -->
 
 # Crush Protocol MCP Client
@@ -16,9 +20,7 @@
 [![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.
-
-> **This is an MCP server, not a library.** Do not use `npm install`. Use the setup command below.
+MCP server for connecting AI coding agents to [Crush](https://crush.xyz) — market data, backtests, live strategies, and trading.
 
 ## Quick Start
 
@@ -28,34 +30,7 @@ npx -y @crush-protocol/mcp-client@latest setup --claude    # Claude Code
 npx -y @crush-protocol/mcp-client@latest setup --all       # all supported hosts
 ```
 
-First tool call will open browser for OAuth login automatically. No separate `login` step needed.
-
-## What You Can Do
-
-- Market data: tokens, indicators, timeframes, OHLCV
-- Backtests: schema discovery, token universe, expression validation, backtest execution
-- Live strategies: create, inspect, activate, pause, monitor
-- Market intelligence: token info, trending feeds, alpha context
-
-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@latest
-  - Cursor:         npx -y @crush-protocol/mcp-client@latest setup --cursor
-  - VS Code:        npx -y @crush-protocol/mcp-client@latest setup --vscode
-  - Codex:          npx -y @crush-protocol/mcp-client@latest setup --codex
-  - All hosts:      npx -y @crush-protocol/mcp-client@latest 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@latest doctor
-</div>
+OAuth login happens automatically on first tool call.
 
 ## Install
 

package/dist/mcp/oauthProvider.js

@@ -8,48 +8,89 @@ import { defaultStorageDir, getStorageFileForServer } from "./oauthStorage.js";
 const DEFAULT_REDIRECT_PORT = 8787;
 const DEFAULT_REDIRECT_PATH = "/oauth/callback";
 const escapeHtml = (s) => s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
-const renderCallbackHtml = (title, message) => `<!DOCTYPE html>
+const CRUSH_LOGO_SVG = `<svg width="150" height="78" viewBox="0 0 399 78" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <path d="M6.09178 25.7399C11.0178 10.3981 25.2316 0 41.2772 0H120.647L111.405 28.7857H5.11381L6.09178 25.7399Z" fill="#FF1850"/>
+  <path d="M1.38577 50.1428C-3.76778 63.563 6.09066 78 20.4083 78H69.7897L80.4873 50.1428H1.38577Z" fill="#FF1850"/>
+  <path d="M175.128 73.96C170.008 73.96 165.24 73.128 160.824 71.464C156.472 69.736 152.664 67.336 149.4 64.264C146.2 61.128 143.704 57.448 141.912 53.224C140.12 49 139.224 44.392 139.224 39.4C139.224 34.408 140.12 29.8 141.912 25.576C143.704 21.352 146.232 17.704 149.496 14.632C152.76 11.496 156.568 9.096 160.92 7.432C165.272 5.704 170.04 4.84 175.224 4.84C180.728 4.84 185.752 5.8 190.296 7.72C194.84 9.576 198.68 12.36 201.816 16.072L193.752 23.656C191.32 21.032 188.6 19.08 185.592 17.8C182.584 16.456 179.32 15.784 175.8 15.784C172.28 15.784 169.048 16.36 166.104 17.512C163.224 18.664 160.696 20.296 158.52 22.408C156.408 24.52 154.744 27.016 153.528 29.896C152.376 32.776 151.8 35.944 151.8 39.4C151.8 42.856 152.376 46.024 153.528 48.904C154.744 51.784 156.408 54.28 158.52 56.392C160.696 58.504 163.224 60.136 166.104 61.288C169.048 62.44 172.28 63.016 175.8 63.016C179.32 63.016 182.584 62.376 185.592 61.096C188.6 59.752 191.32 57.736 193.752 55.048L201.816 62.728C198.68 66.376 194.84 69.16 190.296 71.08C185.752 73 180.696 73.96 175.128 73.96Z" fill="white"/>
+  <path d="M207.822 73V21.736H219.246V35.848L217.902 31.72C219.438 28.264 221.838 25.64 225.102 23.848C228.43 22.056 232.558 21.16 237.486 21.16V32.584C236.974 32.456 236.494 32.392 236.046 32.392C235.598 32.328 235.15 32.296 234.702 32.296C230.158 32.296 226.542 33.64 223.854 36.328C221.166 38.952 219.822 42.888 219.822 48.136V73H207.822Z" fill="white"/>
+  <path d="M265.031 73.672C260.679 73.672 256.838 72.872 253.51 71.272C250.182 69.608 247.59 67.112 245.734 63.784C243.878 60.392 242.951 56.136 242.951 51.016V21.736H254.951V49.384C254.951 53.992 255.974 57.448 258.022 59.752C260.134 61.992 263.111 63.112 266.951 63.112C269.767 63.112 272.198 62.536 274.246 61.384C276.358 60.232 277.991 58.504 279.143 56.2C280.359 53.896 280.966 51.048 280.966 47.656V21.736H292.966V73H281.543V59.176L283.559 63.4C281.831 66.728 279.303 69.288 275.975 71.08C272.647 72.808 268.999 73.672 265.031 73.672Z" fill="white"/>
+  <path d="M319.718 73.672C315.43 73.672 311.302 73.128 307.334 72.04C303.43 70.888 300.326 69.512 298.022 67.912L302.63 58.792C304.934 60.264 307.686 61.48 310.886 62.44C314.086 63.4 317.286 63.88 320.486 63.88C324.262 63.88 326.982 63.368 328.646 62.344C330.374 61.32 331.238 59.944 331.238 58.216C331.238 56.808 330.662 55.752 329.51 55.048C328.358 54.28 326.854 53.704 324.998 53.32C323.142 52.936 321.062 52.584 318.758 52.264C316.518 51.944 314.246 51.528 311.942 51.016C309.702 50.44 307.654 49.64 305.798 48.616C303.942 47.528 302.438 46.088 301.286 44.296C300.134 42.504 299.558 40.136 299.558 37.192C299.558 33.928 300.486 31.112 302.342 28.744C304.198 26.312 306.79 24.456 310.118 23.176C313.51 21.832 317.51 21.16 322.118 21.16C325.574 21.16 329.062 21.544 332.582 22.312C336.102 23.08 339.014 24.168 341.318 25.576L336.71 34.696C334.278 33.224 331.814 32.232 329.318 31.72C326.886 31.144 324.454 30.856 322.022 30.856C318.374 30.856 315.654 31.4 313.862 32.488C312.134 33.576 311.27 34.952 311.27 36.616C311.27 38.152 311.846 39.304 312.998 40.072C314.15 40.84 315.654 41.448 317.51 41.896C319.366 42.344 321.414 42.728 323.654 43.048C325.958 43.304 328.23 43.72 330.47 44.296C332.71 44.872 334.758 45.672 336.614 46.696C338.534 47.656 340.07 49.032 341.222 50.824C342.374 52.616 342.95 54.952 342.95 57.832C342.95 61.032 341.99 63.816 340.07 66.184C338.214 68.552 335.558 70.408 332.102 71.752C328.646 73.032 324.518 73.672 319.718 73.672Z" fill="white"/>
+  <path d="M377.573 21.16C381.669 21.16 385.317 21.96 388.517 23.56C391.781 25.16 394.34 27.624 396.197 30.952C398.053 34.216 398.98 38.44 398.98 43.624V73H386.98V45.16C386.98 40.616 385.892 37.224 383.716 34.984C381.604 32.744 378.629 31.624 374.789 31.624C371.973 31.624 369.477 32.2 367.301 33.352C365.125 34.504 363.428 36.232 362.212 38.536C361.06 40.776 360.484 43.624 360.484 47.08V73H348.484V1.768H360.484V35.56L357.893 31.336C359.685 28.072 362.277 25.576 365.669 23.848C369.125 22.056 373.093 21.16 377.573 21.16Z" fill="white"/>
+</svg>`;
+const renderCallbackHtml = (title, message) => {
+    const isSuccess = title.toLowerCase().includes("complete");
+    const statusColor = isSuccess ? "var(--green)" : "var(--red)";
+    const statusBg = isSuccess ? "var(--green-bg)" : "var(--red-bg)";
+    return `<!DOCTYPE html>
 <html lang="en">
 <head>
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>${title}</title>
+  <title>${escapeHtml(title)}</title>
   <style>
+    :root {
+      --bg: #000;
+      --card: #0D0D0D;
+      --border: rgba(255, 255, 255, 0.1);
+      --text: #fff;
+      --text-muted: rgba(255, 255, 255, 0.7);
+      --green: #15f364;
+      --green-bg: rgba(34, 197, 94, 0.1);
+      --red: #f3154c;
+      --red-bg: rgba(239, 68, 68, 0.1);
+    }
+    * { box-sizing: border-box; }
     body {
       margin: 0;
       min-height: 100vh;
-      display: grid;
-      place-items: center;
+      display: flex;
+      align-items: center;
+      justify-content: center;
+      background: var(--bg);
       font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
-      background: linear-gradient(135deg, #f6f7fb, #eef2ff);
-      color: #0f172a;
+      color: var(--text);
+    }
+    .card {
+      width: 100%;
+      max-width: 380px;
+      border-radius: 12px;
+      border: 1px solid var(--border);
+      background: var(--card);
+      backdrop-filter: blur(20px);
+      box-shadow: 0 25px 60px rgba(0, 0, 0, 0.5);
+      overflow: hidden;
     }
-    main {
-      max-width: 560px;
-      padding: 32px;
-      border-radius: 20px;
-      background: rgba(255, 255, 255, 0.96);
-      box-shadow: 0 20px 45px rgba(15, 23, 42, 0.14);
+    .header {
+      padding: 32px 24px;
       text-align: center;
     }
+    .logo { margin-bottom: 20px; }
     h1 {
-      margin: 0 0 12px;
-      font-size: 28px;
+      margin: 0 0 8px;
+      font-size: 18px;
+      font-weight: 600;
+      color: ${statusColor};
     }
-    p {
+    .desc {
       margin: 0;
-      line-height: 1.6;
-      color: #334155;
+      font-size: 13px;
+      color: var(--text-muted);
+      line-height: 1.5;
     }
   </style>
 </head>
 <body>
-  <main>
-    <h1>${escapeHtml(title)}</h1>
-    <p>${escapeHtml(message)}</p>
-  </main>
+  <div class="card">
+    <div class="header">
+      <div class="logo">${CRUSH_LOGO_SVG}</div>
+      <h1>${escapeHtml(title)}</h1>
+      <p class="desc">${escapeHtml(message)}</p>
+    </div>
+  </div>
+  <script>setTimeout(() => window.close(), 3000);</script>
 </body>
 </html>`;
+};
 const openBrowser = async (authorizationUrl) => {
     const url = authorizationUrl.toString();
     if (process.env.BROWSER) {

package/package.json

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