formbro-mcp-server 1.0.0

package/dist/schemas/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../src/schemas/common.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAE5C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE3E,oBAAoB;AACpB,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;SACd,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,SAAS,CAAC;SACd,OAAO,CAAC,aAAa,CAAC;SACtB,QAAQ,CAAC,0DAA0D,CAAC;IACvE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;SACf,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,OAAO,CAAC,CAAC,CAAC;SACV,QAAQ,CAAC,0CAA0C,CAAC;CACxD,CAAC,CAAC,MAAM,EAAE,CAAC;AAEZ,yBAAyB;AACzB,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,eAAe,EAAE,CAAC,CAAC,UAAU,CAAC,cAAc,CAAC;SAC1C,OAAO,CAAC,cAAc,CAAC,QAAQ,CAAC;SAChC,QAAQ,CAAC,6EAA6E,CAAC;CAC3F,CAAC,CAAC,MAAM,EAAE,CAAC;AAEZ,wCAAwC;AACxC,MAAM,CAAC,MAAM,iBAAiB,GAAG,gBAAgB,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;AAE9E,sBAAsB;AACtB,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/B,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;SACX,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,0CAA0C,CAAC;CACxD,CAAC,CAAC,MAAM,EAAE,CAAC;AAEZ,wBAAwB;AACxB,MAAM,CAAC,MAAM,kBAAkB,GAAG,QAAQ,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;AAEvE,gBAAgB;AAChB,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;SACf,QAAQ,EAAE;SACV,QAAQ,CAAC,6DAA6D,CAAC;CAC3E,CAAC,CAAC,MAAM,EAAE,CAAC;AAEZ,0BAA0B;AAC1B,MAAM,CAAC,MAAM,oBAAoB,GAAG,iBAAiB,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC"}

package/dist/services/api-client.d.ts

@@ -0,0 +1,38 @@
+import { AxiosInstance } from "axios";
+/**
+ * Initialize the default API client (for STDIO mode)
+ */
+export declare function initializeApiClient(baseUrl: string, token: string): void;
+/**
+ * Set base URL for HTTP mode (without token)
+ */
+export declare function setBaseUrl(baseUrl: string): void;
+/**
+ * Create an API client for a specific request with its own token
+ */
+export declare function createApiClientWithToken(token: string): AxiosInstance;
+/**
+ * Run a function with a specific API client in context
+ */
+export declare function runWithApiClient<T>(apiClient: AxiosInstance, fn: () => T): T;
+/**
+ * Get the API client for current request context
+ */
+export declare function getApiClient(): AxiosInstance;
+/**
+ * Make an API request to FormBro backend
+ */
+export declare function makeApiRequest<T>(endpoint: string, method?: "GET" | "POST" | "PUT" | "PATCH" | "DELETE", data?: unknown, params?: Record<string, unknown>): Promise<T>;
+/**
+ * Handle API errors and return user-friendly messages
+ */
+export declare function handleApiError(error: unknown): string;
+/**
+ * Check if the API client is properly configured
+ */
+export declare function isApiClientConfigured(): boolean;
+/**
+ * Get the base URL
+ */
+export declare function getBaseUrl(): string | null;
+//# sourceMappingURL=api-client.d.ts.map

package/dist/services/api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../../src/services/api-client.ts"],"names":[],"mappings":"AAEA,OAAc,EAAE,aAAa,EAAc,MAAM,OAAO,CAAC;AAUzD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAWxE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEhD;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAarE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,SAAS,EAAE,aAAa,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAE5E;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,aAAa,CAW5C;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,CAAC,EACpC,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAgB,EAC3D,IAAI,CAAC,EAAE,OAAO,EACd,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC,CAAC,CAAC,CASZ;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CA6BrD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,OAAO,CAE/C;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,MAAM,GAAG,IAAI,CAE1C"}

package/dist/services/api-client.js

