@fleetx_io/fleetx-mcp-server 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,23 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.0] - 2026-03-03
+
+### Added
+
+- MCP server with stdio transport for local AI agent integration.
+- `login` tool for authenticating with the FleetX API.
+- Dynamic tool generation from FleetX API definitions after login.
+- Zod-based input validation for all dynamically registered tools.
+- Automatic Bearer token injection into downstream API calls.
+- Token expiry handling — clears token and prompts re-login on 401/403.
+- Support for path, query, and body parameters in proxied API calls.
+- `npx` support — run directly with `npx @fleetx_io/fleetx-mcp-server`.
+- Global install support via `npm install -g`.
+- MCP Inspector compatibility for debugging and testing.
+- Configuration via environment variables with sensible defaults.
+- Cursor, Claude Desktop, and Windsurf integration examples in README.

package/README.md

@@ -0,0 +1,215 @@
+# @fleetx_io/fleetx-mcp-server
+
+An MCP (Model Context Protocol) server that gives AI agents access to the FleetX REST API. Install it as an npm package and connect it to any MCP-compatible client — no code required.
+
+## How it Works
+
+1. Your AI agent (Cursor, Claude Desktop, Windsurf, etc.) launches this server as a subprocess.
+2. The agent calls the `login` tool with your FleetX credentials.
+3. The server authenticates and fetches all available API definitions.
+4. Each API is dynamically registered as an MCP tool with validated inputs.
+5. The agent can now call any FleetX API — the server handles auth, validation, and proxying automatically.
+
+---
+
+## Quick Start
+
+### Install
+
+```bash
+npm install -g @fleetx_io/fleetx-mcp-server
+```
+
+Or use it directly with `npx` (no install needed):
+
+```bash
+npx @fleetx_io/fleetx-mcp-server
+```
+
+---
+
+## Connect to Your AI Agent
+
+### Cursor
+
+Add to `.cursor/mcp.json` in your project root:
+
+```json
+{
+  "mcpServers": {
+    "fleetx": {
+      "command": "npx",
+      "args": ["-y", "@fleetx_io/fleetx-mcp-server"]
+    }
+  }
+}
+```
+
+Then restart Cursor. The server will appear in **Settings > MCP**.
+
+### Claude Desktop
+
+Add to your `claude_desktop_config.json`:
+
+**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
+**Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "fleetx": {
+      "command": "npx",
+      "args": ["-y", "@fleetx_io/fleetx-mcp-server"]
+    }
+  }
+}
+```
+
+### Windsurf
+
+Add to your Windsurf MCP config:
+
+```json
+{
+  "mcpServers": {
+    "fleetx": {
+      "command": "npx",
+      "args": ["-y", "@fleetx_io/fleetx-mcp-server"]
+    }
+  }
+}
+```
+
+### Any MCP Client (Generic)
+
+Run the server as a subprocess communicating over **stdio**:
+
+```bash
+npx @fleetx_io/fleetx-mcp-server
+```
+
+Or if installed globally:
+
+```bash
+fleetx-mcp-server
+```
+
+The server speaks JSON-RPC over stdin/stdout. Logs go to stderr.
+
+---
+
+## Usage
+
+Once connected, ask your AI agent to:
+
+1. **Log in:** _"Log in to FleetX with username X and password Y"_
+2. **Use any tool:** _"Show me all vehicles"_, _"Create a new job"_, _"Get trip history for vehicle KA01AB1234"_
+
+The `login` tool must be called first. After login, all FleetX API tools become available automatically.
+
+### Available Tools (after login)
+
+Tools are generated dynamically from your FleetX account's API definitions. Common examples:
+
+| Tool | Description |
+|------|-------------|
+| `login` | Authenticate with FleetX (required first) |
+| `vehicle_listing` | List all vehicles |
+| `vehicle_realtime_api` | Get real-time vehicle data |
+| `create_job` | Create a new job |
+| `job_status_api` | Check job status |
+| `get_trip_history_by_vehicle_within_a_given_time_range` | Trip history for a vehicle |
+| `fetch_tagsfor_a_given_account` | Get all tags |
+| `real_time_analytics_api_by_vehicle_number` | Analytics by vehicle |
+
+The full list depends on your account's enabled APIs.
+
+---
+
+## Configuration (Optional)
+
+By default, the server connects to the FleetX production API. Override with environment variables if needed:
+
+```json
+{
+  "mcpServers": {
+    "fleetx": {
+      "command": "npx",
+      "args": ["-y", "@fleetx_io/fleetx-mcp-server"],
+      "env": {
+        "LOGIN_URL": "https://api.fleetx.io/api/v1/login",
+        "API_DEFINITION_URL": "https://app.fleetx.io/napp/api-reference/apis"
+      }
+    }
+  }
+}
+```
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `LOGIN_URL` | `https://api.fleetx.io/api/v1/login` | Authentication endpoint |
+| `API_DEFINITION_URL` | `https://app.fleetx.io/napp/api-reference/apis` | API definitions endpoint |
+
+---
+
+## Security
+
+- Credentials are sent only to the FleetX login endpoint — never logged or stored on disk.
+- The access token is held in memory for the session duration and never exposed in tool responses.
+- Token is automatically cleared on 401/403 errors, requiring re-login.
+
+---
+
+## Testing with MCP Inspector
+
+For debugging and exploring available tools:
+
+```bash
+npx @modelcontextprotocol/inspector npx @fleetx_io/fleetx-mcp-server
+```
+
+This opens a web UI where you can connect, call `login`, browse all tools, and test them interactively.
+
+---
+
+## Development
+
+```bash
+git clone <repo-url>
+cd fleetx-mcp-server
+npm install
+```
+
+| Command | Description |
+|---------|-------------|
+| `npm run dev` | Start with hot-reload (ts-node-dev) |
+| `npm run build` | Compile TypeScript to `dist/` |
+| `npm start` | Run compiled output |
+| `npm run startClient` | Launch with MCP Inspector (built) |
+| `npm run startClientLive` | Launch with MCP Inspector (live reload) |
+
+### Project Structure
+
+```
+src/
+  index.ts           Stdio transport entrypoint
+  mcpServer.ts       MCP server + login tool + dynamic tool registration
+  auth.ts            Login flow + in-memory token store
+  apiDiscovery.ts    Fetch API definitions from protected endpoint
+  toolGenerator.ts   Convert API definitions into MCP tools
+  proxyCaller.ts     Proxy calls to external APIs via Axios
+  schemaBuilder.ts   Zod schema + JSON Schema generation from API metadata
+  utils.ts           Logging + config helpers
+  types.ts           Shared TypeScript interfaces
+```
+
+---
+
+## Requirements
+
+- Node.js >= 16
+- npm or npx
+
+## License
+
+ISC

