mcp-malt

Ein MCP-Server für die Malt API. Er umfasst alle 13 Operationen, die Malt veröffentlicht: die Rechnungen, die du ausstellst, die Provisionen, die Malt dir in Rechnung stellt, die Zahlungen, die du erhältst, und die SCIM-Benutzerbereitstellung für Organisationskonten.

Was er abdeckt und was nicht

Die API von Malt ist kleiner, als die meisten erwarten. Sie deckt Back-Office-Abrechnung und Enterprise-Benutzerbereitstellung ab und sonst nichts:

Es gibt keine Talentsuche, keine Profile, keine Missionen, keine Angebote und kein Messaging. Dafür ist Malt bekannt, und nichts davon ist in der öffentlichen API enthalten. Wenn du deswegen gekommen bist, kann dir dieser Server das nicht bieten – und nichts anderes, das auf der dokumentierten API aufbaut, ebenso bisher.

Zwei Community-MCP-Server für Malt erreichen diese Daten, indem sie die Web-App mit Browser-Automation steuern und das DOM auslesen. Ihre eigene Dokumentation warnt davor, dass automatisierte Profiländerungen die Geschäftsbedingungen von Malt verletzen könnte. Dieser Server ruft ausschließlich die dokumentierte API auf.

Related MCP server: fintaro-mcp

Ein Token erhalten

1. Erstelle eine Identität auf der Registrierungsseite, falls du keine hast.

2. Öffne Mein Konto, dann API-Schlüssel.

3. Erstelle ein Access Token mit den Berechtigungen (Scopes), die du brauchst. Stimme sie auf die Toolsets ab, die du aktivieren willst.

4. Kopiere den Token sofort. Er wird nur einmal angezeigt, und zwar bei der Erstellung, danach nie mehr.

Tokens für Freelancer-Konten suchst du selbst. Client-Team- und Organisationstokens, die das scim-Toolset braucht, kommen über deinen Malt-Ansprechpartner.

Es gibt hier kein OAuth 2.0. Malt veröffentlicht keinen Autorisierungsserver und keinen Token-Endpoint – das oben genannte API-Token ist also der einzige Zugang. docs/authentication.md erklärt das genauer, auch das Header-Detail, über das die meisten Menschen stolpern.

Install

Drei Arten, eine Veröffentlichung zu nutzen: das npm-Paket über npmjs und über GitHub Packages sowie das Container-Image auf GHCR. npx ist für die MCP-Clients die übliche Wahl; Docker eignet sich für besonders abgesicherte oder geteilte Umgebungen.

Um statt von npmjs aus einem GitHub Packages zu installieren, setze den Scope: @ialejandro:registry=https://npm.pkg.github.com into your .npmrc.

npx

// Claude Desktop: claude_desktop_config.json
// Cursor: .cursor/mcp.json
{
  "mcpServers": {
    "malt": {
      "command": "npx",
      "args": ["-y", "@ialejandro/mcp-malt"],
      "env": {
        "MALT_API_TOKEN": "your-token-here",
        "MALT_TOOLSETS": "invoices,payments,fee-invoices"
      }
    }
  }
}

Claude Code

claude mcp add malt \
  --env MALT_API_TOKEN=your-token-here \
  --env MALT_TOOLSETS=invoices,payments,fee-invoices \
  -- npx -y @ialejandro/mcp-malt

Docker

Der Server kommuniziert JSON-RPC über stdin und stdout: -i ist erforderlich, -t müssen stayout.

docker run -i --rm \
  -e MALT_API_TOKEN=your-token-here \
  -e MALT_TOOLSETS=invoices \
  ghcr.io/ialejandro/mcp-malt

// Claude Desktop: claude_desktop_config.json
// Cursor: .cursor/mcp.json
{
  "mcpServers": {
    "malt": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "MALT_API_TOKEN",
        "-e", "MALT_TOOLSETS",
        "ghcr.io/ialejandro/mcp-malt"
      ],
      "env": {
        "MALT_API_TOKEN": "your-token-here",
        "MALT_TOOLSETS": "invoices,payments,fee-invoices"
      }
    }
  }
}

Aus der Quelle

git clone https://github.com/ialejandro/mcp-malt
cd mcp-malt
npm ci && npm run build

{
  "mcpServers": {
    "malt": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-malt/dist/index.js"],
      "env": {
        "MALT_API_TOKEN": "your-token-here",
        "MALT_TOOLSETS": "invoices,payments,fee-invoices"
      }
    }
  }
}

