by postmanlabs
Enables AI agents and assistants to interact with Postman workspaces, collections, environments, and API specifications through natural language commands.
The server provides a bridge between AI tools and Postman's API ecosystem, allowing AI‑driven workflows to create, read, update, and delete Postman resources without writing code.
https://mcp.postman.com/minimal
for minimal mode or https://mcp.postman.com/mcp
for full mode) and set the Authorization: Bearer <API_KEY>
header.npx @postman/postman-mcp-server
(add --full
for the complete toolset and --region eu
if needed)..vscode/mcp.json
(or equivalent) with the server definition and an input prompt for the API key.Q: Do I need a Postman account? A: Yes, a Postman account with a valid API key is required.
Q: Which mode should I start with? A: Use the Minimal mode for simple tasks; switch to Full mode when you need the complete suite of 100+ tools.
Q: How do I switch between US and EU regions?
A: Change the endpoint URL (https://mcp.eu.postman.com/...
) for remote servers or add the --region eu
flag (or set POSTMAN_API_BASE_URL
) for the local server.
Q: Can I run the server in Docker?
A: Yes, refer to the DOCKER.md
in the repository for container setup.
Q: What changed from v1 to v2?
A: Tool names moved to camelCase, the minimal set now includes 37 core tools, and the --full
flag unlocks the entire catalog.
The Postman MCP Server connects Postman to AI tools, giving AI agents and assistants the ability to access workspaces, manage collections and environments, evaluate APIs, and automate workflows through natural language interactions.
Postman supports the following tool configurations:
For a complete list of the Postman MCP Server's tools, see the Postman MCP Server collection. This collection offers both the remote full and minimal servers, and the local server.
Postman also offers servers as an npm package.
Note: Before getting started, ensure that you have a valid Postman API key.
Designed for developers who want to integrate their AI tools with Postman’s context and features. Supports quick natural language queries queries to advanced agent workflows.
The Postman MCP Server supports the EU region for remote and local servers:
https://mcp.eu.postman.com
.--region
flag to specify the Postman API region (us
or eu
), or set the POSTMAN_API_BASE_URL
environment variable directly.The remote Postman MCP Server is hosted by Postman over streamable HTTP and provides the easiest method for getting started. If your MCP host doesn't support remote MCP servers, you can use the local Postman MCP Server.
The remote server supports the following tool configurations:
https://mcp.postman.com/minimal
and https://mcp.eu.postman.com/minimal
for EU users.https://mcp.postman.com/mcp
and https://mcp.eu.postman.com/mcp
for EU users.To install the remote Postman MCP Server in Cursor, click the install button.
Note: Ensure that the Authorization header uses the Bearer <YOUR_API_KEY>
format.
By default, the server uses Minimal mode. To access Full mode, change the url
value to https://mcp.postman.com/mcp
in the mcp.json
file.
To install the remote Postman MCP Server in VS Code, click the install button or use the Postman VS Code Extension.
By default, the server uses Minimal mode. To access Full mode, change the url
value to https://mcp.postman.com/mcp
in the mcp.json
file.
You can use the Postman MCP Server with MCP-compatible extensions in VS Code, such as GitHub Copilot, Claude for VS Code, or other AI assistants that support MCP. To do so, add the following JSON block to the .vscode/mcp.json
configuration file:
{
"servers": {
"postman-api-http-server": {
"type": "http",
"url": "https://mcp.postman.com/{minimal OR mcp}",
// Use "https://mcp.postman.com/mcp" for full or "https://mcp.postman.com/minimal" for minimal mode.
// For the EU server, use the "https://mcp.eu.postman.com" URL.
"headers": {
"Authorization": "Bearer ${input:postman-api-key}"
}
}
},
"inputs": [
{
"id": "postman-api-key",
"type": "promptString",
"description": "Enter your Postman API key"
}
]
}
When prompted, enter your Postman API key.
To install the MCP server in Claude Code, run the following command in your terminal:
For Minimal mode:
claude mcp add --transport http postman https://mcp.postman.com/minimal
For Full mode:
claude mcp add --transport http postman https://mcp.postman.com/mcp
If remote MCP servers aren't supported by your MCP host, you can install the Postman MCP Server to your local machine.
STDIO is a lightweight solution that's ideal for integration with editors and tools like Visual Studio Code. Install an MCP-compatible VS Code extension, such as GitHub Copilot, Claude for VS Code, or other AI assistants that support MCP.
Note: To run the server as a Node application, install Node.js.
The local server supports the following tool configurations:
--full
flag to enable this configuration.Note: Use the --region
flag to specify the Postman API region (us
or eu
), or set the POSTMAN_API_BASE_URL
environment variable directly. By default, the server uses the us
option.
To install the local Postman MCP Server in VS Code, click the install button.
By default, the server uses Full mode. To access Minimal mode, remove the --full
flag from the mcp.json
configuration file.
You can manually integrate your MCP server with Cursor or VS Code to use it with extensions that support MCP. To do this, create a mcp.json
file in your project and add the following JSON block to it:
{
"servers": {
"postman-api-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"@postman/postman-mcp-server",
"--full" // (optional) Use this flag to enable full mode.
"--region us" // (optional) Use this flag to specify the Postman API region (us or eu). Defaults to us.
],
"env": {
"POSTMAN_API_KEY": "${input:postman-api-key}"
}
}
},
"inputs": [
{
"id": "postman-api-key",
"type": "promptString",
"description": "Enter your Postman API key"
}
]
}
To install the local Postman MCP Server in Cursor, click the install button.
By default, the server uses Full mode. To access Minimal mode, remove the --full
flag from the mcp.json
configuration file.
To integrate the MCP server with Claude, check the latest Postman MCP Server release and get the .mcpb
file.
postman-api-mcp-minimal.mcpb
postman-api-mcp-full.mcpb
For more information, see the Claude Desktop Extensions documentation.
To install the MCP server in Claude Code, run the following command in your terminal:
For Minimal mode:
claude mcp add postman -- npx @postman/mcp-server@latest
For Full mode:
claude mcp add postman -- npx @postman/mcp-server@latest --full
To install the MCP server as a Gemini CLI extension, run the following command in your terminal:
gemini extensions install https://github.com/postmanlabs/postman-mcp-server
For Docker set up and installation, see DOCKER.md.
If you're migrating from Postman MCP Server version 1.x to 2.x, be aware of the following:
create-collection
→ createCollection
get-workspaces
→ getWorkspaces
delete-environment
→ deleteEnvironment
--full
flag provides access to all tools.Please log in to share your review and rating for this MCP.
{ "mcpServers": { "postman-mcp-server": { "command": "npx", "args": [ "@postman/postman-mcp-server" ], "env": { "POSTMAN_API_KEY": "<YOUR_API_KEY>" } } } }
Discover more MCP servers with similar functionality and use cases
by zed-industries
Provides real-time collaborative editing powered by Rust, enabling developers to edit code instantly across machines with a responsive, GPU-accelerated UI.
by cline
Provides autonomous coding assistance directly in the IDE, enabling file creation, editing, terminal command execution, browser interactions, and tool extension with user approval at each step.
by continuedev
Provides continuous AI assistance across IDEs, terminals, and CI pipelines, offering agents, chat, inline editing, and autocomplete to accelerate software development.
by github
Enables AI agents, assistants, and chatbots to interact with GitHub via natural‑language commands, providing read‑write access to repositories, issues, pull requests, workflows, security data and team activity.
by block
Automates engineering tasks by installing, executing, editing, and testing code using any large language model, providing end‑to‑end project building, debugging, workflow orchestration, and external API interaction.
by RooCodeInc
An autonomous coding agent that lives inside VS Code, capable of generating, refactoring, debugging code, managing files, running terminal commands, controlling a browser, and adapting its behavior through custom modes and instructions.
by lastmile-ai
A lightweight, composable framework for building AI agents using Model Context Protocol and simple workflow patterns.
by firebase
Provides a command‑line interface to manage, test, and deploy Firebase projects, covering hosting, databases, authentication, cloud functions, extensions, and CI/CD workflows.
by gptme
Empowers large language models to act as personal AI assistants directly inside the terminal, providing capabilities such as code execution, file manipulation, web browsing, vision, and interactive tool usage.