package/dist/apiDiscovery.d.ts

@@ -0,0 +1,11 @@
+import { ApiDefinition, TokenStore } from "./types";
+/**
+ * Fetches API definitions from a protected endpoint.
+ * Requires a valid Bearer token in the token store.
+ */
+export declare function fetchApiDefinitions(apiDefinitionUrl: string, tokenStore: TokenStore): Promise<{
+    success: boolean;
+    definitions: ApiDefinition[];
+    message: string;
+}>;
+//# sourceMappingURL=apiDiscovery.d.ts.map

package/dist/apiDiscovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiDiscovery.d.ts","sourceRoot":"","sources":["../src/apiDiscovery.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEpD;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,gBAAgB,EAAE,MAAM,EACxB,UAAU,EAAE,UAAU,GACrB,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,WAAW,EAAE,aAAa,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CA6C9E"}

package/dist/apiDiscovery.js

@@ -0,0 +1,83 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchApiDefinitions = fetchApiDefinitions;
+const axios_1 = __importDefault(require("axios"));
+/**
+ * Fetches API definitions from a protected endpoint.
+ * Requires a valid Bearer token in the token store.
+ */
+async function fetchApiDefinitions(apiDefinitionUrl, tokenStore) {
+    const token = tokenStore.getToken();
+    if (!token) {
+        return { success: false, definitions: [], message: "Not authenticated. Call login first." };
+    }
+    try {
+        const response = await axios_1.default.get(apiDefinitionUrl, {
+            headers: { Authorization: `Bearer ${token}` },
+        });
+        const data = response.data?.data;
+        const definitions = Array.isArray(data) ? data : [];
+        if (definitions.length === 0) {
+            return { success: true, definitions: [], message: "No API definitions returned." };
+        }
+        const normalized = definitions.map((d) => normalizeDefinition(d));
+        return {
+            success: true,
+            definitions: normalized,
+            message: `Fetched ${normalized.length} API definition(s).`,
+        };
+    }
+    catch (err) {
+        const axiosErr = err;
+        const status = axiosErr.response?.status;
+        if (status === 401 || status === 403) {
+            tokenStore.clearToken();
+            return {
+                success: false,
+                definitions: [],
+                message: "Token expired or unauthorized. Please login again.",
+            };
+        }
+        return {
+            success: false,
+            definitions: [],
+            message: `Failed to fetch API definitions (HTTP ${status ?? "unknown"}): ${axiosErr.message}`,
+        };
+    }
+}
+function normalizeDefinition(def) {
+    return {
+        name: String(def.name ?? "unnamed"),
+        description: String(def.description ?? ""),
+        method: normalizeMethod(def.method),
+        baseDomain: String(def.baseDomain ?? ""),
+        path: String(def.path ?? "/"),
+        queryParams: normalizeParams(def.queryParams),
+        bodyParams: normalizeParams(def.bodyParams),
+        pathParams: normalizeParams(def.pathParams),
+        headers: Array.isArray(def.headers) ? def.headers : [],
+        authType: def.authType === "None" ? "None" : "Bearer",
+    };
+}
+function normalizeMethod(raw) {
+    const m = String(raw).toUpperCase();
+    if (["GET", "POST", "PUT", "PATCH", "DELETE"].includes(m)) {
+        return m;
+    }
+    return "GET";
+}
+function normalizeParams(raw) {
+    if (!Array.isArray(raw))
+        return [];
+    return raw.map((p) => ({
+        name: String(p.name ?? ""),
+        type: ["string", "boolean", "number", "array"].includes(p.type) ? p.type : "string",
+        required: Boolean(p.required),
+        description: p.description ? String(p.description) : undefined,
+        default: p.default,
+    }));
+}
+//# sourceMappingURL=apiDiscovery.js.map

