@onimaxxing/sussy-seeds-mcp 0.1.0 → 0.1.2

package/README.md

@@ -1,14 +1,14 @@
 # @onimaxxing/sussy-seeds-mcp
 
-MCP server for Oxygen Not Included seed hunting. Runs the sussy-seeds wasm scanner over stdio so an LLM can compose Builder AST specs and drive scans against the game's real worldgen.
+MCP server for Oxygen Not Included seed hunting. Runs the sussy-seeds wasm scanner over stdio so an LLM can compose Builder AST specs and drive scans against onimaxxing worldgen.
 
-Same scanner powers the browser app at [onimaxxing.com/sussy-seeds](https://onimaxxing.com/sussy-seeds/). Same wasm, same constraint kinds, shared share-URL format so a chat session can hand off to the web app and back.
+Companion to the browser scanner at [onimaxxing.com/sussy-seeds](https://onimaxxing.com/sussy-seeds/). Shared share-URL format round-trips between the MCP and the web app.
 
 ## Install
 
 ### Claude Code
 
-Add to `.mcp.json` (project scope) or `~/.claude/settings.json` (user scope):
+`.mcp.json` (project) or `~/.claude/settings.json` (user):
 
 ```json
 {
@@ -21,11 +21,9 @@ Add to `.mcp.json` (project scope) or `~/.claude/settings.json` (user scope):
 }
 ```
 
-Reload MCP servers, then ask the LLM to hunt seeds. The first invocation caches the package under npm's `_npx` cache.
-
 ### Claude Desktop
 
-Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or the platform equivalent:
+`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS, or the platform equivalent:
 
 ```json
 {
@@ -38,96 +36,81 @@ Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS)
 }
 ```
 
-Restart Claude Desktop.
+### Codex CLI
+
+```
+codex mcp add sussy-seeds -- npx -y @onimaxxing/sussy-seeds-mcp
+```
+
+Or edit `~/.codex/config.toml` directly:
+
+```toml
+[mcp_servers.sussy-seeds]
+command = "npx"
+args = ["-y", "@onimaxxing/sussy-seeds-mcp"]
+```
 
-### Other MCP clients
+### Other clients
 
-Any client that speaks the stdio transport works. Tool schemas are declared via the standard MCP JSON-RPC surface (`tools/list`, `tools/call`). Progress notifications tagged with `_meta.progressToken` are emitted during long JS-tier scans.
+Same `{command, args}` shape works in Cursor, Windsurf, Zed, Continue, Cline. Progress notifications carry `_meta.progressToken`.
 
 ## Requirements
 
-Node 20 or newer. No ONI install required; the gambling wasm and the worldgen wasm ship inside the depended-on packages.
+Node 20 or newer.
 
 ## Tools
 
-Grouped by phase of a typical hunt.
-
 ### Discovery
 
-Read-only catalogs of ids the LLM composes constraints from. Each takes an optional `coord` and annotates per-world admissibility where the KG can prove it.
-
-- `listClusters({filter?})`, with disambiguation hints for shared-stem labels (`AQU-C` vs `V-AQU-C`)
+- `listClusters({filter?})`
 - `listWorlds({coord})`, `listWorldsAcrossClusters({query})`
 - `listStoryTraits`, `listMixingCategories`
 - `listGeysers`, `listTraits`, `listBiomes`, `listPois`
-- `listSpawnTags({query?, group?})` paginated critter and plant prefab tags
-- `listConstraintKinds` Builder AST catalog with example payloads
-- `listHelpers` ADVANCED_HELPERS names for preHook / postHook use
-- `listPrefabAdmissibility({coord, prefabId})` point check across a cluster's worlds
+- `listSpawnTags({query?, group?, offset?, limit?})`
+- `listConstraintKinds`
+- `listHelpers`
+- `listPrefabAdmissibility({coord, prefabId})`
 
 ### Coord composition
 
-- `buildCoord({formState})`, `parseCoord({coord})`, `describeCoord({coord})`, `freshCoord({clusterPrefix})`
+- `buildCoord({formState})`
+- `parseCoord({coord})`
+- `describeCoord({coord})`
+- `freshCoord({clusterPrefix})`
 
 ### Admissibility
 
-- `verdictOf({coord, constraint})`, `verdictOfSpec({coord, spec})` microsecond KG-side check for structurally-impossible constraints. Catches things like "Niobium ≤ 4 hexes from home on AQU-C" where the KG placement is rings 7-10 and no seed can match.
+- `verdictOf({coord, constraint})`, `verdictOfSpec({coord, spec})`
 
 ### Scanning
 
-JS-tier scans stream progress via `notifications/progress` when the client sends `_meta.progressToken`. Cancellable via the standard JSON-RPC cancel request; server returns the top-K accumulated so far.
+Streams `notifications/progress` when the client sends `_meta.progressToken`. Cancellable via JSON-RPC.
 
-- `scan({coord, spec, opts?})` seed range scan, top-K matches. Auto-selects bytecode tier (~1M seeds/sec/core) for require-only summary specs; falls to JS tier for prefer mode or map-tier constraints.
-- `scanUntil({coord, spec, targetHits, opts?})` stops at N matches.
-- `scanSeeds({coord, spec, seeds})` evaluates against an explicit seed list, one row per input including `pass: false`.
+- `scan({coord, spec, opts?})`: top-K over a seed range. Bytecode tier (~1M/s/core) for require-only summary specs; JS tier otherwise.
+- `scanUntil({coord, spec, targetHits, opts?})`: stops at N matches.
+- `scanSeeds({coord, spec, seeds})`: one row per input seed.
 
-`spec.preHook` and `spec.postHook` accept raw JS bodies that run before requires and after prefers respectively. A reserved-identifier guard rejects sources that would shadow the Builder emit's bindings.
+`spec.preHook` and `spec.postHook` accept raw JS. Reserved-identifier guard rejects sources that shadow the Builder emit's bindings.
 
 ### Inspection
 
-- `getSeedSummary({coord, seed})` cluster shape from the wasm summary. Cheap.
-- `getSeedDeep({coord, seed})` full worldgen projection with geyser rates and positions.
-- `describeSeed({coord, seed, deep?})` plain-English narration.
+- `getSeedSummary({coord, seed})`
+- `getSeedDeep({coord, seed})`
+- `describeSeed({coord, seed, deep?})`
 
 ### Sharing
 
-- `shareResults({coord, spec, seeds, scanLimit?, tab?})` encodes the current session, uploads to the sussy-seeds share endpoint (R2 + CDN), returns `https://onimaxxing.com/sussy-seeds/<hash>`. Opening the URL loads the Builder tab with the exact spec, pins the seeds, sets the coord.
+- `shareResults({coord, spec, seeds, scanLimit?, tab?})`: returns `https://onimaxxing.com/sussy-seeds/<hash>`. Opening the URL loads the spec, pins the seeds, sets the coord.
 
 ### Diagnostics
 
-- `ping()` smoke test.
-- `probeStreaming({steps, delayMs})` emits N progress notifications spaced by delayMs. Use to verify what your MCP client does with the notifications.
+- `ping()`
+- `probeStreaming({steps, delayMs})`
 
 ## Constraint kinds
 
-Every kind the sussy-seeds Builder tab supports is accepted through the MCP surface. Call `listConstraintKinds` for the catalog with example payloads. Current set:
-
 `world.trait`, `world.geyser`, `world.distToHome`, `world.distTo`, `world.traitCount`, `world.oilWells`, `world.critter`, `world.plant`, `world.spawn`, `world.biomeCount`, `world.marshyTungstenInMagma`, `world.niobiumVolcanoAccess`, `world.sussy`, `world.trash`, `world.asteroidRemix`, `poi.count`, `map.elementMass`, `home.geyserNearStart`, `cluster.geyser`, `cluster.oilWells`, `cluster.critter`, `cluster.plant`, `cluster.sussy`, `cluster.trash`.
 
-## Development
-
-Sources live in the [onimaxxing](https://github.com/tigin-backwards/onimaxxing) monorepo at `packages/sussy-seeds-mcp/`, and reach into `apps/onimaxxing/src/gambling/` for the compile-to-js pipeline and constraint AST.
-
-```
-pnpm install
-pnpm --filter @onimaxxing/sussy-seeds-mcp build
-```
-
-For local Claude Code development, point `.mcp.json` at the built file directly:
-
-```json
-{
-  "mcpServers": {
-    "sussy-seeds": {
-      "command": "node",
-      "args": ["/absolute/path/to/packages/sussy-seeds-mcp/dist/index.js"]
-    }
-  }
-}
-```
-
-Reload MCP servers on every rebuild.
-
 ## License
 
 MIT.

package/dist/index.js

@@ -143276,7 +143276,7 @@ function errorPayload(message, extras) {
     content: [
       {
         type: "text",
-        text: JSON.stringify({ ok: false, error: message, ...extras ?? {} })
+        text: JSON.stringify({ ok: false, error: message, ...extras })
       }
     ],
     isError: true

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onimaxxing/sussy-seeds-mcp",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "MCP server for Oxygen Not Included seed hunting. Runs the sussy-seeds wasm scanner over stdio; the LLM composes Builder AST specs and drives cluster / summary / map-tier scans against the game's real worldgen.",
   "keywords": [
     "claude",