coil-mcp 1.7.0 → 1.8.0

package/README.md

@@ -1,17 +1,23 @@
 # coil-mcp
 
-**Live US stock market data and trading signals, as an MCP server.** Market regime, ranked buy
-lists, 0-100 opportunity / entry-timing / hold-strength scores across ~575 S&P 500, Nasdaq-100
-and macro names, sector rotation, and a 24/7 crypto board covering 81 pairs.
+**A trading desk's discipline for your AI agent, as an MCP server.** Connect it and your agent
+reads the market the way a desk does: the gate first (and cash when it is shut), where money is
+rotating, the names set up inside their entry window, one name before any buy, and whether the
+trend behind what it holds is intact. Every free answer closes with the rule that applies, and
+`why_not` / `check_my_trade` hold a name or a proposed trade against the principles. Underneath
+it is the full catalogue: market regime, ranked buy lists, 0-100 opportunity / entry-timing /
+hold-strength scores across 650+ US stocks and ETFs (S&P 500, Nasdaq-100 and a macro book),
+sector rotation, and a 24/7 read of 81 crypto coins (a read of trend and state, not trading
+signals). Impersonal research, not investment advice.
 
 The free tier needs **no key, no wallet, no signup**.
 
 ## Install
 
-Claude Code speaks remote MCP directly — you do not need this package:
+Clients with native remote MCP (Claude Code, for one) do not need this package:
 
 ```
-claude mcp add --transport http coil https://coil.trade/mcp
+claude mcp add --transport http coil https://mcp.coil.trade/mcp
 ```
 
 For clients that launch servers by command (Claude Desktop, Cursor, Windsurf), use this bridge:
@@ -32,7 +38,7 @@ npx -y coil-mcp
 
 ## What you get for free
 
-The full board, delayed one market day, with no account of any kind:
+A sample of the board (top 3 per book, headline fields), delayed one market day, with no account of any kind:
 `get_market_regime`, `get_buy_list`, `get_stock_read`, `get_market_leaders`, `get_sector_read`,
 `get_crypto_trend`, `get_morning_brief`, `get_day_board`, `get_rotation`, `get_crypto_day`,
 `get_crypto_night`, `get_hold_state`.
@@ -45,14 +51,48 @@ Every free tool has a `*_live` twin. Two ways to open them:
 account and no card. A wallet-equipped client pays inline via `params._meta["x402/payment"]`
 (@x402/mcp compatible). Cheapest read is `/api/crypto/gate` at $0.001.
 
