Postman MCP Server

What is Postman MCP Server?

A Node.js Express server that provides an interface for managing Postman collections, creating mock servers, and running API tests using Newman (Postman’s command-line collection runner). It is designed for API development and testing environments.

How to use Postman MCP Server?

Clone the repository, install dependencies with npm install, copy .env.example to .env and fill in your Postman API key, then run npm start. The server starts on the port defined in the .env file (default 3000). Use the provided API endpoints to manage test scenarios, mock servers, and run tests.

Key features of Postman MCP Server

• Create and manage test scenarios from Postman collections
• Generate mock servers based on Postman collections
• Run API tests using Newman

Use cases of Postman MCP Server

• Automate API testing workflows in a development pipeline
• Quickly spin up mock servers for front‑end or third‑party integration
• Centralize test scenario management across a team

FAQ from Postman MCP Server

What are the prerequisites for running the server?

Node.js v14 or higher, npm or yarn, and a valid Postman API key.

How do I configure the server?

Copy .env.example to .env, then update the file with your Postman API key and other configuration values.

What API endpoints are available?

• POST /create-scenario – Create a test scenario from a Postman collection
• POST /create-mock – Create a mock server from a Postman collection
• POST /run-tests/:scenarioId – Run tests for a specific scenario using Newman

Where does the server store data?

The project includes a data/ directory for data storage, but the exact storage mechanism (e.g., files or database) is not specified in the README.

What transport does the server use?

The server listens for HTTP requests on the configured port (default 3000). No authentication mechanism beyond the Postman API key is described.