nextbillion-mcp 0.1.6 → 0.1.7

package/dist/tools/routing/isochrone.d.ts

@@ -1,22 +0,0 @@
-import * as z from 'zod/v4';
-import { type NbTool } from '../types.js';
-declare const Schema: z.ZodObject<{
-    origin: z.ZodObject<{
-        latitude: z.ZodNumber;
-        longitude: z.ZodNumber;
-    }, z.core.$strip>;
-    contours_minutes: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
-    contours_meters: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
-    mode: z.ZodOptional<z.ZodEnum<{
-        bike: "bike";
-        car: "car";
-        motorcycle: "motorcycle";
-        truck: "truck";
-        walk: "walk";
-    }>>;
-    polygons: z.ZodOptional<z.ZodBoolean>;
-    denoise: z.ZodOptional<z.ZodNumber>;
-    departure_time: z.ZodOptional<z.ZodNumber>;
-}, z.core.$strip>;
-export declare const isochrone: NbTool<typeof Schema>;
-export {};

package/dist/tools/routing/isochrone.js

@@ -1,67 +0,0 @@
-import * as z from 'zod/v4';
-import { CoordinateSchema, toLatLng } from '../shared/geo.js';
-import { READ_ONLY, textResult, ToolInputError } from '../types.js';
-const Schema = z.object({
-    origin: CoordinateSchema.describe('Starting point of the reachability analysis'),
-    contours_minutes: z
-        .array(z.number().int().min(1).max(40))
-        .max(4)
-        .optional()
-        .describe('Travel times in minutes, one contour each (max 4 values, increasing, max 40)'),
-    contours_meters: z
-        .array(z.number().int().min(1).max(60_000))
-        .max(4)
-        .optional()
-        .describe('Travel distances in meters, one contour each (max 4 values, increasing, max 60000)'),
-    mode: z
-        .enum(['car', 'truck', 'motorcycle', 'bike', 'walk'])
-        .optional()
-        .describe('Travel mode (default car)'),
-    polygons: z
-        .boolean()
-        .optional()
-        .describe('Return contours as GeoJSON Polygons instead of LineStrings'),
-    denoise: z
-        .number()
-        .min(0)
-        .max(1)
-        .optional()
-        .describe('Remove contours smaller than this fraction of the largest (default 1: largest only)'),
-    departure_time: z
-        .number()
-        .int()
-        .optional()
-        .describe('Departure as a UNIX timestamp in seconds, for typical-traffic analysis'),
-});
-export const isochrone = {
-    name: 'isochrone',
-    title: 'Isochrone',
-    description: 'Calculate the area reachable from a point within given travel time(s) or distance(s). ' +
-        'Returns a GeoJSON FeatureCollection of contours. Note: contour geometry coordinates are ' +
-        'GeoJSON [longitude, latitude] order.',
-    inputSchema: Schema,
-    annotations: READ_ONLY,
-    async run(args, nb) {
-        if (!args.contours_minutes?.length && !args.contours_meters?.length) {
-            throw new ToolInputError('Provide `contours_minutes` or `contours_meters`.');
-        }
-        if (args.contours_minutes?.length && args.contours_meters?.length) {
-            throw new ToolInputError('Provide either `contours_minutes` or `contours_meters`, not both.');
-        }
-        const response = await nb.getJson('/isochrone/json', {
-            coordinates: toLatLng(args.origin),
-            contours_minutes: args.contours_minutes?.join(','),
-            contours_meters: args.contours_meters?.join(','),
-            mode: args.mode,
-            polygons: args.polygons,
-            denoise: args.denoise,
-            departure_time: args.departure_time,
-        });
-        const features = response.features ?? [];
-        const metric = args.contours_minutes?.length ? 'minutes' : 'meters';
-        const values = (args.contours_minutes ?? args.contours_meters ?? []).join(', ');
-        return textResult(`Computed ${features.length} isochrone contour(s) for ${values} ${metric} from ` +
-            `(${args.origin.latitude}, ${args.origin.longitude}). GeoJSON is in structured content.`, response);
-    },
-};
-//# sourceMappingURL=isochrone.js.map