@@ -0,0 +1,125 @@
+// FormBro API Client with Token Authentication
+import axios, { AxiosError } from "axios";
+import { API_TIMEOUT } from "../constants.js";
+let defaultApiClient = null;
+let defaultBaseUrl = null;
+// AsyncLocalStorage for per-request API client
+import { AsyncLocalStorage } from "async_hooks";
+const requestContext = new AsyncLocalStorage();
+/**
+ * Initialize the default API client (for STDIO mode)
+ */
+export function initializeApiClient(baseUrl, token) {
+    defaultBaseUrl = baseUrl.replace(/\/$/, "");
+    defaultApiClient = axios.create({
+        baseURL: defaultBaseUrl,
+        timeout: API_TIMEOUT,
+        headers: {
+            "Content-Type": "application/json",
+            "Accept": "application/json",
+            "Authorization": `Bearer ${token}`
+        }
+    });
+}
+/**
+ * Set base URL for HTTP mode (without token)
+ */
+export function setBaseUrl(baseUrl) {
+    defaultBaseUrl = baseUrl.replace(/\/$/, "");
+}
+/**
+ * Create an API client for a specific request with its own token
+ */
+export function createApiClientWithToken(token) {
+    if (!defaultBaseUrl) {
+        throw new Error("API base URL not configured. Set FORMBRO_API_URL environment variable.");
+    }
+    return axios.create({
+        baseURL: defaultBaseUrl,
+        timeout: API_TIMEOUT,
+        headers: {
+            "Content-Type": "application/json",
+            "Accept": "application/json",
+            "Authorization": `Bearer ${token}`
+        }
+    });
+}
+/**
+ * Run a function with a specific API client in context
+ */
+export function runWithApiClient(apiClient, fn) {
+    return requestContext.run({ apiClient }, fn);
+}
+/**
+ * Get the API client for current request context
+ */
+export function getApiClient() {
+    const store = requestContext.getStore();
+    if (store?.apiClient) {
+        return store.apiClient;
+    }
+    if (!defaultApiClient) {
+        throw new Error("API client not initialized. For HTTP mode, include Authorization header. For STDIO mode, set FORMBRO_API_TOKEN.");
+    }
+    return defaultApiClient;
+}
+/**
+ * Make an API request to FormBro backend
+ */
+export async function makeApiRequest(endpoint, method = "GET", data, params) {
+    const client = getApiClient();
+    const response = await client.request({
+        method,
+        url: endpoint,
+        data,
+        params
+    });
+    return response.data;
+}
+/**
+ * Handle API errors and return user-friendly messages
+ */
+export function handleApiError(error) {
+    if (error instanceof AxiosError) {
+        if (error.response) {
+            const status = error.response.status;
+            const detail = error.response.data?.detail || error.response.data?.message;
+            switch (status) {
+                case 401:
+                    return "Error: Authentication failed. Please check your FORMBRO_API_TOKEN is valid.";
+                case 403:
+                    return "Error: Permission denied. You don't have access to this resource.";
+                case 404:
+                    return `Error: Resource not found. ${detail || "Please check the ID is correct."}`;
+                case 422:
+                    return `Error: Invalid request. ${detail || "Please check your parameters."}`;
+                case 429:
+                    return "Error: Rate limit exceeded. Please wait before making more requests.";
+                case 500:
+                    return "Error: FormBro server error. Please try again later.";
+                default:
+                    return `Error: API request failed with status ${status}. ${detail || ""}`;
+            }
+        }
+        else if (error.code === "ECONNABORTED") {
+            return "Error: Request timed out. Please try again.";
+        }
+        else if (error.code === "ECONNREFUSED") {
+            return "Error: Could not connect to FormBro server. Please check FORMBRO_API_URL.";
+        }
+    }
+    return `Error: Unexpected error occurred: ${error instanceof Error ? error.message : String(error)}`;
+}
+/**
+ * Check if the API client is properly configured
+ */
+export function isApiClientConfigured() {
+    return defaultApiClient !== null || defaultBaseUrl !== null;
+}
+/**
+ * Get the base URL
+ */
+export function getBaseUrl() {
+    return defaultBaseUrl;
+}
+//# sourceMappingURL=api-client.js.map

package/dist/services/api-client.js.map

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

package/dist/tools/applicants.d.ts

@@ -0,0 +1,6 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Register applicant tools with the MCP server
+ */
+export declare function registerApplicantTools(server: McpServer): void;
+//# sourceMappingURL=applicants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"applicants.d.ts","sourceRoot":"","sources":["../../src/tools/applicants.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA8FpE;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAqM9D"}

package/dist/tools/applicants.js

