snowbll-mcp 0.2.2 → 0.2.3

package/README.md

@@ -13,7 +13,7 @@ Two binaries ship in one package:
 | `snowbll-mcp` | [Model Context Protocol](https://modelcontextprotocol.io) server over stdio — launched by agents (Claude, Cursor, Hermes, …) |
 | `snowbll` | CLI for humans — search, persona, Forge, key management |
 
-There is also a **hosted remote MCP server (developer preview)** at `https://www.snowbll.com/api/mcp` (Streamable HTTP) for clients that connect to URLs instead of launching processes — ChatGPT connectors, Claude custom connectors, Hermes remote MCP. It connects with **no key and no sign-in** — the catalog and Forge tools work right away. Only `get_persona` is consent-scoped: complete the optional OAuth sign-in for the read-only `persona.read` scope (some clients offer it on connect), or pass an `sb_` key.
+There is also a **hosted remote MCP server (developer preview)** at `https://www.snowbll.com/api/mcp` (Streamable HTTP) for clients that connect to URLs instead of launching processes — ChatGPT connectors, Claude custom connectors, Hermes remote MCP. It is an **OAuth 2.1 protected resource**: MCP clients start the sign-in flow automatically on connect (no manual key needed); persona access uses the `persona.read` scope.
 
 ## Tools
 
@@ -33,13 +33,13 @@ Honesty model: `verification` is `verified` only after third-party human testing
 
 ### Claude Code
 
-Hosted (remote — no install, no sign-in to search):
+Hosted (remote, OAuth — no install):
 
 ```bash
 claude mcp add --transport http snowbll https://www.snowbll.com/api/mcp
 ```
 
-It connects right away — the catalog and Forge tools need no sign-in. To also read your persona, run `/mcp` and complete the optional OAuth sign-in (read-only `persona.read` scope).
+Then run `/mcp` and complete the OAuth sign-in when prompted — no manual key needed. Persona access uses the `persona.read` scope.
 
 Or run it locally over stdio (uses `SNOWBLL_API_KEY` if set — see below):
 
@@ -66,14 +66,14 @@ Omit the `env` block to run keyless (search, game lookups, and Forge tools still
 ### ChatGPT (remote connector — no install)
 
 1. Settings → Connectors (requires a plan with connectors/developer mode).
-2. Add a custom connector with URL `https://www.snowbll.com/api/mcp`. It connects with no sign-in — the catalog and Forge tools work right away. For persona, complete the optional OAuth sign-in (read-only `persona.read` scope).
+2. Add a custom connector with URL `https://www.snowbll.com/api/mcp`, then complete the OAuth sign-in when prompted — no manual key needed. Persona access uses the `persona.read` scope.
 3. Ask: *"Use Snowbll to find an economy sim like Lemonade Tycoon with a deep economy."*
 
 The remote server also implements OpenAI's `search` / `fetch` connector contract, so it works in ChatGPT deep research too.
 
 ### Claude (claude.ai custom connector / remote)
 
-Add a custom connector with URL `https://www.snowbll.com/api/mcp` — it connects with no sign-in. The catalog and Forge tools (`search_games`, `get_game`, `list_forge_campaigns`, `get_forge_campaign`) work right away; `get_persona` is consent-scoped (complete the optional OAuth sign-in for read-only `persona.read`).
+Add a custom connector with URL `https://www.snowbll.com/api/mcp` and complete the OAuth sign-in when prompted — no manual key needed. The catalog and Forge tools (`search_games`, `get_game`, `list_forge_campaigns`, `get_forge_campaign`) are free once connected; `get_persona` is consent-scoped via `persona.read`.
 
 ### Verify any setup
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "snowbll-mcp",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "description": "Snowbll MCP server + CLI — search the Snowbll game catalog, read consented personas, and follow Forge campaigns from any MCP-capable AI agent (Claude, ChatGPT, Cursor, Hermes) or your terminal. Live API, no mock data.",
   "type": "module",
   "license": "MIT",