package/dist/tools/routing/isochrone.js.map

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

package/dist/tools/routing/search-along-route.d.ts

@@ -1,17 +0,0 @@
-import * as z from 'zod/v4';
-import { type NbTool } from '../types.js';
-declare const Schema: z.ZodObject<{
-    route_points: z.ZodArray<z.ZodObject<{
-        latitude: z.ZodNumber;
-        longitude: z.ZodNumber;
-    }, z.core.$strip>>;
-    query: z.ZodString;
-    max_detour_seconds: z.ZodOptional<z.ZodNumber>;
-    sort_by: z.ZodOptional<z.ZodEnum<{
-        detour_offset: "detour_offset";
-        detour_time: "detour_time";
-    }>>;
-    limit: z.ZodOptional<z.ZodNumber>;
-}, z.core.$strip>;
-export declare const searchAlongRoute: NbTool<typeof Schema>;
-export {};

package/dist/tools/routing/search-along-route.js

@@ -1,58 +0,0 @@
-import * as z from 'zod/v4';
-import { CoordinateSchema, toLatLngList } from '../shared/geo.js';
-import { READ_ONLY, textResult } from '../types.js';
-const Schema = z.object({
-    route_points: z
-        .array(CoordinateSchema)
-        .min(2)
-        .describe('Waypoints defining the route to search along, in travel order'),
-    query: z.string().min(1).describe('What to find along the route, e.g. "gas station", "coffee"'),
-    max_detour_seconds: z
-        .number()
-        .int()
-        .min(1)
-        .max(3600)
-        .optional()
-        .describe('Max driving time to reach a result after leaving the route (default 900 = 15 min)'),
-    sort_by: z
-        .enum(['detour_time', 'detour_offset'])
-        .optional()
-        .describe('Order by detour driving time, or by distance of the detour point from route start'),
-    limit: z
-        .number()
-        .int()
-        .min(1)
-        .max(20)
-        .optional()
-        .describe('Maximum results (default 10, max 20)'),
-});
-export const searchAlongRoute = {
-    name: 'search_along_route',
-    title: 'Search Along Route',
-    description: 'Find places (POIs) matching a text query along a driving route, with the detour time and ' +
-        'distance each stop adds. Pass the route as an ordered list of waypoints — e.g. the ' +
-        'origin/waypoints/destination used with the directions tool. Ideal for "find X on the way" ' +
-        'questions.',
-    inputSchema: Schema,
-    annotations: READ_ONLY,
-    async run(args, nb) {
-        const response = await nb.postJson('/orbis/alongroute', {}, {
-            route: { points: toLatLngList(args.route_points) },
-            q: args.query,
-            max_detour_time: args.max_detour_seconds,
-            sort_by: args.sort_by,
-            limit: args.limit,
-        });
-        const items = response.items ?? [];
-        const lines = items.slice(0, 5).map((item, index) => {
-            const address = item.address;
-            const detourMin = typeof item.detour_time === 'number' ? Math.round(item.detour_time / 60) : '?';
-            return `${index + 1}. ${item.title} (${address?.label ?? ''}) — ~${detourMin} min detour`;
-        });
-        const more = items.length > 5 ? `\n…and ${items.length - 5} more.` : '';
-        return textResult(items.length > 0
-            ? `${items.length} place(s) along the route:\n${lines.join('\n')}${more}`
-            : 'No places found along the route.', response);
-    },
-};
-//# sourceMappingURL=search-along-route.js.map

package/dist/tools/routing/search-along-route.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"search-along-route.js","sourceRoot":"","sources":["../../../src/tools/routing/search-along-route.ts"],"names":[],"mappings":"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"}

package/dist/tools/shared/geo.d.ts

