@promptpartner/bexio-mcp-server 2.0.0

package/dist/types/schemas/timetracking.d.ts

@@ -0,0 +1,150 @@
+/**
+ * Time Tracking Zod schemas and types.
+ * Domain: Time Tracking (Timesheets, Statuses, Business Activities, Communication Types)
+ *
+ * IMPORTANT: Duration format is "HH:MM" (e.g., "02:30" for 2.5 hours) per Bexio API requirements.
+ */
+import { z } from "zod";
+export declare const ListTimesheetsParamsSchema: z.ZodObject<{
+    limit: z.ZodDefault<z.ZodNumber>;
+    offset: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    offset: number;
+}, {
+    limit?: number | undefined;
+    offset?: number | undefined;
+}>;
+export type ListTimesheetsParams = z.infer<typeof ListTimesheetsParamsSchema>;
+export declare const GetTimesheetParamsSchema: z.ZodObject<{
+    timesheet_id: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    timesheet_id: number;
+}, {
+    timesheet_id: number;
+}>;
+export type GetTimesheetParams = z.infer<typeof GetTimesheetParamsSchema>;
+/**
+ * Schema for creating a new timesheet entry.
+ * Duration MUST be in HH:MM format (e.g., "02:30" for 2.5 hours).
+ */
+export declare const CreateTimesheetParamsSchema: z.ZodObject<{
+    user_id: z.ZodNumber;
+    date: z.ZodString;
+    duration: z.ZodString;
+    pr_project_id: z.ZodOptional<z.ZodNumber>;
+    pr_package_id: z.ZodOptional<z.ZodNumber>;
+    pr_milestone_id: z.ZodOptional<z.ZodNumber>;
+    client_service_id: z.ZodOptional<z.ZodNumber>;
+    text: z.ZodOptional<z.ZodString>;
+    allowable_bill: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    date: string;
+    user_id: number;
+    duration: string;
+    allowable_bill: boolean;
+    text?: string | undefined;
+    pr_project_id?: number | undefined;
+    pr_package_id?: number | undefined;
+    pr_milestone_id?: number | undefined;
+    client_service_id?: number | undefined;
+}, {
+    date: string;
+    user_id: number;
+    duration: string;
+    text?: string | undefined;
+    pr_project_id?: number | undefined;
+    pr_package_id?: number | undefined;
+    pr_milestone_id?: number | undefined;
+    client_service_id?: number | undefined;
+    allowable_bill?: boolean | undefined;
+}>;
+export type CreateTimesheetParams = z.infer<typeof CreateTimesheetParamsSchema>;
+export declare const DeleteTimesheetParamsSchema: z.ZodObject<{
+    timesheet_id: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    timesheet_id: number;
+}, {
+    timesheet_id: number;
+}>;
+export type DeleteTimesheetParams = z.infer<typeof DeleteTimesheetParamsSchema>;
+/**
+ * Search criteria for timesheets.
+ * Supports field/value/criteria pattern used by Bexio search API.
+ */
+export declare const SearchTimesheetsParamsSchema: z.ZodObject<{
+    search_criteria: z.ZodArray<z.ZodObject<{
+        field: z.ZodString;
+        value: z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]>;
+        criteria: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        field: string;
+        value: string | number | boolean;
+        criteria?: string | undefined;
+    }, {
+        field: string;
+        value: string | number | boolean;
+        criteria?: string | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    search_criteria: {
+        field: string;
+        value: string | number | boolean;
+        criteria?: string | undefined;
+    }[];
+}, {
+    search_criteria: {
+        field: string;
+        value: string | number | boolean;
+        criteria?: string | undefined;
+    }[];
+}>;
+export type SearchTimesheetsParams = z.infer<typeof SearchTimesheetsParamsSchema>;
+export declare const ListTimesheetStatusesParamsSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export type ListTimesheetStatusesParams = z.infer<typeof ListTimesheetStatusesParamsSchema>;
+export declare const ListBusinessActivitiesParamsSchema: z.ZodObject<{
+    limit: z.ZodDefault<z.ZodNumber>;
+    offset: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    offset: number;
+}, {
+    limit?: number | undefined;
+    offset?: number | undefined;
+}>;
+export type ListBusinessActivitiesParams = z.infer<typeof ListBusinessActivitiesParamsSchema>;
+export declare const GetBusinessActivityParamsSchema: z.ZodObject<{
+    activity_id: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    activity_id: number;
+}, {
+    activity_id: number;
+}>;
+export type GetBusinessActivityParams = z.infer<typeof GetBusinessActivityParamsSchema>;
+export declare const CreateBusinessActivityParamsSchema: z.ZodObject<{
+    name: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+}, {
+    name: string;
+}>;
+export type CreateBusinessActivityParams = z.infer<typeof CreateBusinessActivityParamsSchema>;
+export declare const ListCommunicationTypesParamsSchema: z.ZodObject<{
+    limit: z.ZodDefault<z.ZodNumber>;
+    offset: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    offset: number;
+}, {
+    limit?: number | undefined;
+    offset?: number | undefined;
+}>;
+export type ListCommunicationTypesParams = z.infer<typeof ListCommunicationTypesParamsSchema>;
+export declare const GetCommunicationTypeParamsSchema: z.ZodObject<{
+    type_id: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    type_id: number;
+}, {
+    type_id: number;
+}>;
+export type GetCommunicationTypeParams = z.infer<typeof GetCommunicationTypeParamsSchema>;