@@ -0,0 +1,261 @@
+// Applicant Tools for FormBro MCP Server
+import { z } from "zod";
+import { makeApiRequest, handleApiError } from "../services/api-client.js";
+import { ListWithSearchSchema, IdWithFormatSchema } from "../schemas/common.js";
+import { ResponseFormat, CHARACTER_LIMIT } from "../constants.js";
+// Extended schema for listing applicants
+const ListApplicantsSchema = ListWithSearchSchema.extend({
+    program: z.string()
+        .optional()
+        .describe("Filter by program type (e.g., 'tr', 'pr', 'lmia')")
+}).strict();
+/**
+ * Format applicant list item as Markdown (flattened structure from list endpoint)
+ */
+function formatApplicantListItemMarkdown(applicant) {
+    const lines = [];
+    const name = `${applicant.first_name || ""} ${applicant.last_name || ""}`.trim() || "Unknown";
+    lines.push(`## ${name} (${applicant.id})`);
+    lines.push("");
+    if (applicant.email)
+        lines.push(`- **Email**: ${applicant.email}`);
+    if (applicant.phone)
+        lines.push(`- **Phone**: ${applicant.phone}`);
+    if (applicant.dob)
+        lines.push(`- **DOB**: ${applicant.dob}`);
+    if (applicant.identifier)
+        lines.push(`- **Identifier**: ${applicant.identifier}`);
+    lines.push("");
+    lines.push(`- **Status**: ${applicant.is_active ? "Active" : "Deleted"}`);
+    lines.push(`- **Created**: ${applicant.created_date}`);
+    return lines.join("\n");
+}
+/**
+ * Format full applicant data as Markdown (nested structure from detail endpoint)
+ */
+function formatApplicantMarkdown(applicant) {
+    const lines = [];
+    const personal = applicant.personal || {};
+    lines.push(`## ${personal.first_name || ""} ${personal.last_name || ""} (${applicant.id})`);
+    lines.push("");
+    if (personal.email)
+        lines.push(`- **Email**: ${personal.email}`);
+    if (personal.phone)
+        lines.push(`- **Phone**: ${personal.phone}`);
+    if (personal.dob)
+        lines.push(`- **Date of Birth**: ${personal.dob}`);
+    if (personal.sex)
+        lines.push(`- **Sex**: ${personal.sex}`);
+    if (personal.country_of_birth)
+        lines.push(`- **Country of Birth**: ${personal.country_of_birth}`);
+    if (personal.city_of_birth)
+        lines.push(`- **City of Birth**: ${personal.city_of_birth}`);
+    if (personal.citizenship?.length) {
+        lines.push(`- **Citizenship**: ${personal.citizenship.join(", ")}`);
+    }
+    lines.push("");
+    lines.push(`- **Status**: ${applicant.is_active ? "Active" : "Deleted"}`);
+    lines.push(`- **Created**: ${applicant.created_date}`);
+    if (applicant.last_modified_date) {
+        lines.push(`- **Last Modified**: ${applicant.last_modified_date}`);
+    }
+    lines.push(`- **Version**: ${applicant.version}`);
+    return lines.join("\n");
+}
+/**
+ * Format applicant list as Markdown
+ */
+function formatApplicantsListMarkdown(applicants, total, offset) {
+    const lines = [
+        "# Applicants List",
+        "",
+        `Found ${total} applicants (showing ${applicants.length} from offset ${offset})`,
+        ""
+    ];
+    for (const applicant of applicants) {
+        lines.push(formatApplicantListItemMarkdown(applicant));
+        lines.push("---");
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+/**
+ * Register applicant tools with the MCP server
+ */
+export function registerApplicantTools(server) {
+    // List Applicants Tool
+    server.registerTool("formbro_list_applicants", {
+        title: "List FormBro Applicants",
+        description: `List applicants in the FormBro immigration management system.
+
+This tool retrieves a paginated list of applicants with their personal information,
+contact details, and metadata. Supports filtering by search query and program type.
+
+Args:
+  - limit (number): Maximum results to return, 1-100 (default: 20)
+  - offset (number): Number of results to skip for pagination (default: 0)
+  - search (string, optional): Search query to filter by name, email, etc.
+  - program (string, optional): Filter by program type ('tr', 'pr', 'lmia')
+  - response_format ('markdown' | 'json'): Output format (default: 'markdown')
+
+Returns:
+  Paginated list of applicants with personal information, contact details, and status.
+
+Examples:
+  - "List all applicants" -> params: {}
+  - "Find applicants named John" -> params: { search: "John" }
+  - "Get PR program applicants" -> params: { program: "pr" }`,
+        inputSchema: ListApplicantsSchema,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true
+        }
+    }, async (params) => {
+        try {
+            const queryParams = {
+                skip: params.offset,
+                limit: params.limit
+            };
+            if (params.search)
+                queryParams.search = params.search;
+            if (params.program)
+                queryParams.program = params.program;
+            // Backend returns array directly (flattened list items)
+            const applicants = await makeApiRequest("/api/applicants", "GET", undefined, queryParams);
+            const total = applicants.length;
+            if (!applicants.length) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: params.search
+                                ? `No applicants found matching '${params.search}'`
+                                : "No applicants found"
+                        }]
+                };
+            }
+            const output = {
+                total,
+                count: applicants.length,
+                offset: params.offset,
+                items: applicants.map(a => ({
+                    id: a.id,
+                    name: `${a.first_name || ""} ${a.last_name || ""}`.trim() || "Unknown",
+                    email: a.email,
+                    phone: a.phone,
+                    dob: a.dob,
+                    identifier: a.identifier,
+                    is_active: a.is_active,
+                    created_date: a.created_date
+                })),
+                has_more: total > params.offset + applicants.length,
+                ...(total > params.offset + applicants.length ? {
+                    next_offset: params.offset + applicants.length
+                } : {})
+            };
+            let textContent;
+            if (params.response_format === ResponseFormat.MARKDOWN) {
+                textContent = formatApplicantsListMarkdown(applicants, total, params.offset);
+            }
+            else {
+                textContent = JSON.stringify(output, null, 2);
+            }
+            // Truncate if too large
+            if (textContent.length > CHARACTER_LIMIT) {
+                textContent = textContent.substring(0, CHARACTER_LIMIT) +
+                    "\n\n[Response truncated. Use smaller limit or offset to see more results.]";
+            }
+            return {
+                content: [{ type: "text", text: textContent }],
+                structuredContent: output
+            };
+        }
+        catch (error) {
+            return {
+                isError: true,
+                content: [{ type: "text", text: handleApiError(error) }]
+            };
+        }
+    });
+    // Get Single Applicant Tool
+    server.registerTool("formbro_get_applicant", {
+        title: "Get FormBro Applicant Details",
+        description: `Get detailed information about a specific applicant in FormBro.
+
+This tool retrieves comprehensive information about an applicant including:
+- Personal information (name, DOB, contact details)
+- Addresses and ID documents
+- Family members and dependents
+- Education and employment history
+- Travel history and other background
+
+Args:
+  - id (string): The applicant's unique identifier (MongoDB ObjectId)
+  - response_format ('markdown' | 'json'): Output format (default: 'markdown')
+
+Returns:
+  Complete applicant profile with all available information.
+
+Examples:
+  - "Get applicant 507f1f77bcf86cd799439011" -> params: { id: "507f1f77bcf86cd799439011" }`,
+        inputSchema: IdWithFormatSchema,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true
+        }
+    }, async (params) => {
+        try {
+            const applicant = await makeApiRequest(`/api/applicants/${params.id}`, "GET");
+            let textContent;
+            if (params.response_format === ResponseFormat.MARKDOWN) {
+                const lines = [
+                    "# Applicant Details",
+                    "",
+                    formatApplicantMarkdown(applicant)
+                ];
+                // Add additional sections if available
+                if (applicant.education?.length) {
+                    lines.push("", "### Education", "");
+                    for (const edu of applicant.education) {
+                        lines.push(`- ${edu.institution || "Unknown"} (${edu.start_date || "?"} - ${edu.end_date || "present"})`);
+                    }
+                }
+                if (applicant.employment?.length) {
+                    lines.push("", "### Employment", "");
+                    for (const emp of applicant.employment) {
+                        lines.push(`- ${emp.employer_name || "Unknown"}: ${emp.job_title || "Unknown"} (${emp.start_date || "?"} - ${emp.end_date || "present"})`);
+                    }
+                }
+                if (applicant.family?.length) {
+                    lines.push("", "### Family Members", "");
+                    for (const member of applicant.family) {
+                        lines.push(`- ${member.first_name || ""} ${member.last_name || ""} (${member.relationship || "Unknown"})`);
+                    }
+                }
+                textContent = lines.join("\n");
+            }
+            else {
+                textContent = JSON.stringify(applicant, null, 2);
+            }
+            // Truncate if too large
+            if (textContent.length > CHARACTER_LIMIT) {
+                textContent = textContent.substring(0, CHARACTER_LIMIT) +
+                    "\n\n[Response truncated due to size. Use JSON format for complete data.]";
+            }
+            return {
+                content: [{ type: "text", text: textContent }],
+                structuredContent: applicant
+            };
+        }
+        catch (error) {
+            return {
+                isError: true,
+                content: [{ type: "text", text: handleApiError(error) }]
+            };
+        }
+    });
+}
+//# sourceMappingURL=applicants.js.map

package/dist/tools/applicants.js.map

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

package/dist/tools/applications.d.ts

@@ -0,0 +1,6 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Register application tools with the MCP server
+ */
+export declare function registerApplicationTools(server: McpServer): void;
+//# sourceMappingURL=applications.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"applications.d.ts","sourceRoot":"","sources":["../../src/tools/applications.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAiEpE;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA4LhE"}