# Postman Mcp Server

> MCP server from ankit-roy-0602/postman-mcp-server.

- **Type:** MCP server
- **Install:** `agentstack add mcp-ankit-roy-0602-postman-mcp-server`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [ankit-roy-0602](https://agentstack.voostack.com/s/ankit-roy-0602)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [ankit-roy-0602](https://github.com/ankit-roy-0602)
- **Source:** https://github.com/ankit-roy-0602/postman-mcp-server

## Install

```sh
agentstack add mcp-ankit-roy-0602-postman-mcp-server
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 🚀 Postman MCP Server

> **Transform your AI conversations into powerful API workflows with seamless Postman integration**

[](https://www.npmjs.com/package/postman-mcp-server)
[](https://www.npmjs.com/package/postman-mcp-server)
[](https://github.com/ankit-roy-0602/postman-mcp-server/actions)
[](https://github.com/ankit-roy-0602/postman-mcp-server/actions)
[](https://socket.dev/npm/package/postman-mcp-server)
[](https://opensource.org/licenses/MIT)
[](https://nodejs.org/)
[](https://www.typescriptlang.org/)

**Stop switching between your AI assistant and Postman!** This Model Context Protocol (MCP) server brings the full power of Postman directly into your AI conversations with Cline, Claude Desktop, Cursor, and other MCP-compatible clients.

## 🎯 Why You Need This

### The Problem
- **Context Switching Nightmare**: Constantly jumping between AI chats and Postman to manage APIs
- **Manual API Documentation**: Tediously explaining API structures to your AI assistant
- **Workflow Interruption**: Breaking your flow to test, update, or create API requests
- **Team Collaboration Gaps**: Difficulty sharing API workflows between AI-assisted development and team tools

### The Solution
**One command. Infinite possibilities.** Connect your AI assistant directly to Postman and unlock:

✨ **Instant API Management** - Create, update, and organize API collections without leaving your AI conversation  
🔄 **Real-time Sync** - Changes made through AI are immediately available in Postman  
🎯 **Context-Aware Assistance** - Your AI understands your entire API ecosystem  
🚀 **Accelerated Development** - Build and test APIs 10x faster with AI-powered workflows  
👥 **Seamless Team Integration** - AI-generated APIs automatically sync with your team's Postman workspace  

## 🌟 What You Can Do

### 🏢 **Smart Workspace Management**
- **"Create a new workspace for our mobile app project"** - Done in seconds
- **"List all my team workspaces"** - Instant overview of your organization
- **"Switch to the production workspace"** - Seamless environment management

### 📚 **Intelligent Collection Building**
- **"Build a REST API collection for user authentication"** - AI creates the entire structure
- **"Add CRUD operations for the products endpoint"** - Complete API sets generated instantly
- **"Import my OpenAPI spec into a new collection"** - Automated API documentation

### 🌍 **Dynamic Environment Control**
- **"Set up dev, staging, and prod environments"** - Multi-environment setup in one command
- **"Update the API key for production"** - Secure credential management
- **"Switch all requests to use the staging server"** - Bulk environment changes

### 🔧 **Effortless Request Management**
- **"Create a POST request for user registration with validation"** - Complete request with headers, body, and tests
- **"Add authentication to all requests in this collection"** - Bulk security implementation
- **"Generate test data for the user creation endpoint"** - Realistic test scenarios

### 📂 **Organized Folder Structures**
- **"Organize these requests by feature"** - Automatic logical grouping
- **"Create a folder structure for microservices"** - Enterprise-ready organization
- **"Move all authentication requests to a separate folder"** - Instant reorganization

### 🎭 **AI-Powered Mock Server Creation**
- **"Create a mock server for my user API with realistic data"** - Instant mock endpoints with intelligent responses
- **"Generate mock responses with error scenarios for testing"** - Complete testing scenarios including 400, 401, 404, 500 responses
- **"Set up a mock server with dynamic data and response delays"** - Production-like mock behavior for realistic testing

## 🚀 Quick Start (60 seconds to API mastery)

### 1. Install Globally
```bash
npm install -g postman-mcp-server
```

### 2. Get Your Postman API Key
1. Visit [Postman API Keys](https://web.postman.co/settings/me/api-keys)
2. Click "Generate API Key"
3. Copy your key

### 3. Configure Your AI Agent

#### For **Cline** (VSCode Extension)
Add to your Cline MCP settings:
```json
{
  "mcpServers": {
    "postman": {
      "command": "postman-mcp-server",
      "env": {
        "POSTMAN_API_KEY": "your-postman-api-key-here"
      }
    }
  }
}
```

#### For **Claude Desktop**
Add to your configuration file:

**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`  
**Windows**: `%APPDATA%/Claude/claude_desktop_config.json`

```json
{
  "mcpServers": {
    "postman": {
      "command": "postman-mcp-server",
      "env": {
        "POSTMAN_API_KEY": "your-postman-api-key-here"
      }
    }
  }
}
```

#### For **Cursor**
Add to your Cursor MCP configuration:
```json
{
  "mcpServers": {
    "postman": {
      "command": "postman-mcp-server",
      "env": {
        "POSTMAN_API_KEY": "your-postman-api-key-here"
      }
    }
  }
}
```

### 4. Start Building!
Restart your AI agent and start with:
> *"Show me all my Postman workspaces and help me create a new API collection for my e-commerce project"*

## 💡 Real-World Use Cases

### 🎯 **API-First Development**
```
You: "I'm building a social media app. Create a complete API collection with user management, posts, and comments."

AI: *Creates workspace, sets up collections with proper folder structure, adds CRUD operations for users/posts/comments, configures authentication, and sets up test environments*
```

### 🔄 **Rapid Prototyping**
```
You: "Convert this OpenAPI spec into a Postman collection and add realistic test data."

AI: *Imports spec, creates organized collection, generates sample requests with proper headers and realistic JSON payloads*
```

### 🚀 **Team Onboarding**
```
You: "Set up a development environment for our new team member with all our microservice endpoints."

AI: *Creates workspace, imports all collections, sets up environment variables, organizes by service, adds documentation*
```

### 🔧 **API Testing Automation**
```
You: "Add comprehensive tests to all endpoints in my user management collection."

AI: *Adds status code checks, response validation, authentication tests, and error handling to every request*
```

## 🛠️ Powerful Features

### 🏢 **Workspace Management**
- **List & Browse**: Instantly see all your workspaces
- **Create & Configure**: Set up new team or personal workspaces
- **Update & Organize**: Modify workspace settings and descriptions
- **Smart Switching**: Context-aware workspace management

### 📚 **Collection Operations**
- **Intelligent Creation**: AI-powered collection structure generation
- **Bulk Operations**: Manage multiple collections simultaneously
- **Version Control**: Track and manage collection changes
- **Import/Export**: Seamless data migration

### 🌍 **Environment Control**
- **Multi-Environment Setup**: Dev, staging, production configurations
- **Variable Management**: Secure handling of API keys and endpoints
- **Bulk Updates**: Change environments across collections
- **Environment Cloning**: Duplicate setups for new projects

### 🔧 **Request Engineering**
- **Smart Generation**: AI creates complete requests with proper structure
- **Bulk Modifications**: Update multiple requests simultaneously
- **Authentication Integration**: Automatic auth setup across requests
- **Test Generation**: Comprehensive test suites for all endpoints

### 📂 **Organization Tools**
- **Folder Hierarchies**: Create logical API groupings
- **Auto-Organization**: AI suggests optimal folder structures
- **Bulk Moving**: Reorganize requests efficiently
- **Search & Filter**: Find requests across large collections

## 🔒 Security & Best Practices

### 🛡️ **Supply Chain Security**
- **✅ Zero Known Vulnerabilities**: Regular security audits with npm audit
- **🔍 Dependency Monitoring**: Automated vulnerability scanning via Socket.dev
- **📦 Minimal Dependencies**: Only 3 production dependencies to reduce attack surface
- **🔄 Regular Updates**: Automated dependency updates and security patches
- **🏷️ Signed Releases**: All releases are signed and verified

### 🔐 **API Security**
- **🔑 Secure API Key Handling**: Environment variable storage only
- **🛡️ Rate Limit Respect**: Built-in Postman API rate limiting
- **✅ Input Validation**: Comprehensive request validation using Zod schemas
- **🔍 Error Handling**: Graceful failure management without data leakage
- **📝 Audit Logging**: Track all API operations for security monitoring

### 🚨 **Security Reporting**
Found a security vulnerability? Please see our [Security Policy](SECURITY.md) for responsible disclosure guidelines.

### 🔧 **Security Configuration**
```bash
# Recommended: Use environment variables for API keys
export POSTMAN_API_KEY="your-secure-api-key"

# Never commit API keys to version control
echo "POSTMAN_API_KEY=*" >> .gitignore
```

### 📊 **Security Monitoring**
- **Automated Security Audits**: Daily vulnerability scans
- **Dependency Health Checks**: Weekly dependency reviews
- **Socket.dev Integration**: Real-time supply chain monitoring
- **GitHub Security Advisories**: Automatic security notifications

## 🎨 Advanced Configuration

### Environment Variable Setup
```bash
export POSTMAN_API_KEY="your-postman-api-key-here"
```

### Alternative Configuration (if global install doesn't work)
```json
{
  "mcpServers": {
    "postman": {
      "command": "node",
      "args": ["$(npm root -g)/postman-mcp-server/build/index.js"],
      "env": {
        "POSTMAN_API_KEY": "your-postman-api-key-here"
      }
    }
  }
}
```

## 🧪 Verification

Test your installation:
```bash
# Check if the command is available
postman-mcp-server --help

# Verify global installation
npm list -g postman-mcp-server
```

## 🚀 Available Tools

🏢 Workspace Tools

#### `list_workspaces`
Get all your Postman workspaces instantly
```json
{ "name": "list_workspaces", "arguments": {} }
```

#### `get_workspace`
Detailed workspace information and metadata
```json
{ "name": "get_workspace", "arguments": { "workspaceId": "workspace-id" } }
```

#### `create_workspace`
Create new team or personal workspaces
```json
{
  "name": "create_workspace",
  "arguments": {
    "name": "My New Workspace",
    "type": "team",
    "description": "Workspace for our new project"
  }
}
```

#### `update_workspace`
Modify workspace settings and descriptions
```json
{
  "name": "update_workspace",
  "arguments": {
    "workspaceId": "workspace-id",
    "name": "Updated Name",
    "description": "New description"
  }
}
```

#### `delete_workspace`
Remove workspaces (use with caution!)
```json
{ "name": "delete_workspace", "arguments": { "workspaceId": "workspace-id" } }
```

📚 Collection Tools

#### `list_collections`
Browse all collections or filter by workspace
```json
{ "name": "list_collections", "arguments": { "workspaceId": "optional-workspace-id" } }
```

#### `get_collection`
Complete collection structure and metadata
```json
{ "name": "get_collection", "arguments": { "collectionId": "collection-id" } }
```

#### `create_collection`
Build new API collections
```json
{
  "name": "create_collection",
  "arguments": {
    "name": "User Management API",
    "description": "Complete user CRUD operations",
    "workspaceId": "workspace-id"
  }
}
```

#### `update_collection`
Modify collection metadata and settings
```json
{
  "name": "update_collection",
  "arguments": {
    "collectionId": "collection-id",
    "name": "Updated API Collection",
    "description": "Enhanced description"
  }
}
```

#### `delete_collection`
Remove collections permanently
```json
{ "name": "delete_collection", "arguments": { "collectionId": "collection-id" } }
```

🌍 Environment Tools

#### `list_environments`
View all environments or filter by workspace
```json
{ "name": "list_environments", "arguments": { "workspaceId": "optional-workspace-id" } }
```

#### `get_environment`
Environment details with all variables
```json
{ "name": "get_environment", "arguments": { "environmentId": "environment-id" } }
```

#### `create_environment`
Set up new environments with variables
```json
{
  "name": "create_environment",
  "arguments": {
    "name": "Production",
    "values": [
      { "key": "baseUrl", "value": "https://api.production.com", "type": "default" },
      { "key": "apiKey", "value": "secret-key", "type": "secret" }
    ],
    "workspaceId": "workspace-id"
  }
}
```

#### `update_environment`
Modify environment variables and settings
```json
{
  "name": "update_environment",
  "arguments": {
    "environmentId": "environment-id",
    "name": "Updated Environment",
    "values": [
      { "key": "newVariable", "value": "newValue", "type": "default" }
    ]
  }
}
```

#### `delete_environment`
Remove environments
```json
{ "name": "delete_environment", "arguments": { "environmentId": "environment-id" } }
```

🔧 Request & Folder Management Tools

#### `create_request`
Create new API requests with complete configuration
```json
{
  "name": "create_request",
  "arguments": {
    "collectionId": "collection-id",
    "name": "Create User",
    "url": "https://api.example.com/users",
    "method": "POST",
    "description": "Create a new user account",
    "headers": [
      { "key": "Content-Type", "value": "application/json" },
      { "key": "Authorization", "value": "Bearer {{token}}" }
    ],
    "body": {
      "mode": "raw",
      "raw": "{\"name\": \"John Doe\", \"email\": \"john@example.com\"}"
    },
    "folderId": "optional-folder-id"
  }
}
```

#### `get_request`
Retrieve detailed request information
```json
{
  "name": "get_request",
  "arguments": {
    "collectionId": "collection-id",
    "requestId": "request-id"
  }
}
```

#### `update_request`
Modify existing requests
```json
{
  "name": "update_request",
  "arguments": {
    "collectionId": "collection-id",
    "requestId": "request-id",
    "name": "Updated Request Name",
    "url": "https://api.example.com/v2/users",
    "method": "PUT",
    "headers": [
      { "key": "Content-Type", "value": "application/json" }
    ]
  }
}
```

#### `delete_request`
Remove requests from collections
```json
{
  "name": "delete_request",
  "arguments": {
    "collectionId": "collection-id",
    "requestId": "request-id"
  }
}
```

#### `create_folder`
Organize requests with folder structures
```json
{
  "name": "create_folder",
  "arguments": {
    "collectionId": "collection-id",
    "name": "User Management",
    "description": "All user-related API endpoints",
    "parentFolderId": "optional-parent-folder-id"
  }
}
```

#### `update_folder`
Modify folder properties
```json
{
  "name": "update_folder",
  "arguments": {
    "collectionId": "collection-id",
    "folderId": "folder-id",
    "name": "Updated Folder Name",
    "description": "Updated description"
  }
}
```

#### `delete_folder`
Remove folders and their contents
```json
{
  "name": "delete_folder",
  "arguments": {
    "collectionId": "collection-id",
    "folderId": "folder-id"
  }
}
```

#### `move_request`
Reorganize requests between folders
```json
{
  "name": "move_request",
  "arguments": {
    "collectionId": "collection-id",
    "requestId": "request-id",
    "targetFolderId": "target-folder-id"
  }
}
```

🎭 Mock Server Tools

#### `list_mock_servers`
Get all your mock servers instantly
```json
{ "name": "list_mock_servers", "arguments": {} }
```

#### `get_mock_server`
Detailed mock server information and configuration
```json
{ "name": "get_mock_server", "arguments": { "mockId": "mock-server-id" } }
```

#### `create_mock_server`
Create new mock servers from collections
```json
{
  "name": "create_mock_server",
  "arguments": {
    "name": "User API Mock",
    "collectionId": "collection-id",
    "environmentId": "environment-id",
    "private": false,
    "config": {
      "headers": [
        { "key": "Content-Type", "value": "application/json" }
      ],
      "matchBody": true,
      "matchQueryParams": true,
      "delay": {
        "type": "fixed",
        "preset": "medium"
      }
    }
  }
}
```

#### `create_

…

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [ankit-roy-0602](https://github.com/ankit-roy-0602)
- **Source:** [ankit-roy-0602/postman-mcp-server](https://github.com/ankit-roy-0602/postman-mcp-server)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-ankit-roy-0602-postman-mcp-server
- Seller: https://agentstack.voostack.com/s/ankit-roy-0602
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.