package/dist/apiDiscovery.js.map

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

package/dist/auth.d.ts

@@ -0,0 +1,7 @@
+import { TokenStore } from "./types";
+export declare function createTokenStore(): TokenStore;
+export declare function login(loginUrl: string, username: string, password: string, tokenStore: TokenStore): Promise<{
+    success: boolean;
+    message: string;
+}>;
+//# sourceMappingURL=auth.d.ts.map

package/dist/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAGrC,wBAAgB,gBAAgB,IAAI,UAAU,CAoB7C;AAED,wBAAsB,KAAK,CACzB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,UAAU,GACrB,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAwChD"}

package/dist/auth.js

@@ -0,0 +1,65 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTokenStore = createTokenStore;
+exports.login = login;
+const axios_1 = __importDefault(require("axios"));
+const utils_1 = require("./utils");
+function createTokenStore() {
+    let accessToken = null;
+    return {
+        get accessToken() {
+            return accessToken;
+        },
+        setToken(token) {
+            accessToken = token;
+        },
+        getToken() {
+            return accessToken;
+        },
+        clearToken() {
+            accessToken = null;
+        },
+        isAuthenticated() {
+            return accessToken !== null;
+        },
+    };
+}
+async function login(loginUrl, username, password, tokenStore) {
+    try {
+        const formData = new FormData();
+        formData.append("grant_type", "password");
+        formData.append("username", username);
+        formData.append("password", password);
+        (0, utils_1.log)("Login attempt for user:", username, "to URL:", loginUrl);
+        const response = await axios_1.default.post(loginUrl, formData, {
+            headers: {
+                clientId: "fleetxMcpClient",
+            },
+        });
+        const token = response.data?.access_token;
+        if (!token || typeof token !== "string") {
+            return {
+                success: false,
+                message: "Login succeeded but no access token found in response.",
+            };
+        }
+        tokenStore.setToken(token);
+        return { success: true, message: "Login successful. Tools are now available." };
+    }
+    catch (err) {
+        const axiosErr = err;
+        const status = axiosErr.response?.status ?? "unknown";
+        const body = axiosErr.response?.data;
+        const detail = typeof body === "object" && body !== null && "message" in body
+            ? body.message
+            : axiosErr.message;
+        return {
+            success: false,
+            message: `Login failed (HTTP ${status}): ${detail}`,
+        };
+    }
+}
+//# sourceMappingURL=auth.js.map

package/dist/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":";;;;;AAIA,4CAoBC;AAED,sBA6CC;AAvED,kDAA0C;AAE1C,mCAA8B;AAE9B,SAAgB,gBAAgB;IAC9B,IAAI,WAAW,GAAkB,IAAI,CAAC;IAEtC,OAAO;QACL,IAAI,WAAW;YACb,OAAO,WAAW,CAAC;QACrB,CAAC;QACD,QAAQ,CAAC,KAAa;YACpB,WAAW,GAAG,KAAK,CAAC;QACtB,CAAC;QACD,QAAQ;YACN,OAAO,WAAW,CAAC;QACrB,CAAC;QACD,UAAU;YACR,WAAW,GAAG,IAAI,CAAC;QACrB,CAAC;QACD,eAAe;YACb,OAAO,WAAW,KAAK,IAAI,CAAC;QAC9B,CAAC;KACF,CAAC;AACJ,CAAC;AAEM,KAAK,UAAU,KAAK,CACzB,QAAgB,EAChB,QAAgB,EAChB,QAAgB,EAChB,UAAsB;IAEtB,IAAI,CAAC;QAEH,MAAM,QAAQ,GAAG,IAAI,QAAQ,EAAE,CAAC;QAChC,QAAQ,CAAC,MAAM,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;QAC1C,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QACtC,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QACtC,IAAA,WAAG,EAAC,yBAAyB,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;QAC9D,MAAM,QAAQ,GAAG,MAAM,eAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE;YACpD,OAAO,EAAE;gBACP,QAAQ,EAAE,iBAAiB;aAC5B;SACF,CAAC,CAAC;QAEH,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAA;QAGzC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YACxC,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,wDAAwD;aAClE,CAAC;QACJ,CAAC;QAED,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC3B,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,4CAA4C,EAAE,CAAC;IAClF,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,QAAQ,GAAG,GAAiB,CAAC;QACnC,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,SAAS,CAAC;QACtD,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC;QACrC,MAAM,MAAM,GACV,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAI,SAAS,IAAI,IAAI;YAC5D,CAAC,CAAE,IAA4B,CAAC,OAAO;YACvC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;QAEvB,OAAO;YACL,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,sBAAsB,MAAM,MAAM,MAAM,EAAE;SACpD,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node 
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,20 @@
+#!/usr/bin/env node 
+"use strict";
+// Node will treat it as executable.
+Object.defineProperty(exports, "__esModule", { value: true });
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const mcpServer_1 = require("./mcpServer");
+const auth_1 = require("./auth");
+const utils_1 = require("./utils");
+async function main() {
+    const tokenStore = (0, auth_1.createTokenStore)();
+    const server = (0, mcpServer_1.createMcpServer)(tokenStore);
+    const transport = new stdio_js_1.StdioServerTransport();
+    await server.connect(transport);
+    (0, utils_1.log)("Running on stdio");
+}
+main().catch((err) => {
+    (0, utils_1.log)("Fatal error:", err);
+    process.exit(1);
+});
+//# 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,oCAAoC;;AAEpC,wEAAiF;AACjF,2CAA8C;AAC9C,iCAA0C;AAC1C,mCAA8B;AAE9B,KAAK,UAAU,IAAI;IACjB,MAAM,UAAU,GAAG,IAAA,uBAAgB,GAAE,CAAC;IACtC,MAAM,MAAM,GAAG,IAAA,2BAAe,EAAC,UAAU,CAAC,CAAC;IAC3C,MAAM,SAAS,GAAG,IAAI,+BAAoB,EAAE,CAAC;IAE7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,IAAA,WAAG,EAAC,kBAAkB,CAAC,CAAC;AAC1B,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,IAAA,WAAG,EAAC,cAAc,EAAE,GAAG,CAAC,CAAC;IACzB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/mcpServer.d.ts

