nextcloud-agent 2.4.2__tar.gz → 3.0.0__tar.gz

{nextcloud_agent-2.4.2 → nextcloud_agent-3.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nextcloud-agent
-Version: 2.4.2
+Version: 3.0.0
 Summary: Nextcloud MCP Server for Agentic AI!
 Author-email: Repository Maintainers <maintainers@knuckles.team>
 License: MIT
@@ -82,58 +82,151 @@ This server use dynamic Action-Routed tools to optimize token overhead and maxim
 
 ### Available MCP Tools
 
-<!-- This table is auto-generated by `python -m scion_sdk.mcp.readme_tools` — do not edit by hand. -->
 
 <!-- MCP-TOOLS-TABLE:START -->
 
-#### Condensed action-routed tools (`MCP_TOOL_MODE=condensed`)
-
-| MCP Tool | Toggle Env Var | Description |
-|----------|----------------|-------------|
-| `nextcloud_calendar` | `CALENDARTOOL` | Manage nextcloud calendar operations. |
-| `nextcloud_contacts` | `CONTACTSTOOL` | Manage nextcloud contacts operations. |
-| `nextcloud_files` | `FILESTOOL` | Manage nextcloud files operations. |
-| `nextcloud_ingest_file` | `INGESTTOOL` | Fetch a Nextcloud file over WebDAV and natively store it in the knowledge |
-| `nextcloud_sharing` | `SHARINGTOOL` | Manage nextcloud sharing operations. |
-| `nextcloud_user` | `USERTOOL` | Manage nextcloud user operations. |
-
-#### Verbose 1:1 API-mapped tools (`MCP_TOOL_MODE=verbose` or `both`)
-
-<details>
-<summary>26 per-operation tools — one per public API method (click to expand)</summary>
-
-| MCP Tool | Toggle Env Var | Description |
-|----------|----------------|-------------|
-| `nextcloud_copy_item` | `APITOOL` | Alias for copy_resource to support MCP server action. |
-| `nextcloud_copy_resource` | `APITOOL` | Copy a file or directory. |
-| `nextcloud_create_calendar_event` | `APITOOL` | Alias for create_event to support MCP server action. |
-| `nextcloud_create_contact` | `APITOOL` | Invoke the create_contact operation. |
-| `nextcloud_create_directory` | `APITOOL` | Create a directory (MKCOL). |
-| `nextcloud_create_event` | `APITOOL` | Create an event with ICS data. |
-| `nextcloud_create_folder` | `APITOOL` | Alias for create_directory to support MCP server action. |
-| `nextcloud_create_share` | `APITOOL` | Create a share. |
-| `nextcloud_delete_item` | `APITOOL` | Alias for delete_resource to support MCP server action. |
-| `nextcloud_delete_resource` | `APITOOL` | Delete a file or directory. |
-| `nextcloud_delete_share` | `APITOOL` | Delete a share. |
-| `nextcloud_get_properties` | `APITOOL` | Helper to get properties of a path by listing its contents. |
-| `nextcloud_get_user_info` | `APITOOL` | Get current user info. |
-| `nextcloud_get_user_quota` | `APITOOL` | Get storage quota information. |
-| `nextcloud_list_address_books` | `APITOOL` | List address books. |
-| `nextcloud_list_calendar_events` | `APITOOL` | Alias for list_events to support MCP server action. |
-| `nextcloud_list_calendars` | `APITOOL` | List available calendars. |
-| `nextcloud_list_contacts` | `APITOOL` | List contacts in address book. |
-| `nextcloud_list_contents` | `APITOOL` | List files and folders in a directory using PROPFIND. |
-| `nextcloud_list_events` | `APITOOL` | List events in a calendar (returns basic info). |
-| `nextcloud_list_files` | `APITOOL` | Alias for list_contents to support MCP server action. |
-| `nextcloud_list_shares` | `APITOOL` | List all shares. |
-| `nextcloud_move_item` | `APITOOL` | Alias for move_resource to support MCP server action. |
-| `nextcloud_move_resource` | `APITOOL` | Move a file or directory. |
-| `nextcloud_read_file` | `APITOOL` | Download a file. |
-| `nextcloud_write_file` | `APITOOL` | Upload a file. |
-
-</details>
-
-_6 action-routed tool(s) · 26 verbose 1:1 tool(s). Each is enabled unless its `<DOMAIN>TOOL` toggle is set false; `MCP_TOOL_MODE` selects the surface (**`intent` default** — the six verb-tools, granular set loaded on demand · `condensed` action-routed · `verbose` 1:1 · `both`). Auto-generated — do not edit._
+One typed tool per operation (89 tools), grouped by domain. Each domain is enabled unless its toggle is set false. Destructive tools ask for confirmation.
+
+**activity** (toggle `ACTIVITYTOOL`)
+
+| MCP Tool | Description |
+|----------|-------------|
+| `nextcloud_dismiss_notification` | Dismiss one notification. |
+| `nextcloud_list_activities` | Read the activity stream, newest first; narrow to one object (``object_type="files"`` with a file id) when given. |
+| `nextcloud_list_notifications` | List the account's current notifications. |
+
+**admin** (toggle `ADMINTOOL`)
+
+| MCP Tool | Description |
+|----------|-------------|
+| `nextcloud_add_user_to_group` | Add one account to a group. |
+| `nextcloud_create_group` | Create one group. |
+| `nextcloud_create_user` | Create one account. Give a password, or an email for a set-password invite. |
+| `nextcloud_delete_group` | Delete one group (its members keep their accounts). |
+| `nextcloud_delete_user` | Delete one account and its files. |
+| `nextcloud_disable_app` | Disable one app. |
+| `nextcloud_disable_user` | Disable one account (it can no longer log in; data is kept). |
+| `nextcloud_enable_app` | Enable one installed app. |
+| `nextcloud_enable_user` | Enable one disabled account. |
+| `nextcloud_get_app` | Read one installed app's metadata (name, version, dependencies). |
+| `nextcloud_get_user` | Read one account's details. |
+| `nextcloud_get_user_info` | Read the connected account: id, display name, email, quota, groups. |
+| `nextcloud_list_apps` | List installed app ids that are enabled, disabled, or all of them. |
+| `nextcloud_list_group_members` | List the account ids in one group. |
+| `nextcloud_list_groups` | List group ids, optionally matching a search string. |
+| `nextcloud_list_users` | List account ids, optionally matching a search string. |
+| `nextcloud_remove_user_from_group` | Remove one account from a group. |
+| `nextcloud_update_user` | Change one field of an account. |
+
+**calendar** (toggle `CALENDARTOOL`)
+
+| MCP Tool | Description |
+|----------|-------------|
+| `nextcloud_create_calendar` | Create one calendar that holds events and, by default, tasks. |
+| `nextcloud_create_event` | Create one event. Attendees get a draft invitation unless ``send_invitations``. |
+| `nextcloud_create_task` | Create one task (VTODO) in a task-capable calendar (the Tasks app shows it). |
+| `nextcloud_delete_calendar` | Delete one calendar and everything in it (it moves to the calendar trash). |
+| `nextcloud_delete_calendar_object` | Delete one event or task. |
+| `nextcloud_get_calendar_object` | Read one event or task: its parsed fields, etag and raw iCalendar text. |
+| `nextcloud_list_calendars` | List the account's calendars and the components (VEVENT, VTODO) each holds. |
+| `nextcloud_list_events` | List the events of one calendar, optionally within an ISO time range. |
+| `nextcloud_list_tasks` | List the tasks (VTODO) of one task-capable calendar. |
+| `nextcloud_update_event` | Change one event's fields; the write is guarded by the event's etag. |
+| `nextcloud_update_task` | Change one task, or mark it complete or open again; guarded by its etag. |
+
+**contacts** (toggle `CONTACTSTOOL`)
+
+| MCP Tool | Description |
+|----------|-------------|
+| `nextcloud_create_contact` | Create one contact in an address book. |
+| `nextcloud_delete_contact` | Delete one contact. |
+| `nextcloud_get_contact` | Read one contact: parsed fields, etag and the raw vCard. |
+| `nextcloud_list_address_books` | List the account's address books. |
+| `nextcloud_list_contacts` | List the contacts of one address book with name, emails, phones and organization. |
+| `nextcloud_update_contact` | Change one contact; omitted fields keep their value. Guarded by the etag. |
+
+**deck** (toggle `DECKTOOL`)
+
+| MCP Tool | Description |
+|----------|-------------|
+| `nextcloud_assign_card_user` | Assign one user to a card. |
+| `nextcloud_create_board` | Create one board; ``color`` is a hex RGB value without ``#``. |
+| `nextcloud_create_card` | Create one card in a stack; ``duedate`` is ISO 8601. |
+| `nextcloud_create_stack` | Create one stack (column) on a board. |
+| `nextcloud_delete_board` | Delete one board (Deck keeps it restorable for a while). |
+| `nextcloud_delete_card` | Delete one card. |
+| `nextcloud_delete_stack` | Delete one stack and its cards. |
+| `nextcloud_get_board` | Read one board with its labels and members. |
+| `nextcloud_get_card` | Read one card. |
+| `nextcloud_list_boards` | List the Deck boards the account can see. |
+| `nextcloud_list_stacks` | List the stacks (columns) of one board, each with its cards. |
+| `nextcloud_move_card` | Move one card to a stack (column) of the board, at position ``order``. |
+| `nextcloud_update_card` | Change one card's title, description or due date. |
+
+**files** (toggle `FILESTOOL`)
+
+| MCP Tool | Description |
+|----------|-------------|
+| `nextcloud_copy_item` | Copy one file or folder. |
+| `nextcloud_create_folder` | Create one folder. |
+| `nextcloud_delete_item` | Delete one file or folder (it moves to the trash bin). |
+| `nextcloud_get_properties` | Read the properties of one file or folder (size, type, etag, file id). |
+| `nextcloud_get_user_quota` | Read the storage quota of the connected account. |
+| `nextcloud_list_files` | List the files and folders in one folder (PROPFIND, depth 1). |
+| `nextcloud_list_trash` | List the items in the trash bin of the connected account. |
+| `nextcloud_list_versions` | List the stored versions of one file, newest first. |
+| `nextcloud_move_item` | Move or rename one file or folder. |
+| `nextcloud_read_file` | Download one file; the bytes come back base64-encoded. |
+| `nextcloud_restore_trash_item` | Restore one trash-bin item to its original location. |
+| `nextcloud_restore_version` | Restore one stored version of a file; the current content becomes a version. |
+| `nextcloud_search_files` | Search files by name (case-insensitive substring) under one folder. |
+| `nextcloud_write_file` | Upload one file, creating missing parent folders. |
+
+**notes** (toggle `NOTESTOOL`)
+
+| MCP Tool | Description |
+|----------|-------------|
+| `nextcloud_create_note` | Create one note. |
+| `nextcloud_delete_note` | Delete one note. |
+| `nextcloud_get_note` | Read one note with its content. |
+| `nextcloud_list_notes` | List the account's notes, optionally of one category. |
+| `nextcloud_update_note` | Change one note's title, content, category or favorite flag. |
+
+**office** (toggle `OFFICETOOL`)
+
+| MCP Tool | Description |
+|----------|-------------|
+| `nextcloud_create_document` | Create one new document at ``path``; the extension picks the type (``.docx``, ``.xlsx``, ``.pptx``, ``.odg``, ``.md``). |
+| `nextcloud_list_document_templates` | List the document types the server can create (document, spreadsheet, presentation, diagram, markdown) with their extensions and templates. |
+| `nextcloud_open_document` | Open one document for editing and return a one-time editor ``url`` for the connected account (Office for office files, Text for markdown). |
+
+**shares** (toggle `SHARESTOOL`)
+
+| MCP Tool | Description |
+|----------|-------------|
+| `nextcloud_create_share` | Share one file or folder and return the share (a public link carries its ``url``). |
+| `nextcloud_delete_share` | Revoke one share. |
+| `nextcloud_get_share` | Read one share by id. |
+| `nextcloud_list_shares` | List shares: all of the account's shares, the shares on one path, or the shares other people gave the account. |
+| `nextcloud_update_share` | Change one share's permissions, password, expiry, label or note. |
+
+**talk** (toggle `TALKTOOL`)
+
+| MCP Tool | Description |
+|----------|-------------|
+| `nextcloud_add_participant` | Add a user, group, email guest or team to one conversation. |
+| `nextcloud_create_conversation` | Create one conversation and return it with its ``token``. |
+| `nextcloud_delete_conversation` | Delete one conversation for everyone (moderators only). |
+| `nextcloud_delete_message` | Delete one chat message. |
+| `nextcloud_get_conversation` | Read one conversation by its token. |
+| `nextcloud_list_conversations` | List the conversations the account takes part in. |
+| `nextcloud_list_messages` | Read the chat history of one conversation, newest first. |
+| `nextcloud_list_participants` | List the participants of one conversation. |
+| `nextcloud_remove_participant` | Remove one attendee (by attendee id from list_participants) from a conversation. |
+| `nextcloud_rename_conversation` | Rename one conversation. |
+| `nextcloud_send_message` | Post one chat message to a conversation. |
+
+
 <!-- MCP-TOOLS-TABLE:END -->
 
 Detailed tool schemas, parameter shapes, and validation constraints are preserved in [docs/usage.md](docs/usage.md).
@@ -187,8 +280,8 @@ When query strings or parameters are supplied, an LLM-free **Knowledge Graph res
         "NEXTCLOUD_PASSWORD": "your_password",
         "NEXTCLOUD_URL": "https://nextcloud.example.com",
         "NEXTCLOUD_USERNAME": "your_username",
-        "SHARINGTOOL": "True",
-        "USERTOOL": "True"
+        "SHARESTOOL": "True",
+        "ADMINTOOL": "True"
       }
     }
   }
