nextbillion-mcp 0.1.0

package/dist/config.d.ts

@@ -0,0 +1,11 @@
+export interface ServerConfig {
+    apiKey: string;
+    baseUrl: string;
+    timeoutMs: number;
+}
+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

@@ -0,0 +1,22 @@
+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

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

@@ -0,0 +1,13 @@
+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

@@ -0,0 +1,62 @@
+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

@@ -0,0 +1 @@
+{"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

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

package/dist/index.js

@@ -0,0 +1,50 @@
+#!/usr/bin/env node
+import { createRequire } from 'node:module';
+import { serveStdio } from '@modelcontextprotocol/server/stdio';
+import { ConfigError, loadConfig } from './config.js';
+import { buildServer, SERVER_NAME } from './core/server.js';
+import { logError, logInfo } from './log.js';
+import { NbClient } from './nbclient/client.js';
+const pkg = createRequire(import.meta.url)('../package.json');
+function main() {
+    const args = process.argv.slice(2);
+    if (args.includes('--version') || args.includes('-v')) {
+        console.log(pkg.version);
+        return;
+    }
+    if (args.includes('--help') || args.includes('-h')) {
+        console.log(`${SERVER_NAME} ${pkg.version} — MCP server for NextBillion.ai location APIs\n\n` +
+            'Runs as an MCP stdio server; configure it in your MCP client, not by hand.\n\n' +
+            'Environment variables:\n' +
+            '  NBAI_API_KEY      (required) NextBillion.ai API key\n' +
+            '  NBAI_BASE_URL     (optional) API base URL, default https://api.nextbillion.io\n' +
+            '  NBAI_TIMEOUT_MS   (optional) per-request timeout, default 30000\n');
+        return;
+    }
+    let config;
+    try {
+        config = loadConfig();
+    }
+    catch (error) {
+        if (error instanceof ConfigError) {
+            logError(error.message);
+            process.exitCode = 1;
+            return;
+        }
+        throw error;
+    }
+    const nb = new NbClient({
+        apiKey: config.apiKey,
+        baseUrl: config.baseUrl,
+        timeoutMs: config.timeoutMs,
+    });
+    const handle = serveStdio(() => buildServer(nb, pkg.version));
+    logInfo(`${SERVER_NAME} ${pkg.version} listening on stdio`);
+    const shutdown = () => {
+        void handle.close().finally(() => process.exit(0));
+    };
+    process.on('SIGINT', shutdown);
+    process.on('SIGTERM', shutdown);
+}
+main();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"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,CACxE,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

@@ -0,0 +1,7 @@
+/**
+ * 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

@@ -0,0 +1,13 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,39 @@
+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

@@ -0,0 +1,124 @@
+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

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

package/dist/nbclient/errors.d.ts

@@ -0,0 +1,13 @@
+/** 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

@@ -0,0 +1,36 @@
+/** 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,7 @@
+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

@@ -0,0 +1,35 @@
+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

@@ -0,0 +1 @@
+{"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/static-map-image.d.ts

@@ -0,0 +1,25 @@
+import * as z from 'zod/v4';
+import { type NbTool } from '../types.js';
+declare const Schema: z.ZodObject<{
+    width: z.ZodOptional<z.ZodNumber>;
+    height: z.ZodOptional<z.ZodNumber>;
+    style: z.ZodOptional<z.ZodString>;
+    format: z.ZodOptional<z.ZodEnum<{
+        jpg: "jpg";
+        png: "png";
+        webp: "webp";
+    }>>;
+    retina: z.ZodOptional<z.ZodBoolean>;
+    center: z.ZodObject<{
+        latitude: z.ZodNumber;
+        longitude: z.ZodNumber;
+    }, z.core.$strip>;
+    zoom: z.ZodNumber;
+    markers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        latitude: z.ZodNumber;
+        longitude: z.ZodNumber;
+        color: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export declare const staticMapImage: NbTool<typeof Schema>;
+export {};

package/dist/tools/maps/static-map-image.js

@@ -0,0 +1,31 @@
+import * as z from 'zod/v4';
+import { CoordinateSchema } from '../shared/geo.js';
+import { READ_ONLY } from '../types.js';
+import { fetchImageResult, markerParam, StaticImageShape, staticImagePath, } from './static-shared.js';
+const Schema = z.object({
+    center: CoordinateSchema.describe('Center of the map view'),
+    zoom: z
+        .number()
+        .min(0)
+        .max(22)
+        .describe('Zoom level (0 = world, ~10 = city, ~15 = streets; fractional values allowed)'),
+    markers: z
+        .array(CoordinateSchema.extend({ color: z.string().optional() }))
+        .optional()
+        .describe('Markers to draw, each with optional color (e.g. "red", "#0000ff")'),
+    ...StaticImageShape,
+});
+export const staticMapImage = {
+    name: 'static_map_image',
+    title: 'Static Map Image',
+    description: 'Render a static map image centered on a location, with optional markers. Returns the image ' +
+        'directly. To draw a route on a map use static_route_map instead.',
+    inputSchema: Schema,
+    annotations: READ_ONLY,
+    async run(args, nb) {
+        const position = `${args.center.latitude},${args.center.longitude},${args.zoom}`;
+        return fetchImageResult(nb, staticImagePath(position, args), { markers: args.markers?.length ? markerParam(args.markers) : undefined }, `Map centered at (${args.center.latitude}, ${args.center.longitude}), zoom ${args.zoom}` +
+            (args.markers?.length ? `, ${args.markers.length} marker(s).` : '.'), args);
+    },
+};
+//# sourceMappingURL=static-map-image.js.map

package/dist/tools/maps/static-map-image.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"static-map-image.js","sourceRoot":"","sources":["../../../src/tools/maps/static-map-image.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAe,MAAM,aAAa,CAAC;AACrD,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,gBAAgB,EAChB,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;IACtB,MAAM,EAAE,gBAAgB,CAAC,QAAQ,CAAC,wBAAwB,CAAC;IAC3D,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,EAAE,CAAC;SACP,QAAQ,CAAC,8EAA8E,CAAC;IAC3F,OAAO,EAAE,CAAC;SACP,KAAK,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;SAChE,QAAQ,EAAE;SACV,QAAQ,CAAC,mEAAmE,CAAC;IAChF,GAAG,gBAAgB;CACpB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,cAAc,GAA0B;IACnD,IAAI,EAAE,kBAAkB;IACxB,KAAK,EAAE,kBAAkB;IACzB,WAAW,EACT,6FAA6F;QAC7F,kEAAkE;IACpE,WAAW,EAAE,MAAM;IACnB,WAAW,EAAE,SAAS;IACtB,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE;QAChB,MAAM,QAAQ,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACjF,OAAO,gBAAgB,CACrB,EAAE,EACF,eAAe,CAAC,QAAQ,EAAE,IAAI,CAAC,EAC/B,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,EACzE,oBAAoB,IAAI,CAAC,MAAM,CAAC,QAAQ,KAAK,IAAI,CAAC,MAAM,CAAC,SAAS,WAAW,IAAI,CAAC,IAAI,EAAE;YACtF,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,MAAM,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,EACtE,IAAI,CACL,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/tools/maps/static-route-map.d.ts

@@ -0,0 +1,28 @@
+import * as z from 'zod/v4';
+import { type NbTool } from '../types.js';
+declare const Schema: z.ZodObject<{
+    width: z.ZodOptional<z.ZodNumber>;
+    height: z.ZodOptional<z.ZodNumber>;
+    style: z.ZodOptional<z.ZodString>;
+    format: z.ZodOptional<z.ZodEnum<{
+        jpg: "jpg";
+        png: "png";
+        webp: "webp";
+    }>>;
+    retina: z.ZodOptional<z.ZodBoolean>;
+    encoded_polyline: z.ZodOptional<z.ZodString>;
+    route_points: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        latitude: z.ZodNumber;
+        longitude: z.ZodNumber;
+    }, z.core.$strip>>>;
+    markers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        latitude: z.ZodNumber;
+        longitude: z.ZodNumber;
+        color: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    stroke_color: z.ZodOptional<z.ZodString>;
+    stroke_width: z.ZodOptional<z.ZodNumber>;
+    padding: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const staticRouteMap: NbTool<typeof Schema>;
+export {};