Postman Collection Runner MCP Server

Postman Collection Runner MCP

This MCP server enables you to run Postman collections using Newman, providing a powerful way to test APIs and automate API workflows directly from your AI assistant.

Features

• Run Postman collections with environment variables
• Execute API tests and validate responses
• Support for complex API workflows
• Integration with AI assistants for API testing and validation

Installation

To use the Postman Collection Runner MCP, you'll need to add it to your MCP client configuration:

1. Install the package globally:

npm install -g mcp-postman

2. Or run it directly using npx:

npx mcp-postman

Usage

The MCP server accepts Postman collections in JSON format and can run them with optional environment variables. You can use it to:

1. Test API endpoints
2. Validate API responses
3. Run complex API workflows
4. Automate API testing

Example

Here's an example of how to use the MCP to run a Postman collection:

1. Prepare your Postman collection in JSON format
2. Optionally prepare an environment file with variables
3. Send the collection to the MCP server
4. Review the test results

Configuration Options

The MCP server supports several configuration options:

• Port: Configure the port the server runs on (default: 3000)
• Timeout: Set maximum execution time for collections
• Reporter: Choose output format for test results

Requirements

• Node.js 14 or higher
• Newman (installed automatically as a dependency)

Troubleshooting

If you encounter issues:

1. Ensure your Postman collection is valid JSON
2. Check that environment variables are correctly formatted
3. Verify network connectivity to API endpoints
4. Check for proper authentication in your collection