@@ -0,0 +1,7 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { TokenStore } from "./types";
+/**
+ * Creates and configures the McpServer instance with login + dynamic tools.
+ */
+export declare function createMcpServer(tokenStore: TokenStore): McpServer;
+//# sourceMappingURL=mcpServer.d.ts.map

package/dist/mcpServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcpServer.d.ts","sourceRoot":"","sources":["../src/mcpServer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,UAAU,EAAiB,MAAM,SAAS,CAAC;AAMpD;;GAEG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,UAAU,GAAG,SAAS,CASjE"}

package/dist/mcpServer.js

@@ -0,0 +1,125 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createMcpServer = createMcpServer;
+const zod_1 = require("zod");
+const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
+const auth_1 = require("./auth");
+const apiDiscovery_1 = require("./apiDiscovery");
+const toolGenerator_1 = require("./toolGenerator");
+const utils_1 = require("./utils");
+/**
+ * Creates and configures the McpServer instance with login + dynamic tools.
+ */
+function createMcpServer(tokenStore) {
+    const mcp = new mcp_js_1.McpServer({ name: "fleetx-mcp-server", version: "1.0.0" }, { capabilities: { tools: {} } });
+    registerLoginTool(mcp, tokenStore);
+    return mcp;
+}
+function registerLoginTool(mcp, tokenStore) {
+    mcp.tool("login", "Authenticate with the FleetX API. Must be called before any other tool.", {
+        username: zod_1.z.string().describe("Login username"),
+        password: zod_1.z.string().describe("Login password"),
+    }, async ({ username, password }) => {
+        const result = await (0, auth_1.login)((0, utils_1.getLoginURL)(), username, password, tokenStore);
+        if (!result.success) {
+            return {
+                content: [{ type: "text", text: result.message }],
+                isError: true,
+            };
+        }
+        const discoveryResult = await (0, apiDiscovery_1.fetchApiDefinitions)((0, utils_1.getAPIDefinitionURL)(), tokenStore);
+        if (!discoveryResult.success) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Login succeeded but failed to fetch API definitions: ${discoveryResult.message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const toolNames = registerDynamicTools(mcp, discoveryResult.definitions, tokenStore);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: [
+                        result.message,
+                        discoveryResult.message,
+                        `Registered ${toolNames.length} tool(s): ${toolNames.join(", ")}`,
+                    ].join("\n"),
+                },
+            ],
+        };
+    });
+}
+let registeredDynamicTools = [];
+function registerDynamicTools(mcp, definitions, tokenStore) {
+    for (const rt of registeredDynamicTools) {
+        try {
+            rt.remove();
+        }
+        catch {
+            // tool may already have been removed
+        }
+    }
+    registeredDynamicTools = [];
+    const tools = (0, toolGenerator_1.generateTools)(definitions, tokenStore);
+    const registeredNames = [];
+    for (const tool of tools) {
+        if (tool.name === "login")
+            continue;
+        const shape = {};
+        for (const [key, propSchema] of Object.entries(tool.inputSchema.properties)) {
+            shape[key] = jsonSchemaPropertyToZod(propSchema, tool.inputSchema.required.includes(key));
+        }
+        try {
+            const registered = mcp.tool(tool.name, tool.description, shape, async (args) => {
+                const result = await tool.handler(args);
+                return result;
+            });
+            registeredDynamicTools.push(registered);
+            registeredNames.push(tool.name);
+        }
+        catch (err) {
+            (0, utils_1.log)(`Failed to register tool "${tool.name}":`, err);
+        }
+    }
+    try {
+        mcp.sendToolListChanged();
+    }
+    catch (err) {
+        (0, utils_1.log)("sendToolListChanged failed:", err);
+    }
+    (0, utils_1.log)(`Registered ${registeredNames.length} dynamic tool(s): ${registeredNames.join(", ")}`);
+    return registeredNames;
+}
+/**
+ * Converts a single JSON-Schema property descriptor back to a Zod type
+ * for MCP tool registration.
+ */
+function jsonSchemaPropertyToZod(prop, required) {
+    const p = prop;
+    let schema;
+    switch (p.type) {
+        case "boolean":
+            schema = zod_1.z.boolean();
+            break;
+        case "number":
+            schema = zod_1.z.number();
+            break;
+        case "array":
+            schema = zod_1.z.array(zod_1.z.string());
+            break;
+        case "string":
+        default:
+            schema = zod_1.z.string();
+            break;
+    }
+    if (typeof p.description === "string") {
+        schema = schema.describe(p.description);
+    }
+    return required ? schema : schema.optional();
+}
+//# sourceMappingURL=mcpServer.js.map