{
  "mcpServers": {
    "malt": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "MALT_API_TOKEN",
        "-e", "MALT_TOOLSETS",
        "ghcr.io/ialejandro/mcp-malt"
      ],
      "env": {
        "MALT_API_TOKEN": "your-token-here",
        "MALT_TOOLSETS": "invoices,payments,fee-invoices"
      }
    }
  }
}

Konfiguration

Ohne MALT_TOOLSETS startet der Server und bietet nichts an. Das ist Absicht und kein Fehler: Du legst fest, was eine KI zu sehen bekommt. Füge die Toolsets jeweils einzeln hinzu.

Ein unbekannter Toolsetname würde den Server mit einem Fehler stoppen, anstatt ignoriert zu werden, weil ein Tippfehler, das dich im Stillen drei Werkzeuge kostet, deutlich schwerer zu debuggen.

Häufige Aufgaben

Ein Quartal abgleichen. Aktiviere invoices,payments,fee-invoices und führe den Prompt malt_reconcile_revenue aus. Er zieht alle drei Listen, gleicht Zahlungen mit den Rechnungen ab, für die sie bestimmt sind, und meldet Bruttobetrag, Steuern, Malt's Provision und erhaltene Zahlungen.

Gleiche meine Malt-Einnahmen für Q1 2026 ab.

Eine Rechnungs-PDF abrufen. Malt liefert PDFs base64-kodiert in einem JSON-Body aus. Die Werkzeuge dekodieren sie und geben eine echte PDF-Datei zurück.

Lade die PDF für Rechnung INV-123456 herunter.

Jemanden abmelden. Aktiviere scim mit MALT_ALLOW_WRITES=true und verwende dafür malt_user_lifecycle. Sie deaktiviert statt gelöscht zu werden – das ist der Fall, den Malt tatsächlich unterstützt.

Deaktiviere jane.doe@acme.com in unserer Malt-Organisation.

Dokumentation

• Token erhalten und verwalten

• Authentifizierung und das Fehlen von OAuth

• Toolsets: Was du aktivieren solltest und wann

• Jeder Endpunkt mit Anfragen und Antworten

• Fehler und ihre Bedeutung

• Ratenlimits

• Den Server entwickeln

Entwicklung

npm ci
npm run typecheck
npm test
npm run build
npm run check-spec   # diff the live Malt spec against spec/malt-openapi.json

Tests mocken fetch und rufen niemals die Live-API auf.

spec/malt-openapi.json ist ein eingecheckter Schnappschuss des veröffentlichten Dokuments von Malt. Ein täglicher Workflow erstellt einen Diff gegen die Live-Spec und öffnet, sobald sich etwas ändert, einen PR. Malt hat bei info.version durchgehend 0.0.1 stehen, weshalb der Vergleich die Operationen vergleicht und sich nicht auf die Versionsnummer.

Mitwirken

Siehe CONTRIBUTING.md. Das Hinzufügen eines Endpunktes oder Toolset wird in docs/extending.md beschrieben.

Lizenz

MIT# mcp-malt

Ein MCP-Server für die Malt API. Er umfasst alle 13 Operationen, die Malt veröffentlicht: die Rechnungen, die du deinen Kunden stellst, die Provisionen, die Malt dir verrechnet, die Zahlungen, die du erhältst, sowie die SCIM-Benutzerbereitstellung für Organisationskonten.

Was dieser Server abdeckt und was nicht

Die API von Malt ist kleiner, als die meisten erwarten. Sie deckt Backoffice-Abrechnung und Benutzerverwaltung für Unternehmen ab – und sonst nichts:

Es gibt keine Talentsuche, keine Profile, keine Missionen, keine Angebote und keine Nachrichten. Das ist das, wofür Malt bekannt ist – und nichts davon steckt in der öffentlichen API. Wenn du danach gesucht suchst, kann dir dieser Server nicht helfen, und auch alles andere, das auf der dokumentierten API basiert, kann es nicht.

Zwei Community-MCP-Server für Malt greifen über Browser-Automatisierung und DOM-Scraping auf diese Daten zu. Deren eigene Dokumentation weist darauf hin, dass automatische Profiländerungen gegen die Nutzungsbedingungen von Malt verstoßen könnten. Dieser Server ruft ausschließlich die dokumentierte API auf.

Ein Starttoken erhalten / Zugangsdaten holen

1. Lege auf der Signup-Seite ein Konto an, falls du noch keins hast.

