nextbillion-mcp 0.1.6 → 0.1.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nextbillion-mcp",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "description": "MCP server exposing NextBillion.ai location APIs (geocoding, places, routing, maps) as tools for AI agents",
   "license": "Apache-2.0",
   "type": "module",
@@ -29,21 +29,20 @@
   ],
   "scripts": {
     "prepublishOnly": "npm run typecheck && npm run test && npm run build",
-    "build": "tsc -p tsconfig.json && node -e \"require('fs').chmodSync('dist/index.js', 0o755)\"",
+    "build": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\" && esbuild src/index.ts --bundle --platform=node --format=esm --target=node20 --outfile=dist/index.js --log-level=warning && node -e \"require('fs').chmodSync('dist/index.js', 0o755)\"",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "test": "vitest run tests/unit tests/conformance",
     "test:e2e": "vitest run tests/e2e",
     "dev": "tsx src/index.ts"
   },
-  "dependencies": {
-    "@modelcontextprotocol/server": "^2.0.0",
-    "zod": "^4.2.0"
-  },
   "devDependencies": {
     "@modelcontextprotocol/client": "^2.0.0",
+    "@modelcontextprotocol/server": "^2.0.0",
     "@types/node": "^24.0.0",
+    "esbuild": "^0.28.2",
     "tsx": "^4.23.0",
     "typescript": "^7.0.0",
-    "vitest": "^4.1.0"
+    "vitest": "^4.1.0",
+    "zod": "^4.2.0"
   }
 }

package/dist/config.d.ts

@@ -1,17 +0,0 @@
-export interface ServerConfig {
-    apiKey: string;
-    baseUrl: string;
-    timeoutMs: number;
-}
-/**
- * Directory where rendered map images are saved (in addition to being returned inline).
- * Terminal-based MCP clients such as the Codex CLI cannot display image content, so a
- * local file path in the result text is the only way for those users to see the map.
- */
-export declare function imageOutputDir(env?: NodeJS.ProcessEnv): string;
-export declare const DEFAULT_BASE_URL = "https://api.nextbillion.io";
-export declare const DEFAULT_TIMEOUT_MS = 30000;
-export declare class ConfigError extends Error {
-}
-/** Read configuration from environment variables. Throws ConfigError when the API key is missing. */
-export declare function loadConfig(env?: NodeJS.ProcessEnv): ServerConfig;

package/dist/config.js

