procountor-mcp-server 1.0.0

package/README.md

@@ -0,0 +1,59 @@
+# Procountor MCP Server
+
+Connect AI agents to **Procountor** — Finland's leading financial management and accounting platform.
+
+Manage invoices, business partners, ledger entries, products, and more through the Model Context Protocol.
+
+## Tools (19)
+
+| Category | Tools | Description |
+|----------|-------|-------------|
+| **Invoices** | `list_invoices`, `get_invoice`, `create_sales_invoice`, `send_invoice`, `list_payments` | Create, send, and track invoices |
+| **Partners** | `list_business_partners`, `get_business_partner`, `create_business_partner` | Manage customers and suppliers |
+| **Accounting** | `list_ledger_receipts`, `create_journal_entry`, `list_chart_of_accounts`, `list_fiscal_years` | Journal entries and tilikartta |
+| **Company** | `get_company_info`, `list_dimensions` | Company info and tracking dimensions |
+| **Products** | `list_products`, `create_product` | Product and service catalog |
+
+## Quick Start
+
+### 1. Get Procountor API Credentials
+
+Register at [dev.procountor.com](https://dev.procountor.com/) and create an application. Free test environment available.
+
+### 2. Configure in Claude Desktop
+
+```json
+{
+  "mcpServers": {
+    "procountor": {
+      "command": "npx",
+      "args": ["-y", "procountor-mcp-server"],
+      "env": {
+        "PROCOUNTOR_ACCESS_TOKEN": "your-access-token-here"
+      }
+    }
+  }
+}
+```
+
+### 3. Start Using
+
+Ask Claude things like:
+- "Näytä kaikki maksamattomat laskut" (List all unpaid invoices)
+- "Luo myyntilasku asiakkaalle Oy Firma Ab" (Create a sales invoice)
+- "Mitä ostolaskuja on erääntymässä?" (What purchase invoices are due?)
+- "Show me the chart of accounts"
+
+## Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `PROCOUNTOR_ACCESS_TOKEN` | Yes | OAuth2 access token from Procountor |
+
+## API Reference
+
+This server wraps the [Procountor REST API](https://dev.procountor.com/api-reference/). Free test environment available for development.
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/**
+ * Procountor MCP Server
+ *
+ * Connects AI agents to Procountor — Finland's leading financial management
+ * platform. Manage invoices, business partners, ledger entries, and more.
+ */
+export {};

package/dist/index.js

@@ -0,0 +1,227 @@
+#!/usr/bin/env node
+/**
+ * Procountor MCP Server
+ *
+ * Connects AI agents to Procountor — Finland's leading financial management
+ * platform. Manage invoices, business partners, ledger entries, and more.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { ProcountorClient } from "./procountor-client.js";
+const server = new McpServer({
+    name: "procountor-mcp-server",
+    version: "1.0.0",
+});
+function getClient() {
+    const token = process.env.PROCOUNTOR_ACCESS_TOKEN;
+    if (!token) {
+        throw new Error("PROCOUNTOR_ACCESS_TOKEN environment variable is required. " +
+            "Register at https://dev.procountor.com to get API credentials.");
+    }
+    return new ProcountorClient({ accessToken: token });
+}
+function jsonResponse(data) {
+    return {
+        content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+    };
+}
+// ── INVOICES (5 tools) ────────────────────────────────────────
+server.tool("list_invoices", "List and filter invoices (sales, purchase, travel, etc.).", {
+    type: z.string().optional().describe("Type: SALES_INVOICE, PURCHASE_INVOICE, TRAVEL_INVOICE, BILL_OF_CHARGES"),
+    status: z.string().optional().describe("Status: EMPTY, UNFINISHED, NOT_SENT, SENT, PAID, etc."),
+    startDate: z.string().optional().describe("Start date (YYYY-MM-DD)"),
+    endDate: z.string().optional().describe("End date (YYYY-MM-DD)"),
+    size: z.string().optional().describe("Results per page (max 200)"),
+}, async ({ type, status, startDate, endDate, size }) => {
+    const client = getClient();
+    const result = await client.listInvoices({ type, status, startDate, endDate, size });
+    return jsonResponse(result);
+});
+server.tool("get_invoice", "Get full details of a specific invoice.", {
+    id: z.string().describe("Invoice ID"),
+}, async ({ id }) => {
+    const client = getClient();
+    const result = await client.getInvoice(id);
+    return jsonResponse(result);
+});
+server.tool("create_sales_invoice", "Create a new sales invoice.", {
+    customerName: z.string().describe("Customer/company name"),
+    customerBusinessId: z.string().optional().describe("Customer business ID (Y-tunnus)"),
+    rows: z.array(z.object({
+        product: z.string().describe("Product/service name"),
+        quantity: z.number().describe("Quantity"),
+        unitPrice: z.number().describe("Unit price"),
+        vatPercent: z.number().optional().describe("VAT percentage (default 25.5 in Finland)"),
+        unit: z.string().optional().describe("Unit (e.g. kpl, h, pv)"),
+    })).describe("Invoice line items"),
+    dueDate: z.string().optional().describe("Due date (YYYY-MM-DD)"),
+    date: z.string().optional().describe("Invoice date (YYYY-MM-DD)"),
+    currency: z.string().optional().describe("Currency (default EUR)"),
+    notes: z.string().optional().describe("Notes/comments"),
+}, async ({ customerName, customerBusinessId, rows, dueDate, date, currency, notes }) => {
+    const client = getClient();
+    const result = await client.createInvoice({
+        type: "SALES_INVOICE",
+        counterParty: {
+            name: customerName,
+            identifier: customerBusinessId,
+        },
+        invoiceRows: rows.map((r) => ({
+            product: r.product,
+            quantity: r.quantity,
+            unitPrice: r.unitPrice,
+            vatPercent: r.vatPercent,
+            unit: r.unit,
+        })),
+        dueDate,
+        date,
+        currency,
+        notes,
+    });
+    return jsonResponse(result);
+});
+server.tool("send_invoice", "Send an invoice via email or e-invoice.", {
+    id: z.string().describe("Invoice ID to send"),
+    method: z.string().optional().describe("Send method: EMAIL (default), EINVOICE, LETTER"),
+}, async ({ id, method }) => {
+    const client = getClient();
+    const result = await client.sendInvoice(id, method);
+    return jsonResponse(result);
+});
+server.tool("list_payments", "List payments and payment status.", {
+    startDate: z.string().optional().describe("Start date (YYYY-MM-DD)"),
+    endDate: z.string().optional().describe("End date (YYYY-MM-DD)"),
+    size: z.string().optional().describe("Results per page"),
+}, async ({ startDate, endDate, size }) => {
+    const client = getClient();
+    const result = await client.listPayments({ startDate, endDate, size });
+    return jsonResponse(result);
+});
+// ── BUSINESS PARTNERS — Customers & Suppliers (3 tools) ───────
+server.tool("list_business_partners", "List customers, suppliers, or all business partners.", {
+    name: z.string().optional().describe("Search by name"),
+    type: z.string().optional().describe("Filter: CUSTOMER, SUPPLIER (omit for all)"),
+    size: z.string().optional().describe("Results per page"),
+}, async ({ name, type, size }) => {
+    const client = getClient();
+    const result = await client.listBusinessPartners({ name, type, size });
+    return jsonResponse(result);
+});
+server.tool("get_business_partner", "Get full details of a customer or supplier.", {
+    id: z.string().describe("Business partner ID"),
+}, async ({ id }) => {
+    const client = getClient();
+    const result = await client.getBusinessPartner(id);
+    return jsonResponse(result);
+});
+server.tool("create_business_partner", "Add a new customer or supplier.", {
+    name: z.string().describe("Company/person name"),
+    type: z.string().describe("Type: CUSTOMER or SUPPLIER"),
+    email: z.string().optional().describe("Email address"),
+    phone: z.string().optional().describe("Phone number"),
+    businessId: z.string().optional().describe("Business ID (Y-tunnus)"),
+    street: z.string().optional().describe("Street address"),
+    zip: z.string().optional().describe("Postal code"),
+    city: z.string().optional().describe("City"),
+    country: z.string().optional().describe("Country code (e.g. FI, SE)"),
+    currency: z.string().optional().describe("Default currency (e.g. EUR)"),
+}, async ({ name, type, email, phone, businessId, street, zip, city, country, currency }) => {
+    const client = getClient();
+    const result = await client.createBusinessPartner({
+        name,
+        type,
+        email,
+        phone,
+        businessId,
+        billingAddress: street ? { street, zip, city, country } : undefined,
+        currency,
+    });
+    return jsonResponse(result);
+});
+// ── ACCOUNTING (4 tools) ──────────────────────────────────────
+server.tool("list_ledger_receipts", "List journal entries/ledger receipts.", {
+    startDate: z.string().optional().describe("Start date (YYYY-MM-DD)"),
+    endDate: z.string().optional().describe("End date (YYYY-MM-DD)"),
+    size: z.string().optional().describe("Results per page"),
+}, async ({ startDate, endDate, size }) => {
+    const client = getClient();
+    const result = await client.listLedgerReceipts({ startDate, endDate, size });
+    return jsonResponse(result);
+});
+server.tool("create_journal_entry", "Create a manual journal entry. Transactions must balance.", {
+    name: z.string().describe("Entry description"),
+    receiptDate: z.string().describe("Date (YYYY-MM-DD)"),
+    transactions: z.array(z.object({
+        accountNumber: z.string().describe("Account number"),
+        debit: z.number().describe("Amount (positive = debit, negative = credit)"),
+        description: z.string().optional().describe("Transaction description"),
+    })).describe("Transactions (must sum to zero)"),
+}, async ({ name, receiptDate, transactions }) => {
+    const client = getClient();
+    const result = await client.createLedgerReceipt({
+        type: "JOURNAL",
+        receiptDate,
+        name,
+        transactions: transactions.map((t) => ({
+            accountNumber: t.accountNumber,
+            debit: t.debit,
+            description: t.description,
+        })),
+    });
+    return jsonResponse(result);
+});
+server.tool("list_chart_of_accounts", "Get the chart of accounts (tilikartta).", {
+    size: z.string().optional().describe("Results per page"),
+}, async ({ size }) => {
+    const client = getClient();
+    const result = await client.listChartOfAccounts({ size });
+    return jsonResponse(result);
+});
+server.tool("list_fiscal_years", "Get information about fiscal/accounting years (tilikaudet).", {}, async () => {
+    const client = getClient();
+    const result = await client.listFiscalYears();
+    return jsonResponse(result);
+});
+// ── COMPANY & REPORTS (2 tools) ───────────────────────────────
+server.tool("get_company_info", "Get company information and settings.", {}, async () => {
+    const client = getClient();
+    const result = await client.getCompanyInfo();
+    return jsonResponse(result);
+});
+server.tool("list_dimensions", "List tracking dimensions (cost centers, projects, etc.).", {
+    size: z.string().optional().describe("Results per page"),
+}, async ({ size }) => {
+    const client = getClient();
+    const result = await client.listDimensions({ size });
+    return jsonResponse(result);
+});
+// ── PRODUCTS (2 tools) ────────────────────────────────────────
+server.tool("list_products", "List products and services.", {
+    type: z.string().optional().describe("Filter by type"),
+    size: z.string().optional().describe("Results per page"),
+}, async ({ type, size }) => {
+    const client = getClient();
+    const result = await client.listProducts({ type, size });
+    return jsonResponse(result);
+});
+server.tool("create_product", "Add a new product or service.", {
+    name: z.string().describe("Product/service name"),
+    type: z.string().describe("Type: PRODUCT or SERVICE"),
+    price: z.number().optional().describe("Default price"),
+    unit: z.string().optional().describe("Unit (e.g. kpl, h)"),
+    vatPercent: z.number().optional().describe("VAT percentage"),
+}, async ({ name, type, price, unit, vatPercent }) => {
+    const client = getClient();
+    const result = await client.createProduct({ name, type, price, unit, vatPercent });
+    return jsonResponse(result);
+});
+// ── Start server ──────────────────────────────────────────────
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((error) => {
+    console.error("Server error:", error);
+    process.exit(1);
+});

package/dist/procountor-client.d.ts

@@ -0,0 +1,122 @@
+/**
+ * Procountor REST API client.
+ * API docs: https://dev.procountor.com/api-reference/
+ * Production: https://api.procountor.com/api
+ */
+interface ProcountorConfig {
+    accessToken: string;
+}
+export declare class ProcountorClient {
+    private accessToken;
+    constructor(config: ProcountorConfig);
+    private request;
+    listInvoices(params?: {
+        status?: string;
+        startDate?: string;
+        endDate?: string;
+        previousId?: string;
+        orderById?: string;
+        size?: string;
+        type?: string;
+    }): Promise<unknown>;
+    getInvoice(id: string): Promise<unknown>;
+    createInvoice(invoice: {
+        type: string;
+        partnerId?: number;
+        counterParty: {
+            contactPersonName?: string;
+            identifier?: string;
+            name: string;
+            taxCode?: string;
+        };
+        billingAddress?: {
+            name?: string;
+            street?: string;
+            zip?: string;
+            city?: string;
+            country?: string;
+        };
+        invoiceRows: Array<{
+            product?: string;
+            productCode?: string;
+            quantity?: number;
+            unit?: string;
+            unitPrice?: number;
+            vatPercent?: number;
+            comment?: string;
+        }>;
+        date?: string;
+        dueDate?: string;
+        currency?: string;
+        notes?: string;
+    }): Promise<unknown>;
+    sendInvoice(id: string, method?: string): Promise<unknown>;
+    listPayments(params?: {
+        previousId?: string;
+        size?: string;
+        startDate?: string;
+        endDate?: string;
+    }): Promise<unknown>;
+    listBusinessPartners(params?: {
+        name?: string;
+        type?: string;
+        previousId?: string;
+        size?: string;
+    }): Promise<unknown>;
+    getBusinessPartner(id: string): Promise<unknown>;
+    createBusinessPartner(partner: {
+        name: string;
+        type: string;
+        contactPersonName?: string;
+        email?: string;
+        phone?: string;
+        businessId?: string;
+        billingAddress?: {
+            name?: string;
+            street?: string;
+            zip?: string;
+            city?: string;
+            country?: string;
+        };
+        currency?: string;
+    }): Promise<unknown>;
+    listLedgerReceipts(params?: {
+        startDate?: string;
+        endDate?: string;
+        previousId?: string;
+        size?: string;
+    }): Promise<unknown>;
+    createLedgerReceipt(receipt: {
+        type: string;
+        receiptDate: string;
+        name?: string;
+        transactions: Array<{
+            accountNumber: string;
+            debit: number;
+            description?: string;
+        }>;
+    }): Promise<unknown>;
+    listChartOfAccounts(params?: {
+        previousId?: string;
+        size?: string;
+    }): Promise<unknown>;
+    listFiscalYears(): Promise<unknown>;
+    getCompanyInfo(): Promise<unknown>;
+    listDimensions(params?: {
+        previousId?: string;
+        size?: string;
+    }): Promise<unknown>;
+    listProducts(params?: {
+        previousId?: string;
+        size?: string;
+        type?: string;
+    }): Promise<unknown>;
+    createProduct(product: {
+        name: string;
+        type: string;
+        price?: number;
+        unit?: string;
+        vatPercent?: number;
+    }): Promise<unknown>;
+}
+export {};

package/dist/procountor-client.js

@@ -0,0 +1,92 @@
+/**
+ * Procountor REST API client.
+ * API docs: https://dev.procountor.com/api-reference/
+ * Production: https://api.procountor.com/api
+ */
+const BASE_URL = "https://api.procountor.com/api";
+export class ProcountorClient {
+    accessToken;
+    constructor(config) {
+        this.accessToken = config.accessToken;
+    }
+    async request(method, path, body, params) {
+        const url = new URL(`${BASE_URL}${path}`);
+        if (params) {
+            for (const [key, value] of Object.entries(params)) {
+                if (value !== undefined && value !== "") {
+                    url.searchParams.set(key, value);
+                }
+            }
+        }
+        const headers = {
+            Authorization: `Bearer ${this.accessToken}`,
+            "Content-Type": "application/json",
+            Accept: "application/json",
+        };
+        const response = await fetch(url.toString(), {
+            method,
+            headers,
+            body: body ? JSON.stringify(body) : undefined,
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            throw new Error(`Procountor API error ${response.status}: ${errorText}`);
+        }
+        return response.json();
+    }
+    // ── Invoices ──────────────────────────────────────────────
+    async listInvoices(params) {
+        return this.request("GET", "/invoices", undefined, params);
+    }
+    async getInvoice(id) {
+        return this.request("GET", `/invoices/${id}`);
+    }
+    async createInvoice(invoice) {
+        return this.request("POST", "/invoices", invoice);
+    }
+    async sendInvoice(id, method = "EMAIL") {
+        return this.request("PUT", `/invoices/${id}/send`, {
+            method,
+        });
+    }
+    async listPayments(params) {
+        return this.request("GET", "/payments", undefined, params);
+    }
+    // ── Business Partners (Customers/Suppliers) ───────────────
+    async listBusinessPartners(params) {
+        return this.request("GET", "/businesspartners", undefined, params);
+    }
+    async getBusinessPartner(id) {
+        return this.request("GET", `/businesspartners/${id}`);
+    }
+    async createBusinessPartner(partner) {
+        return this.request("POST", "/businesspartners", partner);
+    }
+    // ── Ledger / Accounting ───────────────────────────────────
+    async listLedgerReceipts(params) {
+        return this.request("GET", "/ledgerreceipts", undefined, params);
+    }
+    async createLedgerReceipt(receipt) {
+        return this.request("POST", "/ledgerreceipts", receipt);
+    }
+    async listChartOfAccounts(params) {
+        return this.request("GET", "/coa", undefined, params);
+    }
+    async listFiscalYears() {
+        return this.request("GET", "/fiscalyears");
+    }
+    // ── Company & Reports ─────────────────────────────────────
+    async getCompanyInfo() {
+        return this.request("GET", "/company");
+    }
+    async listDimensions(params) {
+        return this.request("GET", "/dimensions", undefined, params);
+    }
+    // ── Products ──────────────────────────────────────────────
+    async listProducts(params) {
+        return this.request("GET", "/products", undefined, params);
+    }
+    async createProduct(product) {
+        return this.request("POST", "/products", product);
+    }
+}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "procountor-mcp-server",
+  "version": "1.0.0",
+  "description": "MCP server for Procountor — Finnish accounting and financial management via AI agents. Invoices, customers, ledger, and more.",
+  "main": "dist/index.js",
+  "bin": {
+    "procountor-mcp-server": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsc --watch"
+  },
+  "keywords": [
+    "mcp",
+    "procountor",
+    "accounting",
+    "finland",
+    "finnish",
+    "invoices",
+    "bookkeeping",
+    "ai",
+    "model-context-protocol",
+    "taloushallinto"
+  ],
+  "author": "Viggo Johansson",
+  "license": "MIT",
+  "type": "module",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "typescript": "^6.0.2"
+  }
+}

package/src/index.ts

@@ -0,0 +1,338 @@
+#!/usr/bin/env node
+
+/**
+ * Procountor MCP Server
+ *
+ * Connects AI agents to Procountor — Finland's leading financial management
+ * platform. Manage invoices, business partners, ledger entries, and more.
+ */
+
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { ProcountorClient } from "./procountor-client.js";
+
+const server = new McpServer({
+  name: "procountor-mcp-server",
+  version: "1.0.0",
+});
+
+function getClient(): ProcountorClient {
+  const token = process.env.PROCOUNTOR_ACCESS_TOKEN;
+  if (!token) {
+    throw new Error(
+      "PROCOUNTOR_ACCESS_TOKEN environment variable is required. " +
+        "Register at https://dev.procountor.com to get API credentials."
+    );
+  }
+  return new ProcountorClient({ accessToken: token });
+}
+
+function jsonResponse(data: unknown) {
+  return {
+    content: [{ type: "text" as const, text: JSON.stringify(data, null, 2) }],
+  };
+}
+
+// ── INVOICES (5 tools) ────────────────────────────────────────
+
+server.tool(
+  "list_invoices",
+  "List and filter invoices (sales, purchase, travel, etc.).",
+  {
+    type: z.string().optional().describe("Type: SALES_INVOICE, PURCHASE_INVOICE, TRAVEL_INVOICE, BILL_OF_CHARGES"),
+    status: z.string().optional().describe("Status: EMPTY, UNFINISHED, NOT_SENT, SENT, PAID, etc."),
+    startDate: z.string().optional().describe("Start date (YYYY-MM-DD)"),
+    endDate: z.string().optional().describe("End date (YYYY-MM-DD)"),
+    size: z.string().optional().describe("Results per page (max 200)"),
+  },
+  async ({ type, status, startDate, endDate, size }) => {
+    const client = getClient();
+    const result = await client.listInvoices({ type, status, startDate, endDate, size });
+    return jsonResponse(result);
+  }
+);
+
+server.tool(
+  "get_invoice",
+  "Get full details of a specific invoice.",
+  {
+    id: z.string().describe("Invoice ID"),
+  },
+  async ({ id }) => {
+    const client = getClient();
+    const result = await client.getInvoice(id);
+    return jsonResponse(result);
+  }
+);
+
+server.tool(
+  "create_sales_invoice",
+  "Create a new sales invoice.",
+  {
+    customerName: z.string().describe("Customer/company name"),
+    customerBusinessId: z.string().optional().describe("Customer business ID (Y-tunnus)"),
+    rows: z.array(z.object({
+      product: z.string().describe("Product/service name"),
+      quantity: z.number().describe("Quantity"),
+      unitPrice: z.number().describe("Unit price"),
+      vatPercent: z.number().optional().describe("VAT percentage (default 25.5 in Finland)"),
+      unit: z.string().optional().describe("Unit (e.g. kpl, h, pv)"),
+    })).describe("Invoice line items"),
+    dueDate: z.string().optional().describe("Due date (YYYY-MM-DD)"),
+    date: z.string().optional().describe("Invoice date (YYYY-MM-DD)"),
+    currency: z.string().optional().describe("Currency (default EUR)"),
+    notes: z.string().optional().describe("Notes/comments"),
+  },
+  async ({ customerName, customerBusinessId, rows, dueDate, date, currency, notes }) => {
+    const client = getClient();
+    const result = await client.createInvoice({
+      type: "SALES_INVOICE",
+      counterParty: {
+        name: customerName,
+        identifier: customerBusinessId,
+      },
+      invoiceRows: rows.map((r) => ({
+        product: r.product,
+        quantity: r.quantity,
+        unitPrice: r.unitPrice,
+        vatPercent: r.vatPercent,
+        unit: r.unit,
+      })),
+      dueDate,
+      date,
+      currency,
+      notes,
+    });
+    return jsonResponse(result);
+  }
+);
+
+server.tool(
+  "send_invoice",
+  "Send an invoice via email or e-invoice.",
+  {
+    id: z.string().describe("Invoice ID to send"),
+    method: z.string().optional().describe("Send method: EMAIL (default), EINVOICE, LETTER"),
+  },
+  async ({ id, method }) => {
+    const client = getClient();
+    const result = await client.sendInvoice(id, method);
+    return jsonResponse(result);
+  }
+);
+
+server.tool(
+  "list_payments",
+  "List payments and payment status.",
+  {
+    startDate: z.string().optional().describe("Start date (YYYY-MM-DD)"),
+    endDate: z.string().optional().describe("End date (YYYY-MM-DD)"),
+    size: z.string().optional().describe("Results per page"),
+  },
+  async ({ startDate, endDate, size }) => {
+    const client = getClient();
+    const result = await client.listPayments({ startDate, endDate, size });
+    return jsonResponse(result);
+  }
+);
+
+// ── BUSINESS PARTNERS — Customers & Suppliers (3 tools) ───────
+
+server.tool(
+  "list_business_partners",
+  "List customers, suppliers, or all business partners.",
+  {
+    name: z.string().optional().describe("Search by name"),
+    type: z.string().optional().describe("Filter: CUSTOMER, SUPPLIER (omit for all)"),
+    size: z.string().optional().describe("Results per page"),
+  },
+  async ({ name, type, size }) => {
+    const client = getClient();
+    const result = await client.listBusinessPartners({ name, type, size });
+    return jsonResponse(result);
+  }
+);
+
+server.tool(
+  "get_business_partner",
+  "Get full details of a customer or supplier.",
+  {
+    id: z.string().describe("Business partner ID"),
+  },
+  async ({ id }) => {
+    const client = getClient();
+    const result = await client.getBusinessPartner(id);
+    return jsonResponse(result);
+  }
+);
+
+server.tool(
+  "create_business_partner",
+  "Add a new customer or supplier.",
+  {
+    name: z.string().describe("Company/person name"),
+    type: z.string().describe("Type: CUSTOMER or SUPPLIER"),
+    email: z.string().optional().describe("Email address"),
+    phone: z.string().optional().describe("Phone number"),
+    businessId: z.string().optional().describe("Business ID (Y-tunnus)"),
+    street: z.string().optional().describe("Street address"),
+    zip: z.string().optional().describe("Postal code"),
+    city: z.string().optional().describe("City"),
+    country: z.string().optional().describe("Country code (e.g. FI, SE)"),
+    currency: z.string().optional().describe("Default currency (e.g. EUR)"),
+  },
+  async ({ name, type, email, phone, businessId, street, zip, city, country, currency }) => {
+    const client = getClient();
+    const result = await client.createBusinessPartner({
+      name,
+      type,
+      email,
+      phone,
+      businessId,
+      billingAddress: street ? { street, zip, city, country } : undefined,
+      currency,
+    });
+    return jsonResponse(result);
+  }
+);
+
+// ── ACCOUNTING (4 tools) ──────────────────────────────────────
+
+server.tool(
+  "list_ledger_receipts",
+  "List journal entries/ledger receipts.",
+  {
+    startDate: z.string().optional().describe("Start date (YYYY-MM-DD)"),
+    endDate: z.string().optional().describe("End date (YYYY-MM-DD)"),
+    size: z.string().optional().describe("Results per page"),
+  },
+  async ({ startDate, endDate, size }) => {
+    const client = getClient();
+    const result = await client.listLedgerReceipts({ startDate, endDate, size });
+    return jsonResponse(result);
+  }
+);
+
+server.tool(
+  "create_journal_entry",
+  "Create a manual journal entry. Transactions must balance.",
+  {
+    name: z.string().describe("Entry description"),
+    receiptDate: z.string().describe("Date (YYYY-MM-DD)"),
+    transactions: z.array(z.object({
+      accountNumber: z.string().describe("Account number"),
+      debit: z.number().describe("Amount (positive = debit, negative = credit)"),
+      description: z.string().optional().describe("Transaction description"),
+    })).describe("Transactions (must sum to zero)"),
+  },
+  async ({ name, receiptDate, transactions }) => {
+    const client = getClient();
+    const result = await client.createLedgerReceipt({
+      type: "JOURNAL",
+      receiptDate,
+      name,
+      transactions: transactions.map((t) => ({
+        accountNumber: t.accountNumber,
+        debit: t.debit,
+        description: t.description,
+      })),
+    });
+    return jsonResponse(result);
+  }
+);
+
+server.tool(
+  "list_chart_of_accounts",
+  "Get the chart of accounts (tilikartta).",
+  {
+    size: z.string().optional().describe("Results per page"),
+  },
+  async ({ size }) => {
+    const client = getClient();
+    const result = await client.listChartOfAccounts({ size });
+    return jsonResponse(result);
+  }
+);
+
+server.tool(
+  "list_fiscal_years",
+  "Get information about fiscal/accounting years (tilikaudet).",
+  {},
+  async () => {
+    const client = getClient();
+    const result = await client.listFiscalYears();
+    return jsonResponse(result);
+  }
+);
+
+// ── COMPANY & REPORTS (2 tools) ───────────────────────────────
+
+server.tool(
+  "get_company_info",
+  "Get company information and settings.",
+  {},
+  async () => {
+    const client = getClient();
+    const result = await client.getCompanyInfo();
+    return jsonResponse(result);
+  }
+);
+
+server.tool(
+  "list_dimensions",
+  "List tracking dimensions (cost centers, projects, etc.).",
+  {
+    size: z.string().optional().describe("Results per page"),
+  },
+  async ({ size }) => {
+    const client = getClient();
+    const result = await client.listDimensions({ size });
+    return jsonResponse(result);
+  }
+);
+
+// ── PRODUCTS (2 tools) ────────────────────────────────────────
+
+server.tool(
+  "list_products",
+  "List products and services.",
+  {
+    type: z.string().optional().describe("Filter by type"),
+    size: z.string().optional().describe("Results per page"),
+  },
+  async ({ type, size }) => {
+    const client = getClient();
+    const result = await client.listProducts({ type, size });
+    return jsonResponse(result);
+  }
+);
+
+server.tool(
+  "create_product",
+  "Add a new product or service.",
+  {
+    name: z.string().describe("Product/service name"),
+    type: z.string().describe("Type: PRODUCT or SERVICE"),
+    price: z.number().optional().describe("Default price"),
+    unit: z.string().optional().describe("Unit (e.g. kpl, h)"),
+    vatPercent: z.number().optional().describe("VAT percentage"),
+  },
+  async ({ name, type, price, unit, vatPercent }) => {
+    const client = getClient();
+    const result = await client.createProduct({ name, type, price, unit, vatPercent });
+    return jsonResponse(result);
+  }
+);
+
+// ── Start server ──────────────────────────────────────────────
+
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+}
+
+main().catch((error) => {
+  console.error("Server error:", error);
+  process.exit(1);
+});

