search-rotation 0.4.9 → 0.4.10

package/README.md

@@ -18,6 +18,15 @@ Rotate across available quotas, automatically fail over when a provider is unava
 
 ## Quick start
 
+### npm
+
+```sh
+npx -y search-rotation --http --open
+```
+
+Requires **Node.js 20.3+**. For MCP over stdio, configure your client to run
+`npx -y search-rotation` with no arguments.
+
 ### Homebrew
 
 ```sh
@@ -29,19 +38,13 @@ Homebrew installs the required Node.js runtime. For MCP over stdio, configure yo
 client to run `search-rotation` with no arguments. See the
 [LocalFoundry tap](https://github.com/localfoundry/homebrew-tap) for upgrades and details.
 
-### GitHub / npx
-
-Requires **Node.js 20.3+** and **Git**. Install directly from GitHub — **no npm account needed**.
+### Pinned release from GitHub
 
 ```sh
-npx -y --allow-git=all github:localfoundry/search-rotation-mcp#v0.4.9
+npx -y --allow-git=all github:localfoundry/search-rotation-mcp#v0.4.10
 ```
 
-To preview the dashboard:
-
-```sh
-npx -y --allow-git=all github:localfoundry/search-rotation-mcp#v0.4.9 --http --open
-```
+Use this when you want a fixed version instead of the current npm release.
 
 Add your provider keys in the dashboard, then connect your assistant using the **[MCP client setup guide](docs/clients.md)** for Codex, Claude, Cursor, or OpenCode.
 
@@ -117,7 +120,9 @@ After updating, reconnect your MCP client to load the new tool schema.
 VERSION=0.4.9 ./scripts/release.sh --publish
 ```
 
-The script checks the package (`npm ci`, build, tests, `npm run smoke:package`), bumps the version, points the document pins at it, commits and tags, packs the tarball with its checksum, creates the GitHub release and updates the formula in `localfoundry/homebrew-tap`. Without `--publish` it only prepares the artifacts in `.build/releases`; `--dry-run` checks the prerequisites, `--draft` creates a draft release and `--force` tolerates a dirty tree. The tap is cloned temporarily when `TAP_DIR` is not set, so a fresh checkout is enough.
+The script checks the package (`npm ci`, build, tests, `npm run smoke:package`), bumps the version, points the document pins at it, commits and tags, packs the tarball with its checksum, creates the GitHub release, updates the formula in `localfoundry/homebrew-tap` and finally waits until the npm registry serves the new version. Without `--publish` it only prepares the artifacts in `.build/releases`; `--dry-run` checks the prerequisites, `--draft` creates a draft release and `--force` tolerates a dirty tree. The tap is cloned temporarily when `TAP_DIR` is not set, so a fresh checkout is enough.
+
+Publishing to npm happens in [`.github/workflows/publish.yml`](.github/workflows/publish.yml) through trusted publishing once the GitHub release is published, so the script itself needs no npm credentials. The workflow requires a trusted publisher for `search-rotation` on npmjs.com that points at this repository and `publish.yml`.
 
 ## Learn more
 

package/docs/clients.md

@@ -36,7 +36,7 @@ Add to `~/.codex/config.toml`:
 ```toml
 [mcp_servers.search-rotation]
 command = "npx"
-args = ["-y", "--allow-git=all", "github:localfoundry/search-rotation-mcp#v0.4.9"]
+args = ["-y", "search-rotation"]
 ```
 
 ## Claude Desktop and Cursor
@@ -48,7 +48,7 @@ Add to Claude Desktop's MCP configuration or Cursor's `.cursor/mcp.json`:
   "mcpServers": {
     "search-rotation": {
       "command": "npx",
-      "args": ["-y", "--allow-git=all", "github:localfoundry/search-rotation-mcp#v0.4.9"]
+      "args": ["-y", "search-rotation"]
     }
   }
 }