@@ -1,32 +0,0 @@
-import { tmpdir } from 'node:os';
-import { join } from 'node:path';
-/**
- * Directory where rendered map images are saved (in addition to being returned inline).
- * Terminal-based MCP clients such as the Codex CLI cannot display image content, so a
- * local file path in the result text is the only way for those users to see the map.
- */
-export function imageOutputDir(env = process.env) {
-    return env.NBAI_IMAGE_DIR?.trim() || join(tmpdir(), 'nextbillion-mcp');
-}
-export const DEFAULT_BASE_URL = 'https://api.nextbillion.io';
-export const DEFAULT_TIMEOUT_MS = 30_000;
-export class ConfigError extends Error {
-}
-/** Read configuration from environment variables. Throws ConfigError when the API key is missing. */
-export function loadConfig(env = process.env) {
-    const apiKey = env.NBAI_API_KEY?.trim();
-    if (!apiKey) {
-        throw new ConfigError('NBAI_API_KEY is not set. Get an API key at https://console.nextbillion.ai and ' +
-            'expose it to the server, e.g. NBAI_API_KEY=<your key> npx nextbillion-mcp');
-    }
-    const timeoutMs = env.NBAI_TIMEOUT_MS ? Number(env.NBAI_TIMEOUT_MS) : DEFAULT_TIMEOUT_MS;
-    if (!Number.isFinite(timeoutMs) || timeoutMs <= 0) {
-        throw new ConfigError(`NBAI_TIMEOUT_MS must be a positive number, got: ${env.NBAI_TIMEOUT_MS}`);
-    }
-    return {
-        apiKey,
-        baseUrl: (env.NBAI_BASE_URL?.trim() || DEFAULT_BASE_URL).replace(/\/+$/, ''),
-        timeoutMs,
-    };
-}
-//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAQjC;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,GAAG,GAAsB,OAAO,CAAC,GAAG;IACjE,OAAO,GAAG,CAAC,cAAc,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,iBAAiB,CAAC,CAAC;AACzE,CAAC;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,4BAA4B,CAAC;AAC7D,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAEzC,MAAM,OAAO,WAAY,SAAQ,KAAK;CAAG;AAEzC,qGAAqG;AACrG,MAAM,UAAU,UAAU,CAAC,GAAG,GAAsB,OAAO,CAAC,GAAG;IAC7D,MAAM,MAAM,GAAG,GAAG,CAAC,YAAY,EAAE,IAAI,EAAE,CAAC;IACxC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,WAAW,CACnB,gFAAgF;YAC9E,2EAA2E,CAC9E,CAAC;IACJ,CAAC;IACD,MAAM,SAAS,GAAG,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC;IACzF,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,WAAW,CAAC,mDAAmD,GAAG,CAAC,eAAe,EAAE,CAAC,CAAC;IAClG,CAAC;IACD,OAAO;QACL,MAAM;QACN,OAAO,EAAE,CAAC,GAAG,CAAC,aAAa,EAAE,IAAI,EAAE,IAAI,gBAAgB,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;QAC5E,SAAS;KACV,CAAC;AACJ,CAAC"}

package/dist/core/server.d.ts

@@ -1,13 +0,0 @@
-import { McpServer } from '@modelcontextprotocol/server';
-import type { NbClient } from '../nbclient/client.js';
-export declare const SERVER_NAME = "nextbillion-mcp";
-/**
- * Build one McpServer instance wired to the given NextBillion API client.
- * Used as the per-connection factory for serveStdio (and later HTTP serving).
- *
- * 2026-07-28 spec notes: the SDK provides server/discover, per-request _meta
- * validation, and resultType stamping. The deprecated Roots/Sampling/Logging
- * features are intentionally not implemented. The tool list is static, so
- * tools/list advertises a 24h public cache hint.
- */
-export declare function buildServer(nb: NbClient, version: string): McpServer;

package/dist/core/server.js

@@ -1,62 +0,0 @@
-import { McpServer } from '@modelcontextprotocol/server';
-import { NbApiError } from '../nbclient/errors.js';
-import { ALL_TOOLS } from '../tools/index.js';
-import { ToolInputError } from '../tools/types.js';
-import { logError } from '../log.js';
-export const SERVER_NAME = 'nextbillion-mcp';
-/**
- * Build one McpServer instance wired to the given NextBillion API client.
- * Used as the per-connection factory for serveStdio (and later HTTP serving).
- *
- * 2026-07-28 spec notes: the SDK provides server/discover, per-request _meta
- * validation, and resultType stamping. The deprecated Roots/Sampling/Logging
- * features are intentionally not implemented. The tool list is static, so
- * tools/list advertises a 24h public cache hint.
- */
-export function buildServer(nb, version) {
-    const server = new McpServer({ name: SERVER_NAME, version }, {
-        capabilities: { tools: {} },
-        cacheHints: {
-            'tools/list': { ttlMs: 86_400_000, cacheScope: 'public' },
-        },
-    });
-    for (const tool of ALL_TOOLS) {
-        server.registerTool(tool.name, {
-            title: tool.title,
-            description: tool.description,
-            inputSchema: tool.inputSchema,
-            annotations: tool.annotations,
-        }, async (args) => {
-            try {
-                return await tool.run(args, nb);
-            }
-            catch (error) {
-                return toToolError(tool.name, error);
-            }
-        });
-    }
-    return server;
-}
-/**
- * Upstream API failures and input validation problems come back as ordinary tool
- * results with isError, so the model can read the message and correct its call.
- */
-function toToolError(toolName, error) {
-    if (error instanceof ToolInputError) {
-        return { content: [{ type: 'text', text: `Invalid input: ${error.message}` }], isError: true };
-    }
-    if (error instanceof NbApiError) {
-        return { content: [{ type: 'text', text: error.message }], isError: true };
-    }
-    logError(`Unexpected error in tool ${toolName}`, error);
-    return {
-        content: [
-            {
-                type: 'text',
-                text: `Unexpected error in ${toolName}: ${error instanceof Error ? error.message : String(error)}`,
-            },
-        ],
-        isError: true,
-    };
-}
-//# sourceMappingURL=server.js.map

