formbro-mcp-server 1.0.0

package/dist/tools/applications.js

@@ -0,0 +1,225 @@
+// Application 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 applications
+const ListApplicationsSchema = ListWithSearchSchema.extend({
+    program: z.enum(["tr", "pr", "lmia"])
+        .optional()
+        .describe("Filter by program type: 'tr' (Temporary Residence), 'pr' (Permanent Residence), 'lmia' (Labour Market Impact Assessment)"),
+    status: z.string()
+        .optional()
+        .describe("Filter by application status (e.g., 'draft', 'in_progress', 'submitted', 'approved', 'refused')")
+}).strict();
+/**
+ * Format application data as Markdown
+ */
+function formatApplicationMarkdown(app) {
+    const lines = [];
+    lines.push(`## ${app.case_name || "Unnamed Application"} (${app.id})`);
+    lines.push("");
+    if (app.program_type)
+        lines.push(`- **Program**: ${app.program_type.toUpperCase()}`);
+    if (app.status)
+        lines.push(`- **Status**: ${app.status}`);
+    if (app.applicant_id)
+        lines.push(`- **Applicant ID**: ${app.applicant_id}`);
+    if (app.employer_id)
+        lines.push(`- **Employer ID**: ${app.employer_id}`);
+    lines.push(`- **Created**: ${app.created_date}`);
+    if (app.last_modified_date) {
+        lines.push(`- **Last Modified**: ${app.last_modified_date}`);
+    }
+    return lines.join("\n");
+}
+/**
+ * Format applications list as Markdown
+ */
+function formatApplicationsListMarkdown(applications, total, offset) {
+    const lines = [
+        "# Applications List",
+        "",
+        `Found ${total} applications (showing ${applications.length} from offset ${offset})`,
+        ""
+    ];
+    for (const app of applications) {
+        lines.push(formatApplicationMarkdown(app));
+        lines.push("---");
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+/**
+ * Register application tools with the MCP server
+ */
+export function registerApplicationTools(server) {
+    // List Applications Tool
+    server.registerTool("formbro_list_applications", {
+        title: "List FormBro Applications",
+        description: `List immigration applications in the FormBro system.
+
+This tool retrieves a paginated list of applications across different immigration programs:
+- TR (Temporary Residence): Work permits, study permits, visitor visas
+- PR (Permanent Residence): Family sponsorship, Express Entry, PNP
+- LMIA (Labour Market Impact Assessment): Employer applications for foreign workers
+
+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 case name
+  - program (string, optional): Filter by program type ('tr', 'pr', 'lmia')
+  - status (string, optional): Filter by status ('draft', 'in_progress', 'submitted', 'approved', 'refused')
+  - response_format ('markdown' | 'json'): Output format (default: 'markdown')
+
+Returns:
+  Paginated list of applications with case names, programs, statuses, and related IDs.
+
+Examples:
+  - "List all applications" -> params: {}
+  - "Show LMIA applications" -> params: { program: "lmia" }
+  - "Find approved PR cases" -> params: { program: "pr", status: "approved" }`,
+        inputSchema: ListApplicationsSchema,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true
+        }
+    }, async (params) => {
+        try {
+            let applications;
+            // Use search endpoint when search query is provided
+            if (params.search) {
+                const searchParams = {
+                    q: params.search,
+                    limit: params.limit
+                };
+                applications = await makeApiRequest("/api/dashboard/search", "GET", undefined, searchParams);
+            }
+            else {
+                // Use regular applications endpoint for listing
+                const queryParams = {
+                    skip: params.offset,
+                    limit: params.limit
+                };
+                if (params.status)
+                    queryParams.status = params.status;
+                if (params.program)
+                    queryParams.program_type = params.program.toUpperCase();
+                applications = await makeApiRequest("/api/dashboard/applications", "GET", undefined, queryParams);
+            }
+            const total = applications.length;
+            if (!applications.length) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: params.program
+                                ? `No ${params.program.toUpperCase()} applications found`
+                                : "No applications found"
+                        }]
+                };
+            }
+            const output = {
+                total,
+                count: applications.length,
+                offset: params.offset,
+                items: applications.map(a => ({
+                    id: a.id,
+                    case_name: a.case_name,
+                    program_type: a.program_type,
+                    status: a.status,
+                    applicant_id: a.applicant_id,
+                    employer_id: a.employer_id,
+                    created_date: a.created_date,
+                    last_modified_date: a.last_modified_date
+                })),
+                has_more: total > params.offset + applications.length,
+                ...(total > params.offset + applications.length ? {
+                    next_offset: params.offset + applications.length
+                } : {})
+            };
+            let textContent;
+            if (params.response_format === ResponseFormat.MARKDOWN) {
+                textContent = formatApplicationsListMarkdown(applications, total, params.offset);
+            }
+            else {
+                textContent = JSON.stringify(output, null, 2);
+            }
+            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 Application Tool
+    server.registerTool("formbro_get_application", {
+        title: "Get FormBro Application Details",
+        description: `Get detailed information about a specific immigration application.
+
+This tool retrieves comprehensive information about an application including:
+- Case identification and status
+- Program-specific details (TR forms, PR sponsorship info, LMIA job details)
+- Associated applicant and employer information
+- Timeline and modification history
+
+Args:
+  - id (string): The application's unique identifier (MongoDB ObjectId)
+  - response_format ('markdown' | 'json'): Output format (default: 'markdown')
+
+Returns:
+  Complete application details with all available information.
+
+Examples:
+  - "Get application 507f1f77bcf86cd799439011" -> params: { id: "507f1f77bcf86cd799439011" }`,
+        inputSchema: IdWithFormatSchema,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true
+        }
+    }, async (params) => {
+        try {
+            // Use unified endpoint that works for all program types (TR/PR/LMIA)
+            const application = await makeApiRequest(`/api/applications/${params.id}`, "GET");
+            let textContent;
+            if (params.response_format === ResponseFormat.MARKDOWN) {
+                const lines = [
+                    "# Application Details",
+                    "",
+                    formatApplicationMarkdown(application)
+                ];
+                textContent = lines.join("\n");
+            }
+            else {
+                textContent = JSON.stringify(application, null, 2);
+            }
+            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: application
+            };
+        }
+        catch (error) {
+            return {
+                isError: true,
+                content: [{ type: "text", text: handleApiError(error) }]
+            };
+        }
+    });
+}
+//# sourceMappingURL=applications.js.map

