@pilot-status/mcp-server 0.1.0

package/dist/tools/types.d.ts

@@ -0,0 +1,23 @@
+import type { z } from "zod";
+import type { ApiClient } from "../lib/api-client.js";
+/**
+ * A single MCP tool definition. `inputSchema` is a Zod *raw shape*
+ * (`Record<string, ZodTypeAny>`) — the shape the MCP SDK's `server.tool()`
+ * expects. The handler receives the already-validated args plus the
+ * per-connection {@link ApiClient}.
+ */
+export interface ToolDef<Shape extends z.ZodRawShape = z.ZodRawShape> {
+    name: string;
+    description: string;
+    inputSchema: Shape;
+    handler: (client: ApiClient, args: Record<string, unknown>) => Promise<unknown>;
+}
+/**
+ * Identity helper: keeps the precise `inputSchema` shape type at the definition
+ * site (so each tool's args are well-typed) while widening the return type to
+ * the base {@link ToolDef} so tools compose cleanly into `ToolDef[]` arrays.
+ */
+export declare function defineTool<Shape extends z.ZodRawShape>(def: ToolDef<Shape>): ToolDef;
+/** Build a query object from a subset of args, skipping undefined values. */
+export declare function pickQuery(args: Record<string, unknown>, keys: string[]): Record<string, string | number | boolean | undefined>;
+//# sourceMappingURL=types.d.ts.map

package/dist/tools/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEtD;;;;;GAKG;AACH,MAAM,WAAW,OAAO,CAAC,KAAK,SAAS,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW;IAChE,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,KAAK,CAAC;IACnB,OAAO,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACnF;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,SAAS,CAAC,CAAC,WAAW,EAClD,GAAG,EAAE,OAAO,CAAC,KAAK,CAAC,GACpB,OAAO,CAET;AAED,6EAA6E;AAC7E,wBAAgB,SAAS,CACrB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,IAAI,EAAE,MAAM,EAAE,GACf,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,CAQvD"}

package/dist/tools/types.js

@@ -0,0 +1,20 @@
+/**
+ * Identity helper: keeps the precise `inputSchema` shape type at the definition
+ * site (so each tool's args are well-typed) while widening the return type to
+ * the base {@link ToolDef} so tools compose cleanly into `ToolDef[]` arrays.
+ */
+export function defineTool(def) {
+    return def;
+}
+/** Build a query object from a subset of args, skipping undefined values. */
+export function pickQuery(args, keys) {
+    const out = {};
+    for (const key of keys) {
+        const value = args[key];
+        if (value === undefined || value === null)
+            continue;
+        out[key] = value;
+    }
+    return out;
+}
+//# sourceMappingURL=types.js.map

package/dist/tools/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":"AAgBA;;;;GAIG;AACH,MAAM,UAAU,UAAU,CACtB,GAAmB;IAEnB,OAAO,GAAc,CAAC;AAC1B,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,SAAS,CACrB,IAA6B,EAC7B,IAAc;IAEd,MAAM,GAAG,GAA0D,EAAE,CAAC;IACtE,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACrB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;QACxB,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;YAAE,SAAS;QACpD,GAAG,CAAC,GAAG,CAAC,GAAG,KAAkC,CAAC;IAClD,CAAC;IACD,OAAO,GAAG,CAAC;AACf,CAAC"}

package/package.json

@@ -0,0 +1,64 @@
+{
+    "name": "@pilot-status/mcp-server",
+    "version": "0.1.0",
+    "type": "module",
+    "description": "Model Context Protocol (MCP) server exposing the Pilot Status public /v1 API as tools. Supports stdio and streamable HTTP transports (with OAuth 2.1 for the claude.ai custom connector).",
+    "license": "MIT",
+    "author": "Pilot Status",
+    "homepage": "https://github.com/oismaelash/pilot-status/tree/main/apps/mcp-server#readme",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/oismaelash/pilot-status.git",
+        "directory": "apps/mcp-server"
+    },
+    "bugs": {
+        "url": "https://github.com/oismaelash/pilot-status/issues"
+    },
+    "keywords": [
+        "mcp",
+        "model-context-protocol",
+        "whatsapp",
+        "pilot-status",
+        "claude"
+    ],
+    "main": "dist/index.js",
+    "types": "dist/index.d.ts",
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "import": "./dist/index.js"
+        }
+    },
+    "bin": {
+        "pilot-status-mcp": "dist/index.js"
+    },
+    "files": [
+        "dist",
+        "README.md",
+        "LICENSE"
+    ],
+    "engines": {
+        "node": ">=20"
+    },
+    "publishConfig": {
+        "access": "public"
+    },
+    "scripts": {
+        "dev": "tsx watch src/index.ts",
+        "build": "tsc",
+        "start": "node dist/index.js",
+        "test": "vitest run -c vitest.config.ts",
+        "test:coverage": "vitest run -c vitest.coverage.config.ts",
+        "prepublishOnly": "npm run build"
+    },
+    "dependencies": {
+        "@modelcontextprotocol/sdk": "^1.20.0",
+        "zod": "^3.23.8"
+    },
+    "devDependencies": {
+        "@types/node": "^22.0.0",
+        "tsx": "^4.19.0",
+        "typescript": "^5.6.0",
+        "vitest": "^4.0.18"
+    }
+}