package/dist/types/schemas/timetracking.js

@@ -0,0 +1,68 @@
+/**
+ * Time Tracking Zod schemas and types.
+ * Domain: Time Tracking (Timesheets, Statuses, Business Activities, Communication Types)
+ *
+ * IMPORTANT: Duration format is "HH:MM" (e.g., "02:30" for 2.5 hours) per Bexio API requirements.
+ */
+import { z } from "zod";
+// ===== TIMESHEETS (PROJ-06) =====
+export const ListTimesheetsParamsSchema = z.object({
+    limit: z.number().int().positive().default(100),
+    offset: z.number().int().min(0).default(0),
+});
+export const GetTimesheetParamsSchema = z.object({
+    timesheet_id: z.number().int().positive(),
+});
+/**
+ * Schema for creating a new timesheet entry.
+ * Duration MUST be in HH:MM format (e.g., "02:30" for 2.5 hours).
+ */
+export const CreateTimesheetParamsSchema = z.object({
+    // Required fields
+    user_id: z.number().int().positive({ message: "User ID is required and must be positive" }),
+    date: z.string().regex(/^\d{4}-\d{2}-\d{2}$/, "Date must be in YYYY-MM-DD format"),
+    duration: z.string().regex(/^\d{2}:\d{2}$/, "Duration must be in HH:MM format (e.g., '02:30' for 2.5 hours)"),
+    // Optional linking fields
+    pr_project_id: z.number().int().positive().optional(),
+    pr_package_id: z.number().int().positive().optional(),
+    pr_milestone_id: z.number().int().positive().optional(),
+    client_service_id: z.number().int().positive().optional(),
+    // Optional metadata
+    text: z.string().optional(),
+    allowable_bill: z.boolean().default(true),
+});
+export const DeleteTimesheetParamsSchema = z.object({
+    timesheet_id: z.number().int().positive(),
+});
+/**
+ * Search criteria for timesheets.
+ * Supports field/value/criteria pattern used by Bexio search API.
+ */
+export const SearchTimesheetsParamsSchema = z.object({
+    search_criteria: z.array(z.object({
+        field: z.string(),
+        value: z.union([z.string(), z.number(), z.boolean()]),
+        criteria: z.string().optional(),
+    })).min(1, "At least one search criterion is required"),
+});
+// ===== TIMESHEET STATUSES (PROJ-07) =====
+export const ListTimesheetStatusesParamsSchema = z.object({});
+// ===== BUSINESS ACTIVITIES (PROJ-08) =====
+export const ListBusinessActivitiesParamsSchema = z.object({
+    limit: z.number().int().positive().default(100),
+    offset: z.number().int().min(0).default(0),
+});
+export const GetBusinessActivityParamsSchema = z.object({
+    activity_id: z.number().int().positive(),
+});
+export const CreateBusinessActivityParamsSchema = z.object({
+    name: z.string().min(1, "Name is required"),
+});
+// ===== COMMUNICATION TYPES (PROJ-09) =====
+export const ListCommunicationTypesParamsSchema = z.object({
+    limit: z.number().int().positive().default(100),
+    offset: z.number().int().min(0).default(0),
+});
+export const GetCommunicationTypeParamsSchema = z.object({
+    type_id: z.number().int().positive(),
+});

