From 1ca5c7b82bdd21e89e2be2a1f793697818cde4ec Mon Sep 17 00:00:00 2001 From: Mohammod Al Amin Ashik Date: Wed, 11 Feb 2026 12:53:42 +0000 Subject: [PATCH 1/4] Add Postman MCP server definition Official Postman MCP server for managing collections, workspaces, environments, and API specs. Uses @postman/postman-mcp-server npm package with stdio transport. https://claude.ai/code/session_013AxurW8hPAfnUNvik354Xx --- servers/com.postman-mcp.json | 64 ++++++++++++++++++++++++++++++++++++ 1 file changed, 64 insertions(+) create mode 100644 servers/com.postman-mcp.json diff --git a/servers/com.postman-mcp.json b/servers/com.postman-mcp.json new file mode 100644 index 0000000..684a90c --- /dev/null +++ b/servers/com.postman-mcp.json @@ -0,0 +1,64 @@ +{ + "$schema": "../schemas/server-definition.schema.json", + "id": "com.postman-mcp", + "name": "Postman", + "alias": "postman", + "description": "Manage Postman collections, workspaces, environments, and API specifications. Search APIs, generate client code, and run collections.", + "icon": "https://avatars.githubusercontent.com/u/10251060?v=4", + "schema_version": "2.1", + "categories": ["developer-tools"], + "tags": ["postman", "api", "testing", "collections", "api-specs", "code-generation"], + + "transport": { + "type": "stdio", + "command": "npx", + "args": ["-y", "@postman/postman-mcp-server@latest"], + "env": { + "POSTMAN_API_KEY": "${input:POSTMAN_API_KEY}" + }, + "metadata": { + "inputs": [ + { + "id": "POSTMAN_API_KEY", + "label": "Postman API Key", + "description": "API key for the Postman API. Required to access your workspaces, collections, and environments.", + "type": "password", + "required": true, + "secret": true, + "placeholder": "PMAK-xxxxxxxxxxxxxxxxxxxxxxxx", + "obtain": { + "url": "https://go.postman.co/settings/me/api-keys", + "instructions": "1. Log in to postman.com\n2. Click your avatar > Settings > API keys\n3. Click 'Generate API Key'\n4. Name your key and click 'Generate'\n5. Copy the key", + "button_label": "Generate API Key" + } + } + ] + } + }, + + "auth": { + "type": "api_key", + "instructions": "Generate a Postman API key at https://go.postman.co/settings/me/api-keys" + }, + + "contributor": { + "name": "Postman", + "github": "postmanlabs", + "url": "https://www.postman.com" + }, + + "links": { + "repository": "https://github.com/postmanlabs/postman-mcp-server", + "homepage": "https://www.postman.com", + "documentation": "https://learning.postman.com/docs/developer/postman-api/postman-mcp-server/set-up-postman-mcp-server" + }, + + "platforms": ["all"], + + "capabilities": { + "tools": true, + "resources": false, + "prompts": false, + "read_only_mode": false + } +} From ae34d25f149a8217a561dce6f66c382489e58e29 Mon Sep 17 00:00:00 2001 From: Mohammod Al Amin Ashik Date: Thu, 19 Feb 2026 19:10:18 +0800 Subject: [PATCH 2/4] fix: update server definition (input type 'password' -> 'text' for POSTMAN_API_KEY) --- servers/com.postman-mcp.json | 30 +++++++++++++++++++----------- 1 file changed, 19 insertions(+), 11 deletions(-) diff --git a/servers/com.postman-mcp.json b/servers/com.postman-mcp.json index 684a90c..8866c05 100644 --- a/servers/com.postman-mcp.json +++ b/servers/com.postman-mcp.json @@ -6,13 +6,24 @@ "description": "Manage Postman collections, workspaces, environments, and API specifications. Search APIs, generate client code, and run collections.", "icon": "https://avatars.githubusercontent.com/u/10251060?v=4", "schema_version": "2.1", - "categories": ["developer-tools"], - "tags": ["postman", "api", "testing", "collections", "api-specs", "code-generation"], - + "categories": [ + "developer-tools" + ], + "tags": [ + "postman", + "api", + "testing", + "collections", + "api-specs", + "code-generation" + ], "transport": { "type": "stdio", "command": "npx", - "args": ["-y", "@postman/postman-mcp-server@latest"], + "args": [ + "-y", + "@postman/postman-mcp-server@latest" + ], "env": { "POSTMAN_API_KEY": "${input:POSTMAN_API_KEY}" }, @@ -22,7 +33,7 @@ "id": "POSTMAN_API_KEY", "label": "Postman API Key", "description": "API key for the Postman API. Required to access your workspaces, collections, and environments.", - "type": "password", + "type": "text", "required": true, "secret": true, "placeholder": "PMAK-xxxxxxxxxxxxxxxxxxxxxxxx", @@ -35,26 +46,23 @@ ] } }, - "auth": { "type": "api_key", "instructions": "Generate a Postman API key at https://go.postman.co/settings/me/api-keys" }, - "contributor": { "name": "Postman", "github": "postmanlabs", "url": "https://www.postman.com" }, - "links": { "repository": "https://github.com/postmanlabs/postman-mcp-server", "homepage": "https://www.postman.com", "documentation": "https://learning.postman.com/docs/developer/postman-api/postman-mcp-server/set-up-postman-mcp-server" }, - - "platforms": ["all"], - + "platforms": [ + "all" + ], "capabilities": { "tools": true, "resources": false, From b1d24f874f8cfe46fda5c0f3f71dc32fa7dd0789 Mon Sep 17 00:00:00 2001 From: Mohammod Al Amin Ashik Date: Thu, 19 Feb 2026 22:45:25 +0800 Subject: [PATCH 3/4] fix: rename server files with transport suffix - com.postman-mcp.json -> com.postman-mcp-npx.json (id: com.postman-mcp-npx) Signed-off-by: Mohammod Al Amin Ashik --- servers/{com.postman-mcp.json => com.postman-mcp-npx.json} | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) rename servers/{com.postman-mcp.json => com.postman-mcp-npx.json} (97%) diff --git a/servers/com.postman-mcp.json b/servers/com.postman-mcp-npx.json similarity index 97% rename from servers/com.postman-mcp.json rename to servers/com.postman-mcp-npx.json index 8866c05..71a9b12 100644 --- a/servers/com.postman-mcp.json +++ b/servers/com.postman-mcp-npx.json @@ -1,7 +1,7 @@ { "$schema": "../schemas/server-definition.schema.json", - "id": "com.postman-mcp", - "name": "Postman", + "id": "com.postman-mcp-npx", + "name": "Postman (npx)", "alias": "postman", "description": "Manage Postman collections, workspaces, environments, and API specifications. Search APIs, generate client code, and run collections.", "icon": "https://avatars.githubusercontent.com/u/10251060?v=4", From 6c545435d85776a02ff0193df938abb73d2dce8d Mon Sep 17 00:00:00 2001 From: Mohammod Al Amin Ashik Date: Thu, 19 Feb 2026 22:49:59 +0800 Subject: [PATCH 4/4] feat(postman): add Docker variant using mcp/postman image Signed-off-by: Mohammod Al Amin Ashik --- servers/com.postman-mcp-docker.json | 72 +++++++++++++++++++++++++++++ 1 file changed, 72 insertions(+) create mode 100644 servers/com.postman-mcp-docker.json diff --git a/servers/com.postman-mcp-docker.json b/servers/com.postman-mcp-docker.json new file mode 100644 index 0000000..4a252e6 --- /dev/null +++ b/servers/com.postman-mcp-docker.json @@ -0,0 +1,72 @@ +{ + "$schema": "../schemas/server-definition.schema.json", + "id": "com.postman-mcp-docker", + "name": "Postman (Docker)", + "alias": "postman-docker", + "description": "Manage Postman collections, workspaces, environments, and API specifications via Docker. Search APIs, generate client code, and run collections.", + "icon": "https://avatars.githubusercontent.com/u/10251060?v=4", + "schema_version": "2.1", + "categories": [ + "developer-tools" + ], + "tags": [ + "postman", + "api", + "testing", + "collections", + "docker" + ], + "transport": { + "type": "stdio", + "command": "docker", + "args": [ + "run", "-i", "--rm", + "-e", "POSTMAN_API_KEY", + "mcp/postman" + ], + "env": { + "POSTMAN_API_KEY": "${input:POSTMAN_API_KEY}" + }, + "metadata": { + "inputs": [ + { + "id": "POSTMAN_API_KEY", + "label": "Postman API Key", + "description": "API key for the Postman API. Required to access your workspaces, collections, and environments.", + "type": "text", + "required": true, + "secret": true, + "placeholder": "PMAK-xxxxxxxxxxxxxxxxxxxxxxxx", + "obtain": { + "url": "https://go.postman.co/settings/me/api-keys", + "instructions": "1. Log in to postman.com\n2. Click your avatar > Settings > API keys\n3. Click 'Generate API Key'\n4. Name your key and click 'Generate'\n5. Copy the key", + "button_label": "Generate API Key" + } + } + ] + } + }, + "auth": { + "type": "api_key", + "instructions": "Generate a Postman API key at https://go.postman.co/settings/me/api-keys" + }, + "contributor": { + "name": "Postman", + "github": "postmanlabs", + "url": "https://www.postman.com" + }, + "links": { + "repository": "https://github.com/postmanlabs/postman-mcp-server", + "homepage": "https://www.postman.com", + "documentation": "https://learning.postman.com/docs/developer/postman-api/postman-mcp-server/set-up-postman-mcp-server" + }, + "platforms": [ + "all" + ], + "capabilities": { + "tools": true, + "resources": false, + "prompts": false, + "read_only_mode": false + } +}