eeconomic-mcp-server 1.0.0

package/dist/eeconomic-client.d.ts

@@ -0,0 +1,94 @@
+/**
+ * e-conomic REST API client (Danish accounting by Visma).
+ * API docs: https://restapi.e-conomic.com
+ * Auth: Two headers — X-AppSecretToken + X-AgreementGrantToken
+ */
+export declare class EconomicClient {
+    private appToken;
+    private grantToken;
+    constructor(appToken: string, grantToken: string);
+    private request;
+    listDraftInvoices(params?: {
+        pagesize?: string;
+        skippages?: string;
+    }): Promise<unknown>;
+    getDraftInvoice(id: string): Promise<unknown>;
+    createDraftInvoice(invoice: {
+        date: string;
+        currency: string;
+        customer: {
+            customerNumber: number;
+        };
+        layout: {
+            layoutNumber: number;
+        };
+        lines: Array<{
+            description: string;
+            quantity: number;
+            unitNetPrice: number;
+            product?: {
+                productNumber: string;
+            };
+        }>;
+    }): Promise<unknown>;
+    bookDraftInvoice(id: string): Promise<unknown>;
+    listBookedInvoices(params?: {
+        pagesize?: string;
+        skippages?: string;
+    }): Promise<unknown>;
+    listCustomers(params?: {
+        pagesize?: string;
+        skippages?: string;
+    }): Promise<unknown>;
+    getCustomer(customerNumber: string): Promise<unknown>;
+    createCustomer(customer: {
+        name: string;
+        currency: string;
+        customerGroup: {
+            customerGroupNumber: number;
+        };
+        vatZone: {
+            vatZoneNumber: number;
+        };
+        paymentTerms: {
+            paymentTermsNumber: number;
+        };
+        email?: string;
+        corporateIdentificationNumber?: string;
+        address?: string;
+        zip?: string;
+        city?: string;
+        country?: string;
+    }): Promise<unknown>;
+    listSuppliers(params?: {
+        pagesize?: string;
+        skippages?: string;
+    }): Promise<unknown>;
+    getSupplier(supplierNumber: string): Promise<unknown>;
+    listAccounts(params?: {
+        pagesize?: string;
+        skippages?: string;
+    }): Promise<unknown>;
+    listJournals(): Promise<unknown>;
+    createJournalEntry(journalNumber: string, entry: {
+        entries: Array<{
+            accountNumber: number;
+            amount: number;
+            date: string;
+            text?: string;
+        }>;
+    }): Promise<unknown>;
+    listProducts(params?: {
+        pagesize?: string;
+        skippages?: string;
+    }): Promise<unknown>;
+    createProduct(product: {
+        name: string;
+        productNumber: string;
+        salesPrice: number;
+        productGroup: {
+            productGroupNumber: number;
+        };
+    }): Promise<unknown>;
+    getCompanyInfo(): Promise<unknown>;
+}

package/dist/eeconomic-client.js