package/dist/types/schemas/users.d.ts

@@ -0,0 +1,51 @@
+/**
+ * User-related Zod schemas and types.
+ * Domain: Users (Fictional Users)
+ */
+import { z } from "zod";
+export declare const ListFictionalUsersParamsSchema: z.ZodObject<{
+    limit: z.ZodDefault<z.ZodNumber>;
+    offset: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    offset: number;
+}, {
+    limit?: number | undefined;
+    offset?: number | undefined;
+}>;
+export type ListFictionalUsersParams = z.infer<typeof ListFictionalUsersParamsSchema>;
+export declare const GetFictionalUserParamsSchema: z.ZodObject<{
+    user_id: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    user_id: number;
+}, {
+    user_id: number;
+}>;
+export type GetFictionalUserParams = z.infer<typeof GetFictionalUserParamsSchema>;
+export declare const CreateFictionalUserParamsSchema: z.ZodObject<{
+    user_data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    user_data: Record<string, unknown>;
+}, {
+    user_data: Record<string, unknown>;
+}>;
+export type CreateFictionalUserParams = z.infer<typeof CreateFictionalUserParamsSchema>;
+export declare const UpdateFictionalUserParamsSchema: z.ZodObject<{
+    user_id: z.ZodNumber;
+    user_data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    user_id: number;
+    user_data: Record<string, unknown>;
+}, {
+    user_id: number;
+    user_data: Record<string, unknown>;
+}>;
+export type UpdateFictionalUserParams = z.infer<typeof UpdateFictionalUserParamsSchema>;
+export declare const DeleteFictionalUserParamsSchema: z.ZodObject<{
+    user_id: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    user_id: number;
+}, {
+    user_id: number;
+}>;
+export type DeleteFictionalUserParams = z.infer<typeof DeleteFictionalUserParamsSchema>;

package/dist/types/schemas/users.js

@@ -0,0 +1,27 @@
+/**
+ * User-related Zod schemas and types.
+ * Domain: Users (Fictional Users)
+ */
+import { z } from "zod";
+// List fictional users
+export const ListFictionalUsersParamsSchema = z.object({
+    limit: z.number().int().positive().default(50),
+    offset: z.number().int().min(0).default(0),
+});
+// Get single fictional user
+export const GetFictionalUserParamsSchema = z.object({
+    user_id: z.number().int().positive(),
+});
+// Create fictional user
+export const CreateFictionalUserParamsSchema = z.object({
+    user_data: z.record(z.unknown()),
+});
+// Update fictional user
+export const UpdateFictionalUserParamsSchema = z.object({
+    user_id: z.number().int().positive(),
+    user_data: z.record(z.unknown()),
+});
+// Delete fictional user
+export const DeleteFictionalUserParamsSchema = z.object({
+    user_id: z.number().int().positive(),
+});

package/dist/ui/contact-card/mcp-app.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/ui/contact-card/mcp-app.js

