Postman MCP Server

This project offers a single MCP-compatible server option:

• STDIO server — A lightweight MCP server that communicates over standard input/output, ideal for integration with editors and tools like VS Code.

See more about the Model Context Protocol available transports in the MCP specification.

🧰 VS Code Integration

VS Code only supports up to 128 tools. If you add the Postman MCP server and this exceeds 128 tools, you will encounter an issue with your agent.

You can integrate your MCP server with Visual Studio Code to use it with VS Code extensions that support MCP.

1. Create a .vscode/mcp.json file in your project with the following configuration:

   {
     "servers": {
       "postman-api-mcp": {
         "type": "stdio",
         "command": "node",
         "args": [
           "${workspaceFolder}/dist/src/index.js"
         ],
         "env": {
           "POSTMAN_API_KEY": "${input:postman-api-key}"
         }
       }
     },
     "inputs": [
       {
         "id": "postman-api-key",
         "type": "promptString",
         "description": "Enter your Postman API key"
       }
     ]
   }
   

2. Install an MCP-compatible VS Code extension (such as GitHub Copilot, Claude for VS Code, or other AI assistants that support MCP).

3. Configure your extension to use the MCP server:

• postman-api-mcp: Uses the local stdio-based server, running directly from your project files.
• Clone the repository
• In the repository root folder, execute npm install. This will install all the required dependencies.
• Make sure to replace ${workspaceFolder} in the mcp.json file with the full path to the Postman MCP repository.

4. When prompted, enter your Postman API key.

You can now use your Postman API tools with your VS Code extension through the MCP protocol.

🐳 Docker Setup

See DOCKER.md for up-to-date build, Docker, and usage instructions.

HTTP streamable version

If you prefer to use the HTTP version, it's available at https://mcp.postman.com. Here are the instructions to install it:

🧰 VS Code Integration

{
    "servers": {
      "postman-api-http-server": {
        "type": "mcp",
        "url": "https://mcp.postman.com/mcp",
        "headers": {
            "Authorization": "Bearer ${input:postman-api-key}"
          }
      }
    },
    "inputs": [
      {
        "id": "postman-api-key",
        "type": "promptString",
        "description": "Enter your Postman API key"
      }
    ]
  }

You will be asked to input your Postman API key. Afterwards, the agent performs calls to the Postman cloud MCP server (https://mcp.postman.com).

🧰 Claude Integration

Open the claude_desktop_config.json file, which is accessible from Claude preferences. Then, add the following:

{
  "mcpServers": {
    "postman-api": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.postman-beta.com/mcp",
        "--header",
        "Authorization: Bearer PMAK-YOUR-POSTMAN-API-KEY"
      ]
    }
  }
}

💬 Questions and support

• See the Postman Agent Generator page for updates and new capabilities.
• See Add your MCP requests to your collections to learn how to use Postman to perform MCP requests.
• Visit the Postman Community to share what you've built, ask questions, and get help.
• You can connect to both HTTP and STDIO servers and test them using the Postman MCP Server collection.