SemverKit

Working · 1.1 s

dev.workers.mike-tusa.semverkit/semverkitv0.1.0 Domain verified

Semver parse, compare, npm range checks, max-satisfying and version bumps (node-semver compatible).

Developer Tools

Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://semverkit.mike-tusa.workers.dev/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

bump_version Read-only

Compute the next version for a release type (major, minor, patch, premajor, preminor, prepatch, prerelease, release), with an optional prerelease id such as alpha, beta or rc, exactly like npm version / semver.inc. Read-only: nothing is published. Same engine as GET /api/bump.

versionstring, required

Current version: a semantic version such as "1.4.2", "v2.0.0" or "3.0.0-rc.1+build.5".

preidstring

Prerelease identifier, e.g. "beta" (for pre* and prerelease).

releasestring

Release type.

Tools (5)

bump_version

read-only

Argument	Type	Description
preid	string	Prerelease identifier, e.g. "beta" (for pre* and prerelease).
release	string	Release type.
version*	string	Current version: a semantic version such as "1.4.2", "v2.0.0" or "3.0.0-rc.1+build.5".

Input schema (JSON)

{
  "type": "object",
  "required": [
    "version"
  ],
  "properties": {
    "preid": {
      "type": "string",
      "maxLength": 64,
      "minLength": 1,
      "description": "Prerelease identifier, e.g. \"beta\" (for pre* and prerelease)."
    },
    "release": {
      "enum": [
        "major",
        "minor",
        "patch",
        "premajor",
        "preminor",
        "prepatch",
        "prerelease",
        "release"
      ],
      "type": "string",
      "default": "patch",
      "description": "Release type."
    },
    "version": {
      "type": "string",
      "maxLength": 256,
      "minLength": 1,
      "description": "Current version: a semantic version such as \"1.4.2\", \"v2.0.0\" or \"3.0.0-rc.1+build.5\"."
    }
  },
  "additionalProperties": false
}

check_range

Does a version satisfy an npm-style range (^, ~, x-ranges, hyphen ranges, comparators, || alternatives)? Returns the answer and the range desugared into plain comparators (e.g. ^0.2.3 → >=0.2.3 <0.3.0-0), with a note when npm's prerelease rule is why it fails. Read-only. Same engine as GET /api/satisfies.

read-only

Argument	Type	Description
range*	string	npm-style range, e.g. "^1.2.0", "~1.4", ">=1.0.0 <2.0.0", "1.2.3 - 2.x", "1.x \|\| >=3.0.0-beta.1".
version*	string	Version to test: a semantic version such as "1.4.2", "v2.0.0" or "3.0.0-rc.1+build.5".
includePrerelease	boolean	Let prereleases match any range they fall inside (npm includePrerelease). Default false (npm behaviour).

Input schema (JSON)

{
  "type": "object",
  "required": [
    "version",
    "range"
  ],
  "properties": {
    "range": {
      "type": "string",
      "maxLength": 512,
      "minLength": 1,
      "description": "npm-style range, e.g. \"^1.2.0\", \"~1.4\", \">=1.0.0 <2.0.0\", \"1.2.3 - 2.x\", \"1.x || >=3.0.0-beta.1\"."
    },
    "version": {
      "type": "string",
      "maxLength": 256,
      "minLength": 1,
      "description": "Version to test: a semantic version such as \"1.4.2\", \"v2.0.0\" or \"3.0.0-rc.1+build.5\"."
    },
    "includePrerelease": {
      "type": "boolean",
      "default": false,
      "description": "Let prereleases match any range they fall inside (npm includePrerelease). Default false (npm behaviour)."
    }
  },
  "additionalProperties": false
}

compare_versions

Compare a and b by SemVer precedence (prereleases sort before the release, build metadata ignored). Returns -1, 0 or 1 and the change type from the lower to the higher version (major, minor, patch, premajor, preminor, prepatch, prerelease) exactly like semver.diff. Read-only. Same engine as GET /api/compare.

read-only

Argument	Type	Description
a*	string	First version: a semantic version such as "1.4.2", "v2.0.0" or "3.0.0-rc.1+build.5".
b*	string	Second version: a semantic version such as "1.4.2", "v2.0.0" or "3.0.0-rc.1+build.5".

Input schema (JSON)

{
  "type": "object",
  "required": [
    "a",
    "b"
  ],
  "properties": {
    "a": {
      "type": "string",
      "maxLength": 256,
      "minLength": 1,
      "description": "First version: a semantic version such as \"1.4.2\", \"v2.0.0\" or \"3.0.0-rc.1+build.5\"."
    },
    "b": {
      "type": "string",
      "maxLength": 256,
      "minLength": 1,
      "description": "Second version: a semantic version such as \"1.4.2\", \"v2.0.0\" or \"3.0.0-rc.1+build.5\"."
    }
  },
  "additionalProperties": false
}

parse_version

Validate a version against SemVer 2.0.0 and split it into major, minor, patch, prerelease identifiers and build metadata, with isPrerelease/isStable flags. Read-only. Same engine as GET /api/parse.

read-only

Argument	Type	Description
version*	string	Version: a semantic version such as "1.4.2", "v2.0.0" or "3.0.0-rc.1+build.5".

Input schema (JSON)

{
  "type": "object",
  "required": [
    "version"
  ],
  "properties": {
    "version": {
      "type": "string",
      "maxLength": 256,
      "minLength": 1,
      "description": "Version: a semantic version such as \"1.4.2\", \"v2.0.0\" or \"3.0.0-rc.1+build.5\"."
    }
  },
  "additionalProperties": false
}

resolve_versions

Sort 1 to 200 versions by SemVer precedence (duplicates removed, invalid ones listed separately) and, if a range is given, return the matching versions plus maxSatisfying / minSatisfying (what npm would install from that list) and the latest stable version. Read-only. Same engine as GET /api/resolve.

read-only

Argument	Type	Description
range	string	npm-style range, e.g. "^1.2.0", "~1.4", ">=1.0.0 <2.0.0", "1.2.3 - 2.x", "1.x \|\| >=3.0.0-beta.1".
versions*	array	1 to 200 versions.
includePrerelease	boolean	Let prereleases match any range they fall inside (npm includePrerelease). Default false (npm behaviour).

Input schema (JSON)

{
  "type": "object",
  "required": [
    "versions"
  ],
  "properties": {
    "range": {
      "type": "string",
      "maxLength": 512,
      "minLength": 1,
      "description": "npm-style range, e.g. \"^1.2.0\", \"~1.4\", \">=1.0.0 <2.0.0\", \"1.2.3 - 2.x\", \"1.x || >=3.0.0-beta.1\"."
    },
    "versions": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 256,
        "minLength": 1,
        "description": "Version: a semantic version such as \"1.4.2\", \"v2.0.0\" or \"3.0.0-rc.1+build.5\"."
      },
      "maxItems": 200,
      "minItems": 1,
      "description": "1 to 200 versions."
    },
    "includePrerelease": {
      "type": "boolean",
      "default": false,
      "description": "Let prereleases match any range they fall inside (npm includePrerelease). Default false (npm behaviour)."
    }
  },
  "additionalProperties": false
}