@@ -1,89 +0,0 @@
-import * as z from 'zod/v4';
-/**
- * Tool inputs always take coordinates as explicit {latitude, longitude} objects.
- * The NextBillion APIs mix `lat,lng` strings, `lng,lat` markers and GeoJSON
- * `[lng,lat]`; keeping one input shape and serializing internally protects the
- * model from the ordering traps.
- */
-export declare const CoordinateSchema: z.ZodObject<{
-    latitude: z.ZodNumber;
-    longitude: z.ZodNumber;
-}, z.core.$strip>;
-export type Coordinate = z.output<typeof CoordinateSchema>;
-/** Serialize to the `lat,lng` string used by all routing/places request parameters. */
-export declare function toLatLng(coordinate: Coordinate): string;
-export declare function toLatLngList(coordinates: Coordinate[]): string;
-export declare const BoundingBoxSchema: z.ZodObject<{
-    west: z.ZodNumber;
-    south: z.ZodNumber;
-    east: z.ZodNumber;
-    north: z.ZodNumber;
-}, z.core.$strip>;
-export type BoundingBox = z.output<typeof BoundingBoxSchema>;
-export declare const CountryCodesSchema: z.ZodArray<z.ZodString>;
-export declare const PlaceTypesSchema: z.ZodArray<z.ZodEnum<{
-    addressBlock: "addressBlock";
-    area: "area";
-    houseNumber: "houseNumber";
-    intersection: "intersection";
-    place: "place";
-    street: "street";
-}>>;
-export declare const ViewSchema: z.ZodEnum<{
-    AR: "AR";
-    CN: "CN";
-    IL: "IL";
-    IN: "IN";
-    MA: "MA";
-    PK: "PK";
-    RU: "RU";
-    TR: "TR";
-    TW: "TW";
-    Unified: "Unified";
-}>;
-/** Common optional geographic filters shared by the Places search tools. */
-export declare const PlacesFilterShape: {
-    near: z.ZodOptional<z.ZodObject<{
-        latitude: z.ZodNumber;
-        longitude: z.ZodNumber;
-    }, z.core.$strip>>;
-    radius_m: z.ZodOptional<z.ZodNumber>;
-    country_codes: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    bounding_box: z.ZodOptional<z.ZodObject<{
-        west: z.ZodNumber;
-        south: z.ZodNumber;
-        east: z.ZodNumber;
-        north: z.ZodNumber;
-    }, z.core.$strip>>;
-    limit: z.ZodOptional<z.ZodNumber>;
-    language: z.ZodOptional<z.ZodString>;
-    view: z.ZodOptional<z.ZodEnum<{
-        AR: "AR";
-        CN: "CN";
-        IL: "IL";
-        IN: "IN";
-        MA: "MA";
-        PK: "PK";
-        RU: "RU";
-        TR: "TR";
-        TW: "TW";
-        Unified: "Unified";
-    }>>;
-};
-export interface PlacesFilterArgs {
-    near?: Coordinate;
-    radius_m?: number;
-    country_codes?: string[];
-    bounding_box?: BoundingBox;
-    limit?: number;
-    language?: string;
-    view?: string;
-}
-/**
- * Build the `at` / `in` / `limit` / `lang` / `view` query parameters from the shared
- * filter arguments. The API allows only one `in=` filter form, so the combinations
- * are validated here with actionable messages.
- */
-export declare function placesFilterQuery(args: PlacesFilterArgs): Record<string, string | number | undefined>;
-/** Compact text summary of a Places `{items: [...]}` response for the model. */
-export declare function summarizePlaces(response: unknown, noun?: string): string;

package/dist/tools/shared/geo.js