@@ -225,8 +318,8 @@ own runtime secret boundary.
         "NEXTCLOUD_PASSWORD": "your_password",
         "NEXTCLOUD_URL": "https://nextcloud.example.com",
         "NEXTCLOUD_USERNAME": "your_username",
-        "SHARINGTOOL": "True",
-        "USERTOOL": "True"
+        "SHARESTOOL": "True",
+        "ADMINTOOL": "True"
       }
     }
   }
@@ -264,8 +357,8 @@ docker run -i --rm \
   -e NEXTCLOUD_PASSWORD=your_password \
   -e NEXTCLOUD_URL=https://nextcloud.example.com \
   -e NEXTCLOUD_USERNAME=your_username \
-  -e SHARINGTOOL=True \
-  -e USERTOOL=True \
+  -e SHARESTOOL=True \
+  -e ADMINTOOL=True \
   registry.example.invalid/nextcloud-agent@sha256:<digest> nextcloud-mcp
 ```
 
@@ -426,8 +519,8 @@ Built directly upon the enterprise-ready [`scion-sdk`](https://github.com/Knuckl
 | `TLS_PROFILE_REF` | `secret://transport/provider` | Direct runtime profile reference |
 | `TLS_PROFILES_REF` | `secret://transport/catalog` | Named runtime profile catalog |
 | `FILESTOOL` | `True` |  |