-**Subscribe** — [Coil Live](https://coil.trade/live-feed) is $29/mo and unlocks every `*_live`
-tool plus two sold nowhere else: `get_engine_feed` and `get_live_rules`.
+**Subscribe** — [Coil Live](https://coil.trade/live-feed) is **$49/mo or $419/yr, 7 days free** and
+unlocks every `*_live` tool plus two sold nowhere else: `get_engine_feed` and `get_live_rules`.
+After checkout, Gumroad gives you a license key. Send it as the `X-License-Key` header; the
+MCP URL is `https://mcp.coil.trade/mcp`.
+
+**Claude Code** (remote MCP, header sent directly):
+
+```
+claude mcp add --transport http coil https://mcp.coil.trade/mcp --header "X-License-Key: YOUR_GUMROAD_LICENSE_KEY"
+```
+
+**Claude Desktop, Cursor, Windsurf** (they launch servers by command; the connector UI cannot send a
+custom header, so use this bridge with `COIL_LICENSE_KEY`):
+
+```json
+{
+  "mcpServers": {
+    "coil": {
+      "command": "npx",
+      "args": ["-y", "coil-mcp"],
+      "env": { "COIL_LICENSE_KEY": "YOUR_GUMROAD_LICENSE_KEY" }
+    }
+  }
+}
+```
+
+**Any other MCP client** that speaks streamable HTTP: URL `https://mcp.coil.trade/mcp` and the header
+`X-License-Key: YOUR_GUMROAD_LICENSE_KEY` (on your client's own header setting). A client that only
+launches commands can run the bridge: `COIL_LICENSE_KEY=your_key npx -y coil-mcp`.
 
 ```
 COIL_LICENSE_KEY=your_key npx -y coil-mcp   # subscription
 COIL_KEY=your_free_key    npx -y coil-mcp   # free key: 25 live calls/day on the cheap slices
 ```
 
+**Mind the size of `get_engine_feed`.** Measured: the unfiltered feed is about **1.35 MB**
+(hundreds of thousands of tokens) and a plain 2-name `symbols` poll is about 70 KB. Do not read the
+unfiltered feed into a model's context. Poll with `{"symbols": ["NVDA","MU"], "compact": true}`
+(about 12 KB for two names). Optional `fields` picks engine fields; `limit` + `cursor` page the
+board by symbol. Omit all of them and you get the full payload, unchanged. Call `get_live_setup`
+(free, no key) for the connect guide and the polling cadence.
+
 Mint a free key with no signup flow:
 
 ```
@@ -65,7 +105,7 @@ The signature moves no funds. See [coil.trade/auth.md](https://coil.trade/auth.m
 
 ## What this package is
 
-A dependency-free stdio bridge. It forwards JSON-RPC verbatim to `https://coil.trade/mcp` and
+A dependency-free stdio bridge. It forwards JSON-RPC verbatim to `https://mcp.coil.trade/mcp` and
 never inspects, rewrites or caches a payload — whatever the server supports, this supports,
 including tools added after you installed it. Point it elsewhere with `COIL_MCP_URL`.
 

package/bin/coil-mcp.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-// coil-mcp — stdio bridge to Coil's remote MCP server (https://coil.trade/mcp).
+// coil-mcp — stdio bridge to Coil's remote MCP server (https://mcp.coil.trade/mcp).
 //
 // WHY THIS EXISTS: Claude Code speaks remote MCP natively, so for that client this package is
 // redundant. It exists for the clients that only speak stdio (Claude Desktop configs, Cursor,
@@ -11,14 +11,17 @@
 // abandons, and a market-data bridge asking for transitive trust is a bad trade. Node 18+ has
 // fetch and that is all this needs.
 //
-//   npx -y coil-mcp                 # free tier: delayed board, no key, no wallet
+//   npx -y coil-mcp                 # free tier: a sample of the board, delayed, no key, no wallet
 //   COIL_KEY=... npx -y coil-mcp    # free key  -> higher daily limit on the cheap slices
 //   COIL_LICENSE_KEY=... npx -y coil-mcp   # Coil Live subscription -> every *_live tool
 //
 // It is a PROXY, not a client: it forwards JSON-RPC verbatim and never inspects, rewrites or
 // caches a payload. Whatever the server supports, this supports, including tools added later.
-const ENDPOINT = process.env.COIL_MCP_URL || "https://coil.trade/mcp";
-const VERSION = "1.0.0";
+import { readFileSync } from "node:fs";
+
+const ENDPOINT = process.env.COIL_MCP_URL || "https://mcp.coil.trade/mcp";
+// Read from the package's own package.json so the UA can never drift from the published version.
+const VERSION = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8")).version;
 
 function headers() {
   const h = {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "coil-mcp",
-  "version": "1.7.0",
-  "description": "MCP server for live US stock market data and trading signals \u2014 market regime (risk-on/risk-off), ranked buy lists, 0-100 opportunity and hold scores across ~575 S&P 500 and Nasdaq-100 names, sector rotation, and a 24/7 crypto board for 81 pairs. Free tier needs no key, no wallet, no signup; pay-per-call over x402 in USDC for live data.",
+  "version": "1.8.0",
+  "description": "A trading desk's discipline for your AI agent, as an MCP server: when to trade, when to wait and when to sit in cash, read from a scored board of 650+ US stocks and ETFs (S&P 500, Nasdaq-100 and a macro book) plus a crypto book. Every answer closes with the rule that applies; teaching tools check a trade against the principles. Free tier needs no key, no wallet, no signup; pay-per-call over x402 in USDC for live data.",
   "keywords": [
     "mcp",
     "modelcontextprotocol",