@@ -0,0 +1,59 @@
+/**
+ * e-conomic REST API client (Danish accounting by Visma).
+ * API docs: https://restapi.e-conomic.com
+ * Auth: Two headers — X-AppSecretToken + X-AgreementGrantToken
+ */
+const BASE_URL = "https://restapi.e-conomic.com";
+export class EconomicClient {
+    appToken;
+    grantToken;
+    constructor(appToken, grantToken) {
+        this.appToken = appToken;
+        this.grantToken = grantToken;
+    }
+    async request(method, path, body, params) {
+        const url = new URL(`${BASE_URL}${path}`);
+        if (params)
+            for (const [k, v] of Object.entries(params)) {
+                if (v)
+                    url.searchParams.set(k, v);
+            }
+        const res = await fetch(url.toString(), {
+            method, headers: { "X-AppSecretToken": this.appToken, "X-AgreementGrantToken": this.grantToken, "Content-Type": "application/json", Accept: "application/json" },
+            body: body ? JSON.stringify(body) : undefined,
+        });
+        if (!res.ok)
+            throw new Error(`e-conomic API error ${res.status}: ${await res.text()}`);
+        return res.json();
+    }
+    // Invoices
+    async listDraftInvoices(params) { return this.request("GET", "/invoices/drafts", undefined, params); }
+    async getDraftInvoice(id) { return this.request("GET", `/invoices/drafts/${id}`); }
+    async createDraftInvoice(invoice) {
+        return this.request("POST", "/invoices/drafts", invoice);
+    }
+    async bookDraftInvoice(id) { return this.request("POST", `/invoices/drafts/${id}/book`); }
+    async listBookedInvoices(params) { return this.request("GET", "/invoices/booked", undefined, params); }
+    // Customers
+    async listCustomers(params) { return this.request("GET", "/customers", undefined, params); }
+    async getCustomer(customerNumber) { return this.request("GET", `/customers/${customerNumber}`); }
+    async createCustomer(customer) {
+        return this.request("POST", "/customers", customer);
+    }
+    // Suppliers
+    async listSuppliers(params) { return this.request("GET", "/suppliers", undefined, params); }
+    async getSupplier(supplierNumber) { return this.request("GET", `/suppliers/${supplierNumber}`); }
+    // Accounting
+    async listAccounts(params) { return this.request("GET", "/accounts", undefined, params); }
+    async listJournals() { return this.request("GET", "/journals"); }
+    async createJournalEntry(journalNumber, entry) {
+        return this.request("POST", `/journals/${journalNumber}/entries`, entry);
+    }
+    // Products
+    async listProducts(params) { return this.request("GET", "/products", undefined, params); }
+    async createProduct(product) {
+        return this.request("POST", "/products", product);
+    }
+    // Company
+    async getCompanyInfo() { return this.request("GET", "/self"); }
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,42 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { EconomicClient } from "./eeconomic-client.js";
+const server = new McpServer({ name: "eeconomic-mcp-server", version: "1.0.0" });
+function getClient() {
+    const app = process.env.ECONOMIC_APP_TOKEN;
+    const grant = process.env.ECONOMIC_GRANT_TOKEN;
+    if (!app || !grant)
+        throw new Error("ECONOMIC_APP_TOKEN and ECONOMIC_GRANT_TOKEN are required. Get them from e-conomic → Settings → Apps.");
+    return new EconomicClient(app, grant);
+}
+function json(data) { return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] }; }
+server.tool("list_draft_invoices", "List draft invoices.", { pagesize: z.string().optional(), skippages: z.string().optional() }, async (p) => json(await getClient().listDraftInvoices(p)));
+server.tool("get_draft_invoice", "Get draft invoice details.", { id: z.string().describe("Draft invoice number") }, async ({ id }) => json(await getClient().getDraftInvoice(id)));
+server.tool("create_draft_invoice", "Create a draft invoice.", {
+    customerNumber: z.number().describe("Customer number"), date: z.string().describe("Invoice date YYYY-MM-DD"), currency: z.string().describe("Currency code (e.g. DKK)"),
+    layoutNumber: z.number().describe("Layout number"), lines: z.array(z.object({ description: z.string(), quantity: z.number(), unitNetPrice: z.number(), productNumber: z.string().optional() })),
+}, async ({ customerNumber, date, currency, layoutNumber, lines }) => json(await getClient().createDraftInvoice({ date, currency, customer: { customerNumber }, layout: { layoutNumber }, lines: lines.map(l => ({ ...l, product: l.productNumber ? { productNumber: l.productNumber } : undefined })) })));
+server.tool("book_invoice", "Book (finalize) a draft invoice.", { id: z.string().describe("Draft invoice number") }, async ({ id }) => json(await getClient().bookDraftInvoice(id)));
+server.tool("list_booked_invoices", "List booked/sent invoices.", { pagesize: z.string().optional(), skippages: z.string().optional() }, async (p) => json(await getClient().listBookedInvoices(p)));
+server.tool("list_customers", "List customers.", { pagesize: z.string().optional(), skippages: z.string().optional() }, async (p) => json(await getClient().listCustomers(p)));
+server.tool("get_customer", "Get customer details.", { customerNumber: z.string().describe("Customer number") }, async ({ customerNumber }) => json(await getClient().getCustomer(customerNumber)));
+server.tool("create_customer", "Create a new customer.", {
+    name: z.string(), currency: z.string().describe("e.g. DKK"), customerGroupNumber: z.number(), vatZoneNumber: z.number(), paymentTermsNumber: z.number(),
+    email: z.string().optional(), corporateId: z.string().optional().describe("CVR number"), address: z.string().optional(), zip: z.string().optional(), city: z.string().optional(), country: z.string().optional(),
+}, async ({ name, currency, customerGroupNumber, vatZoneNumber, paymentTermsNumber, email, corporateId, address, zip, city, country }) => json(await getClient().createCustomer({ name, currency, customerGroup: { customerGroupNumber }, vatZone: { vatZoneNumber }, paymentTerms: { paymentTermsNumber }, email, corporateIdentificationNumber: corporateId, address, zip, city, country })));
+server.tool("list_suppliers", "List suppliers.", { pagesize: z.string().optional() }, async (p) => json(await getClient().listSuppliers(p)));
+server.tool("get_supplier", "Get supplier details.", { supplierNumber: z.string() }, async ({ supplierNumber }) => json(await getClient().getSupplier(supplierNumber)));
+server.tool("list_accounts", "Get chart of accounts (kontoplan).", { pagesize: z.string().optional() }, async (p) => json(await getClient().listAccounts(p)));
+server.tool("list_journals", "List available journals.", {}, async () => json(await getClient().listJournals()));
+server.tool("create_journal_entry", "Post a journal entry.", {
+    journalNumber: z.string().describe("Journal number"), entries: z.array(z.object({ accountNumber: z.number(), amount: z.number().describe("Positive=debit, negative=credit"), date: z.string(), text: z.string().optional() })),
+}, async ({ journalNumber, entries }) => json(await getClient().createJournalEntry(journalNumber, { entries })));
+server.tool("list_products", "List products.", { pagesize: z.string().optional() }, async (p) => json(await getClient().listProducts(p)));
+server.tool("create_product", "Create a product.", {
+    name: z.string(), productNumber: z.string(), salesPrice: z.number(), productGroupNumber: z.number(),
+}, async ({ name, productNumber, salesPrice, productGroupNumber }) => json(await getClient().createProduct({ name, productNumber, salesPrice, productGroup: { productGroupNumber } })));
+server.tool("get_company_info", "Get company/agreement info.", {}, async () => json(await getClient().getCompanyInfo()));
+async function main() { await server.connect(new StdioServerTransport()); }
+main().catch((e) => { console.error("Server error:", e); process.exit(1); });

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "eeconomic-mcp-server",
+  "version": "1.0.0",
+  "description": "MCP server for e-conomic by Visma — Denmark's leading accounting platform. Manage invoices, customers, accounts, and more via AI agents.",
+  "main": "dist/index.js",
+  "bin": {
+    "eeconomic-mcp-server": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js"
+  },
+  "keywords": [
+    "mcp",
+    "e-conomic",
+    "economic",
+    "accounting",
+    "denmark",
+    "danish",
+    "regnskab",
+    "invoices",
+    "visma",
+    "model-context-protocol"
+  ],
+  "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/eeconomic-client.ts