-| `USERTOOL` | `True` |  |
-| `SHARINGTOOL` | `True` |  |
+| `ADMINTOOL` | `True` |  |
+| `SHARESTOOL` | `True` |  |
 | `CALENDARTOOL` | `True` |  |
 | `CONTACTSTOOL` | `True` |  |
 
@@ -473,8 +566,8 @@ for a copy-paste starting point.
 | `MCP_ENABLED_TAGS` / `MCP_DISABLED_TAGS` | Comma-separated tag allow/deny list | — |
 
 ### Tool toggles
-Each action-routed tool can be disabled individually via its toggle env var (set to `false`):
-`FILESTOOL`, `USERTOOL`, `SHARINGTOOL`, `CALENDARTOOL`, `CONTACTSTOOL`. See the
+Each tool domain can be disabled via its toggle env var (set to `false`):
+`FILESTOOL`, `SHARESTOOL`, `CALENDARTOOL`, `CONTACTSTOOL`, `TALKTOOL`, `DECKTOOL`, `NOTESTOOL`, `OFFICETOOL`, `ACTIVITYTOOL`, `ADMINTOOL`. See the
 [Available MCP Tools](#available-mcp-tools) table above.
 
 ### Telemetry & governance
@@ -553,7 +646,7 @@ the recommended reference for installation, deployment, and day-to-day operation
 | [Deployment](https://knuckles-team.github.io/nextcloud-agent/deployment/) | run the MCP server and the agent, Compose, Caddy + Technitium, env config |
 | [Usage](https://knuckles-team.github.io/nextcloud-agent/usage/) | the MCP tools, the `NextcloudAPI` client, the agent CLI |
 | [Backing Platform](https://knuckles-team.github.io/nextcloud-agent/platform/) | deploy Nextcloud with Docker |
-| [Overview](https://knuckles-team.github.io/nextcloud-agent/overview/) | the action-routed tool surface and ecosystem role |
+| [Overview](https://knuckles-team.github.io/nextcloud-agent/overview/) | the per-operation tool surface and ecosystem role |
 | [Concepts](https://knuckles-team.github.io/nextcloud-agent/concepts/) | concept registry (`CONCEPT:NC-*`) |
 
 ---

{nextcloud_agent-2.4.2 → nextcloud_agent-3.0.0}/README.md

@@ -55,58 +55,151 @@ This server use dynamic Action-Routed tools to optimize token overhead and maxim
 
 ### Available MCP Tools
 
-<!-- This table is auto-generated by `python -m scion_sdk.mcp.readme_tools` — do not edit by hand. -->
 
 <!-- MCP-TOOLS-TABLE:START -->
 
-#### Condensed action-routed tools (`MCP_TOOL_MODE=condensed`)
-
-| MCP Tool | Toggle Env Var | Description |
-|----------|----------------|-------------|
-| `nextcloud_calendar` | `CALENDARTOOL` | Manage nextcloud calendar operations. |
-| `nextcloud_contacts` | `CONTACTSTOOL` | Manage nextcloud contacts operations. |
-| `nextcloud_files` | `FILESTOOL` | Manage nextcloud files operations. |
-| `nextcloud_ingest_file` | `INGESTTOOL` | Fetch a Nextcloud file over WebDAV and natively store it in the knowledge |
-| `nextcloud_sharing` | `SHARINGTOOL` | Manage nextcloud sharing operations. |
-| `nextcloud_user` | `USERTOOL` | Manage nextcloud user operations. |
-
-#### Verbose 1:1 API-mapped tools (`MCP_TOOL_MODE=verbose` or `both`)
-
-<details>
-<summary>26 per-operation tools — one per public API method (click to expand)</summary>
-
-| MCP Tool | Toggle Env Var | Description |
-|----------|----------------|-------------|
-| `nextcloud_copy_item` | `APITOOL` | Alias for copy_resource to support MCP server action. |
-| `nextcloud_copy_resource` | `APITOOL` | Copy a file or directory. |
-| `nextcloud_create_calendar_event` | `APITOOL` | Alias for create_event to support MCP server action. |
-| `nextcloud_create_contact` | `APITOOL` | Invoke the create_contact operation. |
-| `nextcloud_create_directory` | `APITOOL` | Create a directory (MKCOL). |
-| `nextcloud_create_event` | `APITOOL` | Create an event with ICS data. |
-| `nextcloud_create_folder` | `APITOOL` | Alias for create_directory to support MCP server action. |
-| `nextcloud_create_share` | `APITOOL` | Create a share. |
-| `nextcloud_delete_item` | `APITOOL` | Alias for delete_resource to support MCP server action. |
-| `nextcloud_delete_resource` | `APITOOL` | Delete a file or directory. |
-| `nextcloud_delete_share` | `APITOOL` | Delete a share. |
-| `nextcloud_get_properties` | `APITOOL` | Helper to get properties of a path by listing its contents. |
-| `nextcloud_get_user_info` | `APITOOL` | Get current user info. |
-| `nextcloud_get_user_quota` | `APITOOL` | Get storage quota information. |
-| `nextcloud_list_address_books` | `APITOOL` | List address books. |
-| `nextcloud_list_calendar_events` | `APITOOL` | Alias for list_events to support MCP server action. |
-| `nextcloud_list_calendars` | `APITOOL` | List available calendars. |
-| `nextcloud_list_contacts` | `APITOOL` | List contacts in address book. |
-| `nextcloud_list_contents` | `APITOOL` | List files and folders in a directory using PROPFIND. |
-| `nextcloud_list_events` | `APITOOL` | List events in a calendar (returns basic info). |
-| `nextcloud_list_files` | `APITOOL` | Alias for list_contents to support MCP server action. |
-| `nextcloud_list_shares` | `APITOOL` | List all shares. |
-| `nextcloud_move_item` | `APITOOL` | Alias for move_resource to support MCP server action. |
-| `nextcloud_move_resource` | `APITOOL` | Move a file or directory. |
-| `nextcloud_read_file` | `APITOOL` | Download a file. |
-| `nextcloud_write_file` | `APITOOL` | Upload a file. |
-
-</details>
-
-_6 action-routed tool(s) · 26 verbose 1:1 tool(s). Each is enabled unless its `<DOMAIN>TOOL` toggle is set false; `MCP_TOOL_MODE` selects the surface (**`intent` default** — the six verb-tools, granular set loaded on demand · `condensed` action-routed · `verbose` 1:1 · `both`). Auto-generated — do not edit._
+One typed tool per operation (89 tools), grouped by domain. Each domain is enabled unless its toggle is set false. Destructive tools ask for confirmation.
+
+**activity** (toggle `ACTIVITYTOOL`)
+
+| MCP Tool | Description |
+|----------|-------------|
+| `nextcloud_dismiss_notification` | Dismiss one notification. |
+| `nextcloud_list_activities` | Read the activity stream, newest first; narrow to one object (``object_type="files"`` with a file id) when given. |
+| `nextcloud_list_notifications` | List the account's current notifications. |
+
+**admin** (toggle `ADMINTOOL`)
+
+| MCP Tool | Description |
+|----------|-------------|
+| `nextcloud_add_user_to_group` | Add one account to a group. |
+| `nextcloud_create_group` | Create one group. |
+| `nextcloud_create_user` | Create one account. Give a password, or an email for a set-password invite. |
+| `nextcloud_delete_group` | Delete one group (its members keep their accounts). |
+| `nextcloud_delete_user` | Delete one account and its files. |
+| `nextcloud_disable_app` | Disable one app. |
+| `nextcloud_disable_user` | Disable one account (it can no longer log in; data is kept). |
+| `nextcloud_enable_app` | Enable one installed app. |
+| `nextcloud_enable_user` | Enable one disabled account. |
+| `nextcloud_get_app` | Read one installed app's metadata (name, version, dependencies). |
+| `nextcloud_get_user` | Read one account's details. |
+| `nextcloud_get_user_info` | Read the connected account: id, display name, email, quota, groups. |
+| `nextcloud_list_apps` | List installed app ids that are enabled, disabled, or all of them. |
+| `nextcloud_list_group_members` | List the account ids in one group. |
+| `nextcloud_list_groups` | List group ids, optionally matching a search string. |
+| `nextcloud_list_users` | List account ids, optionally matching a search string. |
+| `nextcloud_remove_user_from_group` | Remove one account from a group. |
+| `nextcloud_update_user` | Change one field of an account. |
+
+**calendar** (toggle `CALENDARTOOL`)
+
+| MCP Tool | Description |
+|----------|-------------|
+| `nextcloud_create_calendar` | Create one calendar that holds events and, by default, tasks. |
+| `nextcloud_create_event` | Create one event. Attendees get a draft invitation unless ``send_invitations``. |
+| `nextcloud_create_task` | Create one task (VTODO) in a task-capable calendar (the Tasks app shows it). |
+| `nextcloud_delete_calendar` | Delete one calendar and everything in it (it moves to the calendar trash). |
+| `nextcloud_delete_calendar_object` | Delete one event or task. |
+| `nextcloud_get_calendar_object` | Read one event or task: its parsed fields, etag and raw iCalendar text. |
+| `nextcloud_list_calendars` | List the account's calendars and the components (VEVENT, VTODO) each holds. |
+| `nextcloud_list_events` | List the events of one calendar, optionally within an ISO time range. |
+| `nextcloud_list_tasks` | List the tasks (VTODO) of one task-capable calendar. |
+| `nextcloud_update_event` | Change one event's fields; the write is guarded by the event's etag. |
+| `nextcloud_update_task` | Change one task, or mark it complete or open again; guarded by its etag. |
+
+**contacts** (toggle `CONTACTSTOOL`)
+
+| MCP Tool | Description |
+|----------|-------------|
+| `nextcloud_create_contact` | Create one contact in an address book. |
+| `nextcloud_delete_contact` | Delete one contact. |
+| `nextcloud_get_contact` | Read one contact: parsed fields, etag and the raw vCard. |
+| `nextcloud_list_address_books` | List the account's address books. |
+| `nextcloud_list_contacts` | List the contacts of one address book with name, emails, phones and organization. |
+| `nextcloud_update_contact` | Change one contact; omitted fields keep their value. Guarded by the etag. |
+
+**deck** (toggle `DECKTOOL`)
+
+| MCP Tool | Description |
+|----------|-------------|
+| `nextcloud_assign_card_user` | Assign one user to a card. |
+| `nextcloud_create_board` | Create one board; ``color`` is a hex RGB value without ``#``. |
+| `nextcloud_create_card` | Create one card in a stack; ``duedate`` is ISO 8601. |
+| `nextcloud_create_stack` | Create one stack (column) on a board. |
+| `nextcloud_delete_board` | Delete one board (Deck keeps it restorable for a while). |
+| `nextcloud_delete_card` | Delete one card. |
+| `nextcloud_delete_stack` | Delete one stack and its cards. |
+| `nextcloud_get_board` | Read one board with its labels and members. |
+| `nextcloud_get_card` | Read one card. |
+| `nextcloud_list_boards` | List the Deck boards the account can see. |
+| `nextcloud_list_stacks` | List the stacks (columns) of one board, each with its cards. |
+| `nextcloud_move_card` | Move one card to a stack (column) of the board, at position ``order``. |
+| `nextcloud_update_card` | Change one card's title, description or due date. |
+
+**files** (toggle `FILESTOOL`)
+
+| MCP Tool | Description |
+|----------|-------------|
+| `nextcloud_copy_item` | Copy one file or folder. |
+| `nextcloud_create_folder` | Create one folder. |
+| `nextcloud_delete_item` | Delete one file or folder (it moves to the trash bin). |
+| `nextcloud_get_properties` | Read the properties of one file or folder (size, type, etag, file id). |
+| `nextcloud_get_user_quota` | Read the storage quota of the connected account. |
+| `nextcloud_list_files` | List the files and folders in one folder (PROPFIND, depth 1). |
+| `nextcloud_list_trash` | List the items in the trash bin of the connected account. |
+| `nextcloud_list_versions` | List the stored versions of one file, newest first. |
+| `nextcloud_move_item` | Move or rename one file or folder. |
+| `nextcloud_read_file` | Download one file; the bytes come back base64-encoded. |
+| `nextcloud_restore_trash_item` | Restore one trash-bin item to its original location. |
+| `nextcloud_restore_version` | Restore one stored version of a file; the current content becomes a version. |
+| `nextcloud_search_files` | Search files by name (case-insensitive substring) under one folder. |
+| `nextcloud_write_file` | Upload one file, creating missing parent folders. |
+
+**notes** (toggle `NOTESTOOL`)
+
+| MCP Tool | Description |
+|----------|-------------|
+| `nextcloud_create_note` | Create one note. |
+| `nextcloud_delete_note` | Delete one note. |
+| `nextcloud_get_note` | Read one note with its content. |
+| `nextcloud_list_notes` | List the account's notes, optionally of one category. |
+| `nextcloud_update_note` | Change one note's title, content, category or favorite flag. |
+
+**office** (toggle `OFFICETOOL`)
+
+| MCP Tool | Description |
+|----------|-------------|
+| `nextcloud_create_document` | Create one new document at ``path``; the extension picks the type (``.docx``, ``.xlsx``, ``.pptx``, ``.odg``, ``.md``). |
+| `nextcloud_list_document_templates` | List the document types the server can create (document, spreadsheet, presentation, diagram, markdown) with their extensions and templates. |
+| `nextcloud_open_document` | Open one document for editing and return a one-time editor ``url`` for the connected account (Office for office files, Text for markdown). |
+
+**shares** (toggle `SHARESTOOL`)
+
+| MCP Tool | Description |
+|----------|-------------|
+| `nextcloud_create_share` | Share one file or folder and return the share (a public link carries its ``url``). |
+| `nextcloud_delete_share` | Revoke one share. |
+| `nextcloud_get_share` | Read one share by id. |
+| `nextcloud_list_shares` | List shares: all of the account's shares, the shares on one path, or the shares other people gave the account. |
+| `nextcloud_update_share` | Change one share's permissions, password, expiry, label or note. |
+
+**talk** (toggle `TALKTOOL`)
+
+| MCP Tool | Description |
+|----------|-------------|
+| `nextcloud_add_participant` | Add a user, group, email guest or team to one conversation. |
+| `nextcloud_create_conversation` | Create one conversation and return it with its ``token``. |
+| `nextcloud_delete_conversation` | Delete one conversation for everyone (moderators only). |
+| `nextcloud_delete_message` | Delete one chat message. |
+| `nextcloud_get_conversation` | Read one conversation by its token. |
+| `nextcloud_list_conversations` | List the conversations the account takes part in. |
+| `nextcloud_list_messages` | Read the chat history of one conversation, newest first. |
+| `nextcloud_list_participants` | List the participants of one conversation. |
+| `nextcloud_remove_participant` | Remove one attendee (by attendee id from list_participants) from a conversation. |
+| `nextcloud_rename_conversation` | Rename one conversation. |
+| `nextcloud_send_message` | Post one chat message to a conversation. |
+
+
 <!-- MCP-TOOLS-TABLE:END -->
 
 Detailed tool schemas, parameter shapes, and validation constraints are preserved in [docs/usage.md](docs/usage.md).
@@ -160,8 +253,8 @@ When query strings or parameters are supplied, an LLM-free **Knowledge Graph res
         "NEXTCLOUD_PASSWORD": "your_password",
         "NEXTCLOUD_URL": "https://nextcloud.example.com",
         "NEXTCLOUD_USERNAME": "your_username",
-        "SHARINGTOOL": "True",
-        "USERTOOL": "True"
+        "SHARESTOOL": "True",
+        "ADMINTOOL": "True"
       }
     }
   }
@@ -198,8 +291,8 @@ own runtime secret boundary.
         "NEXTCLOUD_PASSWORD": "your_password",
         "NEXTCLOUD_URL": "https://nextcloud.example.com",
         "NEXTCLOUD_USERNAME": "your_username",
-        "SHARINGTOOL": "True",
-        "USERTOOL": "True"
+        "SHARESTOOL": "True",
+        "ADMINTOOL": "True"
       }
     }
   }
@@ -237,8 +330,8 @@ docker run -i --rm \
   -e NEXTCLOUD_PASSWORD=your_password \
   -e NEXTCLOUD_URL=https://nextcloud.example.com \
   -e NEXTCLOUD_USERNAME=your_username \
-  -e SHARINGTOOL=True \
-  -e USERTOOL=True \
+  -e SHARESTOOL=True \
+  -e ADMINTOOL=True \
   registry.example.invalid/nextcloud-agent@sha256:<digest> nextcloud-mcp
 ```
 
@@ -399,8 +492,8 @@ Built directly upon the enterprise-ready [`scion-sdk`](https://github.com/Knuckl
 | `TLS_PROFILE_REF` | `secret://transport/provider` | Direct runtime profile reference |
 | `TLS_PROFILES_REF` | `secret://transport/catalog` | Named runtime profile catalog |
 | `FILESTOOL` | `True` |  |
-| `USERTOOL` | `True` |  |
-| `SHARINGTOOL` | `True` |  |
+| `ADMINTOOL` | `True` |  |
+| `SHARESTOOL` | `True` |  |
 | `CALENDARTOOL` | `True` |  |
 | `CONTACTSTOOL` | `True` |  |
 
@@ -446,8 +539,8 @@ for a copy-paste starting point.
 | `MCP_ENABLED_TAGS` / `MCP_DISABLED_TAGS` | Comma-separated tag allow/deny list | — |
 
 ### Tool toggles
-Each action-routed tool can be disabled individually via its toggle env var (set to `false`):
-`FILESTOOL`, `USERTOOL`, `SHARINGTOOL`, `CALENDARTOOL`, `CONTACTSTOOL`. See the
+Each tool domain can be disabled via its toggle env var (set to `false`):
+`FILESTOOL`, `SHARESTOOL`, `CALENDARTOOL`, `CONTACTSTOOL`, `TALKTOOL`, `DECKTOOL`, `NOTESTOOL`, `OFFICETOOL`, `ACTIVITYTOOL`, `ADMINTOOL`. See the
 [Available MCP Tools](#available-mcp-tools) table above.
 
 ### Telemetry & governance
@@ -526,7 +619,7 @@ the recommended reference for installation, deployment, and day-to-day operation
 | [Deployment](https://knuckles-team.github.io/nextcloud-agent/deployment/) | run the MCP server and the agent, Compose, Caddy + Technitium, env config |
 | [Usage](https://knuckles-team.github.io/nextcloud-agent/usage/) | the MCP tools, the `NextcloudAPI` client, the agent CLI |
 | [Backing Platform](https://knuckles-team.github.io/nextcloud-agent/platform/) | deploy Nextcloud with Docker |
-| [Overview](https://knuckles-team.github.io/nextcloud-agent/overview/) | the action-routed tool surface and ecosystem role |
+| [Overview](https://knuckles-team.github.io/nextcloud-agent/overview/) | the per-operation tool surface and ecosystem role |
 | [Concepts](https://knuckles-team.github.io/nextcloud-agent/concepts/) | concept registry (`CONCEPT:NC-*`) |
 
 ---

nextcloud_agent-3.0.0/nextcloud_agent/__init__.py

@@ -0,0 +1,14 @@
+from scion_sdk.connector import Connector
+
+from nextcloud_agent.api_client import NextcloudAPI
+from nextcloud_agent.auth import make_client
+
+connector = Connector(
+    api=NextcloudAPI,
+    get_client=make_client,
+    instructions=(
+        "Nextcloud MCP server: one typed tool per operation for files, versions, search, "
+        "sharing, calendar, tasks, contacts, Talk, Deck, Notes, office documents, activity, "
+        "notifications and user, group and app administration."
+    ),
+)

nextcloud_agent-3.0.0/nextcloud_agent/api/__init__.py

@@ -0,0 +1,25 @@
+from nextcloud_agent.api.api_client_activity import NextcloudActivity
+from nextcloud_agent.api.api_client_admin import NextcloudAdmin
+from nextcloud_agent.api.api_client_calendar import NextcloudCalendar
+from nextcloud_agent.api.api_client_contacts import NextcloudContacts
+from nextcloud_agent.api.api_client_deck import NextcloudDeck
+from nextcloud_agent.api.api_client_files import NextcloudFiles
+from nextcloud_agent.api.api_client_notes import NextcloudNotes
+from nextcloud_agent.api.api_client_office import NextcloudOffice
+from nextcloud_agent.api.api_client_shares import NextcloudShares
+from nextcloud_agent.api.api_client_talk import NextcloudTalk
+
+
+class Api(
+    NextcloudFiles,
+    NextcloudShares,
+    NextcloudCalendar,
+    NextcloudContacts,
+    NextcloudTalk,
+    NextcloudDeck,
+    NextcloudNotes,
+    NextcloudActivity,
+    NextcloudAdmin,
+    NextcloudOffice,
+):
+    """Unified Nextcloud API client combining the per-domain sub-clients."""