@@ -0,0 +1,108 @@
+import { App } from "@modelcontextprotocol/ext-apps";
+const appEl = document.getElementById("app");
+const app = new App({ name: "Contact Card", version: "1.0.0" });
+app.ontoolresult = (result) => {
+    const text = result.content?.find((c) => c.type === "text")?.text;
+    if (text) {
+        try {
+            const contact = JSON.parse(text);
+            renderContact(contact);
+        }
+        catch (e) {
+            appEl.innerHTML = `<div class="loading">Error parsing contact data</div>`;
+        }
+    }
+};
+app.connect();
+function getInitials(name1, name2) {
+    const parts = [name1, name2].filter(Boolean);
+    return parts.map(p => p.charAt(0).toUpperCase()).join("").slice(0, 2) || "?";
+}
+function getCountryName(countryId) {
+    const countries = {
+        1: "Switzerland",
+        2: "Germany",
+        3: "Austria",
+        4: "France",
+        5: "Italy",
+        6: "Liechtenstein",
+    };
+    return countryId ? countries[countryId] || `Country #${countryId}` : "";
+}
+function renderContact(contact) {
+    const fullName = [contact.name_1, contact.name_2].filter(Boolean).join(" ");
+    const initials = getInitials(contact.name_1, contact.name_2);
+    const isCompany = contact.contact_type_id === 1;
+    const typeBadge = isCompany ? "Company" : "Person";
+    const typeClass = isCompany ? "type-company" : "type-person";
+    const addressParts = [
+        contact.address,
+        [contact.postcode, contact.city].filter(Boolean).join(" "),
+        getCountryName(contact.country_id),
+    ].filter(Boolean);
+    const hasContactInfo = contact.mail || contact.phone_fixed || contact.phone_mobile || contact.fax;
+    const hasAddress = addressParts.length > 0;
+    appEl.className = "card";
+    appEl.innerHTML = `
+    <div class="card-header">
+      <div class="avatar">${initials}</div>
+      <h1>${fullName}</h1>
+      ${contact.url ? `<div class="company">${contact.url}</div>` : ""}
+      <span class="type-badge ${typeClass}">${typeBadge}</span>
+    </div>
+    <div class="card-body">
+      ${hasContactInfo ? `
+        <div class="info-section">
+          <div class="info-label">Contact Information</div>
+          ${contact.mail ? `
+            <div class="info-row">
+              <svg class="info-icon" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M3 8l7.89 5.26a2 2 0 002.22 0L21 8M5 19h14a2 2 0 002-2V7a2 2 0 00-2-2H5a2 2 0 00-2 2v10a2 2 0 002 2z"/>
+              </svg>
+              <span class="info-value"><a href="mailto:${contact.mail}">${contact.mail}</a></span>
+            </div>
+          ` : ""}
+          ${contact.phone_fixed ? `
+            <div class="info-row">
+              <svg class="info-icon" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M3 5a2 2 0 012-2h3.28a1 1 0 01.948.684l1.498 4.493a1 1 0 01-.502 1.21l-2.257 1.13a11.042 11.042 0 005.516 5.516l1.13-2.257a1 1 0 011.21-.502l4.493 1.498a1 1 0 01.684.949V19a2 2 0 01-2 2h-1C9.716 21 3 14.284 3 6V5z"/>
+              </svg>
+              <span class="info-value"><a href="tel:${contact.phone_fixed}">${contact.phone_fixed}</a></span>
+            </div>
+          ` : ""}
+          ${contact.phone_mobile ? `
+            <div class="info-row">
+              <svg class="info-icon" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 18h.01M8 21h8a2 2 0 002-2V5a2 2 0 00-2-2H8a2 2 0 00-2 2v14a2 2 0 002 2z"/>
+              </svg>
+              <span class="info-value"><a href="tel:${contact.phone_mobile}">${contact.phone_mobile}</a></span>
+            </div>
+          ` : ""}
+          ${contact.fax ? `
+            <div class="info-row">
+              <svg class="info-icon" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M17 17h2a2 2 0 002-2v-4a2 2 0 00-2-2H5a2 2 0 00-2 2v4a2 2 0 002 2h2m2 4h6a2 2 0 002-2v-4a2 2 0 00-2-2H9a2 2 0 00-2 2v4a2 2 0 002 2zm8-12V5a2 2 0 00-2-2H9a2 2 0 00-2 2v4h10z"/>
+              </svg>
+              <span class="info-value">${contact.fax}</span>
+            </div>
+          ` : ""}
+        </div>
+      ` : ""}
+
+      ${hasAddress ? `
+        <div class="info-section">
+          <div class="info-label">Address</div>
+          <div class="address-block">
+            ${addressParts.map(p => `<div>${p}</div>`).join("")}
+          </div>
+        </div>
+      ` : ""}
+
+      ${!hasContactInfo && !hasAddress ? `
+        <div class="info-section" style="text-align: center; color: #6b7280;">
+          No contact details available
+        </div>
+      ` : ""}
+    </div>
+  `;
+}

package/dist/ui/dashboard/mcp-app.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/ui/dashboard/mcp-app.js