2. Öffne Mein Konto, dann API Keys.

3. Erstelle einen Access-Token mit den Berechtigungen, die du brauchst. Stimme diese auf die Toolsets ab, die du aktivieren möchtest.

4. Kopiere den Token sofort. Er wird nur einmal – bei der Erstellung – angezeigt, und danach nie wieder.

Freelancer-Account-Tokens sind auch „Self-Service“. Client-Team- und Organisationstokens, die das scim-Toolset benötigt, erhältst du über deine Malt-Ansprechperson.

Es gibt kein OAuth 2.0: Malt veröffentlicht keinen Autorisierungsserver und keinen Token-Endpunkt, daher ist der oben genannte API-Token der einzige Weg hinein. In docs/authentication.md wird das genauer erläutert, einschließlich des Header-Details, an dem die meisten scheitern.

Installation

Aus einem Release ergeben sich drei Installationswege: das npm-Paket auf npmjs und auf GitHub Packages sowie das Container-Image auf GHCR. npx ist die übliche Wahl für MCP-Clients; Docker passt für abgesicherte und geteilte Setups.

Um von GitHub Packages statt npmjs zu installieren, zeige den Scope auf das Paket: @ialejandro:registry=https://npm.pkg.github.com in deiner .npmrc.

npx

// Claude Desktop: claude_desktop_config.json
// Cursor: .cursor/mcp.json
{
  "mcpServers": {
    "malt": {
      "command": "npx",
      "args": ["-y", "@ialejandro/mcp-malt"],
      "env": {
        "MALT_API_TOKEN": "your-token-here",
        "MALT_TOOLSETS": "invoices,payments,fee-invoices"
      }
    }
  }
}

Claude Code

claude mcp add malt \
  --env MALT_API_TOKEN=your-token-here \
  --env MALT_TOOLSETS=invoices,payments,fee-invoices \
  -- npx -y @ialejandro/mcp-malt

Docker

Der Server spricht JSON-RPC über stdin und stdout, deshalb ist -i Pflicht und -t muss weggelassen werden.

docker run -i --rm \
  -e MALT_API_TOKEN=your-token-here \
  -e MALT_TOOLSETS=invoices \
  ghcr.io/ialejandro/mcp-malt

// Claude Desktop: claude_desktop_config.json
// Cursor: .cursor/mcp.json
{
  "mcpServers": {
    "malt": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "MALT_API_TOKEN",
        "-e", "MALT_TOOLSETS",
        "ghcr.io/ialejandro/mcp-malt"
      ],
      "env": {
        "MALT_API_TOKEN": "your-token-here",
        "MALT_TOOLSETS": "invoices,payments,fee-invoices"
      }
    }
  }
}

Aus dem Quellcode

git clone https://github.com/ialejandro/mcp-malt
cd mcp-malt
npm ci && npm run build

{
  "mcpServers": {
    "malt": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-malt/dist/index.js"],
      "env": {
        "MALT_API_TOKEN": "your-token-here",
        "MALT_TOOLSETS": "invoices,payments,fee-invoices"
      }
    }
  }
}

{
  "mcpServers": {
    "malt": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "MALT_API_TOKEN",
        "-e", "MALT_TOOLSETS",
        "ghcr.io/ialejandro/mcp-malt"
      ],
      "env": {
        "MALT_API_TOKEN": "your-token-here",
        "MALT_TOOLSETS": "invoices,payments,fee-invoices"
      }
    }
  }
}

Konfiguration

Ohne MALT_TOOLSETS startet der Server und bietet nichts an. Das ist gewollt, kein Fehler: Du bestimmst, was ein Modell sehen darf. Erweitere die Toolsets Schritt für Schritt.

Wenn ein unbekannter Toolset-Name den Server mit einem Fehler stoppt statt ignoriert wird, weil ein Tippfehler, der still drei Tools sind, unangenehm zu debuggen.

Häufige Aufgaben

Ein Quartal abstimmen. Aktiviere invoices,payments,fee-invoices und führe das Prompt malt_reconcile_revenue44 aus. Es ruft alle drei Listen auf, gleicht Zahlungen mit zu den entsprechenden Rechnungen ab und meldet Bruttobetrag, Steuern, Malts Provision und erhaltene Zahlungen.

Stimme meine Malt-Einnahmen für Q1 2024 to 2026 ab.

Eine Rechnungs-PDF abrufen. Malt liefert PDFs base64-codiert in einem JSON-Body aus. Die Tools dekodieren sie und liefern eine echte PDF-Datei zurück.