package/dist/tools/applications.js.map

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

package/dist/tools/employers.d.ts

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

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

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

package/dist/tools/employers.js

@@ -0,0 +1,243 @@
+// Employer Tools for FormBro MCP Server
+import { makeApiRequest, handleApiError } from "../services/api-client.js";
+import { ListWithSearchSchema, IdWithFormatSchema } from "../schemas/common.js";
+import { ResponseFormat, CHARACTER_LIMIT } from "../constants.js";
+/**
+ * Format employer data as Markdown
+ */
+function formatEmployerMarkdown(employer) {
+    const lines = [];
+    const general = employer.general || {};
+    lines.push(`## ${general.legal_name || general.operating_name || "Unknown Employer"} (${employer.id})`);
+    lines.push("");
+    if (general.legal_name)
+        lines.push(`- **Legal Name**: ${general.legal_name}`);
+    if (general.operating_name && general.operating_name !== general.legal_name) {
+        lines.push(`- **Operating Name**: ${general.operating_name}`);
+    }
+    if (general.business_number)
+        lines.push(`- **Business Number**: ${general.business_number}`);
+    if (general.industry)
+        lines.push(`- **Industry**: ${general.industry}`);
+    if (general.website)
+        lines.push(`- **Website**: ${general.website}`);
+    if (employer.created_date) {
+        lines.push(`- **Created**: ${employer.created_date}`);
+    }
+    if (employer.last_modified_date) {
+        lines.push(`- **Last Modified**: ${employer.last_modified_date}`);
+    }
+    return lines.join("\n");
+}
+/**
+ * Format employers list as Markdown
+ */
+function formatEmployersListMarkdown(employers, total, offset) {
+    const lines = [
+        "# Employers List",
+        "",
+        `Found ${total} employers (showing ${employers.length} from offset ${offset})`,
+        ""
+    ];
+    for (const employer of employers) {
+        lines.push(formatEmployerMarkdown(employer));
+        lines.push("---");
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+/**
+ * Register employer tools with the MCP server
+ */
+export function registerEmployerTools(server) {
+    // List Employers Tool
+    server.registerTool("formbro_list_employers", {
+        title: "List FormBro Employers",
+        description: `List employers in the FormBro LMIA management system.
+
+This tool retrieves a paginated list of employers who have LMIA applications.
+Each employer record includes company information, contact details, and business addresses.
+
+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 company name, business number, etc.
+  - response_format ('markdown' | 'json'): Output format (default: 'markdown')
+
+Returns:
+  Paginated list of employers with company information and contact details.
+
+Examples:
+  - "List all employers" -> params: {}
+  - "Find employer Tech Corp" -> params: { search: "Tech Corp" }
+  - "Get employers page 2" -> params: { offset: 20, limit: 20 }`,
+        inputSchema: ListWithSearchSchema,
+        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;
+            const response = await makeApiRequest("/api/lmia/employers", "GET", undefined, queryParams);
+            const employers = response.items || [];
+            const total = response.total || 0;
+            if (!employers.length) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: params.search
+                                ? `No employers found matching '${params.search}'`
+                                : "No employers found"
+                        }]
+                };
+            }
+            const output = {
+                total,
+                count: employers.length,
+                offset: params.offset,
+                items: employers.map(e => ({
+                    id: e.id,
+                    legal_name: e.general?.legal_name,
+                    operating_name: e.general?.operating_name,
+                    business_number: e.general?.business_number,
+                    industry: e.general?.industry,
+                    website: e.general?.website,
+                    created_date: e.created_date
+                })),
+                has_more: total > params.offset + employers.length,
+                ...(total > params.offset + employers.length ? {
+                    next_offset: params.offset + employers.length
+                } : {})
+            };
+            let textContent;
+            if (params.response_format === ResponseFormat.MARKDOWN) {
+                textContent = formatEmployersListMarkdown(employers, total, params.offset);
+            }
+            else {
+                textContent = JSON.stringify(output, null, 2);
+            }
+            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 Employer Tool
+    server.registerTool("formbro_get_employer", {
+        title: "Get FormBro Employer Details",
+        description: `Get detailed information about a specific employer in FormBro.
+
+This tool retrieves comprehensive employer information including:
+- Company identification (legal name, operating name, business number)
+- Industry and website
+- Business, mailing, and work site addresses
+- Primary and secondary contact persons
+- Job offer information
+
+Args:
+  - id (string): The employer's unique identifier (MongoDB ObjectId)
+  - response_format ('markdown' | 'json'): Output format (default: 'markdown')
+
+Returns:
+  Complete employer profile with all available information.
+
+Examples:
+  - "Get employer 507f1f77bcf86cd799439011" -> params: { id: "507f1f77bcf86cd799439011" }`,
+        inputSchema: IdWithFormatSchema,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true
+        }
+    }, async (params) => {
+        try {
+            const employer = await makeApiRequest(`/api/lmia/employers/${params.id}`, "GET");
+            let textContent;
+            if (params.response_format === ResponseFormat.MARKDOWN) {
+                const lines = [
+                    "# Employer Details",
+                    "",
+                    formatEmployerMarkdown(employer)
+                ];
+                // Add address information if available
+                if (employer.addresses) {
+                    lines.push("", "### Addresses", "");
+                    const addresses = employer.addresses;
+                    for (const [type, addr] of Object.entries(addresses)) {
+                        if (addr && typeof addr === "object") {
+                            const parts = [
+                                addr.street_number,
+                                addr.street_name,
+                                addr.unit,
+                                addr.city,
+                                addr.province,
+                                addr.postal_code,
+                                addr.country
+                            ].filter(Boolean);
+                            if (parts.length) {
+                                lines.push(`- **${type}**: ${parts.join(", ")}`);
+                            }
+                        }
+                    }
+                }
+                // Add contact information if available
+                if (employer.contacts) {
+                    lines.push("", "### Contacts", "");
+                    const contacts = employer.contacts;
+                    for (const [type, contact] of Object.entries(contacts)) {
+                        if (contact && typeof contact === "object") {
+                            const name = [contact.first_name, contact.last_name].filter(Boolean).join(" ");
+                            if (name) {
+                                lines.push(`- **${type}**: ${name}`);
+                                if (contact.email)
+                                    lines.push(`  - Email: ${contact.email}`);
+                                if (contact.phone)
+                                    lines.push(`  - Phone: ${contact.phone}`);
+                                if (contact.job_title)
+                                    lines.push(`  - Title: ${contact.job_title}`);
+                            }
+                        }
+                    }
+                }
+                textContent = lines.join("\n");
+            }
+            else {
+                textContent = JSON.stringify(employer, null, 2);
+            }
+            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: employer
+            };
+        }
+        catch (error) {
+            return {
+                isError: true,
+                content: [{ type: "text", text: handleApiError(error) }]
+            };
+        }
+    });
+}
+//# sourceMappingURL=employers.js.map

