Home / MCP / Postman MCP Server

Postman MCP Server

Runs Postman collections with Newman, supporting environment files and globals, and returns detailed test results for MCP clients.

typescript

View on GitHub

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

This MCP server lets you run Postman collections using Newman and exposes detailed test results through a standardized interface, enabling efficient API testing by LLMs and automation workflows.

How to use

You can use this server with your MCP client to run Postman collections and retrieve test results. The core tool is run-collection, which executes a specified Postman collection and returns a structured result set that includes an overall status, a summary of tests, any failures, and execution timings.

How to install

Prerequisites you need before installation:

- Node.js (for running the MCP server) - you may already have this installed on your system. If not, install Node.js from the official source for your platform.

Installation via Smithery (automatic) for Claude Desktop integration:

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

Manual installation (from source):

# Clone the repository
git clone <repository-url>
cd mcp-postman

# Install dependencies
pnpm install

# Build the project
pnpm build

Additional configuration and notes

Configure your client to point to the MCP server. The server is exposed via a standard MCP stdio interface, so you connect by launching the Node process that runs the built index. Use the following configuration snippet to wire the server into your MCP client setup.

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

Troubleshooting and notes

If you encounter issues starting the server, ensure the path to the built index.js is correct and that dependencies were installed during the build step. Check that Node.js is accessible from your shell where you launch the MCP client.

Available tools

run-collection

Runs a Postman collection using Newman with optional environment and globals files, returning a structured result with status, summary, failures, and timings.