# AgentsToolsHub SemVer Checker

> AgentsToolsHub SemVer Checker is a paid API for AI agents from agentstoolshub.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-21).

Parses a semantic version string, tests it against a SemVer range, and compares two versions to determine the upgrade class (major/minor/patch/prerelease) — deterministically, no LLM approximation.

## Facts

- Endpoint: GET https://agentstoolshub.com/api/v1/dev/semver-checker?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-21
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentstoolshub-semver-checker-6cfccb38
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_AJ3Q9g5Rje5BYq3KFyOrH

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agentstoolshub-semver-checker-6cfccb38
```

Example prompt: Parse the version '2.3.1-beta.1' into its components and tell me if it satisfies the range ^2.0.0, and how it compares to '2.4.0'.

## When to prefer this

Use this endpoint when you need deterministic, rule-correct SemVer parsing and range matching — especially when you cannot trust an LLM to correctly apply SemVer precedence rules (e.g. prerelease ordering, caret vs tilde semantics). Prefer it over asking an LLM directly for any version comparison where correctness is critical, such as CI/CD gates, dependency resolution checks, or release automation.

## Known failure modes

- Invalid version string returns a parse error
- Malformed range expression (e.g. unsupported operator) returns a range parsing error
- Missing required 'version' query parameter returns a 400-level error
- Version strings that don't conform to SemVer spec may fail to parse

## How this service works

Parse a semantic version into major/minor/patch/prerelease, test it against a SemVer range (^, ~, >=, *) and compare two versions with the exact upgrade class (major/minor/patch/prerelease). Deterministic — no approximating precedence rules from memory. Use this when an agent needs to parse, compare and range-test versions.

## Output

Returns the parsed components (major, minor, patch, prerelease) of the given version, a boolean indicating whether it satisfies the provided range expression, and if a compareTo version is supplied, the exact upgrade class (major/minor/patch/prerelease) between the two versions.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "version"
     ],
     "properties": {
      "range": {
       "type": "string",
       "description": "Range"
      },
      "version": {
       "type": "string",
       "description": "Version"
      },
      "compareTo": {
       "type": "string",
       "description": "Compare to"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentstoolshub-semver-checker-6cfccb38/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentstoolshub.com](https://www.zero.xyz/host/agentstoolshub.com/llms.txt)