package/dist/tools/employers.js.map

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

package/dist/tools/find.d.ts

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

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

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

package/dist/tools/find.js

@@ -0,0 +1,122 @@
+// Smart Find Tool for FormBro MCP Server
+import { z } from "zod";
+import { makeApiRequest, handleApiError } from "../services/api-client.js";
+// Input schema for find tool
+const FindSchema = z.object({
+    name: z.string()
+        .min(1)
+        .describe("Name to search for. Supports full name in any order (e.g., 'John Smith' or 'Zhang Wei')"),
+    program: z.enum(["tr", "pr", "lmia"])
+        .optional()
+        .describe("Filter by program type: 'tr' (Temporary Residence), 'pr' (Permanent Residence), 'lmia' (Labour Market Impact Assessment)"),
+    include: z.array(z.enum(["applications", "employer"]))
+        .optional()
+        .describe("Related data to include. Use ['applications'] to get applicant's applications, or ['applications', 'employer'] for LMIA cases"),
+    limit: z.number()
+        .int()
+        .min(1)
+        .max(20)
+        .optional()
+        .default(5)
+        .describe("Maximum number of results to return (1-20, default: 5)")
+}).strict();
+/**
+ * Format find results as compact text
+ */
+function formatFindResults(response) {
+    if (response.total === 0) {
+        return "No matching applicants found.";
+    }
+    const lines = [];
+    lines.push(`Found ${response.total} applicant(s):\n`);
+    for (const result of response.results) {
+        lines.push(`## ${result.name} (${result.id})`);
+        if (result.email)
+            lines.push(`  Email: ${result.email}`);
+        if (result.phone)
+            lines.push(`  Phone: ${result.phone}`);
+        if (result.dob)
+            lines.push(`  DOB: ${result.dob}`);
+        if (result.applications && result.applications.length > 0) {
+            lines.push(`  Applications (${result.applications.length}):`);
+            for (const app of result.applications) {
+                lines.push(`    - [${app.status}] ${app.program} (${app.id})`);
+                lines.push(`      Created: ${app.created}`);
+            }
+        }
+        else if (result.applications !== undefined) {
+            lines.push("  Applications: None");
+        }
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+/**
+ * Register find tool with the MCP server
+ */
+export function registerFindTool(server) {
+    server.registerTool("formbro_find", {
+        title: "Smart Find in FormBro",
+        description: `Smart search for applicants and their applications in FormBro.
+
+USE THIS TOOL FIRST for most queries - it combines search and detail fetching in one call.
+
+KEY FEATURES:
+- Intelligent name matching: Handles "First Last" and "Last First" order automatically
+  (e.g., "Zhang Wei" matches whether stored as given_name="Zhang" or given_name="Wei")
+- Returns applicant details with optional related applications in one call
+- Compact JSON response optimized for AI processing
+
+COMMON USE CASES:
+1. Find applicant: { "name": "Zhang Wei" }
+2. Find with applications: { "name": "Wei", "include": ["applications"] }
+3. Find TR applicants: { "name": "John", "program": "tr", "include": ["applications"] }
+
+WHEN TO USE OTHER TOOLS:
+- formbro_list_applicants: Browse all applicants without name search
+- formbro_get_applicant: Get full details by known ID
+- formbro_list_applications: Search by case name or browse applications`,
+        inputSchema: FindSchema,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true
+        }
+    }, async (args) => {
+        try {
+            // Build query parameters
+            const params = {
+                name: args.name,
+                limit: args.limit || 5
+            };
+            if (args.program) {
+                params.program = args.program;
+            }
+            if (args.include && args.include.length > 0) {
+                params.include = args.include.join(",");
+            }
+            const response = await makeApiRequest("/mcp/find", "GET", undefined, params);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: formatFindResults(response)
+                    }
+                ]
+            };
+        }
+        catch (error) {
+            return {
+                isError: true,
+                content: [
+                    {
+                        type: "text",
+                        text: handleApiError(error)
+                    }
+                ]
+            };
+        }
+    });
+}
+//# sourceMappingURL=find.js.map

package/dist/tools/find.js.map

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