@promptpartner/bexio-mcp-server 2.0.0

package/dist/tools/projects/definitions.js

@@ -0,0 +1,430 @@
+/**
+ * Projects tool definitions.
+ * Contains MCP tool metadata for projects domain.
+ * Includes: Projects (CRUD, archive, search), Project Types, Project Statuses, Milestones, Work Packages
+ */
+export const toolDefinitions = [
+    // ===== PROJECTS (PROJ-01) =====
+    {
+        name: "list_projects",
+        description: "List all projects in Bexio with pagination support",
+        inputSchema: {
+            type: "object",
+            properties: {
+                limit: {
+                    type: "integer",
+                    description: "Maximum number of projects to return (default: 100)",
+                    default: 100,
+                },
+                offset: {
+                    type: "integer",
+                    description: "Number of projects to skip (default: 0)",
+                    default: 0,
+                },
+            },
+        },
+    },
+    {
+        name: "get_project",
+        description: "Get a specific project by ID from Bexio",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project_id: {
+                    type: "integer",
+                    description: "The ID of the project to retrieve",
+                },
+            },
+            required: ["project_id"],
+        },
+    },
+    {
+        name: "create_project",
+        description: "Create a new project in Bexio. Requires user_id (owner) and name.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                user_id: {
+                    type: "integer",
+                    description: "The ID of the user who owns/manages the project",
+                },
+                name: {
+                    type: "string",
+                    description: "The name of the project",
+                },
+                contact_id: {
+                    type: "integer",
+                    description: "Optional: The ID of the associated contact/customer",
+                },
+                pr_state_id: {
+                    type: "integer",
+                    description: "Optional: The ID of the project status (use list_project_statuses to see available)",
+                },
+                pr_project_type_id: {
+                    type: "integer",
+                    description: "Optional: The ID of the project type (use list_project_types to see available)",
+                },
+                start_date: {
+                    type: "string",
+                    description: "Optional: Project start date in YYYY-MM-DD format",
+                },
+                end_date: {
+                    type: "string",
+                    description: "Optional: Project end date in YYYY-MM-DD format",
+                },
+                comment: {
+                    type: "string",
+                    description: "Optional: Additional comments/notes about the project",
+                },
+            },
+            required: ["user_id", "name"],
+        },
+    },
+    {
+        name: "update_project",
+        description: "Update an existing project in Bexio",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project_id: {
+                    type: "integer",
+                    description: "The ID of the project to update",
+                },
+                project_data: {
+                    type: "object",
+                    description: "Object containing the fields to update (e.g., name, contact_id, pr_state_id, etc.)",
+                },
+            },
+            required: ["project_id", "project_data"],
+        },
+    },
+    {
+        name: "delete_project",
+        description: "Delete a project from Bexio by ID. Consider using archive_project instead for data retention.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project_id: {
+                    type: "integer",
+                    description: "The ID of the project to delete",
+                },
+            },
+            required: ["project_id"],
+        },
+    },
+    {
+        name: "archive_project",
+        description: "Archive a project in Bexio. Archived projects are hidden but not deleted.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project_id: {
+                    type: "integer",
+                    description: "The ID of the project to archive",
+                },
+            },
+            required: ["project_id"],
+        },
+    },
+    {
+        name: "unarchive_project",
+        description: "Unarchive a previously archived project in Bexio, making it active again.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project_id: {
+                    type: "integer",
+                    description: "The ID of the project to unarchive",
+                },
+            },
+            required: ["project_id"],
+        },
+    },
+    {
+        name: "search_projects",
+        description: "Search for projects in Bexio using field-based criteria. Supports exact match and partial matching.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                search_criteria: {
+                    type: "array",
+                    description: "Array of search criteria objects",
+                    items: {
+                        type: "object",
+                        properties: {
+                            field: {
+                                type: "string",
+                                description: "Field name to search (e.g., 'name', 'contact_id', 'pr_state_id')",
+                            },
+                            value: {
+                                description: "Value to search for",
+                            },
+                            criteria: {
+                                type: "string",
+                                description: "Search operator: '=' for exact match, 'like' for partial match, '!=' for not equal",
+                            },
+                        },
+                        required: ["field", "value"],
+                    },
+                },
+            },
+            required: ["search_criteria"],
+        },
+    },
+    // ===== PROJECT TYPES (PROJ-02) =====
+    {
+        name: "list_project_types",
+        description: "List all project types available in Bexio (e.g., Internal, Customer Project)",
+        inputSchema: {
+            type: "object",
+            properties: {
+                limit: {
+                    type: "integer",
+                    description: "Maximum number of results to return (default: 100)",
+                    default: 100,
+                },
+                offset: {
+                    type: "integer",
+                    description: "Number of results to skip (default: 0)",
+                    default: 0,
+                },
+            },
+        },
+    },
+    {
+        name: "get_project_type",
+        description: "Get a specific project type by ID from Bexio",
+        inputSchema: {
+            type: "object",
+            properties: {
+                type_id: {
+                    type: "integer",
+                    description: "The ID of the project type to retrieve",
+                },
+            },
+            required: ["type_id"],
+        },
+    },
+    // ===== PROJECT STATUSES (PROJ-03) =====
+    {
+        name: "list_project_statuses",
+        description: "List all project statuses available in Bexio (e.g., Active, Completed, On Hold)",
+        inputSchema: {
+            type: "object",
+            properties: {
+                limit: {
+                    type: "integer",
+                    description: "Maximum number of results to return (default: 100)",
+                    default: 100,
+                },
+                offset: {
+                    type: "integer",
+                    description: "Number of results to skip (default: 0)",
+                    default: 0,
+                },
+            },
+        },
+    },
+    {
+        name: "get_project_status",
+        description: "Get a specific project status by ID from Bexio",
+        inputSchema: {
+            type: "object",
+            properties: {
+                status_id: {
+                    type: "integer",
+                    description: "The ID of the project status to retrieve",
+                },
+            },
+            required: ["status_id"],
+        },
+    },
+    // ===== MILESTONES (PROJ-04) =====
+    {
+        name: "list_milestones",
+        description: "List milestones for a specific project in Bexio",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project_id: {
+                    type: "integer",
+                    description: "The ID of the project to list milestones for",
+                },
+                limit: {
+                    type: "integer",
+                    description: "Maximum number of milestones to return (default: 100)",
+                    default: 100,
+                },
+                offset: {
+                    type: "integer",
+                    description: "Number of milestones to skip (default: 0)",
+                    default: 0,
+                },
+            },
+            required: ["project_id"],
+        },
+    },
+    {
+        name: "get_milestone",
+        description: "Get a specific milestone by ID from a project in Bexio",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project_id: {
+                    type: "integer",
+                    description: "The ID of the project containing the milestone",
+                },
+                milestone_id: {
+                    type: "integer",
+                    description: "The ID of the milestone to retrieve",
+                },
+            },
+            required: ["project_id", "milestone_id"],
+        },
+    },
+    {
+        name: "create_milestone",
+        description: "Create a new milestone in a project. Milestones track key deadlines and deliverables.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project_id: {
+                    type: "integer",
+                    description: "The ID of the project to add the milestone to",
+                },
+                name: {
+                    type: "string",
+                    description: "The name of the milestone",
+                },
+                end_date: {
+                    type: "string",
+                    description: "Optional: Target completion date in YYYY-MM-DD format",
+                },
+            },
+            required: ["project_id", "name"],
+        },
+    },
+    {
+        name: "delete_milestone",
+        description: "Delete a milestone from a project in Bexio",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project_id: {
+                    type: "integer",
+                    description: "The ID of the project containing the milestone",
+                },
+                milestone_id: {
+                    type: "integer",
+                    description: "The ID of the milestone to delete",
+                },
+            },
+            required: ["project_id", "milestone_id"],
+        },
+    },
+    // ===== WORK PACKAGES (PROJ-05) =====
+    {
+        name: "list_work_packages",
+        description: "List work packages for a specific project in Bexio",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project_id: {
+                    type: "integer",
+                    description: "The ID of the project to list work packages for",
+                },
+                limit: {
+                    type: "integer",
+                    description: "Maximum number of work packages to return (default: 100)",
+                    default: 100,
+                },
+                offset: {
+                    type: "integer",
+                    description: "Number of work packages to skip (default: 0)",
+                    default: 0,
+                },
+            },
+            required: ["project_id"],
+        },
+    },
+    {
+        name: "get_work_package",
+        description: "Get a specific work package by ID from a project in Bexio",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project_id: {
+                    type: "integer",
+                    description: "The ID of the project containing the work package",
+                },
+                workpackage_id: {
+                    type: "integer",
+                    description: "The ID of the work package to retrieve",
+                },
+            },
+            required: ["project_id", "workpackage_id"],
+        },
+    },
+    {
+        name: "create_work_package",
+        description: "Create a new work package in a project. Work packages organize deliverables and track estimated effort.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project_id: {
+                    type: "integer",
+                    description: "The ID of the project to add the work package to",
+                },
+                name: {
+                    type: "string",
+                    description: "The name of the work package",
+                },
+                estimated_time: {
+                    type: "string",
+                    description: "Optional: Estimated time in HH:MM format (e.g., '02:30' for 2.5 hours)",
+                },
+            },
+            required: ["project_id", "name"],
+        },
+    },
+    {
+        name: "update_work_package",
+        description: "Update an existing work package in a project",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project_id: {
+                    type: "integer",
+                    description: "The ID of the project containing the work package",
+                },
+                workpackage_id: {
+                    type: "integer",
+                    description: "The ID of the work package to update",
+                },
+                workpackage_data: {
+                    type: "object",
+                    description: "Object containing the fields to update (e.g., name, estimated_time)",
+                },
+            },
+            required: ["project_id", "workpackage_id", "workpackage_data"],
+        },
+    },
+    {
+        name: "delete_work_package",
+        description: "Delete a work package from a project in Bexio",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project_id: {
+                    type: "integer",
+                    description: "The ID of the project containing the work package",
+                },
+                workpackage_id: {
+                    type: "integer",
+                    description: "The ID of the work package to delete",
+                },
+            },
+            required: ["project_id", "workpackage_id"],
+        },
+    },
+];