@@ -57,7 +57,7 @@ Add to Claude Desktop's MCP configuration or Cursor's `.cursor/mcp.json`:
 ## Claude Code
 
 ```sh
-claude mcp add search-rotation -- npx -y --allow-git=all github:localfoundry/search-rotation-mcp#v0.4.9
+claude mcp add search-rotation -- npx -y search-rotation
 ```
 
 ## OpenCode V2
@@ -67,7 +67,7 @@ Add this entry under `mcp.servers`:
 ```json
 "search-rotation": {
   "type": "local",
-  "command": ["npx", "-y", "--allow-git=all", "github:localfoundry/search-rotation-mcp#v0.4.9"],
+  "command": ["npx", "-y", "search-rotation"],
   "codemode": true
 }
 ```
@@ -77,10 +77,12 @@ Add this entry under `mcp.servers`:
 If installed locally, use `search-rotation` as the command. A prebuilt archive is also available under [GitHub Releases](https://github.com/localfoundry/search-rotation-mcp/releases/latest):
 
 ```sh
-npm install -g ./search-rotation-0.4.9.tgz
+npm install -g ./search-rotation-0.4.10.tgz
 ```
 
-`--allow-git=all` permits Git dependencies in npm 12. Older npm versions may display a warning for this option. npm/npx are package tools here; the package is distributed on GitHub.
+npx installs the package from the npm registry, so no Git access is required. The pinned
+`github:localfoundry/search-rotation-mcp#vX` form from the README needs `--allow-git=all`
+instead, because npm 12 resolves Git dependencies only when explicitly allowed.
 
 For remote HTTP access, authentication and advanced settings, see the [operations guide (German)](operations.md).
 

package/docs/operations.md

@@ -26,7 +26,7 @@ Der Gratis-Modus ist **keine Ausgabengarantie**: andere Anwendungen können dass
 ## Remote-Betrieb (Streamable HTTP)
 
 ```bash
-npx -y --allow-git=all github:localfoundry/search-rotation-mcp#v0.4.9 --http --host 0.0.0.0 --port 6277 --public-origin https://search.example.com --token <geheim>
+npx -y search-rotation --http --host 0.0.0.0 --port 6277 --public-origin https://search.example.com --token <geheim>
 ```
 
 Client-Config (Claude):

package/docs/release-notes.md

@@ -1,3 +1,21 @@
+## v0.4.10 — npm distribution and MCP Registry metadata
+
+The package now ships through npm as well, so `npx -y search-rotation` installs the
+latest release without Git. Publishing runs in the release workflow through npm
+trusted publishing, and `mcpName` plus `server.json` carry the metadata for the
+official MCP Registry.
+
+```sh
+brew update && brew upgrade localfoundry/tap/search-rotation
+```
+
+Or run the pinned GitHub version:
+
+```sh
+npx -y --allow-git=all github:localfoundry/search-rotation-mcp#v0.4.10
+```
+
+
 ## v0.4.9 — Updated Node type definitions
 
 Routine maintenance release: the Node type definitions move to 26.6.3. No behaviour change and no configuration migration. The GitHub release page now shows only the notes for the current version instead of the whole changelog.

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "search-rotation",
-  "version": "0.4.9",
+  "version": "0.4.10",
+  "mcpName": "io.github.localfoundry/search-rotation",
   "description": "Round-robin web search over the free tiers of multiple search APIs (Tavily, Firecrawl, Parallel, Exa, Google PSE, Jina, DuckDuckGo) as an MCP server — with a local dashboard for API keys, engine order/toggles and live quota status.",
   "type": "module",
   "license": "MIT",

package/static/app.js

@@ -462,8 +462,7 @@ function sparkline(entries) {
 
 function renderSnippets() {
   const remoteUrl = location.origin + "/mcp";
-  const packageRef = "github:localfoundry/search-rotation-mcp#v" + state.meta.version;
-  const args = ["-y", "--allow-git=all", packageRef];
+  const args = ["-y", "search-rotation"];
   const codex = $("#snip-codex");
   if (!codex) return;
   codex.textContent = '[mcp_servers.search-rotation]\ncommand = "npx"\nargs = ' + JSON.stringify(args);