# Changelog

Release notes of the Cademí MCP server at `https://mcp.cademi.dev/mcp`, newest first. `https://mcp.cademi.dev/health/ready` reports the `version` of the server that is answering. API release notes: [API changelog](https://cademi.dev/api/changelog.md).

## 0.3.3
October 6, 2026

Current release of the server, built for API release 3.10.1. Tool names, input and output schemas, annotations and permissions are the same as in 0.3.2.

### Changed

- A path ID equal to `list`, `get`, `create`, `update` or `delete` (for example `operation_id: "list"` in `operations_items`) is refused with `INVALID_ARGUMENT` before any request is sent, with a message asking for the public ID of the resource.
- The documentation resources use "account" for the connected Cademí platform in their titles, descriptions and text: `account-settings` is "Account settings that change student experience" and `imports-and-migration` is "Importing students and migrating accounts".

## 0.3.2
October 6, 2026

Built for API release 3.10.1.

### Changed

- The descriptions of `account_usage` and `uploads_create` follow API release 3.10.1: `storage.used_bytes` is a stored total recalculated daily, the storage quota is 50 GiB, and the attachment limit is set by the account. `catalog.json` reports `api_release` 3.10.1.
- The documentation resources on access diagnosis, enrollments and terminology use plain punctuation in tables and prose. Their content is unchanged.

## 0.3.1
October 5, 2026

Built for API release 3.10.0.

### Added

- `/health/ready` reports `version`, the version of the server that is answering.

### Changed

- The 26 `support_*` tools have English titles, descriptions and input field descriptions, matching the rest of the public catalog. Names, schemas and behavior are unchanged; receipt `effects` texts are in Portuguese.
- `get_settings_context`, `get_tool_schema` and `instance_overview` use "account" for the connected Cademí platform.

## 0.3.0
October 5, 2026

Built for API release 3.10.0. The server serves agent skills through the MCP Skills extension.

### Added

- **MCP Skills extension (SEP-2640, `io.modelcontextprotocol/skills`).** The server declares the extension with `directoryRead: true` and implements `skills/list`, `skills/get` and `resources/directory/read` on every protocol revision (2025-06-18, 2025-11-25, 2026-07-28). Skills follow the Agent Skills format, are validated at startup (name equals directory, strict frontmatter, resolvable relative links, reserved `io.modelcontextprotocol/` metadata prefix, 512 files and 16 MiB per skill), and every file is served as a resource at `skill://cademi/<name>/<path>` with its sha256 digest and byte size announced in the manifest. The immutable snapshot is answered with `cacheScope: public` and a one-hour `ttlMs`.
- Four skills: `cademi-operations` (how to work with this server: discovery, reads versus writes, authorization, idempotent retries, partial workflows, resources, with `references/write-safety.md`), `investigate-access-problem`, `audit-student-experience` and `analyze-product-structure`.
- `catalog.json` lists the skills and the prompts' source skill.

### Changed

- The prompts `investigate-access-problem`, `audit-student-experience` and `analyze-product-structure` are rendered from the corresponding `SKILL.md` body plus an argument header, so each strategy has a single source. Names, titles and arguments are unchanged; the body wording was de-parameterized ("the student", "the user") and gained short notes on ambiguity, pagination and the documentation resources.
- The server instructions point agents to the skill URIs and, like the skills, use "account" for the connected platform.

## 0.2.1
October 4, 2026

Built for API release 3.10.0.

### Added

- Curated task catalog: task workflows for access, sales investigation, deliveries, release programs, student support, course structure, banners and settings context. The direct surface is compact; all 391 eligible operations stay reachable through `search_tools`, `get_tool_schema`, `execute_read_tool` and `execute_write_tool`.
- Documentation resources under `cademi://docs/<id>`, `docs_search` to find them by text and tags, and the dynamic resources `cademi://capabilities` and `cademi://instance/current`.
- MCP prompts for the three investigation strategies.

### Fixed

- Fixes in the permission preflight, in the cancellation of running calls, and in concurrency.

## 0.1.3
September 27, 2026

Built for API release 3.4.7.

### Added

- `batch_read`: run one read-only tool for many inputs in parallel.

### Changed

- Unknown query and body fields are rejected before reaching the API, and a `503` without `Retry-After` is not retried.

### Fixed

- Generated output schemas accept `null` where the API returns it.

## 0.1.2
September 26, 2026

Built for API release 3.4.7.

### Changed

- Performance tuning for calls to the API, and a call that reaches its time limit is stopped cleanly.

### Fixed

- Startup and the readiness check verify that the server's configuration directory is usable.
- Tool errors include `details.reason`; a call that cannot start reports the system error; a failed token exchange reports the authorization server's status and OAuth error.

## 0.1.1
September 26, 2026

Built for API release 3.4.7.

### Added

- The server identifies itself to the API as `cademi-mcp/<version>` for the audit trail.

## 0.1.0
September 26, 2026

First release, built for API release 3.4.7.

### Added

- First production release at `https://mcp.cademi.dev/mcp`: Streamable HTTP, OAuth protected resource with delegated identity (token exchange) down to the API, 391 generated primitives plus the composites `student_context`, `student_access_context`, `product_context`, `product_structure` and `instance_overview`, and discovery tools.
