{"uid":"cap_AJ3Q9g5Rje5BYq3KFyOrH","slug":"agentstoolshub-semver-checker-6cfccb38","name":"AgentsToolsHub SemVer Checker","description":"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.","url":"https://agentstoolshub.com/api/v1/dev/semver-checker?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_UkQMju-b2ZnEpanfGRMJH","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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'.","exampleUseCases":[{"title":"Dependency range check in CI pipeline","prompt":"Does version 3.1.4 satisfy the semver range ~3.1.0? I need to know before merging this dependency update."},{"title":"Classify upgrade type between releases","prompt":"Compare 1.5.0 to 2.0.0 and tell me whether that's a major, minor, or patch upgrade so I know if it could break our app."},{"title":"Parse prerelease version for display","prompt":"Break down the version string '4.0.0-alpha.3' into its major, minor, patch, and prerelease parts for me."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-21T18:45:27.707Z","isFirstParty":false,"canonicalSlug":"agentstoolshub-semver-checker-6cfccb38"}