@frihet/mcp-server 1.1.0 → 1.2.1

package/README.md

@@ -9,7 +9,7 @@
 
 <p align="center">
   <a href="https://www.npmjs.com/package/@frihet/mcp-server"><img src="https://img.shields.io/npm/v/@frihet/mcp-server?style=flat&color=18181b&labelColor=09090b" alt="npm"></a>
-  <a href="https://github.com/berthelius/frihet-mcp/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-18181b?style=flat&labelColor=09090b" alt="license"></a>
+  <a href="https://github.com/Frihet-io/frihet-mcp/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-18181b?style=flat&labelColor=09090b" alt="license"></a>
   <a href="https://smithery.ai/server/@frihet/mcp-server"><img src="https://img.shields.io/badge/smithery-listed-18181b?style=flat&labelColor=09090b" alt="smithery"></a>
   <a href="https://frihet.io"><img src="https://img.shields.io/badge/frihet.io-ERP-18181b?style=flat&labelColor=09090b" alt="frihet"></a>
 </p>
@@ -25,13 +25,19 @@ You:     "Create an invoice for TechStart SL, 40 hours of consulting at 75 EUR/h
 Claude:  Done. Invoice INV-2026-089 created. Total: 3,000.00 EUR + 21% IVA = 3,630.00 EUR.
 ```
 
-31 tools. 6 resources. Zero boilerplate.
+31 tools. 5 resources. 5 prompts. Structured output. Zero boilerplate.
 
 ---
 
 ## Install
 
-One line. Pick your tool.
+### Universal (30+ agents — Claude Code, Cursor, Copilot, Codex, Windsurf, Gemini CLI, and more)
+
+```bash
+npx skills add Frihet-io/frihet-mcp
+```
+
+### Per-tool configuration
 
 ### Claude Code / Claude Desktop
 
@@ -245,7 +251,7 @@ Beyond raw MCP tools, Frihet ships a **Claude Code skill** that adds business in
 
 ```bash
 # Clone and symlink
-git clone https://github.com/berthelius/frihet-mcp.git
+git clone https://github.com/Frihet-io/frihet-mcp.git
 ln -s "$(pwd)/frihet-mcp/skill" ~/.claude/skills/frihet
 ```
 
@@ -271,7 +277,7 @@ Full documentation: [docs.frihet.io/desarrolladores/skill-claude-code](https://d
 ## Development
 
 ```bash
-git clone https://github.com/berthelius/frihet-mcp.git
+git clone https://github.com/Frihet-io/frihet-mcp.git
 cd frihet-mcp
 npm install
 npm run build

package/dist/index.js

@@ -12,6 +12,8 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { FrihetClient } from "./client.js";
 import { registerAllTools } from "./tools/register-all.js";
