-
Notifications
You must be signed in to change notification settings - Fork 27
feat: adding changes in package.json and server.json for publication in mcp registry #66
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Merged
Merged
Changes from 3 commits
Commits
Show all changes
11 commits
Select commit
Hold shift + click to select a range
38f2b0a
adding changes in package.json and server.json in order to publish to…
rubenbaraut 3a80d11
adding new line
rubenbaraut 3ad6e75
Apply suggestion from @akira28
rubenbaraut 2bcd6f2
Update server.json
rubenbaraut 14b1f47
Update server.json
rubenbaraut dac965f
Update server.json
rubenbaraut 360d209
Update server.json
rubenbaraut e7f2dbf
Update server.json
rubenbaraut e8047ab
Update server.json
rubenbaraut 4e70c3f
Update server.json
rubenbaraut a997bab
Update server.json
rubenbaraut File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,33 +1,110 @@ | ||
| { | ||
| "server": { | ||
| "description": "Postman's MCP server connects AI agents, assistants, and chatbots directly to your APIs on Postman. Use natural language to prompt AI to automate work across your Postman collections, environments, workspaces, and more.", | ||
| "name": "com.postman/postman-mcp-server", | ||
| "status": "active", | ||
| "packages": [ | ||
| { | ||
| "environment_variables": [ | ||
| { | ||
| "name": "POSTMAN_API_KEY", | ||
| "value": "{api_key}", | ||
| "variables": { | ||
| "api_key": { | ||
| "description": "Your Postman API key", | ||
| "is_required": true, | ||
| "is_secret": true | ||
| } | ||
| } | ||
| } | ||
| ], | ||
| "name": "@postman/postman-mcp-server", | ||
| "registry_name": "npm", | ||
| "runtime_hint": "npx", | ||
| "version": "latest" | ||
| } | ||
| ], | ||
| "repository": { | ||
| "readme": "# Postman MCP Server\n\nThis project offers the following Model Context Protocol (MCP) server options:\n\n- [**STDIO**](#stdio)\n- [**Streamable HTTP**](#streamable-http)\n\nFor more information about the available transports, see the [MCP specification](https://modelcontextprotocol.io/docs/concepts/transports).\n\n## STDIO\n\nThis is a lightweight solution that's ideal for integration with editors and tools like [VS Code](https://code.visualstudio.com/).\n\n\u003e For Docker set up and installation, see [DOCKER.md](./DOCKER.md).\n\n### VS Code integration\n\n\u003e **Note:**\n\u003e By default, this server provides 37 tools (minimal mode). Use the `--full` flag to access all 106 tools.\n\u003e Use the `--region` flag to specify the Postman API region (`us` or `eu`), or set the `POSTMAN_API_BASE_URL` environment variable directly.\n\nIntegrate your MCP server with Visual Studio Code and use it with VS Code extensions that support MCP. To do this, do the following:\n\n1. Create a *.vscode/mcp.json* file in your project and enter the following:\n\n ```json\n {\n \"servers\": {\n \"postman-api-mcp\": {\n \"type\": \"stdio\",\n \"command\": \"npx\",\n \"args\": [\n \"@postman/postman-mcp-server\",\n \"--full\" // (optional) Use this flag to enable full mode\n ],\n \"env\": {\n \"POSTMAN_API_KEY\": \"${input:postman-api-key}\"\n }\n }\n },\n \"inputs\": [\n {\n \"id\": \"postman-api-key\",\n \"type\": \"promptString\",\n \"description\": \"Enter your Postman API key\"\n }\n ]\n }\n ```\n\n1. Install an MCP-compatible VS Code extension, such as GitHub Copilot, Claude for VS Code, or other AI assistants that support MCP.\n\n#### Configure the extension\n\nConfigure the extension to use the **postman-api-mcp** server, a local STDIO-based server that runs directly from your project files:\n\n1. Clone the **postman-mcp-server** repository.\n1. In the repository's root folder, run the `npm install` command. This installs all the required dependencies.\n1. Replace `${workspaceFolder}` in the *mcp.json* file with the full path to the Postman MCP repository.\n1. When prompted, enter your [Postman API key](https://go.postman.co/settings/me/api-keys).\n\n### Claude integration\n\nTo integrate the MCP server with Claude, check the latest [Postman MCP server release](https://github.com/postmanlabs/postman-mcp-server/releases) and download one of the following `.dxt` files:\n\n- **postman-api-mcp-minimal.dxt** - Contains 37 essential tools for basic Postman operations.\n- **postman-api-mcp-full.dxt** - Contains all 106+ tools for comprehensive Postman functionality.\n\nFor more information, see Anthropic's [Claude Desktop Extensions](https://www.anthropic.com/engineering/desktop-extensions) documentation.\n\n## Streamable HTTP\n\nThe streamable HTTP version is available at `https://mcp.postman.com`. It supports two tool configurations to better serve different use cases:\n\n- **Minimal** — Only includes essential tools for basic Postman operations, available at `https://mcp.postman.com/minimal`. This offers faster performance and simplifies use for those who only need basic Postman operations.\n- **Full** — Includes all available Postman API tools (100+ tools), available at `https://mcp.postman.com/mcp`.\n\n\u003e **Note:** The streamable EU HTTP server is available at `https://mcp.eu.postman.com`.\n\n### Cursor integration\n\nTo integrate the MCP server with Cursor, click the following button:\n\u003e Ensure the Authorization header uses the Bearer \u003cYOUR_API_KEY\u003e format.\n\n[](https://cursor.com/en/install-mcp?name=postman_mcp_server\u0026config=eyJ1cmwiOiJodHRwczovL21jcC5wb3N0bWFuLmNvbS9taW5pbWFsIiwiaGVhZGVycyI6eyJBdXRob3JpemF0aW9uIjoiQmVhcmVyIFlPVVJfQVBJX0tFWSJ9fQ%3D%3D)\n\n### VS Code integration\n\n\u003e By default, the server provides 37 tools. Use **Full** (`https://mcp.postman.com/mcp`) mode to access all 106 tools.\n\nTo install in VS Code, you can use the [Postman VS Code Extension](https://marketplace.visualstudio.com/items?itemName=Postman.postman-for-vscode). Or you can add the following to the *.vscode/mcp.json* file:\n\n```json\n{\n \"servers\": {\n \"postman-api-http-server\": {\n \"type\": \"http\",\n \"url\": \"https://mcp.postman.com/{minimal | mcp}\", // choose \"minimal\" or \"mcp\"\n \"headers\": {\n \"Authorization\": \"Bearer ${input:postman-api-key}\"\n }\n }\n },\n \"inputs\": [\n {\n \"id\": \"postman-api-key\",\n \"type\": \"promptString\",\n \"description\": \"Enter your Postman API key\"\n }\n ]\n}\n```\n\nWhen prompted, enter your Postman API key. Afterwards, the agent performs calls to the Postman cloud MCP server at `https://mcp.postman.com`.\n\n## Migration from v1.x to v2.x\n\n- **Tool naming changes** - All tool names changed from kebab-case to camelCase. For example:\n - `create-collection` → `createCollection`\n - `get-workspaces` → `getWorkspaces`\n - `delete-environment` → `deleteEnvironment`\n- **Tool availability changes**\n - The default (Minimal) behavior provides only 37 essential tools.\n - The `--full` flag provides access to all 106 tools.\n\n## Questions and support\n\n- See the [Postman Agent Generator](https://postman.com/explore/agent-generator) page for updates and new capabilities.\n- See [Add your MCP requests to your collections](https://learning.postman.com/docs/postman-ai-agent-builder/mcp-requests/overview/) to learn how to use Postman to perform MCP requests.\n- Visit the [Postman Community](https://community.postman.com/) to share what you've built, ask questions, and get help.\n- You can connect to both HTTP and STDIO servers and test them using the [Postman MCP Server collection](https://www.postman.com/postman/postman-public-workspace/collection/681dc649440b35935978b8b7).\n", | ||
| "source": "github", | ||
| "url": "https://github.com/postmanlabs/postman-mcp-server" | ||
| "$schema": "https://static.modelcontextprotocol.io/schemas/2025-10-17/server.schema.json", | ||
| "name": "com.postman/postman-mcp-server", | ||
| "description": "A simple MCP server to operate on the Postman API", | ||
rubenbaraut marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||
| "repository": { | ||
| "url": "https://github.com/postmanlabs/postman-mcp-server", | ||
| "source": "github" | ||
| }, | ||
| "version": "2.4.0", | ||
| "packages": [ | ||
| { | ||
| "registryType": "npm", | ||
| "identifier": "@postman/postman-mcp-server", | ||
| "version": "2.4.0", | ||
| "transport": { | ||
| "type": "stdio" | ||
| }, | ||
| "environmentVariables": [ | ||
| { | ||
| "description": "Your Postman API Key", | ||
rubenbaraut marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||
| "isRequired": true, | ||
| "isSecret": true, | ||
| "name": "POSTMAN_API_KEY" | ||
| } | ||
| ] | ||
| }, | ||
| { | ||
| "registryType": "mcpb", | ||
| "identifier": "https://github.com/postmanlabs/postman-mcp-server/releases/download/v2.3.7/postman-mcp-server-minimal.mcpb", | ||
| "fileSha256": "141d04ea82f35bd140ba8c73fa87b1f746260b9c11ee0623fc04b6012056985f", | ||
| "transport": { | ||
| "type": "stdio" | ||
| }, | ||
| "environmentVariables": [ | ||
| { | ||
| "description": "Your Postman API Key", | ||
rubenbaraut marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||
| "isRequired": true, | ||
| "isSecret": true, | ||
| "name": "POSTMAN_API_KEY" | ||
| } | ||
| ] | ||
| }, | ||
| { | ||
| "registryType": "mcpb", | ||
| "identifier": "https://github.com/postmanlabs/postman-mcp-server/releases/download/v2.3.7/postman-mcp-server-full.mcpb", | ||
| "fileSha256": "8ec132046ecf970a52ae056628a9187bdcabad89dff7b4b6ea3f91769f360aeb", | ||
| "transport": { | ||
| "type": "stdio" | ||
| }, | ||
| "environmentVariables": [ | ||
| { | ||
| "description": "Your Postman API Key", | ||
rubenbaraut marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||
| "isRequired": true, | ||
| "isSecret": true, | ||
| "name": "POSTMAN_API_KEY" | ||
| } | ||
| ] | ||
| } | ||
| } | ||
| } | ||
| ], | ||
| "remotes": [ | ||
| { | ||
| "type": "streamable-http", | ||
| "url": "https://mcp.postman.com/mcp", | ||
| "headers": [ | ||
| { | ||
| "name": "Authorization", | ||
| "description": "Bearer + your API key for authentication", | ||
rubenbaraut marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||
| "isRequired": true, | ||
| "isSecret": true | ||
| } | ||
| ] | ||
| }, | ||
| { | ||
| "type": "streamable-http", | ||
| "url": "https://mcp.postman.com/minimal", | ||
| "headers": [ | ||
| { | ||
| "name": "Authorization", | ||
| "description": "Bearer + your API key for authentication", | ||
rubenbaraut marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||
| "isRequired": true, | ||
| "isSecret": true | ||
| } | ||
| ] | ||
| }, | ||
| { | ||
| "type": "streamable-http", | ||
| "url": "https://mcp.eu.postman.com/mcp", | ||
| "headers": [ | ||
| { | ||
| "name": "Authorization", | ||
| "description": "Bearer + your API key for authentication", | ||
rubenbaraut marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||
| "isRequired": true, | ||
| "isSecret": true | ||
| } | ||
| ] | ||
| }, | ||
| { | ||
| "type": "streamable-http", | ||
| "url": "https://mcp.eu.postman.com/minimal", | ||
| "headers": [ | ||
| { | ||
| "name": "Authorization", | ||
| "description": "Bearer + your API key for authentication", | ||
rubenbaraut marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||
| "isRequired": true, | ||
| "isSecret": true | ||
| } | ||
| ] | ||
| } | ||
| ] | ||
| } | ||
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.