postman

The Postman MCP Server integrates Postman capabilities with AI agents via the MCP protocol, enabling natural language queries to access Postman workspaces, collections, environments, and API tooling. With Minimal, Code, and Full tool configurations, you can tailor the breadth of Postman tools exposed to your AI agents—from basic workspace and collection management to advanced API code generation. The server supports both remote (OAuth-enabled) usage and local operation with API key authentication, and it can generate client code from API definitions using the Code tools. Use the remote server for quick onboarding and public APIs; switch to the local server when you need network access to your workstation or private APIs. Tools available include management of workspaces, environments, collections, documentation, tagging, and automated spec creation, as well as client code generation that adheres to your API definitions and project conventions.

Prerequisites:

• Node.js (LTS) and npm installed on your machine.
• Optional: access to Postman API keys if using non-OAuth remote setup.

1. Install the MCP server package (example using npm to install globally):

   npm install -g @postman/postman-mcp-server

2. Run the MCP server via npx (as configured in mcp_config):

   npx -y @postman/postman-mcp-server

3. Alternatively, run via local development for testing:

   npm install -g @postman/postman-mcp-server postman-mcp-server --help

4. Configure environment variables if needed:

   • POSTMAN_API_BASE_URL: Set region/base URL for Postman API (e.g., https://api.postman.com or EU variant)
   • POSTMAN_API_KEY: If using API-key authentication for local usage

5. For production usage, consider using a process manager (pm2, systemd) to keep the MCP server running and auto-restart on failures.

Notes and tips:

• OAuth support is available for the remote Postman MCP server; EU remote server may require API key authentication depending on configuration.
• The Minimal configuration provides basic Postman operations with faster performance; Full exposes 100+ tools for advanced collaboration; Code enables API definition exploration and client code generation.
• When using the local server, ensure the host environment has network access to your Postman workspace and API endpoints if needed.
• If you use the EU region, be mindful of authentication differences and base URLs as documented in Postman MCP Server docs.
• Environment variables can be used to override base URLs or credentials without modifying the server code.
• If you encounter tool availability issues, confirm that you are using the correct MCP tool configuration (Minimal, Code, Full) and that your API keys or OAuth tokens are valid.