@@ -0,0 +1,58 @@
+/**
+ * e-conomic REST API client (Danish accounting by Visma).
+ * API docs: https://restapi.e-conomic.com
+ * Auth: Two headers — X-AppSecretToken + X-AgreementGrantToken
+ */
+
+const BASE_URL = "https://restapi.e-conomic.com";
+
+export class EconomicClient {
+  constructor(private appToken: string, private grantToken: string) {}
+
+  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 [k, v] of Object.entries(params)) { if (v) url.searchParams.set(k, v); }
+    const res = await fetch(url.toString(), {
+      method, headers: { "X-AppSecretToken": this.appToken, "X-AgreementGrantToken": this.grantToken, "Content-Type": "application/json", Accept: "application/json" },
+      body: body ? JSON.stringify(body) : undefined,
+    });
+    if (!res.ok) throw new Error(`e-conomic API error ${res.status}: ${await res.text()}`);
+    return res.json() as Promise<T>;
+  }
+
+  // Invoices
+  async listDraftInvoices(params?: { pagesize?: string; skippages?: string }) { return this.request<unknown>("GET", "/invoices/drafts", undefined, params); }
+  async getDraftInvoice(id: string) { return this.request<unknown>("GET", `/invoices/drafts/${id}`); }
+  async createDraftInvoice(invoice: { date: string; currency: string; customer: { customerNumber: number }; layout: { layoutNumber: number }; lines: Array<{ description: string; quantity: number; unitNetPrice: number; product?: { productNumber: string } }> }) {
+    return this.request<unknown>("POST", "/invoices/drafts", invoice);
+  }
+  async bookDraftInvoice(id: string) { return this.request<unknown>("POST", `/invoices/drafts/${id}/book`); }
+  async listBookedInvoices(params?: { pagesize?: string; skippages?: string }) { return this.request<unknown>("GET", "/invoices/booked", undefined, params); }
+
+  // Customers
+  async listCustomers(params?: { pagesize?: string; skippages?: string }) { return this.request<unknown>("GET", "/customers", undefined, params); }
+  async getCustomer(customerNumber: string) { return this.request<unknown>("GET", `/customers/${customerNumber}`); }
+  async createCustomer(customer: { name: string; currency: string; customerGroup: { customerGroupNumber: number }; vatZone: { vatZoneNumber: number }; paymentTerms: { paymentTermsNumber: number }; email?: string; corporateIdentificationNumber?: string; address?: string; zip?: string; city?: string; country?: string }) {
+    return this.request<unknown>("POST", "/customers", customer);
+  }
+
+  // Suppliers
+  async listSuppliers(params?: { pagesize?: string; skippages?: string }) { return this.request<unknown>("GET", "/suppliers", undefined, params); }
+  async getSupplier(supplierNumber: string) { return this.request<unknown>("GET", `/suppliers/${supplierNumber}`); }
+
+  // Accounting
+  async listAccounts(params?: { pagesize?: string; skippages?: string }) { return this.request<unknown>("GET", "/accounts", undefined, params); }
+  async listJournals() { return this.request<unknown>("GET", "/journals"); }
+  async createJournalEntry(journalNumber: string, entry: { entries: Array<{ accountNumber: number; amount: number; date: string; text?: string }> }) {
+    return this.request<unknown>("POST", `/journals/${journalNumber}/entries`, entry);
+  }
+
+  // Products
+  async listProducts(params?: { pagesize?: string; skippages?: string }) { return this.request<unknown>("GET", "/products", undefined, params); }
+  async createProduct(product: { name: string; productNumber: string; salesPrice: number; productGroup: { productGroupNumber: number } }) {
+    return this.request<unknown>("POST", "/products", product);
+  }
+
+  // Company
+  async getCompanyInfo() { return this.request<unknown>("GET", "/self"); }
+}

