Postman
About
Enables execution of Postman collections using Newman for API testing, validation, and workflow automation directly within conversations.
Details
- Author
- gechmind
- Repository
- Gechmind/mcp-postman
- License
- MIT License
- Categories
- Developer Tools, Productivity, Design, Workplace, AI, Communication, Infrastructure, Automation
Jump to
- Run Postman collections using Newman
- Support for environment files
- Support for global variables
- Detailed test results including:
- Overall success/failure status
- Test summary (total, passed, failed)
- Detailed failure information
- Execution timings
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
PostmanCommand (node, npx, python, etc.)nodeArguments-
Argument 1
/absolute/path/to/mcp-postman/build/index.js
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
-
Argument 1
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Add the server to your Claude desktop configuration file at ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"postman-runner": {
"command": "node",
"args": ["/absolute/path/to/mcp-postman/build/index.js"]
}
}
}
To install Postman Runner for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install mcp-postman --client claude
pnpm install
You can use the server in Claude by asking it to run a Postman collection:
"Run the Postman collection at /path/to/collection.json and tell me if all tests passed"
Claude will:
1. Use the run-collection tool
2. Analyze the test results
3. Provide a human-friendly summary of the execution
bashrun-collection
Runs a Postman collection and returns the test results. Parameters: collection (required, path or URL to the Postman collection), environment (optional, path or URL to environment file), globals (optional, path or URL to globals file), iterationCount (optional, number of iterations to run).
run-collection
Runs a Postman collection and returns the test results.
Parameters:
- collection (required): Path or URL to the Postman collection
- environment (optional): Path or URL to environment file
- globals (optional): Path or URL to globals file
- iterationCount (optional): Number of iterations to run
Example Response:
{
"success": true,
"summary": {
"total": 5,
"failed": 0,
"passed": 5
},
"failures": [],
"timings": {
"started": "2024-03-14T10:00:00.000Z",
"completed": "2024-03-14T10:00:01.000Z",
"duration": 1000
}
}
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"postman": {
"cwd": "string (optional)",
"env": {},
"args": [
"/absolute/path/to/mcp-postman/build/index.js"
],
"shell": false,
"command": "node"
}
}
}
Linux
{
"cwd": "string (optional)",
"env": [],
"args": [
"/absolute/path/to/mcp-postman/build/index.js"
],
"shell": false,
"command": "node"
}
Macos
{
"cwd": "string (optional)",
"env": [],
"args": [
"/absolute/path/to/mcp-postman/build/index.js"
],
"shell": false,
"command": "node"
}
Windows
{
"cwd": "string (optional)",
"env": [],
"args": [
"/absolute/path/to/mcp-postman/build/index.js"
],
"shell": false,
"command": "node"
}
An MCP (Model Context Protocol) server that enables running Postman collections using Newman. This server allows LLMs to execute API tests and get detailed results through a standardized interface.
- Run Postman collections using Newman
- Support for environment files
- Support for global variables
- Detailed test results including:
- Overall success/failure status
- Test summary (total, passed, failed)
- Detailed failure information
- Execution timings
To install Postman Runner for Claude Desktop automatically viaSmithery:
npx -y @smithery/cli install mcp-postman --client claude
# Clone the repository git clone <repository-url> cd mcp-postman # Install dependencies pnpm install # Build the project pnpm build
Add the server to your Claude desktop configuration file at~/Library/Application Support/Claude/claude_desktop_config.json:
{ "mcpServers": { "postman-runner": { "command": "node", "args": ["/absolute/path/to/mcp-postman/build/index.js"] } } }
Runs a Postman collection and returns the test results.
- collection(required): Path or URL to the Postman collection
- environment(optional): Path or URL to environment file
- globals(optional): Path or URL to globals file
- iterationCount(optional): Number of iterations to run
{ "success": true, "summary": { "total": 5, "failed": 0, "passed": 5 }, "failures": [], "timings": { "started": "2024-03-14T10:00:00.000Z", "completed": "2024-03-14T10:00:01.000Z", "duration": 1000 } }
You can use the server in Claude by asking it to run a Postman collection:
"Run the Postman collection at /path/to/collection.json and tell me if all tests passed"
- Use the run-collection tool
- Analyze the test results
- Provide a human-friendly summary of the execution
src/ ├── index.ts # Entry point ├── server/ │ ├── server.ts # MCP Server implementation │ └── types.ts # Type definitions └── newman/ └── runner.ts # Newman runner implementation test/ ├── server.test.ts # Server tests ├── newman-runner.test.ts # Runner tests └── fixtures/ # Test fixtures └── sample-collection.json
# Run tests pnpm test # Run tests with coverage pnpm test:coverage
# Build the project pnpm build # Clean build artifacts pnpm clean
- Fork the repository
- Create your feature branch (git checkout -b feature/amazing-feature)
- Commit your changes (git commit -m 'Add some amazing feature')
- Push to the branch (git push origin feature/amazing-feature)
- Open a Pull Request
This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.
Create crafted UI components inspired by the best 21st.dev design engineers.
Bring agent evaluations, observability, and synthetic test set generation directly into your IDE for free with Galileo's new MCP server
An MCP server to help AI assistants to answer questions and generate AccelByte Extend SDK code more effectively .
MCP server for AI Diagram Maker — generate beautiful software engineering diagrams directly inside Cursor, Claude Desktop, Claude Code, or any MCP-compatible AI agent
ALAPI MCP Tools,Call hundreds of API interfaces via MCP
AI-powered SVG animation generator that transforms static files into animated SVG components using the Allyson platform
MCP server that gives AI assistants on-demand access to 1,500+ amCharts docs, ~300 code examples, and 1000+ class API references.
APIMatic MCP Server is used to validate OpenAPI specifications using APIMatic. The server processes OpenAPI files and returns validation summaries by leveraging APIMatic’s API.
One shared context layer for AI agents and humans — live API specs, DB schemas, and versioned contracts across repos so every agent and teammate works from the same source of truth.
Build and deploy full-stack Next.js apps with 98 tools for React, AWS, and MongoDB
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.