package/dist/core/server.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/core/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAEnD,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAmB,MAAM,mBAAmB,CAAC;AACpE,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC,MAAM,CAAC,MAAM,WAAW,GAAG,iBAAiB,CAAC;AAE7C;;;;;;;;GAQG;AACH,MAAM,UAAU,WAAW,CAAC,EAAY,EAAE,OAAe;IACvD,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,EAC9B;QACE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;QAC3B,UAAU,EAAE;YACV,YAAY,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE;SAC1D;KACF,CACF,CAAC;IAEF,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,MAAM,CAAC,YAAY,CACjB,IAAI,CAAC,IAAI,EACT;YACE,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;SAC9B,EACD,KAAK,EAAE,IAAa,EAAuB,EAAE;YAC3C,IAAI,CAAC;gBACH,OAAO,MAAM,IAAI,CAAC,GAAG,CAAC,IAAa,EAAE,EAAE,CAAC,CAAC;YAC3C,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YACvC,CAAC;QACH,CAAC,CACF,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,SAAS,WAAW,CAAC,QAAgB,EAAE,KAAc;IACnD,IAAI,KAAK,YAAY,cAAc,EAAE,CAAC;QACpC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACjG,CAAC;IACD,IAAI,KAAK,YAAY,UAAU,EAAE,CAAC;QAChC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC7E,CAAC;IACD,QAAQ,CAAC,4BAA4B,QAAQ,EAAE,EAAE,KAAK,CAAC,CAAC;IACxD,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,uBAAuB,QAAQ,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;aACnG;SACF;QACD,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -1,2 +0,0 @@
-#!/usr/bin/env node
-export {};

package/dist/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEhD,MAAM,GAAG,GAAG,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,iBAAiB,CAAwB,CAAC;AAErF,SAAS,IAAI;IACX,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACtD,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACzB,OAAO;IACT,CAAC;IACD,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACnD,OAAO,CAAC,GAAG,CACT,GAAG,WAAW,IAAI,GAAG,CAAC,OAAO,oDAAoD;YAC/E,gFAAgF;YAChF,0BAA0B;YAC1B,yDAAyD;YACzD,mFAAmF;YACnF,qEAAqE;YACrE,gGAAgG,CACnG,CAAC;QACF,OAAO;IACT,CAAC;IAED,IAAI,MAAM,CAAC;IACX,IAAI,CAAC;QACH,MAAM,GAAG,UAAU,EAAE,CAAC;IACxB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,WAAW,EAAE,CAAC;YACjC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACxB,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;IAED,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC;QACtB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,SAAS,EAAE,MAAM,CAAC,SAAS;KAC5B,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,EAAE,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;IAC9D,OAAO,CAAC,GAAG,WAAW,IAAI,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC;IAE5D,MAAM,QAAQ,GAAG,GAAG,EAAE;QACpB,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACrD,CAAC,CAAC;IACF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC"}

package/dist/log.d.ts

