# Semver

> Semver is a freemium MCP server for developer tools. Offline semver parsing, comparison and range checks over MCP, for AI agents and developers. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $49 a month
- **Platforms:** API, CLI, Web, self-hosted
- **Website:** https://pipeworx.io/packs/semver
- **Repository:** https://github.com/pipeworx-io/mcp-semver
- **MCP Registry name:** io.github.pipeworx-io/semver
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

The README describes this as a gateway-hosted MCP pack for semantic versioning. Three tools cover parsing a version string into its parts, comparing two versions with prerelease precedence, and testing whether a version satisfies a range written with caret, tilde, comparators, x-ranges, AND and OR syntax.

The site says the parse and compare logic runs offline and needs no key. The npm package is a local stdio bridge that forwards calls to the Pipeworx gateway, so network access is still required for the MCP connection itself.

It suits agents or developers who need reliable version logic inside a tool-calling workflow, such as checking whether a dependency falls within a declared range before an upgrade.

## Features

- **Version parsing:** Splits a semver string into major, minor, patch, prerelease and build fields, with an optional leading v accepted.
- **Prerelease-aware comparison:** Returns -1, 0 or 1 for two versions and honours prerelease precedence rules.
- **Range satisfaction checks:** Tests a version against caret, tilde, comparator, x-range, AND and OR range expressions.
- **Optional API key:** Anonymous calls are daily-capped; an optional Pipeworx key raises the limit.

## Good for

- Checking whether a dependency version falls inside a declared semver range
- Sorting or comparing release tags with prerelease ordering
- Validating version strings before passing them to a build or release script
- Letting an agent reason about upgrade compatibility across package versions

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http semver https://gateway.pipeworx.io/semver/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://gateway.pipeworx.io/semver/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "semver": {
      "url": "https://gateway.pipeworx.io/semver/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "semver": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/semver/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "semver": {
      "serverUrl": "https://gateway.pipeworx.io/semver/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "semver": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/semver/mcp"
    }
  }
}
```

## Tools

- `parse_semver`: Parse a semantic-version string into major/minor/patch/prerelease/build (keyless, offline). Accepts an optional leading "v".
- `compare_semver`: Compare two semver strings. Returns -1 (a<b), 0 (equal), or 1 (a>b), honoring prerelease precedence.
- `satisfies_range`: Test whether a version satisfies a range: exact, ^, ~, comparators, x-ranges, AND (space-separated), OR (||).

## FAQ

### Does the semver parsing need a key?

The site describes parse, compare and range tools as keyless and offline. An optional Pipeworx API key only raises the daily call cap.

### Which tools does the MCP server expose?

The README lists parse_semver, compare_semver and satisfies_range as the pack's own tools, alongside shared gateway meta-tools.

### Is there a free option?

The pricing page describes an anonymous tier of 50 tool calls a day and a free registered tier of 200 calls a day.

### Is Semver free?

Semver has a free plan, with paid plans for more usage or features. Paid plans start at $49 a month.

### How do I add Semver to Claude Code?

Run this command in your terminal: claude mcp add --transport http semver https://gateway.pipeworx.io/semver/mcp

### What are the best alternatives to Semver?

The closest alternatives to Semver are SemverKit, SemVer numbers only, SemVer range operators, value discarded, SemVer shape and Sem.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [SemverKit](https://ai-powered.com/mcp/semverkit): SemverKit is a free MCP server for developer tools.
- [SemVer numbers only](https://ai-powered.com/mcp/semver-numbers-only): SemVer numbers only is an MCP server for developer tools.
- [SemVer range operators, value discarded](https://ai-powered.com/mcp/semver-range-operators-value-discarded): SemVer range operators, value discarded is an MCP server for developer tools.
- [SemVer shape](https://ai-powered.com/mcp/semver-shape): SemVer shape is an MCP server for developer tools.
- [Sem](https://ai-powered.com/mcp/sem): Sem is an open-source MCP server for developer tools.
- [Url](https://ai-powered.com/mcp/url): Url is a freemium MCP server for developer tools.
- [Lens MCP](https://ai-powered.com/mcp/lens-mcp-2): Lens MCP is an open-source MCP server for developer tools.
- [Specwise MCP](https://ai-powered.com/mcp/specwise-mcp): Specwise MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/semver