+import { registerAllResources } from "./resources/register-all.js";
+import { registerAllPrompts } from "./prompts/register-all.js";
 function main() {
     const apiKey = process.env.FRIHET_API_KEY;
     if (!apiKey) {
@@ -22,13 +24,40 @@ function main() {
         process.exit(1);
     }
     const baseUrl = process.env.FRIHET_API_URL;
+    if (baseUrl !== undefined) {
+        let parsed;
+        try {
+            parsed = new URL(baseUrl);
+        }
+        catch {
+            console.error(`Error: FRIHET_API_URL is not a valid URL: "${baseUrl}"\n` +
+                "It must be a valid https:// URL with a frihet.io hostname.\n");
+            process.exit(1);
+        }
+        if (parsed.protocol !== "https:") {
+            console.error(`Error: FRIHET_API_URL must use https:// (got "${parsed.protocol}").\n`);
+            process.exit(1);
+        }
+        if (!parsed.hostname.endsWith("frihet.io")) {
+            console.error(`Error: FRIHET_API_URL hostname must be under frihet.io (got "${parsed.hostname}").\n` +
+                "This prevents redirection to untrusted servers.\n");
+            process.exit(1);
+        }
+    }
     const client = new FrihetClient(apiKey, baseUrl);
     const server = new McpServer({
         name: "frihet-erp",
-        version: "1.0.0",
+        version: "1.2.0",
+        description: "AI-native MCP server for Frihet ERP — invoices, expenses, clients, products, quotes, and webhooks. " +
+            "Provides 31 tools, 5 resources (tax rates, calendar, expense categories, invoice statuses, API schema), " +
+            "and 5 workflow prompts for business management with full Spanish tax compliance (IVA, IGIC, IPSI).",
     });
     // Register all 31 tools
     registerAllTools(server, client);
+    // Register 5 static resources (tax rates, calendar, categories, statuses, API schema)
+    registerAllResources(server);
+    // Register 5 workflow prompts (monthly close, onboard client, tax prep, overdue follow-up, expense batch)
+    registerAllPrompts(server);
     // Connect via stdio transport
     const transport = new StdioServerTransport();
     server.connect(transport).then(() => {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;GAQG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,SAAS,IAAI;IACX,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IAE1C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,CAAC,KAAK,CACX,2DAA2D;YACzD,kEAAkE;YAClE,YAAY;YACZ,mDAAmD,CACtD,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IAC3C,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEjD,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,wBAAwB;IACxB,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjC,8BAA8B;IAC9B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE;QAClC,OAAO,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;QAC1B,OAAO,CAAC,KAAK,CAAC,oCAAoC,EAAE,KAAK,CAAC,CAAC;QAC3D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,IAAI,EAAE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;GAQG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D,SAAS,IAAI;IACX,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IAE1C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,CAAC,KAAK,CACX,2DAA2D;YACzD,kEAAkE;YAClE,YAAY;YACZ,mDAAmD,CACtD,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IAE3C,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,IAAI,MAAW,CAAC;QAChB,IAAI,CAAC;YACH,MAAM,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;QAC5B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,KAAK,CACX,8CAA8C,OAAO,KAAK;gBACxD,8DAA8D,CACjE,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACjC,OAAO,CAAC,KAAK,CACX,iDAAiD,MAAM,CAAC,QAAQ,OAAO,CACxE,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;YAC3C,OAAO,CAAC,KAAK,CACX,gEAAgE,MAAM,CAAC,QAAQ,OAAO;gBACpF,mDAAmD,CACtD,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEjD,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,OAAO;QAChB,WAAW,EACT,qGAAqG;YACrG,0GAA0G;YAC1G,oGAAoG;KACvG,CAAC,CAAC;IAEH,wBAAwB;IACxB,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjC,sFAAsF;IACtF,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAE7B,0GAA0G;IAC1G,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAE3B,8BAA8B;IAC9B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE;QAClC,OAAO,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;QAC1B,OAAO,CAAC,KAAK,CAAC,oCAAoC,EAAE,KAAK,CAAC,CAAC;QAC3D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,IAAI,EAAE,CAAC"}

package/dist/prompts/register-all.d.ts

@@ -0,0 +1,10 @@
+/**
+ * MCP Prompts for the Frihet ERP server.
+ *
+ * Prompts are pre-built templates that guide common business workflows.
+ * They return structured messages that an LLM can follow step-by-step,
+ * using the available Frihet tools to complete each action.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerAllPrompts(server: McpServer): void;
+//# sourceMappingURL=register-all.d.ts.map

package/dist/prompts/register-all.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-all.d.ts","sourceRoot":"","sources":["../../src/prompts/register-all.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA+S1D"}

package/dist/prompts/register-all.js

@@ -0,0 +1,271 @@
+/**
+ * MCP Prompts for the Frihet ERP server.
+ *
+ * Prompts are pre-built templates that guide common business workflows.
+ * They return structured messages that an LLM can follow step-by-step,
+ * using the available Frihet tools to complete each action.
+ */
+import { z } from "zod/v4";
+export function registerAllPrompts(server) {
+    // -- monthly-close --
+    server.registerPrompt("monthly-close", {
+        title: "Monthly Close",
+        description: "Guide through closing the month: review unpaid invoices, categorize uncategorized expenses, " +
+            "check tax obligations, and generate a financial summary. " +
+            "/ Guía para el cierre mensual: revisar facturas impagadas, categorizar gastos, " +
+            "verificar obligaciones fiscales y generar resumen.",
+        argsSchema: {
+            month: z
+                .string()
+                .optional()
+                .describe("Month to close in YYYY-MM format (defaults to previous month) / Mes a cerrar"),
+        },
+    }, async ({ month }) => {
+        const targetMonth = month || "the previous month";
+        return {
+            messages: [
+                {
+                    role: "user",
+                    content: {
+                        type: "text",
+                        text: `Perform the monthly close for ${targetMonth}. Follow these steps in order:\n\n` +
+                            `1. UNPAID INVOICES\n` +
+                            `   - Use list_invoices to find all invoices with status "sent" or "overdue"\n` +
+                            `   - For each overdue invoice, note the client name, amount, and days overdue\n` +
+                            `   - Summarize total outstanding receivables\n\n` +
+                            `2. EXPENSE REVIEW\n` +
+                            `   - Use list_expenses to get all expenses for the period\n` +
+                            `   - Identify any expenses without a category — suggest categories based on the description\n` +
+                            `   - Flag any unusually large expenses that might need review\n` +
+                            `   - Calculate total expenses by category\n\n` +
+                            `3. REVENUE SUMMARY\n` +
+                            `   - List all invoices with status "paid" for the period\n` +
+                            `   - Calculate total revenue, total tax collected (IVA/IGIC)\n` +
+                            `   - Compare with expenses to get net profit/loss\n\n` +
+                            `4. TAX CHECK\n` +
+                            `   - Read frihet://tax/calendar to check if any tax filings are due\n` +
+                            `   - Calculate preliminary IVA/IGIC balance (output tax - input tax)\n` +
+                            `   - Flag if quarterly filing deadline is approaching\n\n` +
+                            `5. SUMMARY REPORT\n` +
+                            `   - Total invoiced (draft/sent/paid/overdue/cancelled counts)\n` +
+                            `   - Total revenue (paid invoices)\n` +
+                            `   - Total expenses by category\n` +
+                            `   - Net position\n` +
+                            `   - Action items (overdue follow-ups, uncategorized expenses, upcoming tax deadlines)`,
+                    },
+                },
+            ],
+        };
+    });
+    // -- onboard-client --
+    server.registerPrompt("onboard-client", {
+        title: "Onboard New Client",
+        description: "Set up a new client: create the client record, determine correct tax rates based on their location, " +
+            "and optionally create a welcome quote. " +
+            "/ Dar de alta un nuevo cliente: crear ficha, determinar impuestos según ubicación y crear presupuesto de bienvenida.",
+        argsSchema: {
+            clientName: z.string().describe("Client or company name / Nombre del cliente o empresa"),
+            country: z
+                .string()
+                .optional()
+                .describe("Client country ISO code (e.g. ES, DE, US) / Código de país"),
+            region: z
+                .string()
+                .optional()
+                .describe("Spanish region if applicable (peninsula, canarias, ceuta, melilla) / Región española"),
+        },
+    }, async ({ clientName, country, region }) => {
+        const locationContext = country
+            ? `The client is located in ${country}${region ? ` (${region})` : ""}.`
+            : "Ask the client for their country and region to determine the correct tax rate.";
+        return {
+            messages: [
+                {
+                    role: "user",
+                    content: {
+                        type: "text",
+                        text: `Onboard a new client: "${clientName}". ${locationContext}\n\n` +
+                            `Follow these steps:\n\n` +
+                            `1. DETERMINE TAX RATE\n` +
+                            `   - Read frihet://tax/rates to look up the correct rate\n` +
+                            `   - Peninsula Spain → IVA 21% (general)\n` +
+                            `   - Canary Islands → IGIC 7% (general)\n` +
+                            `   - Ceuta/Melilla → IPSI 10%\n` +
+                            `   - EU B2B → 0% reverse charge (need their VAT number)\n` +
+                            `   - Outside EU → 0% export exempt\n` +
+                            `   - Confirm the rate with the user before proceeding\n\n` +
+                            `2. CREATE CLIENT RECORD\n` +
+                            `   - Use create_client with the client name\n` +
+                            `   - Ask for: email, phone, taxId (NIF/CIF/VAT number), address\n` +
+                            `   - Set the country in the address based on location\n\n` +
+                            `3. WELCOME QUOTE (optional)\n` +
+                            `   - Ask if the user wants to create an initial quote for this client\n` +
+                            `   - If yes, ask for the services/products and prices\n` +
+                            `   - Use create_quote with the correct tax rate\n` +
+                            `   - Set validUntil to 30 days from now\n\n` +
+                            `4. SUMMARY\n` +
+                            `   - Confirm the client record was created\n` +
+                            `   - State the tax rate that should be used for this client\n` +
+                            `   - List any missing information that should be filled in later`,
+                    },
+                },
+            ],
+        };
+    });
+    // -- quarterly-tax-prep --
+    server.registerPrompt("quarterly-tax-prep", {
+        title: "Quarterly Tax Preparation",
+        description: "Prepare for quarterly tax filing: list all invoices and expenses for the quarter, calculate IVA/IGIC totals, " +
+            "identify deductible expenses, and generate a Modelo 303/130/420 preview. " +
+            "/ Preparar la declaración trimestral: facturas, gastos, cálculo de IVA/IGIC, gastos deducibles y vista previa del modelo.",
+        argsSchema: {
+            quarter: z
+                .string()
+                .optional()
+                .describe("Quarter in format Q1-Q4 and year, e.g. 'Q1 2026' (defaults to current quarter) / Trimestre"),
+            fiscalZone: z
+                .enum(["peninsula", "canarias", "ceuta", "melilla"])
+                .optional()
+                .describe("Fiscal zone for tax calculation / Zona fiscal"),
+        },
+    }, async ({ quarter, fiscalZone }) => {
+        const targetQuarter = quarter || "the current quarter";
+        const zone = fiscalZone || "peninsula";
+        const taxType = zone === "canarias" ? "IGIC" : zone === "peninsula" ? "IVA" : "IPSI";
+        const modelo = zone === "canarias" ? "420" : "303";
+        return {
+            messages: [
+                {
+                    role: "user",
+                    content: {
+                        type: "text",
+                        text: `Prepare the quarterly tax filing for ${targetQuarter} (fiscal zone: ${zone}, tax: ${taxType}).\n\n` +
+                            `Follow these steps:\n\n` +
+                            `1. GATHER INVOICES\n` +
+                            `   - Use list_invoices to get all invoices for the quarter\n` +
+                            `   - Filter by date range for the quarter period\n` +
+                            `   - Separate by status: paid, sent, overdue, cancelled\n` +
+                            `   - Calculate total revenue (base imponible) and total ${taxType} collected (${taxType} repercutido)\n\n` +
+                            `2. GATHER EXPENSES\n` +
+                            `   - Use list_expenses to get all expenses for the quarter\n` +
+                            `   - Read frihet://config/expense-categories for deductibility rules\n` +
+                            `   - Categorize expenses and calculate deductible ${taxType} (${taxType} soportado)\n` +
+                            `   - Flag any expenses missing receipts or with questionable deductibility\n\n` +
+                            `3. TAX CALCULATION\n` +
+                            `   - Read frihet://tax/rates to confirm the applicable rates\n` +
+                            `   - ${taxType} to pay = ${taxType} repercutido (collected) - ${taxType} soportado (deductible)\n` +
+                            `   - If negative, it is a refund (a compensar o devolver)\n\n` +
+                            `4. MODELO ${modelo} PREVIEW\n` +
+                            `   - Base imponible (taxable base): sum of invoice subtotals\n` +
+                            `   - ${taxType} devengado (output tax): sum of tax on invoices\n` +
+                            `   - ${taxType} deducible (input tax): sum of deductible tax on expenses\n` +
+                            `   - Resultado (result): output - input = amount to pay or refund\n\n` +
+                            `5. MODELO 130 PREVIEW (IRPF advance)\n` +
+                            `   - Net income = Revenue - Deductible expenses\n` +
+                            `   - Advance payment = 20% of net income\n` +
+                            `   - Subtract any previous quarterly payments already made\n\n` +
+                            `6. FILING REMINDER\n` +
+                            `   - Read frihet://tax/calendar for the filing deadline\n` +
+                            `   - Note: this is a PREVIEW only — actual filing must be done through AEAT/ATC\n` +
+                            `   - List any issues that need resolution before filing`,
+                    },
+                },
+            ],
+        };
+    });
+    // -- overdue-followup --
+    server.registerPrompt("overdue-followup", {
+        title: "Overdue Invoice Follow-up",
+        description: "Find all overdue invoices, draft follow-up messages for each client, and suggest payment reminders. " +
+            "/ Buscar facturas vencidas, redactar mensajes de seguimiento y sugerir recordatorios de pago.",
+    }, async () => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: `Help me follow up on overdue invoices.\n\n` +
+                        `Follow these steps:\n\n` +
+                        `1. FIND OVERDUE INVOICES\n` +
+                        `   - Use list_invoices to find all invoices with status "overdue" or "sent" past their due date\n` +
+                        `   - For each, note: invoice ID, client name, amount, due date, days overdue\n` +
+                        `   - Sort by days overdue (most overdue first)\n\n` +
+                        `2. GROUP BY CLIENT\n` +
+                        `   - Group overdue invoices by client\n` +
+                        `   - Calculate total outstanding per client\n` +
+                        `   - Use get_client to get contact details for each client\n\n` +
+                        `3. DRAFT FOLLOW-UP MESSAGES\n` +
+                        `   For each client, draft a professional payment reminder:\n` +
+                        `   - Tone: Firm but polite. Maintain the business relationship.\n` +
+                        `   - Include: Invoice number(s), amount(s), original due date(s)\n` +
+                        `   - 1-15 days overdue: Friendly reminder, assume it was overlooked\n` +
+                        `   - 16-30 days overdue: Firmer tone, request confirmation of payment date\n` +
+                        `   - 31-60 days overdue: Escalation notice, mention potential late fees\n` +
+                        `   - 60+ days overdue: Final notice, mention potential debt collection\n` +
+                        `   - Provide both English and Spanish versions\n\n` +
+                        `4. SUGGEST ACTIONS\n` +
+                        `   - Recommend which invoices to update to "overdue" status if still "sent"\n` +
+                        `   - Suggest setting up webhook notifications for future overdue invoices\n` +
+                        `   - Flag any clients with multiple overdue invoices (potential bad debt risk)\n\n` +
+                        `5. SUMMARY\n` +
+                        `   - Total overdue amount\n` +
+                        `   - Number of clients affected\n` +
+                        `   - Oldest unpaid invoice\n` +
+                        `   - Recommended priority order for follow-up`,
+                },
+            },
+        ],
+    }));
+    // -- expense-batch --
+    server.registerPrompt("expense-batch", {
+        title: "Batch Expense Processing",
+        description: "Process a batch of expenses: help categorize each one, apply correct tax rates, flag items needing receipts. " +
+            "/ Procesar lote de gastos: categorizar, aplicar impuestos correctos, marcar los que necesitan justificante.",
+        argsSchema: {
+            fiscalZone: z
+                .enum(["peninsula", "canarias", "ceuta", "melilla"])
+                .optional()
+                .describe("Fiscal zone for tax deduction rules / Zona fiscal"),
+        },
+    }, async ({ fiscalZone }) => {
+        const zone = fiscalZone || "peninsula";
+        const taxType = zone === "canarias" ? "IGIC" : zone === "peninsula" ? "IVA" : "IPSI";
+        return {
+            messages: [
+                {
+                    role: "user",
+                    content: {
+                        type: "text",
+                        text: `Help me process a batch of expenses (fiscal zone: ${zone}, tax: ${taxType}).\n\n` +
+                            `Before we start, read frihet://config/expense-categories to understand the 8 categories and their deductibility rules.\n\n` +
+                            `For each expense I describe, do the following:\n\n` +
+                            `1. CATEGORIZE\n` +
+                            `   - Assign one of the 8 categories: office, travel, software, marketing, professional, equipment, insurance, other\n` +
+                            `   - Explain why this category fits\n\n` +
+                            `2. TAX TREATMENT\n` +
+                            `   - Determine if ${taxType} is deductible on this expense\n` +
+                            `   - Calculate the deductible ${taxType} amount\n` +
+                            `   - Note any special rules (e.g., vehicles 50%, meals with limits)\n\n` +
+                            `3. DEDUCTIBILITY CHECK\n` +
+                            `   - Is this expense fully deductible, partially deductible, or not deductible?\n` +
+                            `   - If equipment >€300, note amortization period\n` +
+                            `   - Flag if the expense seems personal (not deductible)\n\n` +
+                            `4. RECEIPT STATUS\n` +
+                            `   - Does this expense need an official invoice (factura) for ${taxType} deduction?\n` +
+                            `   - A simplified invoice (ticket) works for amounts <€400\n` +
+                            `   - International purchases may need a different document\n\n` +
+                            `5. CREATE THE EXPENSE\n` +
+                            `   - Use create_expense with the suggested category, amount, date, and vendor\n` +
+                            `   - Set taxDeductible based on the analysis\n` +
+                            `   - Wait for my confirmation before creating each one\n\n` +
+                            `I will now describe the expenses one by one. After processing all of them, provide a summary with:\n` +
+                            `- Total expenses by category\n` +
+                            `- Total deductible ${taxType}\n` +
+                            `- Any items flagged for review`,
+                    },
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=register-all.js.map

package/dist/prompts/register-all.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-all.js","sourceRoot":"","sources":["../../src/prompts/register-all.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B,MAAM,UAAU,kBAAkB,CAAC,MAAiB;IAClD,sBAAsB;IAEtB,MAAM,CAAC,cAAc,CACnB,eAAe,EACf;QACE,KAAK,EAAE,eAAe;QACtB,WAAW,EACT,8FAA8F;YAC9F,2DAA2D;YAC3D,iFAAiF;YACjF,oDAAoD;QACtD,UAAU,EAAE;YACV,KAAK,EAAE,CAAC;iBACL,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,8EAA8E,CAAC;SAC5F;KACF,EACD,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;QAClB,MAAM,WAAW,GAAG,KAAK,IAAI,oBAAoB,CAAC;QAClD,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAe;oBACrB,OAAO,EAAE;wBACP,IAAI,EAAE,MAAe;wBACrB,IAAI,EACF,iCAAiC,WAAW,oCAAoC;4BAChF,sBAAsB;4BACtB,+EAA+E;4BAC/E,iFAAiF;4BACjF,kDAAkD;4BAClD,qBAAqB;4BACrB,6DAA6D;4BAC7D,+FAA+F;4BAC/F,iEAAiE;4BACjE,+CAA+C;4BAC/C,sBAAsB;4BACtB,4DAA4D;4BAC5D,gEAAgE;4BAChE,uDAAuD;4BACvD,gBAAgB;4BAChB,uEAAuE;4BACvE,wEAAwE;4BACxE,2DAA2D;4BAC3D,qBAAqB;4BACrB,kEAAkE;4BAClE,sCAAsC;4BACtC,mCAAmC;4BACnC,qBAAqB;4BACrB,wFAAwF;qBAC3F;iBACF;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,uBAAuB;IAEvB,MAAM,CAAC,cAAc,CACnB,gBAAgB,EAChB;QACE,KAAK,EAAE,oBAAoB;QAC3B,WAAW,EACT,sGAAsG;YACtG,yCAAyC;YACzC,sHAAsH;QACxH,UAAU,EAAE;YACV,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uDAAuD,CAAC;YACxF,OAAO,EAAE,CAAC;iBACP,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,4DAA4D,CAAC;YACzE,MAAM,EAAE,CAAC;iBACN,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,sFAAsF,CAAC;SACpG;KACF,EACD,KAAK,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE;QACxC,MAAM,eAAe,GAAG,OAAO;YAC7B,CAAC,CAAC,4BAA4B,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG;YACvE,CAAC,CAAC,gFAAgF,CAAC;QAErF,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAe;oBACrB,OAAO,EAAE;wBACP,IAAI,EAAE,MAAe;wBACrB,IAAI,EACF,0BAA0B,UAAU,MAAM,eAAe,MAAM;4BAC/D,yBAAyB;4BACzB,yBAAyB;4BACzB,4DAA4D;4BAC5D,4CAA4C;4BAC5C,2CAA2C;4BAC3C,iCAAiC;4BACjC,2DAA2D;4BAC3D,sCAAsC;4BACtC,2DAA2D;4BAC3D,2BAA2B;4BAC3B,+CAA+C;4BAC/C,mEAAmE;4BACnE,2DAA2D;4BAC3D,+BAA+B;4BAC/B,yEAAyE;4BACzE,yDAAyD;4BACzD,mDAAmD;4BACnD,6CAA6C;4BAC7C,cAAc;4BACd,8CAA8C;4BAC9C,+DAA+D;4BAC/D,kEAAkE;qBACrE;iBACF;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,2BAA2B;IAE3B,MAAM,CAAC,cAAc,CACnB,oBAAoB,EACpB;QACE,KAAK,EAAE,2BAA2B;QAClC,WAAW,EACT,+GAA+G;YAC/G,2EAA2E;YAC3E,2HAA2H;QAC7H,UAAU,EAAE;YACV,OAAO,EAAE,CAAC;iBACP,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,4FAA4F,CAAC;YACzG,UAAU,EAAE,CAAC;iBACV,IAAI,CAAC,CAAC,WAAW,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;iBACnD,QAAQ,EAAE;iBACV,QAAQ,CAAC,+CAA+C,CAAC;SAC7D;KACF,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE;QAChC,MAAM,aAAa,GAAG,OAAO,IAAI,qBAAqB,CAAC;QACvD,MAAM,IAAI,GAAG,UAAU,IAAI,WAAW,CAAC;QACvC,MAAM,OAAO,GAAG,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;QACrF,MAAM,MAAM,GAAG,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;QAEnD,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAe;oBACrB,OAAO,EAAE;wBACP,IAAI,EAAE,MAAe;wBACrB,IAAI,EACF,wCAAwC,aAAa,kBAAkB,IAAI,UAAU,OAAO,QAAQ;4BACpG,yBAAyB;4BACzB,sBAAsB;4BACtB,8DAA8D;4BAC9D,oDAAoD;4BACpD,2DAA2D;4BAC3D,2DAA2D,OAAO,eAAe,OAAO,mBAAmB;4BAC3G,sBAAsB;4BACtB,8DAA8D;4BAC9D,wEAAwE;4BACxE,qDAAqD,OAAO,KAAK,OAAO,eAAe;4BACvF,gFAAgF;4BAChF,sBAAsB;4BACtB,gEAAgE;4BAChE,QAAQ,OAAO,aAAa,OAAO,8BAA8B,OAAO,2BAA2B;4BACnG,+DAA+D;4BAC/D,aAAa,MAAM,YAAY;4BAC/B,gEAAgE;4BAChE,QAAQ,OAAO,mDAAmD;4BAClE,QAAQ,OAAO,6DAA6D;4BAC5E,uEAAuE;4BACvE,wCAAwC;4BACxC,mDAAmD;4BACnD,4CAA4C;4BAC5C,gEAAgE;4BAChE,sBAAsB;4BACtB,2DAA2D;4BAC3D,mFAAmF;4BACnF,yDAAyD;qBAC5D;iBACF;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,yBAAyB;IAEzB,MAAM,CAAC,cAAc,CACnB,kBAAkB,EAClB;QACE,KAAK,EAAE,2BAA2B;QAClC,WAAW,EACT,sGAAsG;YACtG,+FAA+F;KAClG,EACD,KAAK,IAAI,EAAE,CAAC,CAAC;QACX,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAe;gBACrB,OAAO,EAAE;oBACP,IAAI,EAAE,MAAe;oBACrB,IAAI,EACF,4CAA4C;wBAC5C,yBAAyB;wBACzB,4BAA4B;wBAC5B,mGAAmG;wBACnG,gFAAgF;wBAChF,oDAAoD;wBACpD,sBAAsB;wBACtB,yCAAyC;wBACzC,+CAA+C;wBAC/C,gEAAgE;wBAChE,+BAA+B;wBAC/B,8DAA8D;wBAC9D,mEAAmE;wBACnE,oEAAoE;wBACpE,uEAAuE;wBACvE,8EAA8E;wBAC9E,2EAA2E;wBAC3E,0EAA0E;wBAC1E,oDAAoD;wBACpD,sBAAsB;wBACtB,+EAA+E;wBAC/E,6EAA6E;wBAC7E,oFAAoF;wBACpF,cAAc;wBACd,6BAA6B;wBAC7B,mCAAmC;wBACnC,8BAA8B;wBAC9B,+CAA+C;iBAClD;aACF;SACF;KACF,CAAC,CACH,CAAC;IAEF,sBAAsB;IAEtB,MAAM,CAAC,cAAc,CACnB,eAAe,EACf;QACE,KAAK,EAAE,0BAA0B;QACjC,WAAW,EACT,+GAA+G;YAC/G,6GAA6G;QAC/G,UAAU,EAAE;YACV,UAAU,EAAE,CAAC;iBACV,IAAI,CAAC,CAAC,WAAW,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;iBACnD,QAAQ,EAAE;iBACV,QAAQ,CAAC,mDAAmD,CAAC;SACjE;KACF,EACD,KAAK,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE;QACvB,MAAM,IAAI,GAAG,UAAU,IAAI,WAAW,CAAC;QACvC,MAAM,OAAO,GAAG,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;QAErF,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAe;oBACrB,OAAO,EAAE;wBACP,IAAI,EAAE,MAAe;wBACrB,IAAI,EACF,qDAAqD,IAAI,UAAU,OAAO,QAAQ;4BAClF,4HAA4H;4BAC5H,oDAAoD;4BACpD,iBAAiB;4BACjB,uHAAuH;4BACvH,yCAAyC;4BACzC,oBAAoB;4BACpB,qBAAqB,OAAO,kCAAkC;4BAC9D,iCAAiC,OAAO,WAAW;4BACnD,yEAAyE;4BACzE,0BAA0B;4BAC1B,mFAAmF;4BACnF,qDAAqD;4BACrD,8DAA8D;4BAC9D,qBAAqB;4BACrB,iEAAiE,OAAO,eAAe;4BACvF,8DAA8D;4BAC9D,gEAAgE;4BAChE,yBAAyB;4BACzB,iFAAiF;4BACjF,gDAAgD;4BAChD,4DAA4D;4BAC5D,sGAAsG;4BACtG,gCAAgC;4BAChC,sBAAsB,OAAO,IAAI;4BACjC,gCAAgC;qBACnC;iBACF;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/resources/register-all.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Static MCP Resources for the Frihet ERP server.
+ *
+ * Resources are read-only reference data that LLMs can access without making
+ * API calls. They encode domain knowledge (tax rates, deadlines, categories)
+ * that would otherwise require the user to explain every time.
+ *
+ * All resources use the `frihet://` URI scheme.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerAllResources(server: McpServer): void;
+//# sourceMappingURL=register-all.d.ts.map

package/dist/resources/register-all.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-all.d.ts","sourceRoot":"","sources":["../../src/resources/register-all.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAiRzE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAwG5D"}