package/dist/mcpServer.js.map

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

package/dist/proxyCaller.d.ts

@@ -0,0 +1,9 @@
+import { ApiDefinition, TokenStore } from "./types";
+/**
+ * Executes a proxied API call to the external service.
+ */
+export declare function proxyCall(apiDef: ApiDefinition, inputArgs: Record<string, unknown>, tokenStore: TokenStore): Promise<{
+    status: number;
+    data: unknown;
+}>;
+//# sourceMappingURL=proxyCaller.d.ts.map

package/dist/proxyCaller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxyCaller.d.ts","sourceRoot":"","sources":["../src/proxyCaller.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAiCpD;;GAEG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,aAAa,EACrB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,UAAU,EAAE,UAAU,GACrB,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC,CAuE5C"}

package/dist/proxyCaller.js

@@ -0,0 +1,91 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.proxyCall = proxyCall;
+const axios_1 = __importDefault(require("axios"));
+/**
+ * Constructs the full URL by replacing path parameters and appending query parameters.
+ */
+function buildUrl(baseDomain, pathTemplate, pathParams, queryParams) {
+    let resolvedPath = pathTemplate;
+    for (const [key, value] of Object.entries(pathParams)) {
+        resolvedPath = resolvedPath.replace(`{{${key}}}`, encodeURIComponent(String(value)));
+    }
+    const base = baseDomain.endsWith("/") ? baseDomain.slice(0, -1) : baseDomain;
+    const path = resolvedPath.startsWith("/") ? resolvedPath : `/${resolvedPath}`;
+    const url = new URL(`${base}${path}`);
+    for (const [key, value] of Object.entries(queryParams)) {
+        if (value !== undefined && value !== null) {
+            if (Array.isArray(value)) {
+                value.forEach((v) => url.searchParams.append(key, String(v)));
+            }
+            else {
+                url.searchParams.set(key, String(value));
+            }
+        }
+    }
+    return url.toString();
+}
+/**
+ * Executes a proxied API call to the external service.
+ */
+async function proxyCall(apiDef, inputArgs, tokenStore) {
+    const token = tokenStore.getToken();
+    if (!token && apiDef.authType === "Bearer") {
+        throw new Error("Not authenticated. Call login first.");
+    }
+    const pathParamNames = new Set((apiDef.pathParams ?? []).map((p) => p.name));
+    const queryParamNames = new Set((apiDef.queryParams ?? []).map((p) => p.name));
+    const bodyParamNames = new Set((apiDef.bodyParams ?? []).map((p) => p.name));
+    const pathValues = {};
+    const queryValues = {};
+    const bodyValues = {};
+    for (const [key, value] of Object.entries(inputArgs)) {
+        if (pathParamNames.has(key)) {
+            pathValues[key] = value;
+        }
+        else if (queryParamNames.has(key)) {
+            queryValues[key] = value;
+        }
+        else if (bodyParamNames.has(key)) {
+            bodyValues[key] = value;
+        }
+    }
+    const url = buildUrl(apiDef.baseDomain, apiDef.path, pathValues, queryValues);
+    const headers = { "Content-Type": "application/json" };
+    if (apiDef.authType === "Bearer" && token) {
+        headers["Authorization"] = `Bearer ${token}`;
+    }
+    if (Array.isArray(apiDef.headers)) {
+        for (const h of apiDef.headers) {
+            if (h && typeof h === "object") {
+                Object.assign(headers, h);
+            }
+        }
+    }
+    const config = {
+        method: apiDef.method.toLowerCase(),
+        url,
+        headers,
+        timeout: 30_000,
+    };
+    if (["POST", "PUT", "PATCH"].includes(apiDef.method) && Object.keys(bodyValues).length > 0) {
+        config.data = bodyValues;
+    }
+    try {
+        const response = await (0, axios_1.default)(config);
+        return { status: response.status, data: response.data };
+    }
+    catch (err) {
+        const axiosErr = err;
+        const status = axiosErr.response?.status ?? 500;
+        const data = axiosErr.response?.data ?? { message: axiosErr.message };
+        if (status === 401 || status === 403) {
+            tokenStore.clearToken();
+        }
+        return { status, data };
+    }
+}
+//# sourceMappingURL=proxyCaller.js.map

