Changelog

The two surfaces are versioned differently: the REST API by its URL prefix (see API versioning), the MCP server by a semantic version (see MCP versioning). Both are listed here, newest first. Deprecations are announced here before the headers start appearing.

REST API v1

The base URL is https://api.postal.music/api/v1. No route in v1 is currently deprecated; GET /api/v1/version is the live list.

2026-09-24

• Every tag row on GET /tracks and GET /tracks/single carries modelVersion next to autotagged and accuracy: the tagger build that wrote the auto-tag, null for hand-set tags and for auto-tags applied before 24 September 2026. See auto-tag provenance.

2026-09-07

• New track versions routes under /tracks/{trackId}/versions: list, get, add from file or URL, activate, rename/relabel/hide, delete. GET /tracks/single gains activeVersionId and a versions summary.
• Every /api/v1 response now carries X-Postal-Api-Version.
• New GET /version (no key required) reporting the version, the newest version available, the build and any deprecated routes.
• Deprecated routes, when there are any, answer with Deprecation, Sunset and Link headers per RFC 9745 and RFC 8594.
• API key management moved in the app from Tools to Settings → Integrations.

2026-08-21

• New POST /tracks/search: natural-language search with constraints, seed and exclude lists. Uses the existing read:tracks scope; costs one credit per call.

2026-08-13

• New Platform API under /platform for partner reporting on file requests and sign-ups. Platform keys are issued by Postal, not self-service.

2026-06-12

• New /analytics/dashboard, /analytics/stats and /analytics/top (scope read:analytics).
• New /briefs and /briefs/:id/submissions (scope read:briefs).
• New /tracks/duplicates and /tracks/submissions (scope read:tracks).
• Keys created with an explicit scope list need the two new scopes added to use the new routes; keys created without a scope list have them already.

2026-03

• v1 launched: tracks, tagging, playlists, composers, taxonomy, cover art, scoped API keys and signed webhooks.

MCP server

Deployed at https://mcp.postal.music/mcp; the running version is at /health.

1.8.0 — 2026-10-06

• Tools are now defined on the REST API and served from its manifest (GET /api/v1/mcp/manifest). Tool additions and changes ship with the API and appear in the generated tool reference and at /tools; this changelog records changes to the server itself from here on.
• Tool names, descriptions and inputs are unchanged from 1.7.0. One schema is more precise: the nested details object of upload_track_by_url lists all ten fields with descriptions.
• /health reports the catalog it serves under manifest, and the initialize instructions name the catalog's API build and tool count.
• wait_for_auto_tag waits on the API instead of in the server: one call waits at most 55 seconds before answering "still in progress"; call it again to keep waiting.
• Mutations return the API's own response instead of a { ok: true } confirmation; the summary line still says what happened.
• The tool list reflects the connected key's scopes: a connector sees only the tools its key can call. The public catalog at /tools still lists every tool. See Auth and scopes.
• 39 tools.

1.7.0 — 2026-09-24

• Compact tracks carry autotagModelVersion, the tagger build behind the applied auto-tags, plus autotagModelVersions when a track mixes builds; detail: "full" tag rows include modelVersion. No new tools, no input changes.

1.6.0 — 2026-09-07

• Five track-version tools: list_track_versions, upload_track_version, activate_track_version, update_track_version, delete_track_version. 39 tools.

1.5.0 — 2026-09-07

• /health and /tools report apiVersion; /tools also carries version.
• The server sends instructions on initialize naming its version and the stability guarantees.
• Deprecated-tool convention introduced (a [Deprecated — removed in …] description prefix). No tool is deprecated today.
• 34 tools, unchanged from 1.4.1.

1.4.1 — 2026-09-02

• Moved to Cloudflare Workers with stateless Streamable HTTP.
• Compact track objects include the era, character and movement tag groups.

1.4.0 — 2026-09-01

• Production release of the 1.2.0 and 1.3.0 changes below.
• Six read tools accept detail: "full"; mutations return { ok: true } confirmations.

1.3.0 — 2026-08-21

• New search_tracks.

1.2.0 — 2026-06-12

• Compact responses by default with a detail parameter.
• New get_dashboard, get_entity_stats, get_top_tracks, find_duplicate_tracks, get_track_submissions, list_briefs and get_brief_submissions.

1.1.0 — 2026-06-10

• Public GET /tools catalog.
• Direct X-API-Key authentication alongside OAuth.

1.0.0 — 2026-03-30

• First release: tracks, tagging, playlists, taxonomy, artwork and composer tools over Streamable HTTP with OAuth 2.1.

Changes to either surface are also announced on postal.music/release-notes.