@0xinsider/mcp 2.1.0 → 2.4.0

package/README.md

@@ -2,7 +2,7 @@
 
 Official CLI and MCP server for [0xinsider](https://0xinsider.com) — advanced tools for sports and esports markets, powered by Polymarket, for AI agents and scripts.
 
-Gives your AI agent and terminal scripts the same Polymarket data the tools run on: wallet grades on settled P&L, large trades, which side the profitable wallets hold on a market, daily picks on a public record, and insider-radar flags.
+Gives your AI agent and terminal scripts the same Polymarket data the tools run on: wallet grades on settled P&L, large trades, which side the profitable wallets hold on a market, daily picks on a public record, and suspicious trades.
 
 ## CLI and MCP entry points
 
@@ -36,35 +36,44 @@ is generated from the same public OpenAPI contract the CLI and MCP tools read.
 
 ## Two ways to connect
 
-- **Remote HTTP (no install)** — `POST https://api.0xinsider.com/api/v1/mcp` with `Authorization: Bearer oxi_sk_live_...`. Implements the MCP Streamable HTTP transport (protocolVersion `2025-11-25`). Works with MCP clients that speak HTTP and can send headers. `initialize`, `ping` and `tools/list` need no key, so a client can show the catalog first; `tools/call` without a credential answers HTTP 401 with a `WWW-Authenticate` challenge naming the RFC 9728 document at `/.well-known/oauth-protected-resource/api/v1/mcp`. Clients that implement the MCP authorization spec follow it to the OAuth 2.1 authorization server (PKCE S256, dynamic client registration), sign the user in and send the resulting access token instead of an API key; see https://0xinsider.com/auth.md. Legacy `?token=` authentication works only on exact `/api/v1/mcp`; every other protected V1 route rejects it. Prefer headers because URL secrets can leak through shell history, browser history, proxy logs, and crash reports. The retirement date is unknown until external URL-only client compatibility is checked. Remote and stdio use the same read-only public V1 tool catalog, rate limits, and billing.
+- **Remote HTTP (no install)** — `POST https://api.0xinsider.com/api/v1/mcp` with `Authorization: Bearer oxi_sk_live_...`. Implements the MCP Streamable HTTP transport (protocolVersion `2025-11-25`). Works with MCP clients that speak HTTP and can send headers. `initialize`, `ping` and `tools/list` need no key, so a client can show the catalog first; `tools/call` without a credential answers HTTP 401 with a `WWW-Authenticate` challenge naming the RFC 9728 document at `/.well-known/oauth-protected-resource/api/v1/mcp`. Clients that implement the MCP authorization spec follow it to the OAuth 2.1 authorization server (PKCE S256, dynamic client registration), sign the user in and send the resulting access token instead of an API key; see https://0xinsider.com/auth.md. A key in a `?token=` query parameter is rejected on every route, `/api/v1/mcp` included, with `401 invalid_api_key` and `error.reason` `api_key_in_query`, because URL secrets leak through shell history, browser history, proxy logs, and crash reports. A client that can only take a URL runs the stdio package with the key in its environment. Remote and stdio use the same read-only public V1 tool catalog, rate limits, and billing.
 - **Documentation server (no install, no key)** — `https://docs.0xinsider.com/mcp` searches and reads the developer documentation over MCP. Add it beside the product server so an agent can look up how an endpoint works before it calls a tool.
 - **Stdio (this npm package)** — run `npx -y @0xinsider/mcp` locally for Claude Code / Cursor / Codex / Gemini CLI. Best when the client can launch a child process and you prefer to keep the API key out of URLs.
 
 <!-- generated-mcp-catalog:start -->
-Both remote HTTP and stdio expose 35 read-only tools from the Rust canonical registry.
+Both remote HTTP and stdio expose 44 read-only tools from the Rust canonical registry.
 
 - `get_leaderboard` — Get Trader Leaderboard (group: traders)
 - `get_trader` — Get Trader Intelligence (group: traders)
 - `batch_get_traders` — Batch Trader Intelligence (group: traders)
-- `get_whale_trades` — List Whale Trades (group: whale_activity)
-- `get_whale_trade` — Get Whale Trade (group: whale_activity)
-- `get_whale_trades_history` — Replay Historical Whale Trades (group: whale_activity)
+- `get_large_trades` — List large trades (group: large_trades)
+- `get_large_trade` — Get large trade (group: large_trades)
+- `get_large_trades_history` — Replay historical large trades (group: large_trades)
+- `get_whale_trades` — List Whale Trades (group: large_trades)
+- `get_whale_trade` — Get Whale Trade (group: large_trades)
+- `get_whale_trades_history` — Replay Historical Whale Trades (group: large_trades)
+- `get_pre_game_sides` — List pre-game sides (group: markets)
+- `get_pre_game_side_observations` — List pre-game side observations (group: markets)
 - `get_sports_edge_signals` — Get Ranked Sports Edge Signals (group: markets)
 - `get_sports_edge_observations` — Get Sports Edge Observations (group: markets)
+- `list_games` — List covered games (group: games)
+- `get_game` — Get one game (group: games)
 - `get_market_intel` — Get Market Intelligence (group: markets)
 - `batch_get_market_intel` — Batch Market Intelligence (group: markets)
 - `get_smart_money_flows` — List Smart-Money Flows (group: markets)
 - `get_sharp_money_flows` — List Sharp-Money Flows (group: markets)
 - `get_market_snapshot` — Get Market Snapshot (group: markets)
-- `get_insider_radar` — Get Insider Radar Flags (group: insider_radar)
-- `get_insider_radar_flag` — Get Insider Radar Flag (group: insider_radar)
+- `get_suspicious_trades` — Get suspicious trades (group: suspicious_trades)
+- `get_suspicious_trade` — Get suspicious trade (group: suspicious_trades)
+- `get_insider_radar` — Get Insider Radar Flags (group: suspicious_trades)
+- `get_insider_radar_flag` — Get Insider Radar Flag (group: suspicious_trades)
 - `get_positions` — List Current Positions (group: traders)
 - `get_position_timeline` — Get Position Timeline (group: traders)
 - `get_position_timeline_by_id` — Get Position Timeline By Trader ID (group: traders)
 - `search_markets` — Search Markets (group: markets)
 - `search_content` — Search Editorial Content (group: content)
 - `explore_markets` — Explore Markets (group: markets)
-- `get_event_replay_since` — Replay Public Events (group: whale_activity)
+- `get_event_replay_since` — Replay Public Events (group: large_trades)
 - `list_webhooks` — List Webhook Endpoints (group: webhooks)
 - `get_webhook` — Get Webhook Endpoint (group: webhooks)
 - `get_daily_report_snapshot` — Get Daily Report Snapshot (group: reports)
@@ -80,6 +89,8 @@ Both remote HTTP and stdio expose 35 read-only tools from the Rust canonical reg
 - `get_pick_of_the_day_archive` — Get Pick of the Day Archive (group: picks)
 <!-- generated-mcp-catalog:end -->
 
+The canonical suspicious-trade tools are `get_suspicious_trades` and `get_suspicious_trade`; the older `get_insider_radar` and `get_insider_radar_flag` stay live as deprecated aliases on the deprecated `/api/v1/insider-radar` paths, and `get_smart_money_flows` stays live as a deprecated alias of `get_sharp_money_flows`.
+
 ## Quick Start
 
 ### Claude Code
@@ -90,7 +101,9 @@ npx -y @0xinsider/mcp init
 
 `init` reads the key without echoing it. For non-interactive setup, set `OXINSIDER_API_KEY` in the process environment or pipe the key on stdin. Do not pass the key as a command-line argument.
 
-Or manually add to `~/.claude/settings.json`:
+`init` adds the server to `~/.claude.json`, where Claude Code keeps user-scoped MCP servers, and moves an entry an earlier version left in `~/.claude/settings.json`, which Claude Code does not read for MCP servers. Open a new Claude Code session, then run `claude mcp list` to confirm.
+
+Or add it by hand to the top-level `mcpServers` object in `~/.claude.json`:
 
 ```json
 {
@@ -177,6 +190,22 @@ npx -y @0xinsider/mcp --help
 
 Get your API key at [0xinsider.com/developers](https://0xinsider.com/developers). Requires a Pro subscription.
 
+## Check access after a lapse
+
+The CLI keeps account diagnostics available when paid data access lapses:
+
+```sh
+0xinsider whoami --json
+0xinsider usage --json
+```
+
+`whoami` calls `GET /api/v1/me` and reports `credential_status` plus
+`entitlement.paid_data_access` and `entitlement.recovery_action`. A lapsed
+credential reports `paid_data_access: "lapsed"` and
+`recovery_action: "renew_subscription"`; `usage` still reports the caller's
+rate-limit, daily-usage and monthly-quota state. Use those fields to choose
+subscription renewal or credential recovery before retrying a paid data call.
+
 ## Security
 
 `init` never prints the API key. If an older version wrote the key to recorded terminal output, rotate the key before you use the new configuration.
@@ -197,7 +226,7 @@ hand. Markers are not used here because an HTML comment inside a table breaks it
 | `get_whale_trade` | Read one whale trade by wt_ ID or raw whale_alerts.id, including persisted suspicion facts |
 | `get_whale_trades_history` | Replay historical whale trades with cursor, market, trader, category, grade, suspicious_only, platform, and time filters |
 | `get_leaderboard` | Top-ranked traders (S/A/B grades) with optional category/strategy filters |
-| `search_markets` | Search prediction markets by keyword |
+| `search_markets` | Search prediction markets by keyword, with cursor pagination (`cursor`, `has_more`, `next_cursor`) |
 | `explore_markets` | Browse whale-active markets with facets and grouped discovery entries |
 | `get_market_intel` | Smart money flow analysis for a specific market |
 | `batch_get_market_intel` | Fetch market intelligence for 1-25 condition IDs in one call |
@@ -207,8 +236,10 @@ hand. Markers are not used here because an HTML comment inside a table breaks it
 | `get_positions` | Current positions with trader, market, value, side, P&L, and freshness context |
 | `get_position_timeline` | Per-market trader fills with running amount and average entry price |
 | `get_position_timeline_by_id` | Per-market trader fills using an internal trader ID alias |
-| `get_insider_radar` | Suspicious trading pattern flags |
-| `get_insider_radar_flag` | Read one insider-radar flag by rf_ ID or raw radar_flags.id |
+| `get_suspicious_trades` | Stored trades whose recorded suspicion score meets the live flag threshold (`severity=watch` returns none: no live watch policy exists) |
+| `get_suspicious_trade` | Read one suspicious trade by rf_ ID or raw numeric `whale_alerts.id` |
+| `get_insider_radar` | Deprecated alias of `get_suspicious_trades`, kept live on the deprecated `/api/v1/insider-radar` path |
+| `get_insider_radar_flag` | Deprecated alias of `get_suspicious_trade`, kept live on the deprecated `/api/v1/insider-radar/{id}` path |
 | `get_event_replay_since` | Durable public event replay after an opaque cursor |
 | `list_webhooks` | Read webhook endpoints owned by the authenticated API-key user |
 | `get_webhook` | Read one webhook endpoint by ID |
@@ -216,7 +247,7 @@ hand. Markers are not used here because an HTML comment inside a table breaks it
 | `get_weekly_report_snapshot` | Read a weekly whale-activity report snapshot by week token or date range |
 | `get_monthly_report_snapshot` | Read a monthly whale-activity report snapshot |
 | `get_trader_export_snapshot` | Read trader export metadata without starting an export job |
-| `get_platforms` | Provider capability matrix: which platforms support grade, P&L, strategy, timeline, whale signal, insider radar, and market snapshot |
+| `get_platforms` | Provider capability matrix: which platforms support grade, P&L, strategy, timeline, whale signal, suspicious trades (and the deprecated `insider_radar` spelling), and market snapshot |
 
 ## Resources
 
@@ -255,7 +286,7 @@ Once configured, ask your AI agent:
 
 ## Rate Limits
 
-100 requests per minute per user. The server returns actionable error messages when limits are hit.
+100 requests per minute per user, and 250,000 requests a calendar month (UTC) included with Pro; over that, pay as you go at USD 0.20 per 1,000 when it is turned on at https://0xinsider.com/developers, otherwise `429` with `error.reason` `monthly_quota_exceeded` until the month resets (from October 1, 2026). The server returns actionable error messages when limits are hit, and every authenticated response carries `X-Monthly-Quota-Remaining` and `X-Monthly-Quota-Reset`.
 
 ## Timeouts
 
@@ -337,8 +368,9 @@ webhook administration, exports, streams and Markdown routes are excluded.
 Stored-session reads obtain current credentials for each page. A 401 permits
 one refresh/reload and one retry of that same page; earlier pages are preserved.
 A rotated token from another process is reused without replaying its consumed
-refresh token. Environment keys are not refreshed. Revocation, subscription
-lapse and insufficient scope remain failures.
+refresh token. Environment keys are not refreshed. Revocation and insufficient
+scope remain failures. A subscription lapse still fails paid data reads, while
+`whoami` and `usage` remain available so the CLI can show the recovery state.
 
 `--timeout-ms` bounds each request including lock waits, refresh and SDK retries (default 30000,
 maximum 300000). `--retries` is 0–3 (default 2); the SDK honors Retry-After within

package/dist/catalog.generated.d.ts

@@ -10,18 +10,38 @@ export declare const MCP_TOOL_CATALOG: readonly [{
     readonly name: "batch_get_traders";
     readonly title: "Batch Trader Intelligence";
     readonly docsGroup: "traders";
+}, {
+    readonly name: "get_large_trades";
+    readonly title: "List large trades";
+    readonly docsGroup: "large_trades";
+}, {
+    readonly name: "get_large_trade";
+    readonly title: "Get large trade";
+    readonly docsGroup: "large_trades";
+}, {
+    readonly name: "get_large_trades_history";
+    readonly title: "Replay historical large trades";
+    readonly docsGroup: "large_trades";
 }, {
     readonly name: "get_whale_trades";
     readonly title: "List Whale Trades";
-    readonly docsGroup: "whale_activity";
+    readonly docsGroup: "large_trades";
 }, {
     readonly name: "get_whale_trade";
     readonly title: "Get Whale Trade";
-    readonly docsGroup: "whale_activity";
+    readonly docsGroup: "large_trades";
 }, {
     readonly name: "get_whale_trades_history";
     readonly title: "Replay Historical Whale Trades";
-    readonly docsGroup: "whale_activity";
+    readonly docsGroup: "large_trades";
+}, {
+    readonly name: "get_pre_game_sides";
+    readonly title: "List pre-game sides";
+    readonly docsGroup: "markets";
+}, {
+    readonly name: "get_pre_game_side_observations";
+    readonly title: "List pre-game side observations";
+    readonly docsGroup: "markets";
 }, {
     readonly name: "get_sports_edge_signals";
     readonly title: "Get Ranked Sports Edge Signals";
@@ -30,6 +50,14 @@ export declare const MCP_TOOL_CATALOG: readonly [{
     readonly name: "get_sports_edge_observations";
     readonly title: "Get Sports Edge Observations";
     readonly docsGroup: "markets";
+}, {
+    readonly name: "list_games";
+    readonly title: "List covered games";
+    readonly docsGroup: "games";
+}, {
+    readonly name: "get_game";
+    readonly title: "Get one game";
+    readonly docsGroup: "games";
 }, {
     readonly name: "get_market_intel";
     readonly title: "Get Market Intelligence";
@@ -50,14 +78,22 @@ export declare const MCP_TOOL_CATALOG: readonly [{
     readonly name: "get_market_snapshot";
     readonly title: "Get Market Snapshot";
     readonly docsGroup: "markets";
+}, {
+    readonly name: "get_suspicious_trades";
+    readonly title: "Get suspicious trades";
+    readonly docsGroup: "suspicious_trades";
+}, {
+    readonly name: "get_suspicious_trade";
+    readonly title: "Get suspicious trade";
+    readonly docsGroup: "suspicious_trades";
 }, {
     readonly name: "get_insider_radar";
     readonly title: "Get Insider Radar Flags";
-    readonly docsGroup: "insider_radar";
+    readonly docsGroup: "suspicious_trades";
 }, {
     readonly name: "get_insider_radar_flag";
     readonly title: "Get Insider Radar Flag";
-    readonly docsGroup: "insider_radar";
+    readonly docsGroup: "suspicious_trades";
 }, {
     readonly name: "get_positions";
     readonly title: "List Current Positions";
@@ -85,7 +121,7 @@ export declare const MCP_TOOL_CATALOG: readonly [{
 }, {
     readonly name: "get_event_replay_since";
     readonly title: "Replay Public Events";
-    readonly docsGroup: "whale_activity";
+    readonly docsGroup: "large_trades";
 }, {
     readonly name: "list_webhooks";
     readonly title: "List Webhook Endpoints";

package/dist/catalog.generated.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"catalog.generated.d.ts","sourceRoot":"","sources":["../src/catalog.generated.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"catalog.generated.d.ts","sourceRoot":"","sources":["../src/catalog.generated.ts"],"names":[],"mappings":"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"}

package/dist/catalog.generated.js

@@ -16,20 +16,45 @@ export const MCP_TOOL_CATALOG = [
         "title": "Batch Trader Intelligence",
         "docsGroup": "traders"
     },
+    {
+        "name": "get_large_trades",
+        "title": "List large trades",
+        "docsGroup": "large_trades"
+    },
+    {
+        "name": "get_large_trade",
+        "title": "Get large trade",
+        "docsGroup": "large_trades"
+    },
+    {
+        "name": "get_large_trades_history",
+        "title": "Replay historical large trades",
+        "docsGroup": "large_trades"
+    },
     {
         "name": "get_whale_trades",
         "title": "List Whale Trades",
-        "docsGroup": "whale_activity"
+        "docsGroup": "large_trades"
     },
     {
         "name": "get_whale_trade",
         "title": "Get Whale Trade",
-        "docsGroup": "whale_activity"
+        "docsGroup": "large_trades"
     },
     {
         "name": "get_whale_trades_history",
         "title": "Replay Historical Whale Trades",
-        "docsGroup": "whale_activity"
+        "docsGroup": "large_trades"
+    },
+    {
+        "name": "get_pre_game_sides",
+        "title": "List pre-game sides",
+        "docsGroup": "markets"
+    },
+    {
+        "name": "get_pre_game_side_observations",
+        "title": "List pre-game side observations",
+        "docsGroup": "markets"
     },
     {
         "name": "get_sports_edge_signals",
@@ -41,6 +66,16 @@ export const MCP_TOOL_CATALOG = [
         "title": "Get Sports Edge Observations",
         "docsGroup": "markets"
     },
+    {
+        "name": "list_games",
+        "title": "List covered games",
+        "docsGroup": "games"
+    },
+    {
+        "name": "get_game",
+        "title": "Get one game",
+        "docsGroup": "games"
+    },
     {
         "name": "get_market_intel",
         "title": "Get Market Intelligence",
@@ -66,15 +101,25 @@ export const MCP_TOOL_CATALOG = [
         "title": "Get Market Snapshot",
         "docsGroup": "markets"
     },
+    {
+        "name": "get_suspicious_trades",
+        "title": "Get suspicious trades",
+        "docsGroup": "suspicious_trades"
+    },
+    {
+        "name": "get_suspicious_trade",
+        "title": "Get suspicious trade",
+        "docsGroup": "suspicious_trades"
+    },
     {
         "name": "get_insider_radar",
         "title": "Get Insider Radar Flags",
-        "docsGroup": "insider_radar"
+        "docsGroup": "suspicious_trades"
     },
     {
         "name": "get_insider_radar_flag",
         "title": "Get Insider Radar Flag",
-        "docsGroup": "insider_radar"
+        "docsGroup": "suspicious_trades"
     },
     {
         "name": "get_positions",
@@ -109,7 +154,7 @@ export const MCP_TOOL_CATALOG = [
     {
         "name": "get_event_replay_since",
         "title": "Replay Public Events",
-        "docsGroup": "whale_activity"
+        "docsGroup": "large_trades"
     },
     {
         "name": "list_webhooks",

package/dist/catalog.generated.js.map

@@ -1 +1 @@
-{"version":3,"file":"catalog.generated.js","sourceRoot":"","sources":["../src/catalog.generated.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"catalog.generated.js","sourceRoot":"","sources":["../src/catalog.generated.ts"],"names":[],"mappings":"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"}

package/dist/cli-lib.d.ts

@@ -20,7 +20,15 @@ export declare function resolveCliCommand(args: readonly string[]): CliCommand;
 export declare function detectEnvironments(home?: string): Environment[];
 export declare function readJsonFile(path: string): Record<string, JsonValue>;
 export declare function writeJsonFile(path: string, data: Record<string, JsonValue>): void;
+/**
+ * Read-modify-write of a JSON config that another program may be saving at
+ * the same time (#16686). Each attempt edits the file as it is now and only
+ * replaces it if it is still that version, so a field Claude Code wrote in
+ * between is merged rather than lost.
+ */
+export declare function updateJsonFile(path: string, mutate: (config: Record<string, JsonValue>) => void): void;
 export declare function addJsonMcpServer(configPath: string, apiKey: string): void;
+export declare function removeStaleClaudeSettingsServer(home: string): void;
 export declare function addCodexMcpServer(configPath: string, apiKey: string): void;
 export declare function runCli(args: readonly string[]): Promise<void>;
 export {};

package/dist/cli-lib.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-lib.d.ts","sourceRoot":"","sources":["../src/cli-lib.ts"],"names":[],"mappings":"AAeA,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AACnD,MAAM,MAAM,eAAe,GAAG,aAAa,GAAG,QAAQ,GAAG,OAAO,GAAG,YAAY,CAAC;AAEhF,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,eAAe,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,KAAK,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,EAAE,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAE/F,KAAK,SAAS,GAAG;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7B,CAAC;AASF,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAQxD;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAQtD;AAED,wBAAgB,sBAAsB,IAAI,SAAS,CAElD;AAED,wBAAgB,uBAAuB,IAAI,MAAM,CAEhD;AAOD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,UAAU,CAarE;AA2LD,wBAAgB,kBAAkB,CAChC,IAAI,SAAoD,GACvD,WAAW,EAAE,CAwBf;AAiCD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAYpE;AAWD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,IAAI,CAEjF;AAED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CASzE;AAsCD,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAM1E;AA6CD,wBAAsB,MAAM,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAoBnE"}
+{"version":3,"file":"cli-lib.d.ts","sourceRoot":"","sources":["../src/cli-lib.ts"],"names":[],"mappings":"AAyBA,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AACnD,MAAM,MAAM,eAAe,GAAG,aAAa,GAAG,QAAQ,GAAG,OAAO,GAAG,YAAY,CAAC;AAEhF,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,eAAe,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,KAAK,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,EAAE,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAE/F,KAAK,SAAS,GAAG;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7B,CAAC;AASF,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAQxD;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAQtD;AAED,wBAAgB,sBAAsB,IAAI,SAAS,CAElD;AAED,wBAAgB,uBAAuB,IAAI,MAAM,CAEhD;AAOD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,UAAU,CAarE;AA2LD,wBAAgB,kBAAkB,CAChC,IAAI,SAAoD,GACvD,WAAW,EAAE,CA2Bf;AAiCD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAGpE;AAqED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,IAAI,CAEjF;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,KAAK,IAAI,GAClD,IAAI,CAWN;AAED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAQzE;AAKD,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CA0BlE;AAwCD,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAM1E;AAmDD,wBAAsB,MAAM,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAoBnE"}

package/dist/cli-lib.js

@@ -1,6 +1,6 @@
 import { spawnSync } from "node:child_process";
-import { chmodSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
-import { dirname, join } from "node:path";
+import { chmodSync, existsSync, lstatSync, mkdirSync, readFileSync, readlinkSync, renameSync, unlinkSync, writeFileSync, } from "node:fs";
+import { dirname, join, resolve } from "node:path";
 import { createInterface } from "node:readline";
 import { API_KEY_ENV_VAR, DEVELOPERS_URL, MCP_NPX_ARGS, MCP_NPX_COMMAND, PACKAGE_NAME, SERVER_NAME, } from "./constants.js";
 import { runServer } from "./server.js";
@@ -222,9 +222,12 @@ function validateApiKey(apiKey) {
 }
 export function detectEnvironments(home = process.env.HOME ?? process.env.USERPROFILE ?? "") {
     const environments = [];
-    const claudeDir = join(home, ".claude");
-    if (existsSync(claudeDir)) {
-        environments.push({ type: "claude-code", configPath: join(claudeDir, "settings.json") });
+    // Claude Code keeps user-scoped MCP servers in ~/.claude.json, never in
+    // ~/.claude/settings.json: a server written there is not listed by
+    // `claude mcp list` and never starts (#16587).
+    const claudeConfigPath = join(home, ".claude.json");
+    if (existsSync(claudeConfigPath) || existsSync(join(home, ".claude"))) {
+        environments.push({ type: "claude-code", configPath: claudeConfigPath });
     }
     const cursorDir = join(home, ".cursor");
     if (existsSync(cursorDir)) {
@@ -273,8 +276,11 @@ function isJsonRecord(value) {
 export function readJsonFile(path) {
     if (!existsSync(path))
         return {};
+    return parseJsonConfig(path, readFileSync(path, "utf-8"));
+}
+function parseJsonConfig(path, text) {
     try {
-        const parsed = JSON.parse(readFileSync(path, "utf-8"));
+        const parsed = JSON.parse(text);
         if (!isJsonRecord(parsed)) {
             throw new Error(`${path} does not contain a JSON object`);
         }
@@ -285,28 +291,124 @@ export function readJsonFile(path) {
         throw new Error(`Refusing to update malformed MCP config ${path}: ${message}`);
     }
 }
-function writeTextFileRestricted(path, data) {
-    const dir = dirname(path);
+// The file a write to `path` must replace: `path` itself, or the end of its
+// symlink chain. Followed with lstat/readlink rather than realpath, so a
+// DANGLING link (a dotfiles repo whose target is not created yet) is written
+// at its target and stays a link, instead of being replaced by a regular file
+// (#16686).
+function resolveWriteTarget(path) {
+    let current = path;
+    for (let hops = 0; hops < 40; hops += 1) {
+        let isLink;
+        try {
+            isLink = lstatSync(current).isSymbolicLink();
+        }
+        catch (error) {
+            if (error.code === "ENOENT")
+                return current;
+            throw error;
+        }
+        if (!isLink)
+            return current;
+        current = resolve(dirname(current), readlinkSync(current));
+    }
+    throw new Error(`${path}: too many levels of symbolic links`);
+}
+function readTextOrNull(path) {
+    try {
+        return readFileSync(path, "utf-8");
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return null;
+        throw error;
+    }
+}
+// Writes through a temporary file and a rename, so a crash or a concurrent
+// reader never sees a half-written config: ~/.claude.json holds all of Claude
+// Code's state, not only MCP servers. A symlinked config (a dotfiles repo) is
+// resolved first and replaced at its target, so the link survives. `expected`
+// is the text the caller's edit was based on: when the file changed since
+// (Claude Code saved state meanwhile), nothing is replaced and the caller is
+// told to merge again (#16686).
+function writeTextFileRestricted(path, data, expected) {
+    const target = resolveWriteTarget(path);
+    const dir = dirname(target);
     if (!existsSync(dir)) {
         mkdirSync(dir, { recursive: true });
     }
-    writeFileSync(path, data, { mode: 0o600 });
-    chmodSync(path, 0o600);
+    const temporary = `${target}.${process.pid}.tmp`;
+    writeFileSync(temporary, data, { mode: 0o600 });
+    chmodSync(temporary, 0o600);
+    if (expected !== undefined && readTextOrNull(target) !== expected) {
+        unlinkSync(temporary);
+        return false;
+    }
+    renameSync(temporary, target);
+    return true;
 }
 export function writeJsonFile(path, data) {
     writeTextFileRestricted(path, JSON.stringify(data, null, 2) + "\n");
 }
+/**
+ * Read-modify-write of a JSON config that another program may be saving at
+ * the same time (#16686). Each attempt edits the file as it is now and only
+ * replaces it if it is still that version, so a field Claude Code wrote in
+ * between is merged rather than lost.
+ */
+export function updateJsonFile(path, mutate) {
+    const target = resolveWriteTarget(path);
+    for (let attempt = 0; attempt < 5; attempt += 1) {
+        const before = readTextOrNull(target);
+        const config = before === null ? {} : parseJsonConfig(path, before);
+        mutate(config);
+        if (writeTextFileRestricted(path, JSON.stringify(config, null, 2) + "\n", before)) {
+            return;
+        }
+    }
+    throw new Error(`${path} kept changing while it was being updated; close the program writing it and run init again.`);
+}
 export function addJsonMcpServer(configPath, apiKey) {
-    const config = readJsonFile(configPath);
-    const existing = config.mcpServers;
-    const mcpServers = isJsonRecord(existing) ? existing : {};
-    mcpServers[SERVER_NAME] = buildMcpConfig(apiKey);
-    config.mcpServers = mcpServers;
-    writeJsonFile(configPath, config);
+    updateJsonFile(configPath, (config) => {
+        const existing = config.mcpServers;
+        const mcpServers = isJsonRecord(existing) ? existing : {};
+        mcpServers[SERVER_NAME] = buildMcpConfig(apiKey);
+        config.mcpServers = mcpServers;
+    });
     console.log(`\nAdded ${SERVER_NAME} MCP server to ${configPath}`);
 }
+// Moves a server an earlier `init` wrote to ~/.claude/settings.json, where
+// Claude Code never reads it, so the key does not sit in a second file. A
+// settings file this cannot parse is reported and left untouched.
+export function removeStaleClaudeSettingsServer(home) {
+    const settingsPath = join(home, ".claude", "settings.json");
+    if (!existsSync(settingsPath))
+        return;
+    let settings;
+    try {
+        settings = readJsonFile(settingsPath);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        console.error(`\nCould not check ${settingsPath} for an old ${SERVER_NAME} entry (${message}). If it has one, remove it by hand.`);
+        return;
+    }
+    const servers = settings.mcpServers;
+    if (!isJsonRecord(servers) || !(SERVER_NAME in servers))
+        return;
+    updateJsonFile(settingsPath, (current) => {
+        const currentServers = current.mcpServers;
+        if (!isJsonRecord(currentServers))
+            return;
+        delete currentServers[SERVER_NAME];
+        if (Object.keys(currentServers).length === 0) {
+            delete current.mcpServers;
+        }
+    });
+    console.log(`Removed the old ${SERVER_NAME} entry from ${settingsPath}; Claude Code does not read MCP servers from that file.`);
+}
 function printManualInstructions() {
-    console.log("\nClaude Code / Cursor / Gemini CLI JSON:\n");
+    console.log("\nClaude Code (top-level mcpServers in ~/.claude.json), Cursor (~/.cursor/mcp.json), or Gemini CLI (~/.gemini/settings.json) JSON:\n");
     console.log(JSON.stringify({ mcpServers: { [SERVER_NAME]: buildMcpConfigTemplate() } }, null, 2));
     console.log("\nCodex TOML (~/.codex/config.toml):\n");
     console.log(formatCodexTomlTemplate());
@@ -369,6 +471,10 @@ async function runSetup() {
         return;
     }
     addJsonMcpServer(env.configPath, apiKey);
+    if (env.type === "claude-code") {
+        removeStaleClaudeSettingsServer(dirname(env.configPath));
+        console.log("Claude Code loads MCP servers when a session starts: open a new session, then run `claude mcp list` to confirm.");
+    }
 }
 export async function runCli(args) {
     if (isProductCommand(args[0])) {