KI-Agenten wie Claude, GPT oder Copilot können über das Model Context Protocol (MCP) auf externe Tools und APIs zugreifen. Das eröffnet Unternehmen die Möglichkeit, ihre bestehenden REST-APIs direkt in KI-gestützte Workflows einzubinden — von der automatisierten Datenabfrage bis zur Prozesssteuerung.

In der Praxis scheitert das oft an der Umsetzung: Für jede REST-API muss heute ein eigener MCP-Server programmiert werden. Das ist aufwändig, fehleranfällig und schwer wartbar — besonders wenn sich die API weiterentwickelt oder mehrere APIs gleichzeitig angebunden werden sollen.

DADL (Dunkel API Description Language) löst dieses Problem deklarativ. Eine YAML-basierte Beschreibungsdatei reicht aus, um eine beliebige REST-API als MCP-Tool bereitzustellen. Kein eigener Server, kein individueller Code — die ToolMesh-Runtime übernimmt HTTP-Aufrufe, Authentifizierung, Pagination und Fehlerbehandlung automatisch. Die Dunkel Cloud GmbH entwickelt DADL-Beschreibungen für Ihre APIs und macht sie sofort nutzbar für KI-Agenten.

Was ist eine DADL-Datei?

Eine .dadl-Datei beschreibt eine REST-API deklarativ in YAML. Sie definiert:

• Endpunkte, Parameter und HTTP-Methoden
• Authentifizierung (Bearer, OAuth2, Session-basiert)
• Pagination (Cursor, Offset, Page, Link-Header)
• Fehlerbehandlung und Retry-Strategien
• Response-Transformation (JSONPath, jq-Filter)
• Tool-Scoping für effiziente KI-Nutzung

Ein einfaches Beispiel:

version: "1.0"
backend:
  name: beispiel-api
  type: rest
  base_url: https://api.beispiel.de/v1
  auth:
    type: bearer
    credential: vault/api-key
  tools:
    kunden_auflisten:
      method: GET
      path: /customers
      description: "Alle Kunden abrufen"
      params:
        limit: { type: integer, in: query, default: 50 }

Aus dieser Beschreibung erzeugt die ToolMesh-Runtime automatisch ein MCP-Tool, das KI-Agenten direkt aufrufen können.

Leistungspakete

API Integration Starter — ab 990 €

• Für APIs mit 5–15 Endpoints
• Bearer-Token oder API-Key Authentifizierung
• Standard-Pagination
• Vollständige DADL-Datei, getestet gegen die Live-API
• Inkl. Dokumentation und Deployment-Anleitung

API Integration Professional — ab 2.490 €

• Für APIs mit 15–50 Endpoints
• OAuth2 / Session-basierte Authentifizierung
• Custom Pagination und Response-Transformation
• Tool-Scoping für optimale Token-Effizienz
• Vollständige DADL-Datei, getestet und dokumentiert

Enterprise Integration — auf Anfrage

• Für APIs mit 50+ Endpoints
• Multi-Step-Workflows über Temporal
• Code-Mode-Logik für komplexe Geschäftsprozesse
• Individuelle Beratung und Architektur

Technologie

DADL ist ein offenes Format — die Spezifikation ist unter dadl.ai einsehbar. Als Runtime-Umgebung dient ToolMesh (toolmesh.io): eine sichere Middleware-Schicht zwischen KI-Agenten und APIs. ToolMesh übernimmt Autorisierung, Credential Management, Audit Trail und Content-Prüfung. Sowohl DADL als auch ToolMesh werden von der Dunkel Cloud GmbH entwickelt und betrieben.

• Cloud
• AI
• SaaS