add_api_collection
Add a collection to an API
Work a Postman workspace from the agent side: fork a collection, edit its requests, stand up a mock with canned responses, run a monitor, and hand someone a role — without opening the app.
LABSCO SUMMARY
This is the Postman API mirrored rather than reshaped, which cuts both ways: the coverage is near-total, and the tool list is 99 entries long, so a client with a tight tool budget will feel it. The mirroring also shows in small seams — get_user_info and get_authenticated_user both return the authenticated user, and several calls answer differently depending on the team's plan rather than on what you asked for. Worth knowing before a bulk edit: update_collection replaces the whole collection, up to 20 MB, while patch_collection touches only the fields you send.
A server over the Postman API, 99 tools spanning workspaces, collections, environments, API definitions, mocks, monitors, roles, the Private API Network and billing.
POSTMAN_API_KEY, and a Postman account whose plan carries what you intend to call — list_workspace_roles returns the roles available on the team's plan, and mock call log retention follows the plan as well. Updating collection roles requires the EDITOR role on that collection.
Build from source — git clone https://github.com/delano/postman-mcp-server.git
USE CASES
Fork the collection into your own workspace, edit the requests there, then merge the fork back with the strategy you want once it works.
Create the mock against a collection, give it the server response the client should see, publish it so the other team can reach it, then read the call logs to find out what they actually sent.
Check which roles the team's plan actually offers, grant the workspace role, then narrow further at collection level where the sensitive requests live.
Update the schema file on the API, sync the collection to it, and watch the task rather than assuming the sync landed — the sync runs asynchronously.
List the monitors in the workspace, read the one that went quiet, then run it in blocking mode — an async run comes back without the stats, executions and failures you need to see.
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
add_api_collectionAdd a collection to an API
add_pan_elementAdd element or folder to Private API Network
create_apiCreate a new API
create_api_commentCreate a new comment on an API (max 10,000 characters)
create_api_schemaCreate a schema for an API
create_api_versionCreate a new version of an API
create_collectionCreate a new collection in a workspace. Supports Postman Collection v2.1.0 format.
create_collection_folderCreate a new folder in a collection
create_collection_requestCreate a new request in a collection
create_collection_responseCreate a new response in a collection
create_environmentCreate a new environment in a workspace. Creates in "My Workspace" if workspace not specified.
create_mockCreate a new mock server. Creates in Personal workspace if workspace not specified.
create_monitorCreate a new monitor. Cannot create monitors for collections added to an API definition.
create_server_responseCreate a server response. Only one server response can be active at a time.
create_update_schema_fileCreate or update a schema file
create_webhookCreates webhook that triggers collection with custom payload
delete_apiDelete an API
delete_api_commentDelete an API comment
delete_api_versionDelete an API version
delete_collectionDelete a collection
delete_collection_access_keyDelete a collection access key
delete_collection_folderDelete a folder from a collection
delete_collection_requestDelete a request from a collection
delete_collection_responseDelete a response from a collection
delete_environmentDelete an environment
delete_mockDelete a mock server
delete_monitorDelete a monitor
delete_schema_fileDelete a schema file
delete_server_responseDelete a server response
fork_collectionFork a collection to a workspace
fork_environmentCreate a fork of an environment in a workspace
get_accountsGets Postman billing account details for the given team
get_apiGet details of a specific API
get_api_collectionGet a specific collection from an API
get_api_commentsGet comments for an API
get_api_schemaGet a specific schema from an API
get_api_schema_filesGet files in an API schema
get_api_tagsGet tags for an API
get_api_versionGet a specific version of an API
get_api_versionsGet all versions of an API
get_authenticated_userGet authenticated user information
get_collectionGet details of a specific collection
get_collection_folderGet details of a specific folder in a collection
get_collection_forksGet a list of collection forks
get_collection_requestGet details of a specific request in a collection
get_collection_responseGet details of a specific response in a collection
get_collection_rolesGet roles for a collection
get_environmentGet details of a specific environment
get_environment_forksGet a list of environment forks
get_mockGet details of a specific mock server
get_mock_call_logsGet mock call logs. Maximum 6.5MB or 100 call logs per API call. Retention period based on Postman plan.
get_monitorGet details of a specific monitor
get_schema_file_contentsGet contents of a schema file
get_server_responseGet a specific server response
get_tagged_elementsGet elements by tag
get_task_statusGet status of an asynchronous task
get_user_infoGet information about the authenticated user
get_workspaceGet details of a specific workspace
get_workspace_rolesGet roles for a specific workspace
get_workspace_tagsGet workspace tags
list_account_invoicesGets all invoices for a Postman billing account filtered by status
list_apisList all APIs in a workspace
list_collection_access_keysList collection access keys with optional filtering by collection ID
list_collectionsList all collections in a workspace. Supports filtering and pagination.
list_environmentsList all environments in a workspace. If workspace not specified, lists environments in "My Workspace".
list_mocksList all mock servers
list_monitorsGet all monitors
list_pan_elementsGet all elements and folders in Private API Network
list_server_responsesGet all server responses for a mock
list_workspace_rolesGet all available workspace roles based on team's plan
list_workspacesList all workspaces
merge_collection_forkMerge a forked collection back into its parent
merge_environment_forkMerge a forked environment back into its parent
patch_collectionPartially update a collection. Only updates provided fields.
publish_mockPublish mock server (sets Access Control to public)
pull_collection_changesPull changes from parent collection into forked collection
pull_environmentPull changes from parent environment into forked environment
remove_pan_elementRemove element or folder from Private API Network
resolve_comment_threadResolves a comment and any associated replies
run_monitorRun a monitor. For async=true, response won't include stats, executions, and failures. Use GET /monitors/{id} to get this information for async runs.
sync_collection_with_schemaSync a collection with its schema
transfer_collection_itemsTransfer items between collections
unpublish_mockUnpublish mock server (sets Access Control to private)
update_apiUpdate an existing API
update_api_commentUpdate an existing API comment (max 10,000 characters)
update_api_tagsUpdate tags for an API
update_api_versionUpdate an API version
update_collectionUpdate an existing collection. Full collection replacement with maximum size of 20 MB.
update_collection_folderUpdate a folder in a collection. Acts like PATCH, only updates provided values.
update_collection_requestUpdate a request in a collection. Cannot change request folder.
update_collection_responseUpdate a response in a collection. Acts like PATCH, only updates provided values.
update_collection_rolesUpdate collection roles (requires EDITOR role)
update_environmentUpdate an existing environment. Only include variables that need to be modified.
update_mockUpdate an existing mock server
update_monitorUpdate an existing monitor
update_pan_elementUpdate element or folder in Private API Network
update_server_responseUpdate a server response
update_workspace_rolesUpdate workspace roles for users and groups (limited to 50 operations per call)
update_workspace_tagsUpdate workspace tags
BEFORE YOU INSTALL
99 tools when we connected.
Both documented clients run the server on your machine.
CONTEXT COST
Rated by the size of the 99 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
You clone and build this one yourself.
git clone https://github.com/delano/postman-mcp-server.git
cd postman-mcp-server
pnpm install
pnpm run build{
"mcpServers": {
"postman": {
"command": "node",
"args": [
"<YOUR_PATH_TO_POSTMAN_MCP_SERVER>/build/index.js"
],
"env": {
"POSTMAN_API_KEY": "<YOUR_POSTMAN_API_KEY>"
}
}
}
}