Use AI agents with the Postman API

The Postman Model Context Protocol (MCP) server enables AI agents like Claude, Cursor, and VS Code to help you manage your Postman resources, including workspaces, collections, specifications, mocks, and monitors. The server translates your natural language commands into API workflows behind the scenes. With MCP, you can build AI agents and complex workflows on top of LLMs using the tools and context provided by the servers.

Communication between the Postman API and the AI agent happens through the following methods:

• Remote Server — Securely links the agent to the server over streamable HTTPS, without requiring any extra agent setup. Great for using the Postman MCP server with your preferred IDE or AI agent. It supports several tool configurations to better serve different use cases.

• Local Server — Runs the MCP server locally on the agent machine with STDIO. Requires downloading and running the source code yourself or spinning up a local Docker image. Local servers also support different tool configurations to support different use cases.

For a complete list of the Postman MCP server’s tools, see the Postman MCP server collection.

EU support

The Postman MCP server supports the EU region for remote and local servers:

• For streamable HTTP, the remote server is available at https://mcp.eu.postman.com/mcp (Full), https://mcp.eu.postman.com/code, and https://mcp.eu.postman.com/minimal.
• For the STDIO public package, use the --region eu flag to specify the Postman API EU region, or set the POSTMAN_API_BASE_URL environment variable directly.

Use cases

• Code synchronization — Effortlessly keep your code in sync with your collections and specifications.
• Collection management — Create and tag collections, update collection and request documentation, add comments, or perform actions across multiple collections without leaving your editor.
• Workspace and environment management — Create workspaces and environments, plus manage your environment variables.
• Automatic spec creation — Create specifications from your code and use them to generate Postman Collections.

The Postman MCP server supports both remote servers through streamable HTTP and local servers with STDIO. Postman also offers servers as an npm package and as a Docker image.

Authentication

For the best developer experience and fastest setup, use OAuth on the remote server. OAuth is fully compliant with the MCP Authorization specification and doesn’t require manual API key configuration.

The EU remote server and the local server support only Postman API key authentication.

Get started with agents

Get set up and running with your remote or local Postman MCP server. Then, explore best practices and tips for getting the most out of its features.