package/src/index.ts

@@ -0,0 +1,47 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { EconomicClient } from "./eeconomic-client.js";
+
+const server = new McpServer({ name: "eeconomic-mcp-server", version: "1.0.0" });
+
+function getClient(): EconomicClient {
+  const app = process.env.ECONOMIC_APP_TOKEN;
+  const grant = process.env.ECONOMIC_GRANT_TOKEN;
+  if (!app || !grant) throw new Error("ECONOMIC_APP_TOKEN and ECONOMIC_GRANT_TOKEN are required. Get them from e-conomic → Settings → Apps.");
+  return new EconomicClient(app, grant);
+}
+function json(data: unknown) { return { content: [{ type: "text" as const, text: JSON.stringify(data, null, 2) }] }; }
+
+server.tool("list_draft_invoices", "List draft invoices.", { pagesize: z.string().optional(), skippages: z.string().optional() }, async (p) => json(await getClient().listDraftInvoices(p)));
+server.tool("get_draft_invoice", "Get draft invoice details.", { id: z.string().describe("Draft invoice number") }, async ({ id }) => json(await getClient().getDraftInvoice(id)));
+server.tool("create_draft_invoice", "Create a draft invoice.", {
+  customerNumber: z.number().describe("Customer number"), date: z.string().describe("Invoice date YYYY-MM-DD"), currency: z.string().describe("Currency code (e.g. DKK)"),
+  layoutNumber: z.number().describe("Layout number"), lines: z.array(z.object({ description: z.string(), quantity: z.number(), unitNetPrice: z.number(), productNumber: z.string().optional() })),
+}, async ({ customerNumber, date, currency, layoutNumber, lines }) => json(await getClient().createDraftInvoice({ date, currency, customer: { customerNumber }, layout: { layoutNumber }, lines: lines.map(l => ({ ...l, product: l.productNumber ? { productNumber: l.productNumber } : undefined })) })));
+server.tool("book_invoice", "Book (finalize) a draft invoice.", { id: z.string().describe("Draft invoice number") }, async ({ id }) => json(await getClient().bookDraftInvoice(id)));
+server.tool("list_booked_invoices", "List booked/sent invoices.", { pagesize: z.string().optional(), skippages: z.string().optional() }, async (p) => json(await getClient().listBookedInvoices(p)));
+
+server.tool("list_customers", "List customers.", { pagesize: z.string().optional(), skippages: z.string().optional() }, async (p) => json(await getClient().listCustomers(p)));
+server.tool("get_customer", "Get customer details.", { customerNumber: z.string().describe("Customer number") }, async ({ customerNumber }) => json(await getClient().getCustomer(customerNumber)));
+server.tool("create_customer", "Create a new customer.", {
+  name: z.string(), currency: z.string().describe("e.g. DKK"), customerGroupNumber: z.number(), vatZoneNumber: z.number(), paymentTermsNumber: z.number(),
+  email: z.string().optional(), corporateId: z.string().optional().describe("CVR number"), address: z.string().optional(), zip: z.string().optional(), city: z.string().optional(), country: z.string().optional(),
+}, async ({ name, currency, customerGroupNumber, vatZoneNumber, paymentTermsNumber, email, corporateId, address, zip, city, country }) => json(await getClient().createCustomer({ name, currency, customerGroup: { customerGroupNumber }, vatZone: { vatZoneNumber }, paymentTerms: { paymentTermsNumber }, email, corporateIdentificationNumber: corporateId, address, zip, city, country })));
+
+server.tool("list_suppliers", "List suppliers.", { pagesize: z.string().optional() }, async (p) => json(await getClient().listSuppliers(p)));
+server.tool("get_supplier", "Get supplier details.", { supplierNumber: z.string() }, async ({ supplierNumber }) => json(await getClient().getSupplier(supplierNumber)));
+server.tool("list_accounts", "Get chart of accounts (kontoplan).", { pagesize: z.string().optional() }, async (p) => json(await getClient().listAccounts(p)));
+server.tool("list_journals", "List available journals.", {}, async () => json(await getClient().listJournals()));
+server.tool("create_journal_entry", "Post a journal entry.", {
+  journalNumber: z.string().describe("Journal number"), entries: z.array(z.object({ accountNumber: z.number(), amount: z.number().describe("Positive=debit, negative=credit"), date: z.string(), text: z.string().optional() })),
+}, async ({ journalNumber, entries }) => json(await getClient().createJournalEntry(journalNumber, { entries })));
+server.tool("list_products", "List products.", { pagesize: z.string().optional() }, async (p) => json(await getClient().listProducts(p)));
+server.tool("create_product", "Create a product.", {
+  name: z.string(), productNumber: z.string(), salesPrice: z.number(), productGroupNumber: z.number(),
+}, async ({ name, productNumber, salesPrice, productGroupNumber }) => json(await getClient().createProduct({ name, productNumber, salesPrice, productGroup: { productGroupNumber } })));
+server.tool("get_company_info", "Get company/agreement info.", {}, async () => json(await getClient().getCompanyInfo()));
+
+async function main() { await server.connect(new StdioServerTransport()); }
+main().catch((e) => { console.error("Server error:", e); process.exit(1); });

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/**/*"]
+}