package/dist/proxyCaller.js.map

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

package/dist/schemaBuilder.d.ts

@@ -0,0 +1,17 @@
+import { z, ZodTypeAny } from "zod";
+import { ApiParamDefinition } from "./types";
+/**
+ * Builds a Zod object schema from a flat list of parameter definitions.
+ * Returns both the ZodObject and a JSON-Schema-compatible shape for MCP tool registration.
+ */
+export declare function buildZodSchema(params: ApiParamDefinition[]): z.ZodObject<Record<string, ZodTypeAny>>;
+/**
+ * Converts a flat param list into a JSON Schema `properties` + `required` object
+ * suitable for MCP tool inputSchema registration.
+ */
+export declare function paramsToJsonSchema(params: ApiParamDefinition[]): {
+    type: "object";
+    properties: Record<string, object>;
+    required: string[];
+};
+//# sourceMappingURL=schemaBuilder.d.ts.map

package/dist/schemaBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemaBuilder.d.ts","sourceRoot":"","sources":["../src/schemaBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,UAAU,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AA4B7C;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,kBAAkB,EAAE,GAAG,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAQpG;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,EAAE,GAAG;IAChE,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAiCA"}

package/dist/schemaBuilder.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildZodSchema = buildZodSchema;
+exports.paramsToJsonSchema = paramsToJsonSchema;
+const zod_1 = require("zod");
+function primitiveToZod(param) {
+    let schema;
+    switch (param.type) {
+        case "boolean":
+            schema = zod_1.z.boolean();
+            break;
+        case "number":
+            schema = zod_1.z.number();
+            break;
+        case "array":
+            schema = zod_1.z.array(zod_1.z.string());
+            break;
+        case "string":
+        default:
+            schema = zod_1.z.string();
+            break;
+    }
+    if (param.description) {
+        schema = schema.describe(param.description);
+    }
+    return param.required ? schema : schema.optional();
+}
+/**
+ * Builds a Zod object schema from a flat list of parameter definitions.
+ * Returns both the ZodObject and a JSON-Schema-compatible shape for MCP tool registration.
+ */
+function buildZodSchema(params) {
+    const shape = {};
+    for (const param of params) {
+        shape[param.name] = primitiveToZod(param);
+    }
+    return zod_1.z.object(shape);
+}
+/**
+ * Converts a flat param list into a JSON Schema `properties` + `required` object
+ * suitable for MCP tool inputSchema registration.
+ */
+function paramsToJsonSchema(params) {
+    const properties = {};
+    const required = [];
+    for (const param of params) {
+        const prop = {};
+        switch (param.type) {
+            case "boolean":
+                prop.type = "boolean";
+                break;
+            case "number":
+                prop.type = "number";
+                break;
+            case "array":
+                prop.type = "array";
+                prop.items = { type: "string" };
+                break;
+            case "string":
+            default:
+                prop.type = "string";
+                break;
+        }
+        if (param.description)
+            prop.description = param.description;
+        if (param.default !== undefined)
+            prop.default = param.default;
+        properties[param.name] = prop;
+        if (param.required)
+            required.push(param.name);
+    }
+    return { type: "object", properties, required };
+}
+//# sourceMappingURL=schemaBuilder.js.map

