Get MantisBT Version
get_mantis_versionRead-onlyIdempotent
Check the current MantisBT version and optionally compare it with the latest GitHub release to verify if your installation is up to date.
Instructions
Returns the version of the connected MantisBT installation and optionally compares it against the latest official release on GitHub.
The version is read from the X-Mantis-Version response header sent by every API call. The GitHub comparison requires an outbound HTTPS request to the GitHub API.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| check_latest | No | Whether to fetch the latest release from GitHub and compare (default: true) |
Implementation Reference
- src/tools/version.ts:36-93 (handler)The `get_mantis_version` tool is registered and implemented within `registerVersionTools` in `src/tools/version.ts`. It handles retrieving the MantisBT version and optionally compares it against the latest GitHub release.
server.registerTool( 'get_mantis_version', { title: 'Get MantisBT Version', description: `Returns the version of the connected MantisBT installation and optionally compares it against the latest official release on GitHub. The version is read from the X-Mantis-Version response header sent by every API call. The GitHub comparison requires an outbound HTTPS request to the GitHub API.`, inputSchema: z.object({ check_latest: z.preprocess(coerceBool, z.boolean()).default(true).describe( 'Whether to fetch the latest release from GitHub and compare (default: true)' ), }), annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, }, }, async ({ check_latest }) => { try { const installedRaw = await client.getVersion(); const result: Record<string, unknown> = { installed_version: installedRaw }; if (check_latest) { versionHint.triggerLatestVersionFetch(); const latestRaw = await versionHint.waitForLatestVersion(5000); result.latest_version = latestRaw; if (latestRaw === null) { result.status = 'unknown'; result.github_note = 'Could not fetch latest version from GitHub (timeout or network error).'; } else { const installed = parseVersion(installedRaw); const latest = parseVersion(latestRaw); if (installed && latest) { const cmp = compareVersions(installed, latest); result.status = cmp === 0 ? 'up-to-date' : cmp > 0 ? 'newer-than-release' : 'update-available'; } else { result.status = 'unknown'; } } } return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }], }; } catch (error) { const msg = error instanceof Error ? error.message : String(error); return { content: [{ type: 'text', text: `Error: ${msg}` }], isError: true }; } } );