feat(resources): replace version_tool with mapbox://version resource

CHANGELOG.md

@@ -1,5 +1,13 @@
 ## Unreleased
 
+### Removed
+
+- **version_tool**: Removed from the tool list — version info is now available as a resource at `mapbox://version` with zero token overhead
+
+### New Features
+
+- **mapbox://version resource**: Server version, git SHA, tag, and branch accessible via `readResource('mapbox://version')`
+
 ## 0.10.0 - 2026-03-04
 
 ### New Features

src/resources/index.ts

@@ -30,13 +30,17 @@ import { httpRequest } from '../utils/httpPipeline.js';
 
 // Export all resource classes
 export { CategoryListResource } from './category-list/CategoryListResource.js';
+export { VersionResource } from './version/VersionResource.js';
 
 // Import resource classes for instantiation
 import { CategoryListResource } from './category-list/CategoryListResource.js';
+import { VersionResource } from './version/VersionResource.js';
 
 // Export pre-configured resource instances with short, clean names
 /** Category list for place search (mapbox://categories) */
 export const categoryList = new CategoryListResource({ httpRequest });
+/** Server version info (mapbox://version) */
+export const version = new VersionResource();
 
 // Export registry functions for batch access
 export {

src/resources/resourceRegistry.ts

@@ -5,14 +5,16 @@
 import { CategoryListResource } from './category-list/CategoryListResource.js';
 import { TemporaryDataResource } from './temporary/TemporaryDataResource.js';
 import { StaticMapUIResource } from './ui-apps/StaticMapUIResource.js';
+import { VersionResource } from './version/VersionResource.js';
 import { httpRequest } from '../utils/httpPipeline.js';
 
 // Central registry of all resources
 export const ALL_RESOURCES = [
   // INSERT NEW RESOURCE INSTANCE HERE
   new CategoryListResource({ httpRequest }),
   new TemporaryDataResource(),
-  new StaticMapUIResource()
+  new StaticMapUIResource(),
+  new VersionResource()
 ] as const;
 
 export type ResourceInstance = (typeof ALL_RESOURCES)[number];

src/resources/version/VersionResource.ts

@@ -0,0 +1,33 @@
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
+
+import { BaseResource } from '../BaseResource.js';
+import { getVersionInfo } from '../../utils/versionUtils.js';
+import type { ReadResourceResult } from '@modelcontextprotocol/sdk/types.js';
+
+/**
+ * Resource exposing MCP server version information.
+ *
+ * Available URI:
+ * - mapbox://version
+ */
+export class VersionResource extends BaseResource {
+  readonly uri = 'mapbox://version';
+  readonly name = 'Mapbox MCP Server Version';
+  readonly description =
+    'Version information for the Mapbox MCP server, including version number, git SHA, tag, and branch.';
+  readonly mimeType = 'application/json';
+
+  async read(): Promise<ReadResourceResult> {
+    const info = getVersionInfo();
+    return {
+      contents: [
+        {
+          uri: this.uri,
+          mimeType: 'application/json',
+          text: JSON.stringify(info, null, 2)
+        }
+      ]
+    };
+  }
+}

src/tools/index.ts

@@ -49,8 +49,6 @@ export { ReverseGeocodeTool } from './reverse-geocode-tool/ReverseGeocodeTool.js
 export { SearchAndGeocodeTool } from './search-and-geocode-tool/SearchAndGeocodeTool.js';
 export { SimplifyTool } from './simplify-tool/SimplifyTool.js';
 export { StaticMapImageTool } from './static-map-image-tool/StaticMapImageTool.js';
-export { VersionTool } from './version-tool/VersionTool.js';
-
 // Import tool classes for instantiation
 import { AreaTool } from './area-tool/AreaTool.js';
 import { BearingTool } from './bearing-tool/BearingTool.js';
@@ -72,8 +70,6 @@ import { ReverseGeocodeTool } from './reverse-geocode-tool/ReverseGeocodeTool.js
 import { SearchAndGeocodeTool } from './search-and-geocode-tool/SearchAndGeocodeTool.js';
 import { SimplifyTool } from './simplify-tool/SimplifyTool.js';
 import { StaticMapImageTool } from './static-map-image-tool/StaticMapImageTool.js';
-import { VersionTool } from './version-tool/VersionTool.js';
-
 // Export pre-configured tool instances with short, clean names
 // Note: Import path already indicates these are tools, so we omit the "Tool" suffix
 
@@ -137,9 +133,6 @@ export const simplify = new SimplifyTool();
 /** Generate static map images */
 export const staticMapImage = new StaticMapImageTool({ httpRequest });
 
-/** Get version information */
-export const version = new VersionTool();
-
 // Export registry functions for batch access
 export {
   getCoreTools,

src/tools/toolRegistry.ts

@@ -23,7 +23,6 @@ import { ResourceReaderTool } from './resource-reader-tool/ResourceReaderTool.js
 import { ReverseGeocodeTool } from './reverse-geocode-tool/ReverseGeocodeTool.js';
 import { StaticMapImageTool } from './static-map-image-tool/StaticMapImageTool.js';
 import { SearchAndGeocodeTool } from './search-and-geocode-tool/SearchAndGeocodeTool.js';
-import { VersionTool } from './version-tool/VersionTool.js';
 import { httpRequest } from '../utils/httpPipeline.js';
 
 /**
@@ -42,7 +41,6 @@ export const CORE_TOOLS = [
   new BufferTool(),
   new PointInPolygonTool(),
   new DistanceTool(),
-  new VersionTool(),
   new CategorySearchTool({ httpRequest }),
   new DirectionsTool({ httpRequest }),
   new IsochroneTool({ httpRequest }),