package/dist/schemaBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemaBuilder.js","sourceRoot":"","sources":["../src/schemaBuilder.ts"],"names":[],"mappings":";;AAiCA,wCAQC;AAMD,gDAqCC;AApFD,6BAAoC;AAGpC,SAAS,cAAc,CAAC,KAAyB;IAC/C,IAAI,MAAkB,CAAC;IAEvB,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,SAAS;YACZ,MAAM,GAAG,OAAC,CAAC,OAAO,EAAE,CAAC;YACrB,MAAM;QACR,KAAK,QAAQ;YACX,MAAM,GAAG,OAAC,CAAC,MAAM,EAAE,CAAC;YACpB,MAAM;QACR,KAAK,OAAO;YACV,MAAM,GAAG,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC;YAC7B,MAAM;QACR,KAAK,QAAQ,CAAC;QACd;YACE,MAAM,GAAG,OAAC,CAAC,MAAM,EAAE,CAAC;YACpB,MAAM;IACV,CAAC;IAED,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;QACtB,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAC9C,CAAC;IAED,OAAO,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;AACrD,CAAC;AAED;;;GAGG;AACH,SAAgB,cAAc,CAAC,MAA4B;IACzD,MAAM,KAAK,GAA+B,EAAE,CAAC;IAE7C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IAC5C,CAAC;IAED,OAAO,OAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACzB,CAAC;AAED;;;GAGG;AACH,SAAgB,kBAAkB,CAAC,MAA4B;IAK7D,MAAM,UAAU,GAA2B,EAAE,CAAC;IAC9C,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,IAAI,GAA4B,EAAE,CAAC;QAEzC,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;YACnB,KAAK,SAAS;gBACZ,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC;gBACtB,MAAM;YACR,KAAK,QAAQ;gBACX,IAAI,CAAC,IAAI,GAAG,QAAQ,CAAC;gBACrB,MAAM;YACR,KAAK,OAAO;gBACV,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC;gBACpB,IAAI,CAAC,KAAK,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;gBAChC,MAAM;YACR,KAAK,QAAQ,CAAC;YACd;gBACE,IAAI,CAAC,IAAI,GAAG,QAAQ,CAAC;gBACrB,MAAM;QACV,CAAC;QAED,IAAI,KAAK,CAAC,WAAW;YAAE,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;QAC5D,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS;YAAE,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;QAE9D,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;QAE9B,IAAI,KAAK,CAAC,QAAQ;YAAE,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAChD,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;AAClD,CAAC"}

package/dist/toolGenerator.d.ts

@@ -0,0 +1,16 @@
+import { ApiDefinition, TokenStore, ToolInvocationResult } from "./types";
+export interface GeneratedTool {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: Record<string, object>;
+        required: string[];
+    };
+    handler: (args: Record<string, unknown>) => Promise<ToolInvocationResult>;
+}
+/**
+ * Generates MCP tools for all API definitions.
+ */
+export declare function generateTools(apiDefinitions: ApiDefinition[], tokenStore: TokenStore): GeneratedTool[];
+//# sourceMappingURL=toolGenerator.d.ts.map

package/dist/toolGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolGenerator.d.ts","sourceRoot":"","sources":["../src/toolGenerator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAsB,UAAU,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAI9F,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACnC,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;IACF,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,oBAAoB,CAAC,CAAC;CAC3E;AAgHD;;GAEG;AACH,wBAAgB,aAAa,CAC3B,cAAc,EAAE,aAAa,EAAE,EAC/B,UAAU,EAAE,UAAU,GACrB,aAAa,EAAE,CAEjB"}

package/dist/toolGenerator.js

