Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| POSTMAN_API_KEY | Yes | Postman API Key used to authenticate with the Postman API. Can be generated at https://go.postman.co/settings/me/api-keys |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {} |
| prompts | {} |
| resources | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_workspaces | List all workspaces |
| get_workspace | Get details of a specific workspace |
| list_environments | List all environments in a workspace. If workspace not specified, lists environments in "My Workspace". |
| get_environment | Get details of a specific environment |
| create_environment | Create a new environment in a workspace. Creates in "My Workspace" if workspace not specified. |
| update_environment | Update an existing environment. Only include variables that need to be modified. |
| delete_environment | Delete an environment |
| fork_environment | Create a fork of an environment in a workspace |
| get_environment_forks | Get a list of environment forks |
| merge_environment_fork | Merge a forked environment back into its parent |
| pull_environment | Pull changes from parent environment into forked environment |
| list_collections | List all collections in a workspace. Supports filtering and pagination. |
| get_collection | Get details of a specific collection |
| create_collection | Create a new collection in a workspace. Supports Postman Collection v2.1.0 format. |
| update_collection | Update an existing collection. Full collection replacement with maximum size of 20 MB. |
| patch_collection | Partially update a collection. Only updates provided fields. |
| create_collection_folder | Create a new folder in a collection |
| get_collection_folder | Get details of a specific folder in a collection |
| update_collection_folder | Update a folder in a collection. Acts like PATCH, only updates provided values. |
| create_collection_request | Create a new request in a collection |
| get_collection_request | Get details of a specific request in a collection |
| update_collection_request | Update a request in a collection. Cannot change request folder. |
| create_collection_response | Create a new response in a collection |
| get_collection_response | Get details of a specific response in a collection |
| update_collection_response | Update a response in a collection. Acts like PATCH, only updates provided values. |
| fork_collection | Fork a collection to a workspace |
| get_collection_forks | Get a list of collection forks |
| merge_collection_fork | Merge a forked collection back into its parent |
| pull_collection_changes | Pull changes from parent collection into forked collection |
| transfer_collection_items | Transfer items between collections |
| get_user_info | Get information about the authenticated user |
| list_apis | List all APIs in a workspace |
| get_api | Get details of a specific API |
| create_api | Create a new API |
| update_api | Update an existing API |
| delete_api | Delete an API |
| add_api_collection | Add a collection to an API |
| get_api_collection | Get a specific collection from an API |
| create_api_schema | Create a schema for an API |
| get_api_schema | Get a specific schema from an API |
| create_api_version | Create a new version of an API |
| get_api_versions | Get all versions of an API |
| get_api_version | Get a specific version of an API |
| update_api_version | Update an API version |
| delete_api_version | Delete an API version |
| get_api_comments | Get comments for an API |
| create_api_comment | Create a new comment on an API (max 10,000 characters) |
| update_api_comment | Update an existing API comment (max 10,000 characters) |
| delete_api_comment | Delete an API comment |
| get_api_tags | Get tags for an API |
| update_api_tags | Update tags for an API |
| get_api_schema_files | Get files in an API schema |
| get_schema_file_contents | Get contents of a schema file |
| create_update_schema_file | Create or update a schema file |
| delete_schema_file | Delete a schema file |
| sync_collection_with_schema | Sync a collection with its schema |
| get_task_status | Get status of an asynchronous task |
| list_collection_access_keys | List collection access keys with optional filtering by collection ID |
| delete_collection_access_key | Delete a collection access key |
| list_workspace_roles | Get all available workspace roles based on team's plan |
| get_workspace_roles | Get roles for a specific workspace |
| update_workspace_roles | Update workspace roles for users and groups (limited to 50 operations per call) |
| get_collection_roles | Get roles for a collection |
| update_collection_roles | Update collection roles (requires EDITOR role) |
| get_authenticated_user | Get authenticated user information |
| get_accounts | Gets Postman billing account details for the given team |
| list_account_invoices | Gets all invoices for a Postman billing account filtered by status |
| resolve_comment_thread | Resolves a comment and any associated replies |
| list_pan_elements | Get all elements and folders in Private API Network |
| add_pan_element | Add element or folder to Private API Network |
| update_pan_element | Update element or folder in Private API Network |
| remove_pan_element | Remove element or folder from Private API Network |
| create_webhook | Creates webhook that triggers collection with custom payload |
| get_tagged_elements | Get elements by tag |
| get_workspace_tags | Get workspace tags |
| update_workspace_tags | Update workspace tags |
| health_check | Perform a local system health check to verify Postman MCP server configuration and connectivity. Returns system information and configuration status. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| list_workspaces | Show all available workspaces and their details |
| list_collections | Show all collections across workspaces |
| list_environments | Show all environments and their variables |
| analyze_collection | Analyze a Postman collection for potential improvements and best practices |
| document_api | Generate documentation for an API based on its collection and schema |
| suggest_tests | Suggest test cases for API endpoints in a collection |
| review_environment | Review environment variables for security and completeness |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| Postman Workspaces | List of all available Postman workspaces |
| Current User | Information about the currently authenticated user |
| Postman APIs | List of all available API definitions |
| Postman Collections | List of all available request collections |
| Postman Environments | List of all available environments |
| Collection Roles | List of roles and permissions for collections |
| Workspace Roles | List of roles and permissions for workspaces |
| Collection Access Keys | List of access keys for collections |
| Private API Network Elements | List of elements in the Private API Network |
| Webhooks | List of configured webhooks |
| Tagged Elements | List of elements with specific tags |
| Workspace Tags | List of tags used in workspaces |
| API Tags | List of tags used in APIs |