@@ -1,100 +0,0 @@
-import * as z from 'zod/v4';
-import { ToolInputError } from '../types.js';
-/**
- * Tool inputs always take coordinates as explicit {latitude, longitude} objects.
- * The NextBillion APIs mix `lat,lng` strings, `lng,lat` markers and GeoJSON
- * `[lng,lat]`; keeping one input shape and serializing internally protects the
- * model from the ordering traps.
- */
-export const CoordinateSchema = z.object({
-    latitude: z.number().min(-90).max(90),
-    longitude: z.number().min(-180).max(180),
-});
-/** Serialize to the `lat,lng` string used by all routing/places request parameters. */
-export function toLatLng(coordinate) {
-    return `${coordinate.latitude},${coordinate.longitude}`;
-}
-export function toLatLngList(coordinates) {
-    return coordinates.map(toLatLng).join('|');
-}
-export const BoundingBoxSchema = z.object({
-    west: z.number().min(-180).max(180).describe('Western longitude'),
-    south: z.number().min(-90).max(90).describe('Southern latitude'),
-    east: z.number().min(-180).max(180).describe('Eastern longitude'),
-    north: z.number().min(-90).max(90).describe('Northern latitude'),
-});
-export const CountryCodesSchema = z
-    .array(z.string().regex(/^[A-Za-z]{3}$/, 'ISO 3166-1 alpha-3 code, e.g. USA'))
-    .min(1)
-    .describe('Restrict results to these countries (ISO 3166-1 alpha-3 codes, e.g. ["USA","MEX"])');
-export const PlaceTypesSchema = z
-    .array(z.enum(['houseNumber', 'addressBlock', 'street', 'intersection', 'place', 'area']))
-    .min(1)
-    .describe('Restrict results to these types: houseNumber (exact door point), addressBlock ' +
-    '(address-range/segment match incl. interpolated numbers), street, intersection ' +
-    '(only returned when requested), place (POI), area (city/district/postal/admin area)');
-export const ViewSchema = z
-    .enum(['Unified', 'AR', 'IL', 'IN', 'MA', 'PK', 'RU', 'TR', 'CN', 'TW'])
-    .describe('Geopolitical view for disputed territories. Default: Unified (or the requester region)');
-/** Common optional geographic filters shared by the Places search tools. */
-export const PlacesFilterShape = {
-    near: CoordinateSchema.optional().describe('Center of the search context; results are ranked around this point'),
-    radius_m: z
-        .number()
-        .int()
-        .positive()
-        .optional()
-        .describe('With `near`: hard-limit results to this radius in meters'),
-    country_codes: CountryCodesSchema.optional(),
-    bounding_box: BoundingBoxSchema.optional().describe('Hard-limit results to this bounding box'),
-    limit: z.number().int().min(1).max(100).optional().describe('Maximum results (default 10)'),
-    language: z.string().optional().describe('Result language as a BCP 47 tag, e.g. "en-US"'),
-    view: ViewSchema.optional(),
-};
-/**
- * Build the `at` / `in` / `limit` / `lang` / `view` query parameters from the shared
- * filter arguments. The API allows only one `in=` filter form, so the combinations
- * are validated here with actionable messages.
- */
-export function placesFilterQuery(args) {
-    const inFilters = [];
-    if (args.country_codes) {
-        inFilters.push(`countryCode:${args.country_codes.map((c) => c.toUpperCase()).join(',')}`);
-    }
-    if (args.bounding_box) {
-        const b = args.bounding_box;
-        inFilters.push(`bbox:${b.west},${b.south},${b.east},${b.north}`);
-    }
-    if (args.radius_m !== undefined) {
-        if (!args.near) {
-            throw new ToolInputError('`radius_m` requires `near` to define the circle center.');
-        }
-        inFilters.push(`circle:${toLatLng(args.near)};r=${args.radius_m}`);
-    }
-    if (inFilters.length > 1) {
-        throw new ToolInputError('Use only one geographic filter: `country_codes`, `bounding_box`, or `near`+`radius_m`.');
-    }
-    return {
-        at: args.near && args.radius_m === undefined ? toLatLng(args.near) : undefined,
-        in: inFilters[0],
-        limit: args.limit,
-        lang: args.language,
-        view: args.view,
-    };
-}
-/** Compact text summary of a Places `{items: [...]}` response for the model. */
-export function summarizePlaces(response, noun = 'result') {
-    const items = response?.items;
-    if (!Array.isArray(items) || items.length === 0)
-        return `No ${noun}s found.`;
-    const lines = items.slice(0, 5).map((item, index) => {
-        const address = item.address;
-        const position = item.position;
-        const label = address?.label ?? item.title ?? 'unknown';
-        const coords = position ? ` (${position.lat}, ${position.lng})` : '';
-        return `${index + 1}. ${label}${coords}`;
-    });
-    const more = items.length > 5 ? `\n…and ${items.length - 5} more.` : '';
-    return `${items.length} ${noun}${items.length === 1 ? '' : 's'} found:\n${lines.join('\n')}${more}`;
-}
-//# sourceMappingURL=geo.js.map

