Skip to content

Commit 2abeb0c

Browse files
its-mashits-mash
authored
feat: add Postman MCP server definition (#62)
* 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 * fix: update server definition (input type 'password' -> 'text' for POSTMAN_API_KEY) * 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 <maa.ashik00@gmail.com> * feat(postman): add Docker variant using mcp/postman image Signed-off-by: Mohammod Al Amin Ashik <maa.ashik00@gmail.com> --------- Signed-off-by: Mohammod Al Amin Ashik <maa.ashik00@gmail.com>
1 parent 130c6cd commit 2abeb0c

2 files changed

Lines changed: 144 additions & 0 deletions

File tree

‎servers/com.postman-mcp-docker.json‎

Lines changed: 72 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,72 @@
1+
{
2+
"$schema": "../schemas/server-definition.schema.json",
3+
"id": "com.postman-mcp-docker",
4+
"name": "Postman (Docker)",
5+
"alias": "postman-docker",
6+
"description": "Manage Postman collections, workspaces, environments, and API specifications via Docker. Search APIs, generate client code, and run collections.",
7+
"icon": "https://avatars.githubusercontent.com/u/10251060?v=4",
8+
"schema_version": "2.1",
9+
"categories": [
10+
"developer-tools"
11+
],
12+
"tags": [
13+
"postman",
14+
"api",
15+
"testing",
16+
"collections",
17+
"docker"
18+
],
19+
"transport": {
20+
"type": "stdio",
21+
"command": "docker",
22+
"args": [
23+
"run", "-i", "--rm",
24+
"-e", "POSTMAN_API_KEY",
25+
"mcp/postman"
26+
],
27+
"env": {
28+
"POSTMAN_API_KEY": "${input:POSTMAN_API_KEY}"
29+
},
30+
"metadata": {
31+
"inputs": [
32+
{
33+
"id": "POSTMAN_API_KEY",
34+
"label": "Postman API Key",
35+
"description": "API key for the Postman API. Required to access your workspaces, collections, and environments.",
36+
"type": "text",
37+
"required": true,
38+
"secret": true,
39+
"placeholder": "PMAK-xxxxxxxxxxxxxxxxxxxxxxxx",
40+
"obtain": {
41+
"url": "https://go.postman.co/settings/me/api-keys",
42+
"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",
43+
"button_label": "Generate API Key"
44+
}
45+
}
46+
]
47+
}
48+
},
49+
"auth": {
50+
"type": "api_key",
51+
"instructions": "Generate a Postman API key at https://go.postman.co/settings/me/api-keys"
52+
},
53+
"contributor": {
54+
"name": "Postman",
55+
"github": "postmanlabs",
56+
"url": "https://www.postman.com"
57+
},
58+
"links": {
59+
"repository": "https://github.com/postmanlabs/postman-mcp-server",
60+
"homepage": "https://www.postman.com",
61+
"documentation": "https://learning.postman.com/docs/developer/postman-api/postman-mcp-server/set-up-postman-mcp-server"
62+
},
63+
"platforms": [
64+
"all"
65+
],
66+
"capabilities": {
67+
"tools": true,
68+
"resources": false,
69+
"prompts": false,
70+
"read_only_mode": false
71+
}
72+
}

‎servers/com.postman-mcp-npx.json‎

Lines changed: 72 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,72 @@
1+
{
2+
"$schema": "../schemas/server-definition.schema.json",
3+
"id": "com.postman-mcp-npx",
4+
"name": "Postman (npx)",
5+
"alias": "postman",
6+
"description": "Manage Postman collections, workspaces, environments, and API specifications. Search APIs, generate client code, and run collections.",
7+
"icon": "https://avatars.githubusercontent.com/u/10251060?v=4",
8+
"schema_version": "2.1",
9+
"categories": [
10+
"developer-tools"
11+
],
12+
"tags": [
13+
"postman",
14+
"api",
15+
"testing",
16+
"collections",
17+
"api-specs",
18+
"code-generation"
19+
],
20+
"transport": {
21+
"type": "stdio",
22+
"command": "npx",
23+
"args": [
24+
"-y",
25+
"@postman/postman-mcp-server@latest"
26+
],
27+
"env": {
28+
"POSTMAN_API_KEY": "${input:POSTMAN_API_KEY}"
29+
},
30+
"metadata": {
31+
"inputs": [
32+
{
33+
"id": "POSTMAN_API_KEY",
34+
"label": "Postman API Key",
35+
"description": "API key for the Postman API. Required to access your workspaces, collections, and environments.",
36+
"type": "text",
37+
"required": true,
38+
"secret": true,
39+
"placeholder": "PMAK-xxxxxxxxxxxxxxxxxxxxxxxx",
40+
"obtain": {
41+
"url": "https://go.postman.co/settings/me/api-keys",
42+
"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",
43+
"button_label": "Generate API Key"
44+
}
45+
}
46+
]
47+
}
48+
},
49+
"auth": {
50+
"type": "api_key",
51+
"instructions": "Generate a Postman API key at https://go.postman.co/settings/me/api-keys"
52+
},
53+
"contributor": {
54+
"name": "Postman",
55+
"github": "postmanlabs",
56+
"url": "https://www.postman.com"
57+
},
58+
"links": {
59+
"repository": "https://github.com/postmanlabs/postman-mcp-server",
60+
"homepage": "https://www.postman.com",
61+
"documentation": "https://learning.postman.com/docs/developer/postman-api/postman-mcp-server/set-up-postman-mcp-server"
62+
},
63+
"platforms": [
64+
"all"
65+
],
66+
"capabilities": {
67+
"tools": true,
68+
"resources": false,
69+
"prompts": false,
70+
"read_only_mode": false
71+
}
72+
}

0 commit comments

Comments
 (0)