Changelog

Changes to the MCP server. The server is in beta: tools and their arguments may change between versions. Open API changes are listed in the Open API changelog.

November 2026

  • The pages were gone through against the server's code: the tools page lists all 55 tools with their arguments, limits and who may use them, and says which tools return a cms_url
  • list_expiring_certificates counts only each employee's latest issuance of a certificate, and leaves out kiosk users and users excluded from statistics
  • get_survey_results without survey_id lists the 25 newest surveys whose results the caller may read, with id, title and number of runs, and no paging
  • add_quiz rejects a max_incorrect_answers above one less than the number of questions, and assign_course rejects more than 100 user_ids or 50 group_ids; neither is lowered to the limit
  • compose_article on an article that belongs to other content also needs that content's write scope, for example write:handbooks for a handbook chapter
  • The CMS tab for MCP is called MCP, under Open API; only admins see it and create tokens there
  • call_open_api calls count against the company's Open API rate limit per signed-in user, since each runs on a token made for that one call
  • get_academy_stats with per_department: true splits each department's course completion per course in by_course, next to the pooled totals. A new course_ids argument limits the courses counted, with or without per_department
  • get_article with include_element_ids says which blocks have no translation in the requested locale. Their tag reads no "fr" translation yet, showing the main-language text, since such a block falls back to the main language
  • list_handbooks, list_courses, list_walls and list_groups are paged: they take cursor and return total, has_more and next_cursor, 25 handbooks or courses a page. list_journeys returns total and has_more, which is true when the 25 it shows are not all
  • get_form_responses returns each response's reference, deadline, assignees and whether it is archived, and its answers as a list of field_id, title and value, so fields that share a title each keep their answer. archived: true lists the archived responses instead of the open ones
  • get_form_alarms returns each alarm's response reference, as the CMS shows it
  • call_open_api refuses to create webhooks (a POST to webhooks or incoming-webhooks), since the token made for the call is deleted right after it and would own them
  • search_users takes staff_card: missing to list the employees without a published, unexpired staff card of their own. A card shared with a group doesn't count, and kiosk, deactivated and departed users are left out

October 2026

  • get_org_chart returns the description an admin wrote on a person's box, in the tree and on a person lookup
  • New create_wall tool: creates a social wall with name, description, target groups and a cover image (cover_media_id from upload_media). Saved as a draft unless is_published: true. Admins and editors; editors can only target groups they manage or edit
  • New update_wall tool: changes a wall's name, description, groups or cover, and publishes or unpublishes it. Only the arguments passed change; remove_cover: true removes the cover
  • Both wall tools are only offered while walls are enabled for the company
  • New write:walls scope for both wall tools. Tokens made before this change lack it: create a new one with Create MCP token on the MCP tab
  • New set_cover tool: replaces the cover image of an existing handbook, course or chapter with an image stored with upload_media. A chapter is picked by its article_id. On published content the new cover reaches employees immediately
  • create_handbook, create_course and add_chapter take an optional cover_media_id: an image stored with upload_media becomes the cover of the new handbook, course or chapter
  • get_ai_chat_insights is for admins and global editors only; group editors no longer get it, since the report covers the whole company
  • list_journeys lists the preboarding journey first and filters on type: preboarding, while preboarding is enabled for the company
  • assign_journey refuses the preboarding journey: it takes no groups and reaches the people its items reach
  • New get_ai_chat_insights tool: content gaps from what employees asked the AI chat, each with the content to write and redacted examples of the questions, plus where the AI chat helped and the most-cited content. Reads the latest report from the CMS AI Chat insights page. Needs the AI chat feature
  • New list_collections tool: handbook, course and form collections with the items each holds, the place to find a collection id or which collection an item is in
  • preview_audience takes entity_type: journey to read a journey's target groups. A journey also only reaches the people its items reach
  • New list_announcements tool: announcements newest first with publication date and target groups, filtered with from/to; include_drafts adds unpublished ones
  • New list_journeys tool: a catalogue of journeys with type, publication status, item count and target groups, the place to find a journey id for get_journey
  • add_quiz takes a type on each question: choices (default), boolean (a true/false statement with answer), order (choices listed in the correct order) or pairs (each choice with its pair)
  • search_users filters by source (manual or synced) and registration, works without a query, returns up to 100 rows per call and pages with cursor/next_cursor

September 2026

  • New create_calendar_entry tool: creates a calendar entry as a draft. Set mute_notifications to skip the day-of notification for the entry

  • create_event takes an optional cover_media_id: an image stored with upload_media becomes the event's cover

  • Public beta. One MCP server per company at /mcp, enabled per company by Monotree

  • Sign in with a Monotree account (OAuth 2.1 with PKCE and automatic client registration) for admins, editors and managers, or authenticate with an Open API token. Create MCP token on the MCP tab creates a token with the right scopes

  • 46 tools across content, people, communication, training, forms, insights and media, plus the monotree://locales and monotree://org-structure resources

  • Write tools accept an optional locale; new content defaults to the company's content language, additions to the language of the item they extend

  • Connected clients are listed and can be disconnected under Open API → MCP; every call is logged with client attribution