package/dist/tools/shared/geo.js.map

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

package/dist/tools/types.d.ts

@@ -1,46 +0,0 @@
-import type * as z from 'zod/v4';
-import type { NbClient } from '../nbclient/client.js';
-/** Subset of the MCP CallToolResult shape produced by our tools. */
-export interface ToolResult {
-    content: Array<{
-        type: 'text';
-        text: string;
-    } | {
-        type: 'image';
-        data: string;
-        mimeType: string;
-    }>;
-    structuredContent?: Record<string, unknown>;
-    isError?: boolean;
-    [key: string]: unknown;
-}
-export interface ToolAnnotations {
-    readOnlyHint?: boolean;
-    destructiveHint?: boolean;
-    idempotentHint?: boolean;
-    openWorldHint?: boolean;
-}
-/**
- * One NextBillion API wrapped as an MCP tool. Every tool is a plain object so the
- * registry can sort and register them uniformly and tests can call `run` directly.
- */
-export interface NbTool<Schema extends z.ZodType = z.ZodType> {
-    name: string;
-    title: string;
-    description: string;
-    inputSchema: Schema;
-    annotations?: ToolAnnotations;
-    run(args: z.output<Schema>, nb: NbClient): Promise<ToolResult>;
-}
-/** All NextBillion Phase 1 APIs are read-only queries against an open dataset. */
-export declare const READ_ONLY: ToolAnnotations;
-export declare class ToolInputError extends Error {
-}
-/**
- * Build a tool result whose text block carries BOTH a human-readable summary and the
- * complete response as JSON. The MCP spec recommends mirroring structured content
- * into the text block: some hosts (e.g. Claude Desktop) surface only the text to the
- * model, so a summary-only text block made fields such as `access` invisible even
- * though they were present in `structuredContent`.
- */
-export declare function textResult(summary: string, structuredContent?: Record<string, unknown>): ToolResult;

package/dist/tools/types.js

@@ -1,23 +0,0 @@
-/** All NextBillion Phase 1 APIs are read-only queries against an open dataset. */
-export const READ_ONLY = {
-    readOnlyHint: true,
-    destructiveHint: false,
-    idempotentHint: true,
-    openWorldHint: true,
-};
-export class ToolInputError extends Error {
-}
-/**
- * Build a tool result whose text block carries BOTH a human-readable summary and the
- * complete response as JSON. The MCP spec recommends mirroring structured content
- * into the text block: some hosts (e.g. Claude Desktop) surface only the text to the
- * model, so a summary-only text block made fields such as `access` invisible even
- * though they were present in `structuredContent`.
- */
-export function textResult(summary, structuredContent) {
-    const text = structuredContent === undefined
-        ? summary
-        : `${summary}\n\nFull response (JSON):\n${JSON.stringify(structuredContent)}`;
-    return { content: [{ type: 'text', text }], structuredContent };
-}
-//# sourceMappingURL=types.js.map

package/dist/tools/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":"AAiCA,kFAAkF;AAClF,MAAM,CAAC,MAAM,SAAS,GAAoB;IACxC,YAAY,EAAE,IAAI;IAClB,eAAe,EAAE,KAAK;IACtB,cAAc,EAAE,IAAI;IACpB,aAAa,EAAE,IAAI;CACpB,CAAC;AAEF,MAAM,OAAO,cAAe,SAAQ,KAAK;CAAG;AAE5C;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CACxB,OAAe,EACf,iBAA2C;IAE3C,MAAM,IAAI,GACR,iBAAiB,KAAK,SAAS;QAC7B,CAAC,CAAC,OAAO;QACT,CAAC,CAAC,GAAG,OAAO,8BAA8B,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC,EAAE,CAAC;IAClF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,iBAAiB,EAAE,CAAC;AAClE,CAAC"}