Lade die PDF für Rechnung INV-123456 herunter.

Jemanden deaktivieren. Aktiviere scim mit MALT_ALLOW_WRITES=true und nutze malt_user_lifecycle. Es deaktiviert den Nutzer, statt ihn zu löschen – das ist der Weg, den Malt tatsächlich unterstützt.

Nimm jane.doe@acme.com aus unserer Malt-Organisation heraus.

Dokumentation

• Token abrufen und verwalten

• Authentifizierung und warum es kein OAuth gibt

• Toolsets: Welche Optionen und wann

• Jeder Endpunkt, mit Requests und Responses

• Fehler und was sie bedeuten

• Rate Limits

• Den Server erweitern h___

Entwicklung

npm ci
npm run typecheck
npm test
npm run build
npm run check-spec   # diff the live Malt spec against spec/malt-openapi.json

Tests mocken fetch und rufen die Live-API nicht auf.

spec/malt-openapi.json ist ein eingecheckter Snapshot des veröffentlichten Malt-Dokuments. Eine tägliche Workflow vergleicht die aktuelle Spec und öffnet einen PR, wenn sich etwas ändert. Malt hat info.version die ganze Zeit bei 0.0.1 angeben, deshalb vergleicht der Check die Operationen und vertraut nicht der Versionsnummer.

Mitwirken

Siehe CONTRIBUTING.md. Das Hinzufügen eines Endpunkts oder Toolsets wird in docs/extending.md beschriebt.

Lizenz

Promise: MIT.# mcp-malt

Ein MCP-Server für die Malt API. Er umfasst alle 13 Operationen, die Malt veröffentlicht: die Rechnungen, die du erstellst, die Provisionen, die Malt dir in Rechnung stellt, die Zahlungen, die du erhältst, und die SCIM-Benutzerbereitstellung für Organisationskonten.

Was dieser Server abdeckt und was nicht

Die API von Malt ist kleiner, als die meisten Menschen erwarten. Sie deckt Backoffice-Abrechnung und Unternehmens-Benutzerbereitstellung ab – und sonst nichts:

Es gibt keine Talentsuche, keine Profile, keine Missionen, keine Angebote und kein Messaging. Das alles ist das, wofür Malt bekannt ist, und nichts davon ist in der öffentlichen API enthalten. Wenn du dafür gekommen bist, kann dir dieser Server nicht weiterhelfen – und auch sonst nichts, das auf der dokumentierten API aufbaut.

Zwei Community-MCP-Server für Malt erreichen diese Daten dennoch, indem sie die Web-App per Browser-Automation steuern und das DOM auslesen. Deren jeweilige Dokumentation warnt davor, dass automatisierte Profiländerungen Malts Nutzungsbedingungen verletzen könnten. Dieser Server ruft ausschließlich die dokumentierte API auf.

Ein Token erhalten

1. Lege auf der Registrierungsseite ein Konto an, falls du noch keins hast.

2. Öffne Mein Konto, dann API Keys.

3. Erstelle einen Access Token mit den Berechtigungen, die du brauchst. Stimme die Toolsets darauf ab, die du aktivieren möchtest.

4. Kopiere den Token sofort. Er wird nur einmal gezeigt, und zwar bei der Erstellung – danach nie wieder.

Freelancer-Konten decken Token-Vergabe selbst ab. Client-Team- und Organisationsstokens, die das scim-Toolset braucht, kommen über deinen Malt-Ansprechpartner rein.

Es gibt hier kein OAuth 2.0. Malt stellt keinen Autorisierungsserver und keinen Token-Endpunkt bereit, daher ist das Single-Token die einzige Möglichkeit. docs/authentication.md erklärt das genauer, inklusive des Header-Details, über das die meisten Kinder stolpern.

Installation

Eine Veröffentlichung, drei Bereitstellungswege: das npm-Paket auf npmjs und auf GitHub Packages sowie das Container-Image auf GHCR. npx is ist die übliche Wahl für einen MCP-Client; Docker eignet sich für abgesicherte oder gemeinsame Umgebungen.

Um von GitHub Packages statt von npmjs zu installieren, den Punkt auf Scope darauf setzen: @ialejandro:registry=https://npm.pkg.github.com in deiner .npmrc.

npx