package/dist/tools/projects/handlers.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Projects tool handlers.
+ * Implements the logic for each projects tool.
+ */
+import { BexioClient } from "../../bexio-client.js";
+export type HandlerFn = (client: BexioClient, args: unknown) => Promise<unknown>;
+export declare const handlers: Record<string, HandlerFn>;

package/dist/tools/projects/handlers.js

@@ -0,0 +1,127 @@
+/**
+ * Projects tool handlers.
+ * Implements the logic for each projects tool.
+ */
+import { McpError } from "../../shared/errors.js";
+import { 
+// Projects
+ListProjectsParamsSchema, GetProjectParamsSchema, CreateProjectParamsSchema, UpdateProjectParamsSchema, DeleteProjectParamsSchema, ArchiveProjectParamsSchema, UnarchiveProjectParamsSchema, SearchProjectsParamsSchema, 
+// Project Types
+ListProjectTypesParamsSchema, GetProjectTypeParamsSchema, 
+// Project Statuses
+ListProjectStatusesParamsSchema, GetProjectStatusParamsSchema, 
+// Milestones
+ListMilestonesParamsSchema, GetMilestoneParamsSchema, CreateMilestoneParamsSchema, DeleteMilestoneParamsSchema, 
+// Work Packages
+ListWorkPackagesParamsSchema, GetWorkPackageParamsSchema, CreateWorkPackageParamsSchema, UpdateWorkPackageParamsSchema, DeleteWorkPackageParamsSchema, } from "../../types/index.js";
+export const handlers = {
+    // ===== PROJECTS (PROJ-01) =====
+    list_projects: async (client, args) => {
+        const params = ListProjectsParamsSchema.parse(args);
+        return client.listProjects(params);
+    },
+    get_project: async (client, args) => {
+        const { project_id } = GetProjectParamsSchema.parse(args);
+        const project = await client.getProject(project_id);
+        if (!project) {
+            throw McpError.notFound("Project", project_id);
+        }
+        return project;
+    },
+    create_project: async (client, args) => {
+        const params = CreateProjectParamsSchema.parse(args);
+        return client.createProject(params);
+    },
+    update_project: async (client, args) => {
+        const { project_id, project_data } = UpdateProjectParamsSchema.parse(args);
+        return client.updateProject(project_id, project_data);
+    },
+    delete_project: async (client, args) => {
+        const { project_id } = DeleteProjectParamsSchema.parse(args);
+        return client.deleteProject(project_id);
+    },
+    archive_project: async (client, args) => {
+        const { project_id } = ArchiveProjectParamsSchema.parse(args);
+        return client.archiveProject(project_id);
+    },
+    unarchive_project: async (client, args) => {
+        const { project_id } = UnarchiveProjectParamsSchema.parse(args);
+        return client.unarchiveProject(project_id);
+    },
+    search_projects: async (client, args) => {
+        const { search_criteria } = SearchProjectsParamsSchema.parse(args);
+        return client.searchProjects(search_criteria);
+    },
+    // ===== PROJECT TYPES (PROJ-02) =====
+    list_project_types: async (client, args) => {
+        const params = ListProjectTypesParamsSchema.parse(args);
+        return client.listProjectTypes(params);
+    },
+    get_project_type: async (client, args) => {
+        const { type_id } = GetProjectTypeParamsSchema.parse(args);
+        const projectType = await client.getProjectType(type_id);
+        if (!projectType) {
+            throw McpError.notFound("Project Type", type_id);
+        }
+        return projectType;
+    },
+    // ===== PROJECT STATUSES (PROJ-03) =====
+    list_project_statuses: async (client, args) => {
+        const params = ListProjectStatusesParamsSchema.parse(args);
+        return client.listProjectStatuses(params);
+    },
+    get_project_status: async (client, args) => {
+        const { status_id } = GetProjectStatusParamsSchema.parse(args);
+        const status = await client.getProjectStatus(status_id);
+        if (!status) {
+            throw McpError.notFound("Project Status", status_id);
+        }
+        return status;
+    },
+    // ===== MILESTONES (PROJ-04) =====
+    list_milestones: async (client, args) => {
+        const { project_id, ...params } = ListMilestonesParamsSchema.parse(args);
+        return client.listMilestones(project_id, params);
+    },
+    get_milestone: async (client, args) => {
+        const { project_id, milestone_id } = GetMilestoneParamsSchema.parse(args);
+        const milestone = await client.getMilestone(project_id, milestone_id);
+        if (!milestone) {
+            throw McpError.notFound("Milestone", milestone_id);
+        }
+        return milestone;
+    },
+    create_milestone: async (client, args) => {
+        const { project_id, ...data } = CreateMilestoneParamsSchema.parse(args);
+        return client.createMilestone(project_id, data);
+    },
+    delete_milestone: async (client, args) => {
+        const { project_id, milestone_id } = DeleteMilestoneParamsSchema.parse(args);
+        return client.deleteMilestone(project_id, milestone_id);
+    },
+    // ===== WORK PACKAGES (PROJ-05) =====
+    list_work_packages: async (client, args) => {
+        const { project_id, ...params } = ListWorkPackagesParamsSchema.parse(args);
+        return client.listWorkPackages(project_id, params);
+    },
+    get_work_package: async (client, args) => {
+        const { project_id, workpackage_id } = GetWorkPackageParamsSchema.parse(args);
+        const pkg = await client.getWorkPackage(project_id, workpackage_id);
+        if (!pkg) {
+            throw McpError.notFound("Work Package", workpackage_id);
+        }
+        return pkg;
+    },
+    create_work_package: async (client, args) => {
+        const { project_id, ...data } = CreateWorkPackageParamsSchema.parse(args);
+        return client.createWorkPackage(project_id, data);
+    },
+    update_work_package: async (client, args) => {
+        const { project_id, workpackage_id, workpackage_data } = UpdateWorkPackageParamsSchema.parse(args);
+        return client.updateWorkPackage(project_id, workpackage_id, workpackage_data);
+    },
+    delete_work_package: async (client, args) => {
+        const { project_id, workpackage_id } = DeleteWorkPackageParamsSchema.parse(args);
+        return client.deleteWorkPackage(project_id, workpackage_id);
+    },
+};

package/dist/tools/projects/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Projects domain barrel export.
+ * Exports tool definitions and handlers for projects, types, and statuses.
+ */
+export { toolDefinitions } from "./definitions.js";
+export { handlers } from "./handlers.js";

package/dist/tools/projects/index.js

@@ -0,0 +1,6 @@
+/**
+ * Projects domain barrel export.
+ * Exports tool definitions and handlers for projects, types, and statuses.
+ */
+export { toolDefinitions } from "./definitions.js";
+export { handlers } from "./handlers.js";

package/dist/tools/purchase/definitions.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Purchase tool definitions.
+ * Contains MCP tool metadata for bills, expenses, purchase orders, and outgoing payments.
+ */
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare const toolDefinitions: Tool[];