@cyanheads/openstreetmap-mcp-server 0.2.0

package/dist/mcp-server/tools/definitions/openstreetmap-format.js

@@ -0,0 +1,36 @@
+/**
+ * @fileoverview Shared formatting helpers for Nominatim place result rendering.
+ * @module mcp-server/tools/definitions/openstreetmap-format
+ */
+/** Address keys to omit from the address details line (technical codes, not human-readable). */
+const ADDR_SKIP_KEYS = new Set(['country_code', 'ISO3166-2-lvl4']);
+/**
+ * Append formatted lines for the common fields shared across all three Nominatim
+ * tool format() functions: OSM ref, category, address breakdown, bounding box, extratags.
+ */
+export function appendPlaceLines(lines, r) {
+    if (r.osm_type && r.osm_id !== undefined) {
+        lines.push(`**OSM:** ${r.osm_type.charAt(0).toUpperCase()}${r.osm_id}`);
+    }
+    if (r.category) {
+        lines.push(`**Category:** ${r.category}${r.type ? ` / ${r.type}` : ''}`);
+    }
+    if (r.address) {
+        const addrParts = Object.entries(r.address)
+            .filter(([k]) => !ADDR_SKIP_KEYS.has(k))
+            .map(([k, v]) => `${k}: ${v}`)
+            .join(', ');
+        if (addrParts)
+            lines.push(`**Address details:** ${addrParts}`);
+    }
+    if (r.boundingbox) {
+        lines.push(`**Bounding box:** S:${r.boundingbox[0]} N:${r.boundingbox[1]} W:${r.boundingbox[2]} E:${r.boundingbox[3]}`);
+    }
+    if (r.extratags && Object.keys(r.extratags).length > 0) {
+        const extra = Object.entries(r.extratags)
+            .map(([k, v]) => `${k}: ${v}`)
+            .join(', ');
+        lines.push(`**Extra tags:** ${extra}`);
+    }
+}
+//# sourceMappingURL=openstreetmap-format.js.map

package/dist/mcp-server/tools/definitions/openstreetmap-format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openstreetmap-format.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/openstreetmap-format.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,gGAAgG;AAChG,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,CAAC,cAAc,EAAE,gBAAgB,CAAC,CAAC,CAAC;AAEnE;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAAe,EACf,CAQC;IAED,IAAI,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACzC,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;IAC1E,CAAC;IACD,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC3E,CAAC;IACD,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;QACd,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;aACxC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;aACvC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;aAC7B,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,IAAI,SAAS;YAAE,KAAK,CAAC,IAAI,CAAC,wBAAwB,SAAS,EAAE,CAAC,CAAC;IACjE,CAAC;IACD,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;QAClB,KAAK,CAAC,IAAI,CACR,uBAAuB,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAC5G,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,CAAC,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvD,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;aACtC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;aAC7B,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,KAAK,CAAC,IAAI,CAAC,mBAAmB,KAAK,EAAE,CAAC,CAAC;IACzC,CAAC;AACH,CAAC"}

package/dist/mcp-server/tools/definitions/openstreetmap-geocode.tool.d.ts