@@ -0,0 +1,81 @@
+import { App } from "@modelcontextprotocol/ext-apps";
+const appEl = document.getElementById("app");
+const app = new App({ name: "Bexio Dashboard", version: "1.0.0" });
+app.ontoolresult = (result) => {
+    const text = result.content?.find((c) => c.type === "text")?.text;
+    if (text) {
+        try {
+            const data = JSON.parse(text);
+            renderDashboard(data);
+        }
+        catch (e) {
+            appEl.innerHTML = `<div class="loading">Error parsing dashboard data</div>`;
+        }
+    }
+};
+app.connect();
+function formatCurrency(amount, currency) {
+    return `${currency} ${amount.toLocaleString("de-CH", { minimumFractionDigits: 2, maximumFractionDigits: 2 })}`;
+}
+function getInitials(name1, name2) {
+    const parts = [name1, name2].filter(Boolean);
+    return parts.map(p => p.charAt(0).toUpperCase()).join("").slice(0, 2) || "?";
+}
+function renderDashboard(data) {
+    appEl.className = "dashboard";
+    appEl.innerHTML = `
+    <div class="header">
+      <h1>Bexio Dashboard</h1>
+      <p class="subtitle">Overview of your invoices and recent contacts</p>
+    </div>
+
+    <div class="grid">
+      <div class="card">
+        <div class="card-header">
+          <div class="card-icon blue">
+            <svg fill="none" stroke="currentColor" viewBox="0 0 24 24">
+              <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 12h6m-6 4h6m2 5H7a2 2 0 01-2-2V5a2 2 0 012-2h5.586a1 1 0 01.707.293l5.414 5.414a1 1 0 01.293.707V19a2 2 0 01-2 2z"/>
+            </svg>
+          </div>
+          <span class="card-title">Open Invoices</span>
+        </div>
+        <div class="card-value">${data.open_invoices_count}</div>
+        <div class="card-subtitle">${formatCurrency(data.open_invoices_total, data.currency)} total</div>
+      </div>
+
+      <div class="card">
+        <div class="card-header">
+          <div class="card-icon yellow">
+            <svg fill="none" stroke="currentColor" viewBox="0 0 24 24">
+              <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 8v4l3 3m6-3a9 9 0 11-18 0 9 9 0 0118 0z"/>
+            </svg>
+          </div>
+          <span class="card-title">Overdue</span>
+        </div>
+        <div class="card-value">${data.overdue_count}</div>
+        <div class="card-subtitle">${formatCurrency(data.overdue_total, data.currency)} outstanding</div>
+      </div>
+
+      <div class="card">
+        <div class="card-header">
+          <div class="card-icon green">
+            <svg fill="none" stroke="currentColor" viewBox="0 0 24 24">
+              <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M17 20h5v-2a3 3 0 00-5.356-1.857M17 20H7m10 0v-2c0-.656-.126-1.283-.356-1.857M7 20H2v-2a3 3 0 015.356-1.857M7 20v-2c0-.656.126-1.283.356-1.857m0 0a5.002 5.002 0 019.288 0M15 7a3 3 0 11-6 0 3 3 0 016 0zm6 3a2 2 0 11-4 0 2 2 0 014 0zM7 10a2 2 0 11-4 0 2 2 0 014 0z"/>
+            </svg>
+          </div>
+          <span class="card-title">Recent Contacts</span>
+        </div>
+        <div class="contacts-list">
+          ${data.recent_contacts.length > 0 ? data.recent_contacts.slice(0, 5).map(contact => `
+            <div class="contact-item">
+              <div class="contact-avatar">${getInitials(contact.name_1, contact.name_2)}</div>
+              <span class="contact-name">${[contact.name_1, contact.name_2].filter(Boolean).join(" ")}</span>
+            </div>
+          `).join("") : `
+            <div class="empty-state">No recent contacts</div>
+          `}
+        </div>
+      </div>
+    </div>
+  `;
+}

package/dist/ui/invoice-preview/mcp-app.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/ui/invoice-preview/mcp-app.js

