# mcp-postman

> MCP Server

This repository provides an MCP server that executes Postman collections using Newman, enabling LLMs to run API tests and receive detailed results through a standardized interface. This repository provides an

## Overview

- **Category:** Developer Tools
- **Language:** TypeScript
- **Stars:** 84
- **Forks:** 3
- **Owner:** shannonlal
- **GitHub:** https://github.com/shannonlal/mcp-postman
- **Created:** 2024-12-31T16:44:39+00:00
- **Updated:** 2025-03-28T12:52:10+00:00
- **Source:** https://model-context-protocol.com/servers/mcp-server-run-postman-collections

## Setup

## Setup

### Installing via Smithery

To install Postman Runner for Claude Desktop automatically via [Smithery](https://smithery.ai/server/mcp-postman):

```bash
npx -y @smithery/cli install mcp-postman --client claude
```

### Manual Installation
```bash
# 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`:

```json
{
  "mcpServers": {
    "postman-runner": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-postman/build/index.js"]
    }
  }
}
```

## Tools

## Available Tools

		1. Run Postman collections using Newman
		2. Support for environment files
		3. Support for global variables
		4. Detailed test results including overall success/failure status, test summary, detailed failure information, and execution timings
		5. `run-collection` (Runs a Postman collection and returns the test results.)