Skip to content

v2.8.2

Choose a tag to compare

View all tags
@github-actions github-actions released this 06 Mar 09:30
v2.8.2
6491f1c

New Features

Analytics Tools

Two new MCP tools for querying Postman analytics data:

  • getAnalyticsData — Retrieve analytics data (e.g., API usage metrics, collection runs) with flexible query parameters.
  • getAnalyticsMetadata — Fetch metadata about available analytics dimensions and metrics.

Error Template System

Introduced a Nunjucks-based error template system that provides human-friendly, actionable error messages when API calls return common errors (e.g., 404 Not Found).

  • Created error templates for 8 key resources: getCollectionFolder, getCollectionRequest, getCollectionResponse, getEnvironment, getMock, getMonitor, getSpec, and getWorkspace
  • Each template gives LLM-friendly guidance on what went wrong and how to resolve it

Improvements

Private API Network (PAN) Endpoint Renaming

Standardized all Private API Network endpoint names to be clearer and more descriptive:

Old Name New Name
getAllPanWorkspaces listPrivateNetworkWorkspaces
postPanWorkspace addWorkspaceToPrivateNetwork
deletePanWorkspace removeWorkspaceFromPrivateNetwork
getAllPanAddRequests listPrivateNetworkAddRequests
respondPanAddRequest respondPrivateNetworkAddRequest

All PAN endpoint descriptions now include explicit warnings that these tools are for Private API Network management only, not for general workspace operations.

Postman API Spec Alignment

Regenerated the MCP server tools from the latest Postman API OpenAPI specification:

  • New tools: updateCollectionResponse, addWorkspaceToPrivateNetwork, respondPrivateNetworkAddRequest
  • Removed deprecated tools: postPanElementOrFolder, updatePanElementOrFolder
  • Updated schemas across multiple collection, workspace, and documentation tools
  • Made the collection field optional in mock object schemas (was previously required)
  • Significant reduction in spec size from schema deduplication and cleanup

Bug Fixes & Dependencies

  • Updated @modelcontextprotocol/sdk to v1.27.1, picking up upstream bug fixes and improvements
  • Fixed public repo sync to include new error template files

Full Changelog: v2.7.1...v2.8.1

Assets 5
Loading