package/src/procountor-client.ts

@@ -0,0 +1,234 @@
+/**
+ * Procountor REST API client.
+ * API docs: https://dev.procountor.com/api-reference/
+ * Production: https://api.procountor.com/api
+ */
+
+const BASE_URL = "https://api.procountor.com/api";
+
+interface ProcountorConfig {
+  accessToken: string;
+}
+
+export class ProcountorClient {
+  private accessToken: string;
+
+  constructor(config: ProcountorConfig) {
+    this.accessToken = config.accessToken;
+  }
+
+  private async request<T>(
+    method: string,
+    path: string,
+    body?: unknown,
+    params?: Record<string, string>
+  ): Promise<T> {
+    const url = new URL(`${BASE_URL}${path}`);
+    if (params) {
+      for (const [key, value] of Object.entries(params)) {
+        if (value !== undefined && value !== "") {
+          url.searchParams.set(key, value);
+        }
+      }
+    }
+
+    const headers: Record<string, string> = {
+      Authorization: `Bearer ${this.accessToken}`,
+      "Content-Type": "application/json",
+      Accept: "application/json",
+    };
+
+    const response = await fetch(url.toString(), {
+      method,
+      headers,
+      body: body ? JSON.stringify(body) : undefined,
+    });
+
+    if (!response.ok) {
+      const errorText = await response.text();
+      throw new Error(`Procountor API error ${response.status}: ${errorText}`);
+    }
+
+    return response.json() as Promise<T>;
+  }
+
+  // ── Invoices ──────────────────────────────────────────────
+
+  async listInvoices(params?: {
+    status?: string;
+    startDate?: string;
+    endDate?: string;
+    previousId?: string;
+    orderById?: string;
+    size?: string;
+    type?: string;
+  }) {
+    return this.request<unknown>("GET", "/invoices", undefined, params);
+  }
+
+  async getInvoice(id: string) {
+    return this.request<unknown>("GET", `/invoices/${id}`);
+  }
+
+  async createInvoice(invoice: {
+    type: string; // SALES_INVOICE, PURCHASE_INVOICE, etc.
+    partnerId?: number;
+    counterParty: {
+      contactPersonName?: string;
+      identifier?: string;
+      name: string;
+      taxCode?: string;
+    };
+    billingAddress?: {
+      name?: string;
+      street?: string;
+      zip?: string;
+      city?: string;
+      country?: string;
+    };
+    invoiceRows: Array<{
+      product?: string;
+      productCode?: string;
+      quantity?: number;
+      unit?: string;
+      unitPrice?: number;
+      vatPercent?: number;
+      comment?: string;
+    }>;
+    date?: string;
+    dueDate?: string;
+    currency?: string;
+    notes?: string;
+  }) {
+    return this.request<unknown>("POST", "/invoices", invoice);
+  }
+
+  async sendInvoice(id: string, method: string = "EMAIL") {
+    return this.request<unknown>("PUT", `/invoices/${id}/send`, {
+      method,
+    });
+  }
+
+  async listPayments(params?: {
+    previousId?: string;
+    size?: string;
+    startDate?: string;
+    endDate?: string;
+  }) {
+    return this.request<unknown>("GET", "/payments", undefined, params);
+  }
+
+  // ── Business Partners (Customers/Suppliers) ───────────────
+
+  async listBusinessPartners(params?: {
+    name?: string;
+    type?: string;
+    previousId?: string;
+    size?: string;
+  }) {
+    return this.request<unknown>(
+      "GET",
+      "/businesspartners",
+      undefined,
+      params
+    );
+  }
+
+  async getBusinessPartner(id: string) {
+    return this.request<unknown>("GET", `/businesspartners/${id}`);
+  }
+
+  async createBusinessPartner(partner: {
+    name: string;
+    type: string; // CUSTOMER, SUPPLIER
+    contactPersonName?: string;
+    email?: string;
+    phone?: string;
+    businessId?: string;
+    billingAddress?: {
+      name?: string;
+      street?: string;
+      zip?: string;
+      city?: string;
+      country?: string;
+    };
+    currency?: string;
+  }) {
+    return this.request<unknown>("POST", "/businesspartners", partner);
+  }
+
+  // ── Ledger / Accounting ───────────────────────────────────
+
+  async listLedgerReceipts(params?: {
+    startDate?: string;
+    endDate?: string;
+    previousId?: string;
+    size?: string;
+  }) {
+    return this.request<unknown>(
+      "GET",
+      "/ledgerreceipts",
+      undefined,
+      params
+    );
+  }
+
+  async createLedgerReceipt(receipt: {
+    type: string; // JOURNAL
+    receiptDate: string;
+    name?: string;
+    transactions: Array<{
+      accountNumber: string;
+      debit: number;
+      description?: string;
+    }>;
+  }) {
+    return this.request<unknown>("POST", "/ledgerreceipts", receipt);
+  }
+
+  async listChartOfAccounts(params?: {
+    previousId?: string;
+    size?: string;
+  }) {
+    return this.request<unknown>(
+      "GET",
+      "/coa",
+      undefined,
+      params
+    );
+  }
+
+  async listFiscalYears() {
+    return this.request<unknown>("GET", "/fiscalyears");
+  }
+
+  // ── Company & Reports ─────────────────────────────────────
+
+  async getCompanyInfo() {
+    return this.request<unknown>("GET", "/company");
+  }
+
+  async listDimensions(params?: { previousId?: string; size?: string }) {
+    return this.request<unknown>("GET", "/dimensions", undefined, params);
+  }
+
+  // ── Products ──────────────────────────────────────────────
+
+  async listProducts(params?: {
+    previousId?: string;
+    size?: string;
+    type?: string;
+  }) {
+    return this.request<unknown>("GET", "/products", undefined, params);
+  }
+
+  async createProduct(product: {
+    name: string;
+    type: string;
+    price?: number;
+    unit?: string;
+    vatPercent?: number;
+  }) {
+    return this.request<unknown>("POST", "/products", product);
+  }
+}

package/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "Node16",
+    "moduleResolution": "Node16",
+    "outDir": "dist",
+    "rootDir": "src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "declaration": true,
+    "types": ["node"]
+  },
+  "include": ["src/**/*"]
+}