@@ -1,7 +0,0 @@
-/**
- * stdout is the JSON-RPC channel on stdio transports, so all logging goes to stderr.
- * The MCP `logging` capability is deprecated in the 2026-07-28 revision; stderr is
- * the recommended channel for locally-spawned servers.
- */
-export declare function logError(message: string, error?: unknown): void;
-export declare function logInfo(message: string): void;

package/dist/log.js

@@ -1,13 +0,0 @@
-/**
- * stdout is the JSON-RPC channel on stdio transports, so all logging goes to stderr.
- * The MCP `logging` capability is deprecated in the 2026-07-28 revision; stderr is
- * the recommended channel for locally-spawned servers.
- */
-export function logError(message, error) {
-    const detail = error instanceof Error ? `: ${error.message}` : error ? `: ${String(error)}` : '';
-    console.error(`[nextbillion-mcp] ${message}${detail}`);
-}
-export function logInfo(message) {
-    console.error(`[nextbillion-mcp] ${message}`);
-}
-//# sourceMappingURL=log.js.map

package/dist/log.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"log.js","sourceRoot":"","sources":["../src/log.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAC,OAAe,EAAE,KAAe;IACvD,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACjG,OAAO,CAAC,KAAK,CAAC,qBAAqB,OAAO,GAAG,MAAM,EAAE,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,OAAe;IACrC,OAAO,CAAC,KAAK,CAAC,qBAAqB,OAAO,EAAE,CAAC,CAAC;AAChD,CAAC"}

package/dist/nbclient/client.d.ts

@@ -1,39 +0,0 @@
-export type QueryValue = string | number | boolean | undefined;
-/** Arrays produce repeated query parameters (e.g. several `path=` entries). */
-export type Query = Record<string, QueryValue | QueryValue[]>;
-export interface NbClientOptions {
-    apiKey: string;
-    baseUrl?: string;
-    timeoutMs?: number;
-    /** Injectable for tests. Defaults to global fetch. */
-    fetchFn?: typeof fetch;
-    /** Max retries for 429/5xx/network failures on idempotent requests. */
-    maxRetries?: number;
-    /** Injectable for tests. Defaults to a real delay. */
-    sleepFn?: (ms: number) => Promise<void>;
-}
-export interface BinaryResponse {
-    data: Uint8Array;
-    contentType: string;
-}
-/**
- * Single HTTP client shared by every tool: injects the API key, applies timeouts,
- * retries transient failures with backoff, and normalizes errors. All NextBillion
- * endpoints authenticate via the `key` query parameter.
- */
-export declare class NbClient {
-    private readonly apiKey;
-    private readonly baseUrl;
-    private readonly timeoutMs;
-    private readonly fetchFn;
-    private readonly maxRetries;
-    private readonly sleepFn;
-    constructor(options: NbClientOptions);
-    buildUrl(path: string, query?: Query): string;
-    getJson<T = unknown>(path: string, query?: Query): Promise<T>;
-    postJson<T = unknown>(path: string, query: Query, body: unknown): Promise<T>;
-    getBinary(path: string, query?: Query): Promise<BinaryResponse>;
-    private request;
-    private backoffMs;
-    private parseJson;
-}

package/dist/nbclient/client.js