@@ -0,0 +1,59 @@
+/**
+ * @fileoverview Forward geocoding tool — converts place names or addresses to coordinates.
+ * @module mcp-server/tools/definitions/openstreetmap-geocode.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const openstreetmapGeocode: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    query: z.ZodOptional<z.ZodString>;
+    street: z.ZodOptional<z.ZodString>;
+    city: z.ZodOptional<z.ZodString>;
+    county: z.ZodOptional<z.ZodString>;
+    state: z.ZodOptional<z.ZodString>;
+    country: z.ZodOptional<z.ZodString>;
+    postalcode: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    countrycodes: z.ZodOptional<z.ZodString>;
+    layer: z.ZodOptional<z.ZodString>;
+    featureType: z.ZodOptional<z.ZodEnum<{
+        city: "city";
+        state: "state";
+        country: "country";
+        settlement: "settlement";
+    }>>;
+    extratags: z.ZodDefault<z.ZodBoolean>;
+    language: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    results: z.ZodArray<z.ZodObject<{
+        place_id: z.ZodNumber;
+        osm_type: z.ZodOptional<z.ZodEnum<{
+            node: "node";
+            way: "way";
+            relation: "relation";
+        }>>;
+        osm_id: z.ZodOptional<z.ZodNumber>;
+        lat: z.ZodString;
+        lon: z.ZodString;
+        display_name: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+        category: z.ZodOptional<z.ZodString>;
+        type: z.ZodOptional<z.ZodString>;
+        importance: z.ZodOptional<z.ZodNumber>;
+        address: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        boundingbox: z.ZodOptional<z.ZodTuple<[z.ZodString, z.ZodString, z.ZodString, z.ZodString], null>>;
+        extratags: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$strip>>;
+    total: z.ZodNumber;
+    attribution: z.ZodString;
+}, z.core.$strip>, readonly [{
+    readonly reason: "no_results";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "No places matched the query.";
+    readonly recovery: "Try broader terms, remove constraints, or check spelling. For structured queries, try the free-form query parameter.";
+}, {
+    readonly reason: "invalid_input";
+    readonly code: JsonRpcErrorCode.ValidationError;
+    readonly when: "Both query and structured fields are provided, or neither is provided.";
+    readonly recovery: "Provide either the query parameter (free-form) or structured address fields (street, city, etc.), not both.";
+}]>;
+//# sourceMappingURL=openstreetmap-geocode.tool.d.ts.map

package/dist/mcp-server/tools/definitions/openstreetmap-geocode.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openstreetmap-geocode.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/openstreetmap-geocode.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAMjE,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwP/B,CAAC"}

package/dist/mcp-server/tools/definitions/openstreetmap-geocode.tool.js

@@ -0,0 +1,203 @@
+/**
+ * @fileoverview Forward geocoding tool — converts place names or addresses to coordinates.
+ * @module mcp-server/tools/definitions/openstreetmap-geocode.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { getNominatimService } from '../../../services/nominatim/nominatim-service.js';
+import { appendPlaceLines } from './openstreetmap-format.js';
+const ATTRIBUTION = 'Data © OpenStreetMap contributors, ODbL 1.0';
+export const openstreetmapGeocode = tool('openstreetmap_geocode', {
+    title: 'Geocode a place name or address',
+    description: 'Convert a place name or address to geographic coordinates and structured place data via Nominatim/OpenStreetMap. ' +
+        'Accepts either a free-form query string (e.g., "Space Needle Seattle") or structured address fields (street, city, state, etc.) — ' +
+        'the two modes are mutually exclusive. Returns results ordered by Nominatim relevance (importance score). ' +
+        'Use countrycodes to restrict results to specific countries. ' +
+        'For exhaustive POI lists in an area, use openstreetmap_query_nearby or openstreetmap_query_bbox instead — ' +
+        'Nominatim search returns best matches, not all matching objects.',
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+    input: z.object({
+        query: z
+            .string()
+            .optional()
+            .describe('Free-form search string (e.g., "Space Needle Seattle" or "1600 Pennsylvania Ave NW, Washington DC"). Cannot be combined with structured address fields.'),
+        street: z
+            .string()
+            .optional()
+            .describe('House number and street name (structured query). Use with city/state/country fields. Cannot be combined with query.'),
+        city: z.string().optional().describe('City name (structured query).'),
+        county: z.string().optional().describe('County or district (structured query).'),
+        state: z.string().optional().describe('State or province (structured query).'),
+        country: z
+            .string()
+            .optional()
+            .describe('Country name or ISO 3166-1 alpha-2 code (structured query).'),
+        postalcode: z.string().optional().describe('Postal or ZIP code (structured query).'),
+        limit: z
+            .number()
+            .int()
+            .min(1)
+            .max(40)
+            .default(5)
+            .describe('Maximum results to return. Nominatim may return fewer when additional results do not sufficiently match. Max 40.'),
+        countrycodes: z
+            .string()
+            .optional()
+            .describe('Restrict results to one or more countries. Comma-separated ISO 3166-1 alpha-2 codes (e.g., "us,ca"). Preferred over the structured country field when filtering.'),
+        layer: z
+            .string()
+            .optional()
+            .describe('Filter by data layer. Comma-separated values: address, poi, railway, natural, manmade. Default: no restriction.'),
+        featureType: z
+            .enum(['country', 'state', 'city', 'settlement'])
+            .optional()
+            .describe('Restrict results to a geographic feature type. Automatically implies the address layer.'),
+        extratags: z
+            .boolean()
+            .default(false)
+            .describe('Include extra OSM tags when available (e.g., phone, website, opening_hours, wikidata). Increases response size.'),
+        language: z
+            .string()
+            .optional()
+            .describe('Preferred language for result names (BCP 47 code or Accept-Language string, e.g., "en", "de", "fr,en"). Defaults to local OSM language.'),
+    }),
+    output: z.object({
+        results: z
+            .array(z
+            .object({
+            place_id: z
+                .number()
+                .describe('Nominatim internal place ID. Use osm_type+osm_id for stable cross-server references.'),
+            osm_type: z.enum(['node', 'way', 'relation']).optional().describe('OSM object type.'),
+            osm_id: z
+                .number()
+                .optional()
+                .describe('OSM object ID. Combine with osm_type for openstreetmap_lookup.'),
+            lat: z.string().describe('Latitude (WGS84, as string from API).'),
+            lon: z.string().describe('Longitude (WGS84, as string from API).'),
+            display_name: z.string().describe('Full human-readable address string.'),
+            name: z
+                .string()
+                .optional()
+                .describe('Feature name if applicable (e.g., "Space Needle"). Absent for address-only results.'),
+            category: z
+                .string()
+                .optional()
+                .describe('OSM feature category (e.g., "amenity", "man_made", "boundary").'),
+            type: z
+                .string()
+                .optional()
+                .describe('OSM feature type within category (e.g., "hospital", "tower", "administrative").'),
+            importance: z
+                .number()
+                .optional()
+                .describe('Nominatim relevance score (0–1). Higher is more globally prominent.'),
+            address: z
+                .record(z.string(), z.string())
+                .optional()
+                .describe('Structured address breakdown. Keys vary by feature type and country. Common keys: house_number, road, suburb, city, state, postcode, country, country_code.'),
+            boundingbox: z
+                .tuple([z.string(), z.string(), z.string(), z.string()])
+                .optional()
+                .describe('Bounding box as [south, north, west, east] strings.'),
+            extratags: z
+                .record(z.string(), z.string())
+                .optional()
+                .describe('Additional OSM tags (phone, website, opening_hours, wikidata). Present only when extratags was requested.'),
+        })
+            .describe('A single geocoding result.'))
+            .describe('Geocoding results, ordered by Nominatim relevance (importance score descending).'),
+        total: z.number().describe('Number of results returned.'),
+        attribution: z
+            .string()
+            .describe('Required data attribution: Data © OpenStreetMap contributors, ODbL 1.0.'),
+    }),
+    errors: [
+        {
+            reason: 'no_results',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'No places matched the query.',
+            recovery: 'Try broader terms, remove constraints, or check spelling. For structured queries, try the free-form query parameter.',
+        },
+        {
+            reason: 'invalid_input',
+            code: JsonRpcErrorCode.ValidationError,
+            when: 'Both query and structured fields are provided, or neither is provided.',
+            recovery: 'Provide either the query parameter (free-form) or structured address fields (street, city, etc.), not both.',
+        },
+    ],
+    async handler(input, ctx) {
+        const hasQuery = Boolean(input.query?.trim());
+        const hasStructured = Boolean(input.street?.trim() ||
+            input.city?.trim() ||
+            input.county?.trim() ||
+            input.state?.trim() ||
+            input.country?.trim() ||
+            input.postalcode?.trim());
+        if (hasQuery && hasStructured) {
+            throw ctx.fail('invalid_input', 'Cannot combine free-form query with structured address fields.', { ...ctx.recoveryFor('invalid_input') });
+        }
+        if (!hasQuery && !hasStructured) {
+            throw ctx.fail('invalid_input', 'Provide either the query parameter or at least one structured address field.', { ...ctx.recoveryFor('invalid_input') });
+        }
+        const service = getNominatimService();
+        const results = await service.search({
+            ...(hasQuery && input.query ? { q: input.query } : {}),
+            ...(input.street?.trim() ? { street: input.street } : {}),
+            ...(input.city?.trim() ? { city: input.city } : {}),
+            ...(input.county?.trim() ? { county: input.county } : {}),
+            ...(input.state?.trim() ? { state: input.state } : {}),
+            ...(input.country?.trim() ? { country: input.country } : {}),
+            ...(input.postalcode?.trim() ? { postalcode: input.postalcode } : {}),
+            limit: input.limit,
+            ...(input.countrycodes?.trim() ? { countrycodes: input.countrycodes } : {}),
+            ...(input.layer?.trim() ? { layer: input.layer } : {}),
+            ...(input.featureType ? { featureType: input.featureType } : {}),
+            extratags: input.extratags,
+            ...(input.language?.trim() ? { language: input.language } : {}),
+        }, ctx);
+        if (results.length === 0) {
+            throw ctx.fail('no_results', `No places found for "${input.query ?? [input.city, input.state, input.country].filter(Boolean).join(', ')}"`, { ...ctx.recoveryFor('no_results') });
+        }
+        ctx.log.info('Geocode results', { count: results.length });
+        return {
+            results: results.map((r) => ({
+                place_id: r.place_id,
+                ...(r.osm_type ? { osm_type: r.osm_type } : {}),
+                ...(r.osm_id !== undefined ? { osm_id: r.osm_id } : {}),
+                lat: r.lat,
+                lon: r.lon,
+                display_name: r.display_name,
+                ...(r.name ? { name: r.name } : {}),
+                ...(r.category ? { category: r.category } : {}),
+                ...(r.type ? { type: r.type } : {}),
+                ...(r.importance !== undefined ? { importance: r.importance } : {}),
+                ...(r.address ? { address: r.address } : {}),
+                ...(r.boundingbox ? { boundingbox: r.boundingbox } : {}),
+                ...(r.extratags ? { extratags: r.extratags } : {}),
+            })),
+            total: results.length,
+            attribution: ATTRIBUTION,
+        };
+    },
+    format: (result) => {
+        const lines = [
+            `**${result.total} result${result.total === 1 ? '' : 's'} found**`,
+            '',
+        ];
+        for (const r of result.results) {
+            if (r.name)
+                lines.push(`## ${r.name}`);
+            lines.push(`**Address:** ${r.display_name}`);
+            lines.push(`**Coordinates:** ${r.lat}, ${r.lon}`);
+            lines.push(`**Place ID:** ${r.place_id}`);
+            if (r.importance !== undefined)
+                lines.push(`**Importance:** ${r.importance.toFixed(3)}`);
+            appendPlaceLines(lines, r);
+            lines.push('');
+        }
+        lines.push(`*${result.attribution}*`);
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=openstreetmap-geocode.tool.js.map

package/dist/mcp-server/tools/definitions/openstreetmap-geocode.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openstreetmap-geocode.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/openstreetmap-geocode.tool.ts"],"names":[],"mappings":"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"}

package/dist/mcp-server/tools/definitions/openstreetmap-lookup.tool.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @fileoverview OSM ID lookup tool — fetches address details for known OSM objects.
+ * @module mcp-server/tools/definitions/openstreetmap-lookup.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const openstreetmapLookup: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    osm_ids: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
+    extratags: z.ZodDefault<z.ZodBoolean>;
+    language: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    results: z.ZodArray<z.ZodObject<{
+        place_id: z.ZodNumber;
+        osm_type: z.ZodOptional<z.ZodEnum<{
+            node: "node";
+            way: "way";
+            relation: "relation";
+        }>>;
+        osm_id: z.ZodOptional<z.ZodNumber>;
+        lat: z.ZodString;
+        lon: z.ZodString;
+        display_name: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+        category: z.ZodOptional<z.ZodString>;
+        type: z.ZodOptional<z.ZodString>;
+        address: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        boundingbox: z.ZodOptional<z.ZodTuple<[z.ZodString, z.ZodString, z.ZodString, z.ZodString], null>>;
+        extratags: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$strip>>;
+    not_found: z.ZodArray<z.ZodString>;
+    total: z.ZodNumber;
+    attribution: z.ZodString;
+}, z.core.$strip>, readonly [{
+    readonly reason: "invalid_id_format";
+    readonly code: JsonRpcErrorCode.ValidationError;
+    readonly when: "An OSM ID is missing the N/W/R prefix or is otherwise malformed.";
+    readonly recovery: "Prefix each ID with N (node), W (way), or R (relation), e.g., \"N12345\" not \"12345\".";
+}]>;
+//# sourceMappingURL=openstreetmap-lookup.tool.d.ts.map

package/dist/mcp-server/tools/definitions/openstreetmap-lookup.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openstreetmap-lookup.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/openstreetmap-lookup.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AASjE,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuJ9B,CAAC"}

package/dist/mcp-server/tools/definitions/openstreetmap-lookup.tool.js

@@ -0,0 +1,136 @@
+/**
+ * @fileoverview OSM ID lookup tool — fetches address details for known OSM objects.
+ * @module mcp-server/tools/definitions/openstreetmap-lookup.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { getNominatimService } from '../../../services/nominatim/nominatim-service.js';
+import { appendPlaceLines } from './openstreetmap-format.js';
+const ATTRIBUTION = 'Data © OpenStreetMap contributors, ODbL 1.0';
+/** Regex for valid OSM IDs: N/W/R prefix followed by digits. */
+const OSM_ID_PATTERN = /^[NWRnwr]\d+$/;
+export const openstreetmapLookup = tool('openstreetmap_lookup', {
+    title: 'Look up address details for OSM objects by ID',
+    description: 'Fetch address details for one or more known OSM objects by their IDs via Nominatim. ' +
+        'Each ID must be prefixed with N (node), W (way), or R (relation), e.g., "N240109189", "W50637691", "R146656". ' +
+        'Up to 50 IDs per call. ' +
+        'Use when an OSM ID is already known from a prior openstreetmap_query_nearby or openstreetmap_query_bbox result — ' +
+        'this is more efficient than a geocoding round trip to get the full Nominatim address record.',
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+    input: z.object({
+        osm_ids: z
+            .union([
+            z.string().describe('Single OSM ID string, e.g., "N240109189".'),
+            z.array(z.string()).min(1).max(50).describe('Array of OSM ID strings, up to 50.'),
+        ])
+            .describe('One or more OSM IDs, each prefixed with N (node), W (way), or R (relation). E.g., "N240109189", ["W50637691", "R146656"]. Up to 50 IDs per call.'),
+        extratags: z
+            .boolean()
+            .default(false)
+            .describe('Include extra OSM tags (phone, website, wikidata, etc.).'),
+        language: z.string().optional().describe('Preferred language for names (BCP 47 code).'),
+    }),
+    output: z.object({
+        results: z
+            .array(z
+            .object({
+            place_id: z.number().describe('Nominatim internal place ID.'),
+            osm_type: z.enum(['node', 'way', 'relation']).optional().describe('OSM object type.'),
+            osm_id: z.number().optional().describe('OSM object ID.'),
+            lat: z.string().describe('Latitude (WGS84, as string from API).'),
+            lon: z.string().describe('Longitude (WGS84, as string from API).'),
+            display_name: z.string().describe('Full human-readable address string.'),
+            name: z.string().optional().describe('Feature name if applicable.'),
+            category: z.string().optional().describe('OSM feature category.'),
+            type: z.string().optional().describe('OSM feature type within category.'),
+            address: z
+                .record(z.string(), z.string())
+                .optional()
+                .describe('Structured address breakdown. Keys vary by feature type.'),
+            boundingbox: z
+                .tuple([z.string(), z.string(), z.string(), z.string()])
+                .optional()
+                .describe('Bounding box as [south, north, west, east] strings.'),
+            extratags: z
+                .record(z.string(), z.string())
+                .optional()
+                .describe('Additional OSM tags. Present only when extratags was requested.'),
+        })
+            .describe('Address details for a single OSM ID lookup result.'))
+            .describe('Address details for the requested OSM IDs that were found.'),
+        not_found: z.array(z.string()).describe('OSM IDs from the request that returned no result.'),
+        total: z.number().describe('Number of results returned.'),
+        attribution: z
+            .string()
+            .describe('Required data attribution: Data © OpenStreetMap contributors, ODbL 1.0.'),
+    }),
+    errors: [
+        {
+            reason: 'invalid_id_format',
+            code: JsonRpcErrorCode.ValidationError,
+            when: 'An OSM ID is missing the N/W/R prefix or is otherwise malformed.',
+            recovery: 'Prefix each ID with N (node), W (way), or R (relation), e.g., "N12345" not "12345".',
+        },
+    ],
+    async handler(input, ctx) {
+        const ids = Array.isArray(input.osm_ids) ? input.osm_ids : [input.osm_ids];
+        for (const id of ids) {
+            if (!OSM_ID_PATTERN.test(id.trim())) {
+                throw ctx.fail('invalid_id_format', `Invalid OSM ID format: "${id}". IDs must be prefixed with N, W, or R (e.g., "N12345").`, { id, ...ctx.recoveryFor('invalid_id_format') });
+            }
+        }
+        const normalizedIds = ids.map((id) => id.trim().toUpperCase());
+        const service = getNominatimService();
+        const results = await service.lookup({
+            osm_ids: normalizedIds,
+            extratags: input.extratags,
+            ...(input.language?.trim() ? { language: input.language } : {}),
+        }, ctx);
+        const foundOsmIds = new Set(results.flatMap((r) => r.osm_type && r.osm_id !== undefined
+            ? [`${r.osm_type.charAt(0).toUpperCase()}${r.osm_id}`]
+            : []));
+        const notFound = normalizedIds.filter((id) => !foundOsmIds.has(id));
+        ctx.log.info('Lookup results', { found: results.length, notFound: notFound.length });
+        return {
+            results: results.map((r) => ({
+                place_id: r.place_id,
+                ...(r.osm_type ? { osm_type: r.osm_type } : {}),
+                ...(r.osm_id !== undefined ? { osm_id: r.osm_id } : {}),
+                lat: r.lat,
+                lon: r.lon,
+                display_name: r.display_name,
+                ...(r.name ? { name: r.name } : {}),
+                ...(r.category ? { category: r.category } : {}),
+                ...(r.type ? { type: r.type } : {}),
+                ...(r.address ? { address: r.address } : {}),
+                ...(r.boundingbox ? { boundingbox: r.boundingbox } : {}),
+                ...(r.extratags ? { extratags: r.extratags } : {}),
+            })),
+            not_found: notFound,
+            total: results.length,
+            attribution: ATTRIBUTION,
+        };
+    },
+    format: (result) => {
+        const lines = [
+            `**${result.total} result${result.total === 1 ? '' : 's'} found**`,
+            '',
+        ];
+        for (const r of result.results) {
+            if (r.name)
+                lines.push(`## ${r.name}`);
+            lines.push(`**Address:** ${r.display_name}`);
+            lines.push(`**Coordinates:** ${r.lat}, ${r.lon}`);
+            lines.push(`**Place ID:** ${r.place_id}`);
+            appendPlaceLines(lines, r);
+            lines.push('');
+        }
+        if (result.not_found.length > 0) {
+            lines.push(`**Not found:** ${result.not_found.join(', ')}`);
+            lines.push('');
+        }
+        lines.push(`*${result.attribution}*`);
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=openstreetmap-lookup.tool.js.map

package/dist/mcp-server/tools/definitions/openstreetmap-lookup.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openstreetmap-lookup.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/openstreetmap-lookup.tool.ts"],"names":[],"mappings":"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"}

package/dist/mcp-server/tools/definitions/openstreetmap-query-bbox.tool.d.ts

@@ -0,0 +1,57 @@
+/**
+ * @fileoverview Overpass bounding box query tool — finds OSM features within a bbox.
+ * @module mcp-server/tools/definitions/openstreetmap-query-bbox.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const openstreetmapQueryBbox: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    south: z.ZodNumber;
+    west: z.ZodNumber;
+    north: z.ZodNumber;
+    east: z.ZodNumber;
+    amenity: z.ZodOptional<z.ZodString>;
+    tag_key: z.ZodOptional<z.ZodString>;
+    tag_value: z.ZodOptional<z.ZodString>;
+    element_types: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+        node: "node";
+        way: "way";
+        relation: "relation";
+    }>>>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    timeout_seconds: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    elements: z.ZodArray<z.ZodObject<{
+        osm_type: z.ZodEnum<{
+            node: "node";
+            way: "way";
+            relation: "relation";
+        }>;
+        osm_id: z.ZodNumber;
+        lat: z.ZodOptional<z.ZodNumber>;
+        lon: z.ZodOptional<z.ZodNumber>;
+        name: z.ZodOptional<z.ZodString>;
+        tags: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strip>>;
+    total_found: z.ZodNumber;
+    truncated: z.ZodBoolean;
+    data_timestamp: z.ZodString;
+    attribution: z.ZodString;
+}, z.core.$strip>, readonly [{
+    readonly reason: "invalid_tag";
+    readonly code: JsonRpcErrorCode.ValidationError;
+    readonly when: "Both amenity and tag_key/tag_value are provided, or neither is provided.";
+    readonly recovery: "Provide either amenity (e.g., \"hospital\") or tag_key + tag_value (e.g., tag_key=\"leisure\", tag_value=\"park\"), but not both and not neither.";
+}, {
+    readonly reason: "query_timeout";
+    readonly code: JsonRpcErrorCode.Timeout;
+    readonly when: "The Overpass query exceeded the timeout.";
+    readonly retryable: true;
+    readonly recovery: "Reduce the bounding box area, add more specific tag filters, or increase timeout_seconds and retry.";
+}, {
+    readonly reason: "rate_limited";
+    readonly code: JsonRpcErrorCode.ServiceUnavailable;
+    readonly when: "Overpass returned HTTP 429 — all 4 concurrent query slots are occupied.";
+    readonly retryable: true;
+    readonly recovery: "Wait a few seconds and retry. Reduce concurrent calls or switch to a private Overpass instance via OSM_OVERPASS_BASE_URL.";
+}]>;
+//# sourceMappingURL=openstreetmap-query-bbox.tool.d.ts.map

package/dist/mcp-server/tools/definitions/openstreetmap-query-bbox.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openstreetmap-query-bbox.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/openstreetmap-query-bbox.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAMjE,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8LjC,CAAC"}