Postman MCP Server
com.postmanPublished by postman.comOfficial publisherv2.15.0Updated Oct 29, 2026
Give your AI agents trusted access to the full Postman platform.
Overview
Connects AI assistants to Postman workspaces, collections, specs and environments so they can manage APIs and generate client code.
- What you can do
- Browse, create and tag collections, update documentation and add comments
- Create workspaces and environments and manage environment variables
- Create specs from code and generate collections from them
- Generate client code that consumes public and internal APIs
- Search Postman documentation for guides, tutorials and reference content (Learn mode)
- Test APIs against existing collections, including local APIs via the local server
- When to use it
- Useful when an assistant should work with your Postman assets directly: keeping code in sync with collections and specs, testing APIs, managing collections, workspaces and environments, or generating client code from API definitions.
- Requirements
- Either the remote endpoint (OAuth on the default region, or an API key header for the EU region) or the local npm package run with npx, which needs Node.js and the POSTMAN_API_KEY environment variable. A Postman account and a valid Postman API key are required; the EU server supports API key authentication only.
Installation
In SourceWeft
- Open Postman MCP Server in the dashboard and add it to a workspace.
- Connect the required credentials. They are stored privately and never shown on public pages.
- Enable the server for the chats that should use its tools.
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Use with an agent
Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.
Read https://sourceweft.com/mcp/com.postman%2Fpostman-mcp-server/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.Other MCP clients
Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.
{
"mcpServers": {
"postman": {
"type": "http",
"url": "https://mcp.postman.com/mcp"
}
}
}README
Postman MCP Server
The Postman MCP Server implements the Model Context Protocol (MCP) to connect AI agents and coding assistants — including Claude Code, Cursor, VS Code Copilot, GitHub Copilot CLI, and Gemini CLI — directly to your Postman workspaces, collections, specifications, and environments.
Postman also offers the server as an npm package.
For the full installation guide with agent-specific setup, see Postman's MCP Server product page.
Postman MCP Server collection
The Postman MCP Server collection is the quickest way to explore, test, and connect to the Postman MCP Server. Use it to:
- Browse the complete list of available tools across all configurations.
- Connect to and test the remote server — Full and Minimal.
- Connect to and test the local server.
Tool configurations
- Minimal — (Default) Only includes essential tools for basic Postman operations. Ideal for users who want to modify a single Postman element, such as collections, workspaces, or environments.
- Code — Includes tools to generate high-quality, well-organized client code from public and internal API definitions. Ideal for users who need to consume APIs or get API context to their agents.
- Full — Includes all available Postman API tools (100+ tools). Ideal for users who engage in advanced collaboration and Postman's Enterprise features.
- Learn — Searches Postman Docs for guides, tutorials, and reference content. Ideal for agents who need to discover Postman features, look up API concepts, or find learning resources.
Authentication
For the best developer experience and fastest setup, use OAuth on the remote server (https://mcp.postman.com). OAuth is fully compliant with the MCP Authorization specification and requires no manual API key configuration.
The EU remote server and the local server support only Postman API key authentication.
Quick start
Remote (any OAuth-compatible MCP host):
Add this URL to your MCP host's configuration:
Change /minimal to /code or /mcp for Code or Full mode. For EU or API key auth, pass Authorization: Bearer <POSTMAN_API_KEY> as a header.
Local:
Add --code or --full for Code or Full mode. Set POSTMAN_API_KEY as an environment variable.
For IDE-specific setup instructions, see the following table. For more information, see the Postman MCP Server docs.
Supported agents and IDEs
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, andhttps://mcp.eu.postman.com/minimal. - For the STDIO public package, use the
--region euflag, or set thePOSTMAN_API_BASE_URLenvironment variable directly. - OAuth isn't supported for the EU server. The EU remote server only supports API key authentication.
Use cases
- API Testing — Continuously test your API using your Postman collection. Use the local server to test local APIs, as the remote server won't have network access to your workstation.
- Code synchronization — Keep your code in sync with your Postman Collections and specs.
- Collection management — Create and tag collections, update documentation, add comments, or perform actions across multiple collections without leaving your editor.
- Workspace and environment management — Create workspaces and environments, plus manage environment variables.
- Automatic spec creation — Create specs from your code and use them to generate collections.
- Client code generation — Generate production-ready client code that consumes APIs following best practices and project conventions.
Docker
For Docker setup and installation, see DOCKER.md.
Contributing
Bug reports, tool requests, and documentation fixes are all welcome — see CONTRIBUTING.md.
The MCP tool definitions and the server implementation here are synced from Postman's
internal source of truth, so changes to files under src/ can't be merged in this
repository — but issues are how those changes get made, and we credit contributions
that ship. Documentation and repository tooling accept pull requests directly.
Found a security issue? See SECURITY.md — please don't open a public issue.
Questions and support
- See Add your MCP requests to your collections to learn how to use Postman to perform MCP requests.
- Visit the Postman Community to share what you've built, ask questions, and get help.
- You can connect to both the remote and local servers and test them using the Postman MCP Server collection.
- Report bugs and request tools in GitHub Issues. See SUPPORT.md for which channel fits your question.
Keywords
Model Context Protocol · MCP Server · Postman · AI Agents · Claude Code · Cursor · VS Code · Specifications · REST API · API Testing · TypeScript · OpenAPI
Source: README.md at commit 9542e55
Tools
0Version history
4- v2.15.0LatestOct 29, 2026
- v2.14.0Oct 16, 2026
- v2.13.0Sep 21, 2026
- v2.12.3Sep 16, 2026
Score
85% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
- Reached in the last 30 daysRequired25 pts
- Auth declaredRequired10 pts
- Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
- DescriptionRequired15 pts
- Logo10 pts
- Documentation15 pts
- License10 pts