@@ -1,124 +0,0 @@
-import { NbApiError, redactKey } from './errors.js';
-const RETRIABLE_STATUSES = new Set([429, 502, 503, 504]);
-function sleep(ms) {
-    return new Promise((resolve) => setTimeout(resolve, ms));
-}
-/**
- * Single HTTP client shared by every tool: injects the API key, applies timeouts,
- * retries transient failures with backoff, and normalizes errors. All NextBillion
- * endpoints authenticate via the `key` query parameter.
- */
-export class NbClient {
-    apiKey;
-    baseUrl;
-    timeoutMs;
-    fetchFn;
-    maxRetries;
-    sleepFn;
-    constructor(options) {
-        this.apiKey = options.apiKey;
-        this.baseUrl = (options.baseUrl ?? 'https://api.nextbillion.io').replace(/\/+$/, '');
-        this.timeoutMs = options.timeoutMs ?? 30_000;
-        this.fetchFn = options.fetchFn ?? fetch;
-        this.maxRetries = options.maxRetries ?? 2;
-        this.sleepFn = options.sleepFn ?? sleep;
-    }
-    buildUrl(path, query = {}) {
-        const url = new URL(this.baseUrl + path);
-        url.searchParams.set('key', this.apiKey);
-        for (const [name, value] of Object.entries(query)) {
-            for (const entry of Array.isArray(value) ? value : [value]) {
-                if (entry !== undefined)
-                    url.searchParams.append(name, String(entry));
-            }
-        }
-        return url.toString();
-    }
-    async getJson(path, query = {}) {
-        const response = await this.request('GET', this.buildUrl(path, query));
-        return this.parseJson(response);
-    }
-    async postJson(path, query, body) {
-        const response = await this.request('POST', this.buildUrl(path, query), body);
-        return this.parseJson(response);
-    }
-    async getBinary(path, query = {}) {
-        const response = await this.request('GET', this.buildUrl(path, query));
-        return {
-            data: new Uint8Array(await response.arrayBuffer()),
-            contentType: response.headers.get('content-type') ?? 'application/octet-stream',
-        };
-    }
-    async request(method, url, body) {
-        // POST bodies here are all idempotent queries (search/matrix/geocode), so retrying is safe.
-        let lastError;
-        for (let attempt = 0;; attempt++) {
-            let response;
-            try {
-                response = await this.fetchFn(url, {
-                    method,
-                    headers: body !== undefined ? { 'Content-Type': 'application/json' } : undefined,
-                    body: body !== undefined ? JSON.stringify(body) : undefined,
-                    signal: AbortSignal.timeout(this.timeoutMs),
-                });
-            }
-            catch (error) {
-                const timedOut = error instanceof DOMException && error.name === 'TimeoutError';
-                lastError = new NbApiError({
-                    url,
-                    message: timedOut
-                        ? `Request timed out after ${this.timeoutMs} ms`
-                        : `Network error: ${error instanceof Error ? error.message : String(error)}`,
-                });
-                if (attempt < this.maxRetries && !timedOut) {
-                    await this.sleepFn(this.backoffMs(attempt));
-                    continue;
-                }
-                throw lastError;
-            }
-            if (response.ok)
-                return response;
-            const errorBody = await response.text().catch(() => '');
-            lastError = new NbApiError({
-                status: response.status,
-                url,
-                body: errorBody,
-                message: extractApiMessage(errorBody),
-            });
-            if (RETRIABLE_STATUSES.has(response.status) && attempt < this.maxRetries) {
-                await this.sleepFn(this.backoffMs(attempt));
-                continue;
-            }
-            throw lastError;
-        }
-    }
-    backoffMs(attempt) {
-        return 300 * 2 ** attempt + Math.floor(Math.random() * 100);
-    }
-    async parseJson(response) {
-        const text = await response.text();
-        try {
-            return JSON.parse(text);
-        }
-        catch {
-            throw new NbApiError({
-                status: response.status,
-                url: response.url ?? '',
-                body: text,
-                message: `Expected JSON response but got: ${redactKey(text.slice(0, 200))}`,
-            });
-        }
-    }
-}
-/** NextBillion error bodies vary: some use {status, msg}, others {code, message}. */
-function extractApiMessage(bodyText) {
-    try {
-        const parsed = JSON.parse(bodyText);
-        const message = parsed.msg ?? parsed.message ?? parsed.error;
-        return typeof message === 'string' && message.length > 0 ? message : undefined;
-    }
-    catch {
-        return bodyText.length > 0 && bodyText.length <= 300 ? bodyText : undefined;
-    }
-}
-//# sourceMappingURL=client.js.map

