Skip to content
Postman MCP Server

Postman MCP Server

Released
26 views
v2.11.2
Apache-2.0

Summary

Postman's official MCP server — reach your workspaces, collections, specs and environments from Claude Code, Cursor, VS Code or Copilot, in four tool tiers.

Features

  • Four tool tiers: Minimal, Code, Full and Learn
  • Remote server with OAuth — no API key to manage
  • Local stdio server for testing APIs on your own machine
  • EU-region remote and local endpoints
  • Generate client code from API definitions
  • Create specs from code and collections from specs
  • Manage workspaces, environments and environment variables

Installation

Set up this MCP server in your favorite AI agent — copy a ready-made configuration below.

Any MCP-compatible agent

Most agents (Claude, Cursor, Windsurf, VS Code, and more) read a standard mcpServers configuration.

  1. Open your agent's MCP configuration file.
  2. Merge the snippet below into it, filling in the environment variables with your own values.
  3. Restart the agent — the "Postman MCP Server" tools will be available.
{
  "mcpServers": {
    "postman-mcp": {
      "command": "npx",
      "args": [
        "@postman/postman-mcp-server"
      ],
      "env": {
        "POSTMAN_API_KEY": "<your_postman_api_key>"
      }
    }
  }
}

Description

Postman's official MCP server connects an AI coding assistant to your Postman account: workspaces, collections, API specifications and environments become things the agent can read and change directly.

Four configurations, not one

The tool count is the usual failure mode for a large API, and Postman addresses it by shipping tiers rather than one 100-tool server:

  • Minimal (default) — the essential operations for working on a single collection, workspace or environment.
  • Code — adds tooling to generate well-organised client code from public and internal API definitions. This is the tier to use when the goal is consuming an API rather than curating it.
  • Full — all 100+ Postman API tools, including the Enterprise collaboration surface.
  • Learn — searches the Postman documentation for guides and reference.

Picking the narrowest tier that covers the job keeps the agent's tool list short and its choices better.

Remote and local

The remote server at https://mcp.postman.com supports OAuth compliant with the MCP authorization specification, which means no API key handling at all — append /minimal, /code or /mcp to select the tier. The local server runs as npx @postman/postman-mcp-server with POSTMAN_API_KEY set, plus --code or --full to change tier. Local is the one you need for testing an API running on your own machine, since the remote server cannot reach your workstation.

EU customers get https://mcp.eu.postman.com/… for the remote server or --region eu locally; the EU endpoints are API-key only, with no OAuth.

What people use it for

Running a collection against an API continuously while developing it, keeping code and collections in sync, bulk collection and documentation edits, creating specs from existing code and generating collections from them, and producing client code that follows the project's conventions.

Officially supported across Claude Code, Claude Desktop, Cursor, VS Code, Codex, GitHub Copilot CLI, Kiro, Antigravity CLI and Docker. Apache-2.0 licensed.

Related MCP Servers

MCP: Headroom

by Headroom Labs

New

Context-compression MCP server that shrinks tool outputs, logs, files and RAG chunks before they reach the model, cutting 60-95% of tokens on JSON payloads.

MCP: Engram

by Gentleman Programming

New

Persistent memory for coding agents as a single Go binary — SQLite and FTS5 behind MCP, an HTTP API, a CLI and a TUI, with no Node, Python or Docker required.

MCP: agent-device

by Callstack

New

Give a coding agent a live feedback loop on real mobile, TV and desktop apps — inspect, tap, type and capture evidence on iOS, Android and HarmonyOS over MCP or a CLI.

New

The official W&B MCP server: query experiment runs, Weave LLM traces, artifacts and registries in natural language, and write findings back as a W&B report.

Browse all MCP servers →