// Claude Desktop: claude_desktop_config.json
// Cursor: .cursor/mcp.json
{
  "mcpServers": {
    "malt": {
      "command": "npx",
      "args": ["-y", "@ialejandro/mcp-malt"],
      "env": {
        "MALT_API_TOKEN": "your-token-here",
        "MALT_TOOLSETS": "invoices,payments,fee-invoices"
      }
    }
  }
}

Claude Code

claude mcp add malt \
  --env MALT_API_TOKEN=your-token-here \
  --env MALT_TOOLSETS=invoices,payments,fee-invoices \
  -- npx -y @ialejandro/mcp-malt

Docker

Der Server spricht JSON-RPC über stdin und stdout, also ist -i erforderlich und -t muss weggelassen werden.

docker run -i --rm \
  -e MALT_API_TOKEN=your-token-here \
  -e MALT_TOOLSETS=invoices \
  ghcr.io/ialejandro/mcp-malt

// Claude Desktop: claude_desktop_config.json
// Cursor: .cursor/mcp.json
{
  "mcpServers": {
    "malt": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "MALT_API_TOKEN",
        "-e", "MALT_TOOLSETS",
        "ghcr.io/ialejandro/mcp-malt"
      ],
      "env": {
        "MALT_API_TOKEN": "your-token-here",
        "MALT_TOOLSETS": "invoices,payments,fee-invoices"
      }
    }
  }
}

Aus den Quellen

git clone https://github.com/ialejandro/mcp-malt
cd mcp-malt
npm ci && npm run build

{
  "mcpServers": {
    "malt": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-malt/dist/index.js"],
      "env": {
        "MALT_API_TOKEN": "your-token-here",
        "MALT_TOOLSETS": "invoices,payments,fee-invoices"
      }
    }
  }
}

{
  "mcpServers": {
    "malt": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "MALT_API_TOKEN",
        "-e", "MALT_TOOLSETS",
        "ghcr.io/ialejandro/mcp-malt"
      ],
      "env": {
        "MALT_API_TOKEN": "your-token-here",
        "MALT_TOOLSETS": "invoices,payments,fee-invoices"
      }
    }
  }
}

Konfiguration

Ohne MALT_TOOLSETS startet der Server und stellt nichts bereit. Das ist gewollt und kein Fehler: Du entscheidest, was ein Modell zu Gesicht bekommen darf. Toolsets nacheinander hinzufügen.

Ein unbekannter Toolsetname stoppt den Server mit Fehlermeldung, anstatt ignoriert werden wird, denn ein Tippfehler, der dir drei Tools kostet, ist sonst mühsam zu debuggen.

Häufige Aufgaben

Ein Quartal abschließen. Aktiviere clean invoices,payments,fee-invoices und führe das Prompt malt_reconcile_revenue aus. Es zieht alle drei Listen, gleicht Zahlungen der Rechnungen zu, die dabei beglichen werden, und meldet Bruttobetrag, Steuer, Maltes Kommission und eingegangene Zahlungen.

reconcile meiner Malt-Einnahmen für Q1 2026.

Drucke eine Rechnungs-PDF ab. Malt liefert PDFs innerhalb einer JSON-Bases. Die Tools dekodieren sie und geben dir einen echten PDF-Anhang zurück.

Lade die PDF der Rechnung INV-123455 herunter.

Jemanden abmelden. Aktiviere scim mit MALT_ALLOW_WRITES=true nimm dazu malt_user_lifecycle. Es deaktiviert statt löschen – das ist der Weg, den Malt wirklich unterstützt.

Deaktiviere janedoe@acme.com aus unserer Malt-Organisation.

Dokumentation

• Token erhalten und verwalten

• Authentifizierung und warum es kein OAuth gibt

• Toolsets: Welche einsetzen und wann

• Jeder Endpoint, mit Requests und Responses

• Fehler und Bedeutung

• Rate Limits

• Den Server erweitern

Entwicklung

npm ci
npm run typecheck
npm test
npm run build
npm run check-spec   # diff the live Malt spec against spec/malt-openapi.json

Tests mocken fetch und rufen die Live-API niemals auf.

spec/malt-openapi.json ist ein geliefertes Snapshot des von Malt veröffentlichten Dokuments. Ein täglicher Workflow vergleicht die Live-Spec damit und erstellt einen PR, sobald sich etwas ändert. Malt hällt info.version bei 0.0.1 fest, daher prüft der Vergleich die erwarteten Saulgänge, nicht die Versionsnummer.

Mitwirken

Weitere Infos in CONTRIBUTING.md. Eine Schnittstelle oder ein Toolset hinzufügen: docs/extending.md.

Lizenz

MIT