package/dist/nbclient/client.js.map

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

package/dist/nbclient/errors.d.ts

@@ -1,13 +0,0 @@
-/** Replace the API key value in any URL or message so it never leaks into tool results or logs. */
-export declare function redactKey(text: string): string;
-export declare class NbApiError extends Error {
-    readonly status: number | undefined;
-    readonly url: string;
-    readonly body: unknown;
-    constructor(options: {
-        status?: number;
-        url: string;
-        body?: unknown;
-        message?: string;
-    });
-}

package/dist/nbclient/errors.js

@@ -1,36 +0,0 @@
-/** Replace the API key value in any URL or message so it never leaks into tool results or logs. */
-export function redactKey(text) {
-    return text.replace(/([?&]key=)[^&\s'"]+/gi, '$1***');
-}
-const STATUS_HINTS = {
-    400: 'Input validation failed — a parameter is missing, malformed, or has an invalid value.',
-    401: 'API key is missing or invalid.',
-    403: 'API key is valid but has no access to this service or geographic region.',
-    404: 'Endpoint not found.',
-    413: 'Request URL or body is too large.',
-    414: 'Request URL is too long (max 8192 bytes) — use an encoded polyline or fewer points.',
-    422: 'The request is valid but no result could be produced (e.g. unroutable coordinates or no matching places).',
-    429: 'Rate limit or usage quota exceeded. Retry later or batch requests.',
-    500: 'NextBillion API internal error.',
-};
-export class NbApiError extends Error {
-    status;
-    url;
-    body;
-    constructor(options) {
-        const hint = options.status !== undefined ? STATUS_HINTS[options.status] : undefined;
-        const parts = [
-            options.status !== undefined
-                ? `NextBillion API error (HTTP ${options.status})`
-                : 'NextBillion API request failed',
-            options.message,
-            hint,
-        ].filter(Boolean);
-        super(redactKey(parts.join(': ')));
-        this.name = 'NbApiError';
-        this.status = options.status;
-        this.url = redactKey(options.url);
-        this.body = options.body;
-    }
-}
-//# sourceMappingURL=errors.js.map

package/dist/nbclient/errors.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/nbclient/errors.ts"],"names":[],"mappings":"AAAA,mGAAmG;AACnG,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,IAAI,CAAC,OAAO,CAAC,uBAAuB,EAAE,OAAO,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,YAAY,GAA2B;IAC3C,GAAG,EAAE,uFAAuF;IAC5F,GAAG,EAAE,gCAAgC;IACrC,GAAG,EAAE,0EAA0E;IAC/E,GAAG,EAAE,qBAAqB;IAC1B,GAAG,EAAE,mCAAmC;IACxC,GAAG,EAAE,qFAAqF;IAC1F,GAAG,EAAE,2GAA2G;IAChH,GAAG,EAAE,oEAAoE;IACzE,GAAG,EAAE,iCAAiC;CACvC,CAAC;AAEF,MAAM,OAAO,UAAW,SAAQ,KAAK;IAC1B,MAAM,CAAqB;IAC3B,GAAG,CAAS;IACZ,IAAI,CAAU;IAEvB,YAAY,OAA2E;QACrF,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACrF,MAAM,KAAK,GAAG;YACZ,OAAO,CAAC,MAAM,KAAK,SAAS;gBAC1B,CAAC,CAAC,+BAA+B,OAAO,CAAC,MAAM,GAAG;gBAClD,CAAC,CAAC,gCAAgC;YACpC,OAAO,CAAC,OAAO;YACf,IAAI;SACL,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAClB,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,GAAG,GAAG,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAC3B,CAAC;CACF"}

package/dist/tools/index.d.ts

@@ -1,7 +0,0 @@
-import type { NbTool } from './types.js';
-/**
- * Every tool served by this MCP server, sorted by name. The order is deliberately
- * deterministic: the 2026-07-28 revision requires list results not to vary per
- * connection, and a stable order improves client-side prompt-cache hits.
- */
-export declare const ALL_TOOLS: ReadonlyArray<NbTool>;

package/dist/tools/index.js

@@ -1,35 +0,0 @@
-import { autocomplete, autosuggest, geocodeForward, placeSearch } from './places/text-search.js';
-import { geocodeBatch } from './places/geocode-batch.js';
-import { geocodeReverse } from './places/geocode-reverse.js';
-import { geocodeStructured } from './places/geocode-structured.js';
-import { placeLookup } from './places/place-lookup.js';
-import { postcodeLookup } from './places/postcode-lookup.js';
-import { directions } from './routing/directions.js';
-import { distanceMatrix } from './routing/distance-matrix.js';
-import { isochrone } from './routing/isochrone.js';
-import { searchAlongRoute } from './routing/search-along-route.js';
-import { staticMapImage } from './maps/static-map-image.js';
-import { staticRouteMap } from './maps/static-route-map.js';
-/**
- * Every tool served by this MCP server, sorted by name. The order is deliberately
- * deterministic: the 2026-07-28 revision requires list results not to vary per
- * connection, and a stable order improves client-side prompt-cache hits.
- */
-export const ALL_TOOLS = [
-    autocomplete,
-    autosuggest,
-    directions,
-    distanceMatrix,
-    geocodeBatch,
-    geocodeForward,
-    geocodeReverse,
-    geocodeStructured,
-    isochrone,
-    placeLookup,
-    placeSearch,
-    postcodeLookup,
-    searchAlongRoute,
-    staticMapImage,
-    staticRouteMap,
-].sort((a, b) => a.name.localeCompare(b.name));
-//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACjG,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAE5D;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAA0B;IAC9C,YAAY;IACZ,WAAW;IACX,UAAU;IACV,cAAc;IACd,YAAY;IACZ,cAAc;IACd,cAAc;IACd,iBAAiB;IACjB,SAAS;IACT,WAAW;IACX,WAAW;IACX,cAAc;IACd,gBAAgB;IAChB,cAAc;IACd,cAAc;CACf,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC"}

package/dist/tools/maps/polyline.d.ts

@@ -1,16 +0,0 @@
-import type { Coordinate } from '../shared/geo.js';
-export declare function decodePolyline(encoded: string): Coordinate[];
-export declare function encodePolyline(points: Coordinate[]): string;
-/** Douglas-Peucker simplification with the tolerance in approximate meters. */
-export declare function simplifyPoints(points: Coordinate[], toleranceMeters: number): Coordinate[];
-export interface FittedGeometry {
-    encoded: string;
-    originalPointCount: number;
-    pointCount: number;
-    simplified: boolean;
-}
-/**
- * Return an encoded polyline whose length is at most `maxEncodedChars`, simplifying
- * with progressively coarser tolerances until it fits (or only endpoints remain).
- */
-export declare function fitPolylineToBudget(points: Coordinate[], maxEncodedChars: number): FittedGeometry;

package/dist/tools/maps/polyline.js

@@ -1,117 +0,0 @@
-/**
- * Google encoded polyline codec (precision 5) plus Douglas-Peucker simplification.
- * Used to shrink long route geometries so the static-image GET URL stays within
- * the API's 8192-byte limit: a 600 km route encodes to ~30k characters (~50 kB
- * URL-encoded), far beyond what the endpoint accepts.
- */
-const PRECISION = 1e5;
-export function decodePolyline(encoded) {
-    const points = [];
-    let index = 0;
-    let lat = 0;
-    let lng = 0;
-    while (index < encoded.length) {
-        lat += readVarint();
-        lng += readVarint();
-        points.push({ latitude: lat / PRECISION, longitude: lng / PRECISION });
-    }
-    return points;
-    function readVarint() {
-        let result = 0;
-        let shift = 0;
-        let byte;
-        do {
-            byte = encoded.charCodeAt(index++) - 63;
-            result |= (byte & 0x1f) << shift;
-            shift += 5;
-        } while (byte >= 0x20);
-        return result & 1 ? ~(result >> 1) : result >> 1;
-    }
-}
-export function encodePolyline(points) {
-    let output = '';
-    let prevLat = 0;
-    let prevLng = 0;
-    for (const point of points) {
-        const lat = Math.round(point.latitude * PRECISION);
-        const lng = Math.round(point.longitude * PRECISION);
-        output += encodeValue(lat - prevLat) + encodeValue(lng - prevLng);
-        prevLat = lat;
-        prevLng = lng;
-    }
-    return output;
-    function encodeValue(value) {
-        let v = value < 0 ? ~(value << 1) : value << 1;
-        let chunk = '';
-        while (v >= 0x20) {
-            chunk += String.fromCharCode((0x20 | (v & 0x1f)) + 63);
-            v >>= 5;
-        }
-        return chunk + String.fromCharCode(v + 63);
-    }
-}
-/** Douglas-Peucker simplification with the tolerance in approximate meters. */
-export function simplifyPoints(points, toleranceMeters) {
-    if (points.length <= 2 || toleranceMeters <= 0)
-        return points;
-    const keep = new Array(points.length).fill(false);
-    keep[0] = keep[points.length - 1] = true;
-    const stack = [[0, points.length - 1]];
-    while (stack.length > 0) {
-        const [start, end] = stack.pop();
-        let maxDistance = 0;
-        let maxIndex = -1;
-        for (let i = start + 1; i < end; i++) {
-            const distance = perpendicularDistanceMeters(points[i], points[start], points[end]);
-            if (distance > maxDistance) {
-                maxDistance = distance;
-                maxIndex = i;
-            }
-        }
-        if (maxIndex !== -1 && maxDistance > toleranceMeters) {
-            keep[maxIndex] = true;
-            stack.push([start, maxIndex], [maxIndex, end]);
-        }
-    }
-    return points.filter((_, i) => keep[i]);
-}
-/** Planar approximation (equirectangular) — accurate enough for display-level simplification. */
-function perpendicularDistanceMeters(p, a, b) {
-    const metersPerDegLat = 111_320;
-    const cosLat = Math.cos((a.latitude * Math.PI) / 180);
-    const toXY = (c) => ({
-        x: c.longitude * metersPerDegLat * cosLat,
-        y: c.latitude * metersPerDegLat,
-    });
-    const P = toXY(p);
-    const A = toXY(a);
-    const B = toXY(b);
-    const dx = B.x - A.x;
-    const dy = B.y - A.y;
-    const lengthSquared = dx * dx + dy * dy;
-    if (lengthSquared === 0)
-        return Math.hypot(P.x - A.x, P.y - A.y);
-    const t = Math.max(0, Math.min(1, ((P.x - A.x) * dx + (P.y - A.y) * dy) / lengthSquared));
-    return Math.hypot(P.x - (A.x + t * dx), P.y - (A.y + t * dy));
-}
-/**
- * Return an encoded polyline whose length is at most `maxEncodedChars`, simplifying
- * with progressively coarser tolerances until it fits (or only endpoints remain).
- */
-export function fitPolylineToBudget(points, maxEncodedChars) {
-    let current = points;
-    let encoded = encodePolyline(current);
-    let tolerance = 5; // meters
-    while (encoded.length > maxEncodedChars && current.length > 2) {
-        current = simplifyPoints(points, tolerance);
-        encoded = encodePolyline(current);
-        tolerance *= 2;
-    }
-    return {
-        encoded,
-        originalPointCount: points.length,
-        pointCount: current.length,
-        simplified: current.length < points.length,
-    };
-}
-//# sourceMappingURL=polyline.js.map

package/dist/tools/maps/polyline.js.map

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