@@ -0,0 +1,108 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateTools = generateTools;
+const schemaBuilder_1 = require("./schemaBuilder");
+const proxyCaller_1 = require("./proxyCaller");
+/**
+ * Convert an API name like "Get Vehicle Location" to "get_vehicle_location".
+ */
+function toSnakeCase(name) {
+    return name
+        .trim()
+        .replace(/[^a-zA-Z0-9\s]/g, "")
+        .replace(/\s+/g, "_")
+        .toLowerCase();
+}
+/**
+ * Merges all param groups into a single flat list, de-duplicating by name.
+ */
+function mergeParams(apiDef) {
+    const seen = new Set();
+    const merged = [];
+    const groups = [
+        apiDef.pathParams ?? [],
+        apiDef.queryParams ?? [],
+        apiDef.bodyParams ?? [],
+    ];
+    for (const group of groups) {
+        for (const param of group) {
+            if (!seen.has(param.name)) {
+                seen.add(param.name);
+                merged.push(param);
+            }
+        }
+    }
+    return merged;
+}
+/**
+ * Generates a single MCP-compatible tool from an API definition.
+ */
+function generateTool(apiDef, tokenStore) {
+    const allParams = mergeParams(apiDef);
+    const zodSchema = (0, schemaBuilder_1.buildZodSchema)(allParams);
+    const jsonSchema = (0, schemaBuilder_1.paramsToJsonSchema)(allParams);
+    const toolName = toSnakeCase(apiDef.name);
+    const handler = async (rawArgs) => {
+        if (!tokenStore.isAuthenticated()) {
+            return {
+                content: [{ type: "text", text: "Not authenticated. Please call the login tool first." }],
+                isError: true,
+            };
+        }
+        const validation = zodSchema.safeParse(rawArgs);
+        if (!validation.success) {
+            const errors = validation.error.issues.map((issue) => `${issue.path.join(".")}: ${issue.message}`);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Validation failed:\n${errors.join("\n")}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        try {
+            const result = await (0, proxyCaller_1.proxyCall)(apiDef, validation.data, tokenStore);
+            if (result.status === 401 || result.status === 403) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: "Authentication expired. Please call the login tool again.",
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(result.data, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return {
+                content: [{ type: "text", text: `API call failed: ${message}` }],
+                isError: true,
+            };
+        }
+    };
+    return {
+        name: toolName,
+        description: apiDef.description || `Invoke ${apiDef.name}`,
+        inputSchema: jsonSchema,
+        handler,
+    };
+}
+/**
+ * Generates MCP tools for all API definitions.
+ */
+function generateTools(apiDefinitions, tokenStore) {
+    return apiDefinitions.map((def) => generateTool(def, tokenStore));
+}
+//# sourceMappingURL=toolGenerator.js.map

package/dist/toolGenerator.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,35 @@
+export interface ApiParamDefinition {
+    name: string;
+    type: "string" | "boolean" | "number" | "array";
+    required: boolean;
+    description?: string;
+    default?: unknown;
+}
+export interface ApiDefinition {
+    name: string;
+    description: string;
+    method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+    baseDomain: string;
+    path: string;
+    queryParams: ApiParamDefinition[];
+    bodyParams: ApiParamDefinition[];
+    pathParams: ApiParamDefinition[];
+    headers: Record<string, string>[];
+    authType: "Bearer" | "None";
+}
+export interface TokenStore {
+    accessToken: string | null;
+    setToken(token: string): void;
+    getToken(): string | null;
+    clearToken(): void;
+    isAuthenticated(): boolean;
+}
+export interface ToolInvocationResult {
+    [key: string]: unknown;
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;IAChD,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;IACpD,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,kBAAkB,EAAE,CAAC;IAClC,UAAU,EAAE,kBAAkB,EAAE,CAAC;IACjC,UAAU,EAAE,kBAAkB,EAAE,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;IAClC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,IAAI,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,IAAI,IAAI,CAAC;IACnB,eAAe,IAAI,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,oBAAoB;IACnC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB"}

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/utils.d.ts

@@ -0,0 +1,8 @@
+/**
+ * All logging goes to stderr so stdout stays clean for the stdio JSON-RPC transport.
+ * Use log() everywhere instead of console.log / console.error.
+ */
+export declare function log(...args: unknown[]): void;
+export declare function getAPIDefinitionURL(): string;
+export declare function getLoginURL(): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,QAIrC;AAED,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED,wBAAgB,WAAW,IAAI,MAAM,CAEpC"}

package/dist/utils.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.log = log;
+exports.getAPIDefinitionURL = getAPIDefinitionURL;
+exports.getLoginURL = getLoginURL;
+/**
+ * All logging goes to stderr so stdout stays clean for the stdio JSON-RPC transport.
+ * Use log() everywhere instead of console.log / console.error.
+ */
+function log(...args) {
+    const msg = args.map((a) => (typeof a === "string" ? a : JSON.stringify(a))).join(" ");
+    console.error(`[FleetX MCP] ${msg}`);
+}
+function getAPIDefinitionURL() {
+    return process.env.API_DEFINITION_URL ?? "https://app.fleetx.io/napp/api-reference/apis";
+}
+function getLoginURL() {
+    return process.env.LOGIN_URL ?? "https://api.fleetx.io/api/v1/login";
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":";;AAIA,kBAIC;AAED,kDAEC;AAED,kCAEC;AAhBD;;;GAGG;AACH,SAAgB,GAAG,CAAC,GAAG,IAAe;IACpC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACvF,OAAO,CAAC,KAAK,CAAC,gBAAgB,GAAG,EAAE,CAAC,CAAC;AAEvC,CAAC;AAED,SAAgB,mBAAmB;IACjC,OAAO,OAAO,CAAC,GAAG,CAAC,kBAAmB,IAAI,+CAA+C,CAAC;AAC5F,CAAC;AAED,SAAgB,WAAW;IACzB,OAAO,OAAO,CAAC,GAAG,CAAC,SAAU,IAAI,oCAAoC,CAAC;AACxE,CAAC"}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@fleetx_io/fleetx-mcp-server",
+  "version": "1.0.0",
+  "description": "MCP server that gives AI agents access to the FleetX REST API. Works with Cursor, Claude Desktop, Windsurf, and any MCP-compatible client.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "fleetx-mcp-server": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "dev": "ts-node-dev --respawn --transpile-only ./src/index.ts",
+    "build": "tsc",
+    "publish": "npm run build && npm publish --access public",
+    "start": "node dist/index.js",
+    "startClientLive": "npx @modelcontextprotocol/inspector ts-node-dev --respawn --transpile-only ./src/index.ts",
+    "startClient": "npx @modelcontextprotocol/inspector node dist/index.js"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "fleetx",
+    "ai",
+    "agent",
+    "fleet-management",
+    "cursor",
+    "claude",
+    "windsurf",
+    "stdio",
+    "api-gateway"
+  ],
+  "author": "FleetX <satish@fleetx.io> (https://fleetx.io)",
+  "license": "ISC",
+  "repository": {
+    "type": "git",
+    "url": "https://gitlab.stg-fleetx.io/fleetxdev/fleetx-mcp-server.git"
+  },
+  "homepage": "https://gitlab.stg-fleetx.io/fleetxdev/fleetx-mcp-server#readme",
+  "bugs": {
+    "url": "https://gitlab.stg-fleetx.io/fleetxdev/fleetx-mcp-server/issues"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "axios": "^1.13.6",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/node": "^25.3.3",
+    "ts-node-dev": "^2.0.0",
+    "typescript": "^5.9.3"
+  }
+}