@@ -0,0 +1,96 @@
+import { App } from "@modelcontextprotocol/ext-apps";
+const appEl = document.getElementById("app");
+const app = new App({ name: "Invoice Preview", version: "1.0.0" });
+app.ontoolresult = (result) => {
+    const text = result.content?.find((c) => c.type === "text")?.text;
+    if (text) {
+        try {
+            const invoice = JSON.parse(text);
+            renderInvoice(invoice);
+        }
+        catch (e) {
+            appEl.innerHTML = `<div class="loading">Error parsing invoice data</div>`;
+        }
+    }
+};
+app.connect();
+function getStatusInfo(statusId) {
+    switch (statusId) {
+        case 7: return { label: "Draft", className: "status-draft" };
+        case 8: return { label: "Pending", className: "status-pending" };
+        case 9: return { label: "Sent", className: "status-sent" };
+        case 16: return { label: "Paid", className: "status-paid" };
+        case 17: return { label: "Overdue", className: "status-overdue" };
+        case 19: return { label: "Cancelled", className: "status-cancelled" };
+        default: return { label: `Status ${statusId}`, className: "status-draft" };
+    }
+}
+function formatCurrency(amount, currencyId) {
+    const value = typeof amount === "string" ? parseFloat(amount) : amount;
+    const currency = currencyId === 1 ? "CHF" : currencyId === 2 ? "EUR" : "USD";
+    return `${currency} ${value.toFixed(2)}`;
+}
+function formatDate(dateStr) {
+    if (!dateStr)
+        return "";
+    const date = new Date(dateStr);
+    return date.toLocaleDateString("de-CH", { day: "2-digit", month: "2-digit", year: "numeric" });
+}
+function renderInvoice(invoice) {
+    const status = getStatusInfo(invoice.kb_item_status_id);
+    const positions = invoice.positions || [];
+    appEl.className = "invoice";
+    appEl.innerHTML = `
+    <div class="header">
+      <div class="header-left">
+        <h1>Invoice ${invoice.document_nr}</h1>
+        <p class="title">${invoice.title || ""}</p>
+      </div>
+      <div class="header-right">
+        <div class="dates">
+          <div>Issue: ${formatDate(invoice.is_valid_from)}</div>
+          <div>Due: ${formatDate(invoice.is_valid_to)}</div>
+        </div>
+        <span class="status-badge ${status.className}">${status.label}</span>
+      </div>
+    </div>
+
+    <div class="contact-section">
+      <h2>Bill To</h2>
+      <div class="name">${invoice.contact_address?.split("\n")[0] || `Contact #${invoice.contact_id}`}</div>
+      <div class="email">${invoice.contact_address?.split("\n").slice(1).join(", ") || ""}</div>
+    </div>
+
+    <table class="line-items">
+      <thead>
+        <tr>
+          <th>Description</th>
+          <th>Qty</th>
+          <th>Price</th>
+          <th>Amount</th>
+        </tr>
+      </thead>
+      <tbody>
+        ${positions.length > 0 ? positions.map((p) => `
+          <tr>
+            <td>${p.text}</td>
+            <td>${p.amount}</td>
+            <td>${formatCurrency(p.unit_price, invoice.currency_id)}</td>
+            <td>${formatCurrency(p.amount * p.unit_price * (1 - (p.discount_in_percent || 0) / 100), invoice.currency_id)}</td>
+          </tr>
+        `).join("") : `
+          <tr>
+            <td colspan="4" style="text-align: center; color: #6b7280;">No line items available</td>
+          </tr>
+        `}
+      </tbody>
+    </table>
+
+    <div class="total-section">
+      <div class="total-row">
+        <span class="total-label">Total:</span>
+        <span class="total-amount">${formatCurrency(invoice.total_gross, invoice.currency_id)}</span>
+      </div>
+    </div>
+  `;
+}

package/dist/ui-resources.d.ts

@@ -0,0 +1,17 @@
+/**
+ * MCP Apps UI Resources Registration.
+ *
+ * Registers UI tools and resources for interactive invoice preview,
+ * contact card, and dashboard summary.
+ *
+ * Uses @modelcontextprotocol/ext-apps SDK for UI resource handling.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { BexioClient } from "./bexio-client.js";
+/**
+ * Register MCP Apps UI resources and tools.
+ *
+ * @param server - McpServer instance
+ * @param client - BexioClient for API calls
+ */
+export declare function registerUIResources(server: McpServer, client: BexioClient): void;