sussy seeds MCP

Local MCP server for ONI seed hunting. Compose constraint specs, scan seeds by the million, inspect hits, share results.

add to Claude Code

claude mcp add sussy-seeds -- npx -y @onimaxxing/sussy-seeds-mcp

Or in .mcp.json (project) / ~/.claude/settings.json (user):

{
  "mcpServers": {
    "sussy-seeds": {
      "command": "npx",
      "args": ["-y", "@onimaxxing/sussy-seeds-mcp"]
    }
  }
}

add to Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json on macOS, or the platform equivalent:

{
  "mcpServers": {
    "sussy-seeds": {
      "command": "npx",
      "args": ["-y", "@onimaxxing/sussy-seeds-mcp"]
    }
  }
}

add to Codex CLI

codex mcp add sussy-seeds -- npx -y @onimaxxing/sussy-seeds-mcp

Or edit ~/.codex/config.toml directly:

[mcp_servers.sussy-seeds]
command = "npx"
args = ["-y", "@onimaxxing/sussy-seeds-mcp"]

add to Cherry Studio

In Cherry Studio, open Settings → MCP Servers → Add Server, set the type to stdio, and fill in:

Command:   npx
Arguments: -y @onimaxxing/sussy-seeds-mcp

add to Trae

In Trae, add the server to ~/.trae/mcp.json (global) or the project's .trae/mcp.json:

{
  "mcpServers": {
    "sussy-seeds": {
      "command": "npx",
      "args": ["-y", "@onimaxxing/sussy-seeds-mcp"]
    }
  }
}

add to Qwen Code

Add an mcpServers entry to ~/.qwen/settings.json:

{
  "mcpServers": {
    "sussy-seeds": {
      "command": "npx",
      "args": ["-y", "@onimaxxing/sussy-seeds-mcp"]
    }
  }
}

other clients

The same {command, args} shape works in Cursor, Windsurf, Zed, Continue, Cline. Claude.ai (web) is not supported, its connectors require a hosted URL and this server runs locally over stdio.

requirements

Node 20 or newer.

tools

Discovery

listClusterscluster ids with disambiguation
listWorlds / listWorldsAcrossClustersworlds in a coord, or across clusters
listGeysers / listTraits / listBiomes / listPoisid catalogs
listStoryTraits / listMixingCategoriesstory traits, DLC mixing
listSpawnTagsspawnable critter / plant tags
listConstraintKindsBuilder AST constraint shapes
listHelpersspec helper functions
listPrefabAdmissibilitywhere a prefab can spawn

Mod content

listModExtensionsWorkshop mods with scannable clusters (coordinatePrefix + worlds), plus trait-overlay mods for setTraitOverlays.
setTraitOverlaysActivate cluster-less trait mods for the session — they merge into every scan's snapshot, like installing the mod in-game.
registerClusterRegister a custom cluster from inline worldgen YAML for the session.
useCgmPresetRegister a Cluster Generation Manager preset as a scannable CGM cluster; baseCoord carries its seed, story traits and mixings.

Coord composition

buildCoordcoord string from form state
parseCoord / describeCoorddecode a coord string
freshCoordrandom coord for a cluster

Admissibility

verdictOf / verdictOfSpeccheck a constraint or full spec against a coord

Scanning

scantop-K over a seed range
scanUntilstop at N matches
scanSeedsone row per input seed

Inspection

getSeedSummary / getSeedDeepworldgen output for one seed
describeSeedplain-English seed readout

Sharing

shareResultsshare URL that loads the spec and pins the seeds in the web scanner

Diagnostics

ping / probeStreaminghealth and progress-stream checks

scanner UI

/sussy-seeds/ runs the same scanner in the browser. Share URLs round-trip between the MCP and the web app. Spec syntax lives in the API docs.