Postman

Postman

An MCP server that runs Postman collections via Newman for API testing.

83
Stars
20
Forks
0
Releases

Overview

The Postman MCP Server is an MCP (Model Context Protocol) server that enables running Postman collections using Newman. It allows large language models (LLMs) to execute API tests and receive structured results through a standardized interface. The server supports optional environment files and global variables, enabling realistic test contexts and reusable configurations. On completion, it returns a comprehensive payload that includes an overall success flag, a test summary (total, passed, failed), any detailed failures, and execution timings (start, end, duration). It exposes a run-collection tool for submitting a collection path or URL, with optional environment and globals and an optional iterationCount to run multiple iterations. The results are designed for easy consumption by natural language agents, enabling human-friendly summaries or driving automated decisions. The server can be installed via Smithery or built manually, and is designed to integrate with Claude Desktop configurations for seamless usage with Claude and similar environments.

Details

Owner
shannonlal
Language
TypeScript
License
MIT License
Updated
2025-12-07

Features

Run Postman collections with Newman

Execute Postman collections locally through Newman via the MCP server.

Environment file support

Optional environment files provided as JSON/YAML to configure tests.

Global variables support

Include global variables to be used across test runs.

Detailed test results

Return overall status, test summary, detailed failures, and timings.

Standardized MCP interface for LLMs

Provides a consistent run-collection tool for LLM-driven test execution.

Iteration support

Support multiple runs of a collection via an optional iterationCount.

Audience

LLMsEnable LLMs to run and assess API tests via Postman collections.
DevelopersIntegrate test execution into internal apps or CI pipelines for automated API validation.

Tags

PostmanNewmanAPI testingMCP serverLLM integrationEnvironment filesGlobal variablesTest resultsExecution timings