formbro-mcp-server 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 FormBro
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,166 @@
+# FormBro MCP Server
+
+[![npm version](https://badge.fury.io/js/formbro-mcp-server.svg)](https://www.npmjs.com/package/formbro-mcp-server)
+
+MCP server for FormBro immigration management system - provides access to applicants, applications, and employers data through the Model Context Protocol.
+
+## Features
+
+- 🔍 **Smart Find Tool** - Search across applicants, applications, and employers with intelligent name matching
+- 📋 **List Operations** - Paginated listing with search and filtering
+- 📄 **Detail Views** - Comprehensive entity information retrieval
+- 🔐 **Secure Authentication** - Token-based API authentication
+- 🌐 **Dual Transport** - Supports both stdio (local) and HTTP (remote) modes
+- 📡 **SSE Support** - Server-Sent Events for streaming responses
+
+## Installation
+
+```bash
+# Using npx (recommended)
+npx formbro-mcp-server
+
+# Or install globally
+npm install -g formbro-mcp-server
+```
+
+## Usage
+
+### Quick Start (stdio mode)
+
+```bash
+FORMBRO_API_URL=https://api.formbro.com \
+FORMBRO_API_TOKEN=your-token \
+formbro-mcp-server
+```
+
+### HTTP Server Mode
+
+```bash
+FORMBRO_API_URL=https://api.formbro.com \
+TRANSPORT=http \
+PORT=3000 \
+formbro-mcp-server
+```
+
+## Configuration
+
+### Environment Variables
+
+| Variable | Required | Description | Default |
+|----------|----------|-------------|---------|
+| `FORMBRO_API_URL` | Yes | Base URL of FormBro API | - |
+| `FORMBRO_API_TOKEN` | Yes (stdio) | API token for authentication | - |
+| `TRANSPORT` | No | Transport mode: `stdio` or `http` | `stdio` |
+| `PORT` | No | HTTP server port (http mode only) | `3000` |
+
+### Get Your API Token
+
+1. Log in to FormBro
+2. Navigate to Settings > API Tokens
+3. Generate a new token
+
+## Connecting from Claude
+
+### Claude Desktop (stdio)
+
+Add to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "formbro": {
+      "command": "npx",
+      "args": ["-y", "formbro-mcp-server"],
+      "env": {
+        "FORMBRO_API_URL": "https://api.formbro.com",
+        "FORMBRO_API_TOKEN": "your-token"
+      }
+    }
+  }
+}
+```
+
+### Claude Code (HTTP)
+
+```bash
+# Start HTTP server
+FORMBRO_API_URL=https://api.formbro.com \
+TRANSPORT=http \
+formbro-mcp-server
+
+# Add to Claude Code
+claude mcp add --transport http formbro http://localhost:3000/mcp \
+  --header "Authorization: Bearer your-token"
+```
+
+## Available Tools
+
+### `formbro_find` (Recommended)
+
+Smart search across all entity types with name matching and related data retrieval.
+
+```typescript
+// Find applicants named "John"
+formbro_find({ query: "John" })
+
+// Find LMIA applications
+formbro_find({ query: "LMIA" })
+```
+
+### `formbro_list_applicants`
+
+List applicants with search, program filtering, and pagination.
+
+### `formbro_get_applicant`
+
+Get detailed applicant information by ID.
+
+### `formbro_list_applications`
+
+List applications by program type (tr/pr/lmia) with status filtering.
+
+### `formbro_get_application`
+
+Get detailed application information by ID.
+
+### `formbro_list_employers`
+
+List employers with search and pagination.
+
+### `formbro_get_employer`
+
+Get detailed employer information by ID.
+
+## API Response Formats
+
+All tools support two response formats:
+
+- `markdown` (default) - Human-readable formatted output
+- `json` - Machine-readable structured data
+
+## Development
+
+```bash
+# Clone the repository
+git clone https://github.com/yourusername/formbro-mcp-server.git
+cd formbro-mcp-server
+
+# Install dependencies
+pnpm install
+
+# Build
+pnpm build
+
+# Run in development mode
+pnpm dev
+```
+
+## License
+
+MIT
+
+## Links
+
+- [FormBro](https://formbro.com)
+- [Model Context Protocol](https://modelcontextprotocol.io)
+- [npm Package](https://www.npmjs.com/package/formbro-mcp-server)

package/dist/constants.d.ts

@@ -0,0 +1,9 @@
+export declare const CHARACTER_LIMIT = 25000;
+export declare const DEFAULT_LIMIT = 20;
+export declare const MAX_LIMIT = 100;
+export declare const API_TIMEOUT = 30000;
+export declare enum ResponseFormat {
+    MARKDOWN = "markdown",
+    JSON = "json"
+}
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,eAAe,QAAQ,CAAC;AAGrC,eAAO,MAAM,aAAa,KAAK,CAAC;AAChC,eAAO,MAAM,SAAS,MAAM,CAAC;AAG7B,eAAO,MAAM,WAAW,QAAQ,CAAC;AAGjC,oBAAY,cAAc;IACxB,QAAQ,aAAa;IACrB,IAAI,SAAS;CACd"}

package/dist/constants.js

@@ -0,0 +1,15 @@
+// FormBro MCP Server Constants
+// Maximum response size in characters
+export const CHARACTER_LIMIT = 25000;
+// Default pagination settings
+export const DEFAULT_LIMIT = 20;
+export const MAX_LIMIT = 100;
+// API timeout in milliseconds
+export const API_TIMEOUT = 30000;
+// Response format options
+export var ResponseFormat;
+(function (ResponseFormat) {
+    ResponseFormat["MARKDOWN"] = "markdown";
+    ResponseFormat["JSON"] = "json";
+})(ResponseFormat || (ResponseFormat = {}));
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAE/B,sCAAsC;AACtC,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,CAAC;AAErC,8BAA8B;AAC9B,MAAM,CAAC,MAAM,aAAa,GAAG,EAAE,CAAC;AAChC,MAAM,CAAC,MAAM,SAAS,GAAG,GAAG,CAAC;AAE7B,8BAA8B;AAC9B,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,CAAC;AAEjC,0BAA0B;AAC1B,MAAM,CAAN,IAAY,cAGX;AAHD,WAAY,cAAc;IACxB,uCAAqB,CAAA;IACrB,+BAAa,CAAA;AACf,CAAC,EAHW,cAAc,KAAd,cAAc,QAGzB"}

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+/**
+ * FormBro MCP Server
+ *
+ * Provides access to FormBro immigration management system data through MCP protocol.
+ * Supports both HTTP (for remote access) and stdio (for local CLI) transports.
+ *
+ * Environment Variables:
+ *   FORMBRO_API_URL   - Base URL of FormBro API (e.g., https://api.formbro.com)
+ *   FORMBRO_API_TOKEN - Your FormBro API token for authentication
+ *   TRANSPORT         - Transport mode: 'http' or 'stdio' (default: 'stdio')
+ *   PORT              - HTTP server port (default: 3000, only for HTTP transport)
+ */
+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":";AACA;;;;;;;;;;;GAWG"}

package/dist/index.js

@@ -0,0 +1,299 @@
+#!/usr/bin/env node
+/**
+ * FormBro MCP Server
+ *
+ * Provides access to FormBro immigration management system data through MCP protocol.
+ * Supports both HTTP (for remote access) and stdio (for local CLI) transports.
+ *
+ * Environment Variables:
+ *   FORMBRO_API_URL   - Base URL of FormBro API (e.g., https://api.formbro.com)
+ *   FORMBRO_API_TOKEN - Your FormBro API token for authentication
+ *   TRANSPORT         - Transport mode: 'http' or 'stdio' (default: 'stdio')
+ *   PORT              - HTTP server port (default: 3000, only for HTTP transport)
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import express from "express";
+import http from "http";
+import { initializeApiClient, setBaseUrl, createApiClientWithToken, runWithApiClient, isApiClientConfigured, getBaseUrl } from "./services/api-client.js";
+import { registerApplicantTools } from "./tools/applicants.js";
+import { registerApplicationTools } from "./tools/applications.js";
+import { registerEmployerTools } from "./tools/employers.js";
+import { registerFindTool } from "./tools/find.js";
+// Server configuration
+const SERVER_NAME = "formbro-mcp-server";
+const SERVER_VERSION = "1.0.0";
+/**
+ * Validate required environment variables for STDIO mode
+ */
+function validateEnvironmentStdio() {
+    const apiUrl = process.env.FORMBRO_API_URL;
+    const apiToken = process.env.FORMBRO_API_TOKEN;
+    if (!apiUrl) {
+        console.error("ERROR: FORMBRO_API_URL environment variable is required");
+        console.error("Example: export FORMBRO_API_URL=https://api.formbro.com");
+        process.exit(1);
+    }
+    if (!apiToken) {
+        console.error("ERROR: FORMBRO_API_TOKEN environment variable is required");
+        console.error("Get your API token from FormBro settings");
+        process.exit(1);
+    }
+    return { apiUrl, apiToken };
+}
+/**
+ * Validate required environment variables for HTTP mode
+ * Token is provided per-request via Authorization header
+ */
+function validateEnvironmentHttp() {
+    const apiUrl = process.env.FORMBRO_API_URL;
+    if (!apiUrl) {
+        console.error("ERROR: FORMBRO_API_URL environment variable is required");
+        console.error("Example: export FORMBRO_API_URL=https://api.formbro.com");
+        process.exit(1);
+    }
+    return { apiUrl };
+}
+/**
+ * Create and configure the MCP server
+ */
+function createServer() {
+    const server = new McpServer({
+        name: SERVER_NAME,
+        version: SERVER_VERSION
+    });
+    // Register all tools
+    registerFindTool(server); // Smart find tool - recommended for most queries
+    registerApplicantTools(server);
+    registerApplicationTools(server);
+    registerEmployerTools(server);
+    return server;
+}
+/**
+ * Run server with stdio transport (for local CLI usage)
+ */
+async function runStdio() {
+    const { apiUrl, apiToken } = validateEnvironmentStdio();
+    initializeApiClient(apiUrl, apiToken);
+    const server = createServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error(`${SERVER_NAME} v${SERVER_VERSION} running via stdio`);
+    console.error(`Connected to FormBro API at ${apiUrl}`);
+}
+/**
+ * Extract token from Authorization header
+ * Supports both formats:
+ *   - "Bearer fb_xxx" -> returns "fb_xxx"
+ *   - "fb_xxx" -> returns "fb_xxx"
+ */
+function extractToken(req) {
+    const authHeader = req.headers.authorization;
+    if (!authHeader)
+        return null;
+    // Check for "Bearer xxx" format
+    const parts = authHeader.split(" ");
+    if (parts.length === 2 && parts[0].toLowerCase() === "bearer") {
+        return parts[1];
+    }
+    // Support direct token format (no Bearer prefix)
+    if (parts.length === 1 && authHeader.startsWith("fb_")) {
+        return authHeader;
+    }
+    return null;
+}
+/**
+ * Run server with HTTP transport (for remote access)
+ */
+async function runHttp() {
+    const { apiUrl } = validateEnvironmentHttp();
+    setBaseUrl(apiUrl);
+    const app = express();
+    app.use(express.json());
+    // Health check endpoint
+    app.get("/health", (_req, res) => {
+        res.json({
+            status: "ok",
+            server: SERVER_NAME,
+            version: SERVER_VERSION,
+            apiUrl: getBaseUrl(),
+            apiConfigured: isApiClientConfigured()
+        });
+    });
+    // MCP endpoint - Streamable HTTP transport
+    app.post("/mcp", async (req, res) => {
+        try {
+            // Extract token from Authorization header
+            const token = extractToken(req);
+            if (!token) {
+                res.status(401).json({
+                    error: "Unauthorized",
+                    message: "Missing Authorization header. Include 'Authorization: Bearer YOUR_FORMBRO_API_TOKEN' in your request."
+                });
+                return;
+            }
+            // Create API client with the provided token
+            const apiClient = createApiClientWithToken(token);
+            // Run the MCP request with the token-specific API client
+            await runWithApiClient(apiClient, async () => {
+                const server = createServer();
+                // Create new transport for each request (stateless)
+                const transport = new StreamableHTTPServerTransport({
+                    sessionIdGenerator: undefined,
+                    enableJsonResponse: true
+                });
+                res.on("close", () => transport.close());
+                await server.connect(transport);
+                await transport.handleRequest(req, res, req.body);
+            });
+        }
+        catch (error) {
+            console.error("MCP request error:", error);
+            if (!res.headersSent) {
+                res.status(500).json({
+                    error: "Internal server error",
+                    message: error instanceof Error ? error.message : String(error)
+                });
+            }
+        }
+    });
+    // Handle GET requests with method info
+    app.get("/mcp", (_req, res) => {
+        res.json({
+            name: SERVER_NAME,
+            version: SERVER_VERSION,
+            description: "FormBro MCP Server - Immigration Management System",
+            transport: "Streamable HTTP",
+            method: "POST /mcp",
+            tools: [
+                "formbro_find", // Recommended: Smart search with name matching and related data
+                "formbro_list_applicants",
+                "formbro_get_applicant",
+                "formbro_list_applications",
+                "formbro_get_application",
+                "formbro_list_employers",
+                "formbro_get_employer"
+            ]
+        });
+    });
+    // Support both MCP_PORT (from env files) and PORT (generic)
+    const port = parseInt(process.env.MCP_PORT || process.env.PORT || "3000", 10);
+    // Create raw HTTP server to inject Accept header before Express processes the request
+    // This is necessary because the MCP SDK's StreamableHTTPServerTransport requires
+    // the Accept header to include both application/json and text/event-stream,
+    // but Claude Code's HTTP client may not send this header correctly
+    const server = http.createServer((req, res) => {
+        // Inject Accept header for MCP POST requests if missing
+        if (req.method === "POST" && req.url?.startsWith("/mcp")) {
+            const accept = req.headers.accept || "";
+            if (!accept.includes("text/event-stream")) {
+                const newAccept = "application/json, text/event-stream";
+                // Modify headers object
+                req.headers.accept = newAccept;
+                // Also modify rawHeaders array (used by @hono/node-server)
+                const rawHeaders = req.rawHeaders;
+                let found = false;
+                for (let i = 0; i < rawHeaders.length; i += 2) {
+                    if (rawHeaders[i].toLowerCase() === "accept") {
+                        rawHeaders[i + 1] = newAccept;
+                        found = true;
+                        break;
+                    }
+                }
+                // If Accept header doesn't exist, add it
+                if (!found) {
+                    rawHeaders.push("Accept", newAccept);
+                }
+            }
+        }
+        // Pass to Express
+        app(req, res);
+    });
+    server.listen(port, () => {
+        console.error(`${SERVER_NAME} v${SERVER_VERSION} running on http://localhost:${port}/mcp`);
+        console.error(`Backend API: ${apiUrl}`);
+        console.error("");
+        console.error("Authentication: Each request must include 'Authorization: Bearer YOUR_FORMBRO_API_TOKEN' header.");
+        console.error("Get your API token from FormBro Settings > API Tokens");
+        console.error("");
+        console.error("To connect from Claude Code, add the server with your token:");
+        console.error(`  claude mcp add --transport http formbro http://localhost:${port}/mcp --header "Authorization: Bearer YOUR_TOKEN"`);
+    });
+}
+/**
+ * Print usage information
+ */
+function printHelp() {
+    console.log(`
+${SERVER_NAME} v${SERVER_VERSION}
+FormBro MCP Server - Access immigration data from Claude Code/Desktop
+
+USAGE:
+  formbro-mcp-server [options]
+
+ENVIRONMENT VARIABLES:
+  FORMBRO_API_URL     Base URL of FormBro API (required)
+                      Example: https://api.formbro.com
+
+  FORMBRO_API_TOKEN   Your FormBro API token (required)
+                      Get this from FormBro settings
+
+  TRANSPORT           Transport mode (optional, default: stdio)
+                      - stdio: For local CLI integration
+                      - http: For remote HTTP access
+
+  PORT                HTTP server port (optional, default: 3000)
+                      Only used when TRANSPORT=http
+
+EXAMPLES:
+  # Run with stdio transport (for Claude Desktop)
+  FORMBRO_API_URL=https://api.formbro.com \\
+  FORMBRO_API_TOKEN=your-token \\
+  formbro-mcp-server
+
+  # Run with HTTP transport (for remote access)
+  FORMBRO_API_URL=https://api.formbro.com \\
+  FORMBRO_API_TOKEN=your-token \\
+  TRANSPORT=http \\
+  PORT=8080 \\
+  formbro-mcp-server
+
+AVAILABLE TOOLS:
+  formbro_find              [RECOMMENDED] Smart search with name matching and related data
+  formbro_list_applicants   List applicants with search and pagination
+  formbro_get_applicant     Get detailed applicant information
+  formbro_list_applications List applications by program type
+  formbro_get_application   Get detailed application information
+  formbro_list_employers    List employers with search and pagination
+  formbro_get_employer      Get detailed employer information
+
+CONNECTING FROM CLAUDE CODE:
+  # For HTTP transport
+  claude mcp add --transport http formbro http://localhost:3000/mcp
+
+  # For stdio transport
+  claude mcp add --transport stdio formbro -- \\
+    env FORMBRO_API_URL=... FORMBRO_API_TOKEN=... formbro-mcp-server
+`);
+}
+// Main entry point
+const args = process.argv.slice(2);
+if (args.includes("--help") || args.includes("-h")) {
+    printHelp();
+    process.exit(0);
+}
+const transport = process.env.TRANSPORT || "stdio";
+if (transport === "http") {
+    runHttp().catch((error) => {
+        console.error("Server error:", error);
+        process.exit(1);
+    });
+}
+else {
+    runStdio().catch((error) => {
+        console.error("Server error:", error);
+        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":"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"}

package/dist/schemas/common.d.ts

@@ -0,0 +1,77 @@
+import { z } from "zod";
+import { ResponseFormat } from "../constants.js";
+export declare const PaginationSchema: z.ZodObject<{
+    limit: z.ZodDefault<z.ZodNumber>;
+    offset: z.ZodDefault<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    limit: number;
+    offset: number;
+}, {
+    limit?: number | undefined;
+    offset?: number | undefined;
+}>;
+export declare const ResponseFormatSchema: z.ZodObject<{
+    response_format: z.ZodDefault<z.ZodNativeEnum<typeof ResponseFormat>>;
+}, "strict", z.ZodTypeAny, {
+    response_format: ResponseFormat;
+}, {
+    response_format?: ResponseFormat | undefined;
+}>;
+export declare const ListOptionsSchema: z.ZodObject<{
+    limit: z.ZodDefault<z.ZodNumber>;
+    offset: z.ZodDefault<z.ZodNumber>;
+} & {
+    response_format: z.ZodDefault<z.ZodNativeEnum<typeof ResponseFormat>>;
+}, "strict", z.ZodTypeAny, {
+    limit: number;
+    offset: number;
+    response_format: ResponseFormat;
+}, {
+    limit?: number | undefined;
+    offset?: number | undefined;
+    response_format?: ResponseFormat | undefined;
+}>;
+export declare const IdSchema: z.ZodObject<{
+    id: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    id: string;
+}, {
+    id: string;
+}>;
+export declare const IdWithFormatSchema: z.ZodObject<{
+    id: z.ZodString;
+} & {
+    response_format: z.ZodDefault<z.ZodNativeEnum<typeof ResponseFormat>>;
+}, "strict", z.ZodTypeAny, {
+    response_format: ResponseFormat;
+    id: string;
+}, {
+    id: string;
+    response_format?: ResponseFormat | undefined;
+}>;
+export declare const SearchSchema: z.ZodObject<{
+    search: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    search?: string | undefined;
+}, {
+    search?: string | undefined;
+}>;
+export declare const ListWithSearchSchema: z.ZodObject<{
+    limit: z.ZodDefault<z.ZodNumber>;
+    offset: z.ZodDefault<z.ZodNumber>;
+} & {
+    response_format: z.ZodDefault<z.ZodNativeEnum<typeof ResponseFormat>>;
+} & {
+    search: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    limit: number;
+    offset: number;
+    response_format: ResponseFormat;
+    search?: string | undefined;
+}, {
+    limit?: number | undefined;
+    offset?: number | undefined;
+    response_format?: ResponseFormat | undefined;
+    search?: string | undefined;
+}>;
+//# sourceMappingURL=common.d.ts.map

package/dist/schemas/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/schemas/common.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAA4B,MAAM,iBAAiB,CAAC;AAG3E,eAAO,MAAM,gBAAgB;;;;;;;;;EAYlB,CAAC;AAGZ,eAAO,MAAM,oBAAoB;;;;;;EAItB,CAAC;AAGZ,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;EAA+C,CAAC;AAG9E,eAAO,MAAM,QAAQ;;;;;;EAIV,CAAC;AAGZ,eAAO,MAAM,kBAAkB;;;;;;;;;;EAAuC,CAAC;AAGvE,eAAO,MAAM,YAAY;;;;;;EAId,CAAC;AAGZ,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;EAAwC,CAAC"}

package/dist/schemas/common.js

@@ -0,0 +1,42 @@
+// Common Zod Schemas for FormBro MCP Server
+import { z } from "zod";
+import { ResponseFormat, DEFAULT_LIMIT, MAX_LIMIT } from "../constants.js";
+// Pagination schema
+export const PaginationSchema = z.object({
+    limit: z.number()
+        .int()
+        .min(1)
+        .max(MAX_LIMIT)
+        .default(DEFAULT_LIMIT)
+        .describe("Maximum number of results to return (1-100, default: 20)"),
+    offset: z.number()
+        .int()
+        .min(0)
+        .default(0)
+        .describe("Number of results to skip for pagination")
+}).strict();
+// Response format schema
+export const ResponseFormatSchema = z.object({
+    response_format: z.nativeEnum(ResponseFormat)
+        .default(ResponseFormat.MARKDOWN)
+        .describe("Output format: 'markdown' for human-readable or 'json' for machine-readable")
+}).strict();
+// Combined pagination and format schema
+export const ListOptionsSchema = PaginationSchema.merge(ResponseFormatSchema);
+// ID parameter schema
+export const IdSchema = z.object({
+    id: z.string()
+        .min(1)
+        .describe("The unique identifier (MongoDB ObjectId)")
+}).strict();
+// ID with format schema
+export const IdWithFormatSchema = IdSchema.merge(ResponseFormatSchema);
+// Search schema
+export const SearchSchema = z.object({
+    search: z.string()
+        .optional()
+        .describe("Search query to filter results (searches name, email, etc.)")
+}).strict();
+// List with search schema
+export const ListWithSearchSchema = ListOptionsSchema.merge(SearchSchema);
+//# sourceMappingURL=common.js.map