mcp

listify-api/README.md

@@ -106,6 +106,40 @@ Der Server erzeugt beim MCP-Initialize eine Session. Folge-Requests muessen den
   - Output enthaelt `suggestions` mit `name`, `description`, `kind`, `items`, optionalem Template-Bezug und `rationale`.
   - Schreibt keine Daten und legt keine Liste an.
 
+- `create_list`
+  - Erstellt eine neue Liste fuer den angemeldeten User.
+  - Input:
+
+```json
+{
+  "name": "Sommerurlaub",
+  "description": "Packliste fuer die Reise",
+  "kind": "packing",
+  "items": [
+    { "title": "Pass", "required": true },
+    { "title": "Tickets", "notes": "Digital und offline sichern" }
+  ]
+}
+```
+
+  - `items` ist optional. Wenn Items angegeben sind, werden sie nach dem Erstellen der Liste in Reihenfolge hinzugefuegt.
+  - Output enthaelt `list` mit der erstellten Liste inklusive Items.
+
+- `add_list_item`
+  - Fuegt ein Item zu einer bestehenden Liste hinzu, auf die der angemeldete User Zugriff hat.
+  - Input:
+
+```json
+{
+  "listId": "list-id",
+  "title": "Milch",
+  "quantity": 2,
+  "required": true
+}
+```
+
+  - Output enthaelt `list` mit der aktualisierten Liste.
+
 ### Minimaler MCP-Request
 
 Ein MCP-Client uebernimmt normalerweise Initialize, Session-Header und Tool-Calls selbst. Fuer eigene Tests sieht ein Tool-Call nach erfolgreicher Initialisierung sinngemaess so aus:
@@ -126,7 +160,7 @@ Ein MCP-Client uebernimmt normalerweise Initialize, Session-Header und Tool-Call
 }
 ```
 
-Wichtig: Der aktuelle Ausbau ist absichtlich read-only. Wenn ein Agent spaeter Listen direkt erstellen darf, sollte dafuer ein separates MCP-Tool mit expliziter Bestaetigung und Audit-Logging ergaenzt werden.
+Wichtig: Der aktuelle Ausbau erlaubt Erstellen von Listen und Hinzufuegen von Items. Aendern, Abhaken, Loeschen und Teilen von Listen ist ueber MCP noch nicht freigegeben.
 
 ## Deployment