Summary
The Postman MCP Server integrates Postman's API testing and collection management capabilities with AI agents, enabling natural language interactions to access workspaces, manage collections and environments, and automate API workflows. It provides three tool configuration levels—Minimal (essential operations), Full (100+ tools for advanced collaboration), and Code (API code generation)—supporting both OAuth and API key authentication on remote and local deployments. This server solves the problem of enabling AI assistants to programmatically interact with Postman for API testing, code synchronization, and collection management without manual configuration.
Fastest browser for AI agents to run web automation tasks, always free.
Download Free life-time →
Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →
Block distracting apps from your iPhone permanently without a 3rd party app. Free and open source.
Block now (100% free) →Tools
Public tool metadata for what this MCP can expose to an agent.
41 tools
createCollectionCreates a collection using the [Postman Collection v2.1.0 schema format](https://schema.postman.com/collection/json/v2.1.0/draft-07/docs/index.html). **Note:** If you do not include the \`workspace\` query parameter, the system creates the collection in the oldest personal Int...2 params
Creates a collection using the [Postman Collection v2.1.0 schema format](https://schema.postman.com/collection/json/v2.1.0/draft-07/docs/index.html). **Note:** If you do not include the \`workspace\` query parameter, the system creates the collection in the oldest personal Int...
Parameters* required
collectionobjectworkspacestringThe workspace's ID.
createCollectionRequestCreates a request in a collection. For a complete list of properties, refer to the **Request** entry in the [Postman Collection Format documentation](https://schema.postman.com/collection/json/v2.1.0/draft-07/docs/index.html). **Note:** It is recommended that you pass the \`na...15 params
Creates a request in a collection. For a complete list of properties, refer to the **Request** entry in the [Postman Collection Format documentation](https://schema.postman.com/collection/json/v2.1.0/draft-07/docs/index.html). **Note:** It is recommended that you pass the \`na...
Parameters* required
authvalueThe request's authentication information.
collectionIdstringThe collection's ID.
datavalueThe request body's form data.
dataModestringThe request body's data mode.one of
raw · urlencoded · formdata · binary · graphqldataOptionsvalueAdditional configurations and options set for the request body's various data modes.
descriptionstringThe request's description.
eventsvalueA list of scripts configured to run when specific events occur.
folderIdstringThe folder ID in which to create the request. By default, the system will create the request at the collection level.
graphqlModeDatavalueThe request body's GraphQL mode data.
headerDataarrayThe request's headers.
methodstringThe request's HTTP method.one of
GET · PUT · POST · PATCH · DELETE · COPYnamestringThe request's name. It is recommended that you pass the `name` property in the request body. If you do not, the system uses a null value. As a result, this creates a request with a blank name.
queryParamsarrayThe request's query parameters.
rawModeDatastringThe request body's raw mode data.
urlstringThe request's URL.
createCollectionResponseCreates a request response in a collection. For a complete list of request body properties, refer to the **Response** entry in the [Postman Collection Format documentation](https://schema.postman.com/collection/json/v2.1.0/draft-07/docs/index.html). **Note:** It is recommended...19 params
Creates a request response in a collection. For a complete list of request body properties, refer to the **Response** entry in the [Postman Collection Format documentation](https://schema.postman.com/collection/json/v2.1.0/draft-07/docs/index.html). **Note:** It is recommended...
Parameters* required
collectionIdstringThe collection's ID.
cookiesstringThe response's cookie data.
dataModestringThe associated request body's data mode.one of
raw · urlencoded · formdata · binary · graphqldataOptionsvalueAdditional configurations and options set for the request body's various data modes.
descriptionstringThe response's description.
headersarrayA list of headers.
languagestringThe response body's language type.
methodstringThe request's HTTP method.one of
GET · PUT · POST · PATCH · DELETE · COPYmimestringThe response's MIME type.
namestringThe response's name. It is recommended that you pass the `name` property in the request body. If you do not, the system uses a null value. As a result, this creates a response with a blank name.
rawDataTypestringThe response's raw data type.
rawModeDatastringThe associated request body's raw mode data.
requeststringThe parent request's ID.
requestObjectstringA JSON-stringified representation of the associated request.
responseCodeobjectThe response's HTTP response code information.
statusstringThe response's HTTP status text.
textstringThe raw text of the response body.
timestringThe time taken by the request to complete, in milliseconds.
urlstringThe associated request's URL.
createEnvironmentCreates an environment. **Note:** - The request body size cannot exceed the maximum allowed size of 30MB. - If you receive an HTTP \`411 Length Required\` error response, manually pass the \`Content-Length\` header and its value in the request header. - If you do not include t...2 params
Creates an environment. **Note:** - The request body size cannot exceed the maximum allowed size of 30MB. - If you receive an HTTP \`411 Length Required\` error response, manually pass the \`Content-Length\` header and its value in the request header. - If you do not include t...
Parameters* required
environmentobjectInformation about the environment.
workspacestringThe workspace's ID.
createMockCreates a mock server in a collection. - Pass the collection UID (ownerId-collectionId), not the bare collection ID. - If you only have a \`collectionId\`, resolve the UID first: 1) Prefer GET \`/collections/{collectionId}\` and read \`uid\`, or 2) Construct \`{ownerId}-{colle...2 params
Creates a mock server in a collection. - Pass the collection UID (ownerId-collectionId), not the bare collection ID. - If you only have a \`collectionId\`, resolve the UID first: 1) Prefer GET \`/collections/{collectionId}\` and read \`uid\`, or 2) Construct \`{ownerId}-{colle...
Parameters* required
mockobjectworkspacestringThe workspace's ID.
createSpecCreates an API specification in Postman's [Spec Hub](https://learning.postman.com/docs/design-apis/specifications/overview/). Specifications can be single or multi-file. **Note:** - Postman supports OpenAPI 2.0, OpenAPI 3.0, OpenAPI 3.1, AsyncAPI 2.0, protobuf 2 and 3, and Gra...4 params
Creates an API specification in Postman's [Spec Hub](https://learning.postman.com/docs/design-apis/specifications/overview/). Specifications can be single or multi-file. **Note:** - Postman supports OpenAPI 2.0, OpenAPI 3.0, OpenAPI 3.1, AsyncAPI 2.0, protobuf 2 and 3, and Gra...
Parameters* required
filesarrayA list of the specification's files and their contents.
namestringThe specification's name.
typestringThe specification's type.one of
OPENAPI:2.0 · OPENAPI:3.0 · OPENAPI:3.1 · ASYNCAPI:2.0 · PROTOBUF:2 · PROTOBUF:3workspaceIdstringThe workspace's ID.
createSpecFileCreates an API specification file. **Note:** - If the file path contains a \`/\` (forward slash) character, then a folder is created. For example, if the path is the \`components/schemas.json\` value, then a \`components\` folder is created with the \`schemas.json\` file insid...3 params
Creates an API specification file. **Note:** - If the file path contains a \`/\` (forward slash) character, then a folder is created. For example, if the path is the \`components/schemas.json\` value, then a \`components\` folder is created with the \`schemas.json\` file insid...
Parameters* required
contentstringThe file's stringified contents.
pathstringThe file's path. Accepts JSON or YAML files.
specIdstringThe spec's ID.
createWorkspaceCreates a new [workspace](https://learning.postman.com/docs/collaborating-in-postman/using-workspaces/creating-workspaces/). **Note:** - This endpoint returns a 403 \`Forbidden\` response if the user does not have permission to create workspaces. [Admins and Super Admins](http...1 params
Creates a new [workspace](https://learning.postman.com/docs/collaborating-in-postman/using-workspaces/creating-workspaces/). **Note:** - This endpoint returns a 403 \`Forbidden\` response if the user does not have permission to create workspaces. [Admins and Super Admins](http...
Parameters* required
workspaceobjectInformation about the workspace.
duplicateCollectionCreates a duplicate of the given collection in another workspace. Use the GET \`/collection-duplicate-tasks/{taskId}\` endpoint to get the duplication task's current status.3 params
Creates a duplicate of the given collection in another workspace. Use the GET \`/collection-duplicate-tasks/{taskId}\` endpoint to get the duplication task's current status.
Parameters* required
collectionIdstringThe collection's unique ID.
suffixstringAn optional suffix to append to the duplicated collection's name.
workspacestringThe workspace ID in which to duplicate the collection.
generateCollectionCreates a collection from the given API specification. The specification must already exist or be created before it can be used to generate a collection. The response contains a polling link to the task status.4 params
Creates a collection from the given API specification. The specification must already exist or be created before it can be used to generate a collection. The response contains a polling link to the task status.
Parameters* required
elementTypestringThe `collection` element type.
namestringThe generated collection's name.
optionsobjectThe advanced creation options and their values. For more details, see Postman's [OpenAPI to Postman Collection Converter OPTIONS documentation](https://github.com/postmanlabs/openapi-to-postman/blo...
specIdstringThe spec's ID.
generateSpecFromCollectionGenerates an API specification for the given collection. The response contains a polling link to the task status.5 params
Generates an API specification for the given collection. The response contains a polling link to the task status.
Parameters* required
collectionUidstringThe collection's unique ID.
elementTypestringThe `spec` value.
formatstringThe format of the API specification.one of
JSON · YAMLnamestringThe API specification's name.
typestringThe specification's type.
getAllSpecsGets all API specifications in a workspace.3 params
Gets all API specifications in a workspace.
Parameters* required
cursorstringThe pointer to the first record of the set of paginated results. To view the next response, use the `nextCursor` value for this parameter.
limitintegerThe maximum number of rows to return in the response.default: 10
workspaceIdstringThe workspace's ID.
getAuthenticatedUserGets information about the authenticated user. - This endpoint provides “current user” context (\`user.id\`, \`username\`, \`teamId\`, roles). - When a user asks for “my …” (e.g., “my workspaces, my information, etc.”), call this first to resolve the user ID.
Gets information about the authenticated user. - This endpoint provides “current user” context (\`user.id\`, \`username\`, \`teamId\`, roles). - When a user asks for “my …” (e.g., “my workspaces, my information, etc.”), call this first to resolve the user ID.
No parameter schema in public metadata yet.
getCollectionGet information about a collection. By default this tool returns the lightweight collection map (metadata + recursive itemRefs). Use the model parameter to opt in to Postman's full API responses: - model=minimal — root-level folder/request IDs only - model=full — full Postman...3 params
Get information about a collection. By default this tool returns the lightweight collection map (metadata + recursive itemRefs). Use the model parameter to opt in to Postman's full API responses: - model=minimal — root-level folder/request IDs only - model=full — full Postman...
Parameters* required
access_keystringA collection's read-only access key. Using this query parameter does not require an API key to call the endpoint.
collectionIdstringThe collection ID must be in the form <OWNER_ID>-<UUID> (e.g. 12345-33823532ab9e41c9b6fd12d0fd459b8b).
modelstringOptional response shape override. Omit to receive the lightweight collection map. Set to `minimal` for the Postman minimal model or `full` for the complete collection payload.one of
minimal · fullgetCollectionsThe workspace ID query is required for this endpoint. If not provided, the LLM should ask the user to provide it.4 params
The workspace ID query is required for this endpoint. If not provided, the LLM should ask the user to provide it.
Parameters* required
limitintegerThe maximum number of rows to return in the response.
namestringFilter results by collections that match the given name.
offsetintegerThe zero-based offset of the first item to return.
workspacestringThe workspace's ID.
getDuplicateCollectionTaskStatusGets the status of a collection duplication task.1 params
Gets the status of a collection duplication task.
Parameters* required
taskIdstringThe task's unique ID.
getEnabledToolsIMPORTANT: Run this tool first when a requested tool is unavailable. Returns information about which tools are enabled in the full and minimal tool sets, helping you identify available alternatives.
IMPORTANT: Run this tool first when a requested tool is unavailable. Returns information about which tools are enabled in the full and minimal tool sets, helping you identify available alternatives.
No parameter schema in public metadata yet.
getEnvironmentGets information about an environment.1 params
Gets information about an environment.
Parameters* required
environmentIdstringThe environment's ID.
getEnvironmentsGets information about all of your [environments](https://learning.postman.com/docs/sending-requests/managing-environments/).1 params
Gets information about all of your [environments](https://learning.postman.com/docs/sending-requests/managing-environments/).
Parameters* required
workspacestringThe workspace's ID.
getGeneratedCollectionSpecsGets the API specification generated for the given collection.2 params
Gets the API specification generated for the given collection.
Parameters* required
collectionUidstringThe collection's unique ID.
elementTypestringThe `spec` value.
getMockGets information about a mock server. - Resource: Mock server entity. Response includes the associated \`collection\` UID and \`mockUrl\`. - Use the \`collection\` UID to navigate back to the source collection.1 params
Gets information about a mock server. - Resource: Mock server entity. Response includes the associated \`collection\` UID and \`mockUrl\`. - Use the \`collection\` UID to navigate back to the source collection.
Parameters* required
mockIdstringThe mock's ID.
getMocksGets all active mock servers. By default, returns only mock servers you created across all workspaces. - Always pass either the \`workspace\` or \`teamId\` query to scope results. Prefer \`workspace\` when known. - If you need team-scoped results, set \`teamId\` from the curre...2 params
Gets all active mock servers. By default, returns only mock servers you created across all workspaces. - Always pass either the \`workspace\` or \`teamId\` query to scope results. Prefer \`workspace\` when known. - If you need team-scoped results, set \`teamId\` from the curre...
Parameters* required
teamIdstringReturn only results that belong to the given team ID.
- For team-scoped requests, set this from GET `/me` (`me.teamId`).
workspacestringReturn only results found in the given workspace ID.
- Prefer this parameter when the user mentions a specific workspace.
getSpecGets information about an API specification.1 params
Gets information about an API specification.
Parameters* required
specIdstringThe spec's ID.
getSpecCollectionsGets all of an API specification's generated collections.4 params
Gets all of an API specification's generated collections.
Parameters* required
cursorstringThe pointer to the first record of the set of paginated results. To view the next response, use the `nextCursor` value for this parameter.
elementTypestringThe `collection` element type.
limitintegerThe maximum number of rows to return in the response.default: 10
specIdstringThe spec's ID.
getSpecDefinitionGets the complete contents of an API specification's definition.1 params
Gets the complete contents of an API specification's definition.
Parameters* required
specIdstringThe spec's ID.
getSpecFileGets the contents of an API specification's file.2 params
Gets the contents of an API specification's file.
Parameters* required
filePathstringThe path to the file.
specIdstringThe spec's ID.
getSpecFilesGets all the files in an API specification.1 params
Gets all the files in an API specification.
Parameters* required
specIdstringThe spec's ID.
getTaggedEntities**Requires an Enterprise plan.** Tagging is only available on Postman Enterprise plans. This tool returns a 404 error on Free, Basic, and Professional accounts. Gets Postman elements (entities) by a given tag. Tags enable you to organize and search workspaces, APIs, and collec...5 params
**Requires an Enterprise plan.** Tagging is only available on Postman Enterprise plans. This tool returns a 404 error on Free, Basic, and Professional accounts. Gets Postman elements (entities) by a given tag. Tags enable you to organize and search workspaces, APIs, and collec...
Parameters* required
cursorstringThe cursor to get the next set of results in the paginated response. If you pass an invalid value, the API only returns the first set of results.
directionstringThe ascending (`asc`) or descending (`desc`) order to sort the results by, based on the time of the entity's tagging.one of
asc · descdefault: descentityTypestringFilter results for the given entity type.one of
api · collection · workspacelimitintegerThe maximum number of tagged elements to return in a single call.default: 10
slugstringThe tag's ID within a team or individual (non-team) user scope.
getWorkspaceGets information about a workspace. **Note:** This endpoint's response contains the \`visibility\` field. [Visibility](https://learning.postman.com/docs/collaborating-in-postman/using-workspaces/managing-workspaces/#changing-workspace-visibility) determines who can access the...2 params
Gets information about a workspace. **Note:** This endpoint's response contains the \`visibility\` field. [Visibility](https://learning.postman.com/docs/collaborating-in-postman/using-workspaces/managing-workspaces/#changing-workspace-visibility) determines who can access the...
Parameters* required
includestringInclude the following information in the endpoint's response:
- `mocks:deactivated` — Include all deactivated mock servers in the response.
- `scim` — Return the SCIM user IDs of the workspace crea...one of
mocks:deactivated · scimworkspaceIdstringThe workspace's ID.
getWorkspacesGets all workspaces you have access to. - For “my …” requests, first call GET \`/me\` and pass \`createdBy={me.user.id}\`. - This endpoint's response contains the visibility field. Visibility determines who can access the workspace: - \`personal\` — Only you can access the wor...3 params
Gets all workspaces you have access to. - For “my …” requests, first call GET \`/me\` and pass \`createdBy={me.user.id}\`. - This endpoint's response contains the visibility field. Visibility determines who can access the workspace: - \`personal\` — Only you can access the wor...
Parameters* required
createdByintegerReturn only workspaces created by the specified Postman user ID.
- For “my …” requests, set `createdBy` to the current user’s ID from GET `/me` (`me.user.id`).
- If the user's ID is not known, firs...
includestringInclude the following information in the endpoint's response:
- `mocks:deactivated` — Include all deactivated mock servers in the response.
- `scim` — Return the SCIM user IDs of the workspace crea...one of
mocks:deactivated · scimtypestringThe type of workspace to filter the response by. One of: `personal`, `team`, `private`, `public`, `partner`.
- For “my …” requests, this can be combined with `createdBy`. If type is not specified,...one of
personal · team · private · public · partnerpublishMockPublishes a mock server. Publishing a mock server sets its **Access Control** configuration setting to public.1 params
Publishes a mock server. Publishing a mock server sets its **Access Control** configuration setting to public.
Parameters* required
mockIdstringThe mock's ID.
putCollectionReplaces the contents of a collection using the [Postman Collection v2.1.0 schema format](https://schema.postman.com/collection/json/v2.1.0/draft-07/docs/index.html). Include the collection's ID values in the request body. If you do not, the endpoint removes the existing items...3 params
Replaces the contents of a collection using the [Postman Collection v2.1.0 schema format](https://schema.postman.com/collection/json/v2.1.0/draft-07/docs/index.html). Include the collection's ID values in the request body. If you do not, the endpoint removes the existing items...
Parameters* required
PreferstringThe `respond-async` header to perform the update asynchronously.
collectionobjectcollectionIdstringThe collection ID must be in the form <OWNER_ID>-<UUID> (e.g. 12345-33823532ab9e41c9b6fd12d0fd459b8b).
putEnvironmentReplaces all the contents of an environment with the given information. **Note:** - The request body size cannot exceed the maximum allowed size of 30MB. - If you receive an HTTP \`411 Length Required\` error response, manually pass the \`Content-Length\` header and its value...2 params
Replaces all the contents of an environment with the given information. **Note:** - The request body size cannot exceed the maximum allowed size of 30MB. - If you receive an HTTP \`411 Length Required\` error response, manually pass the \`Content-Length\` header and its value...
Parameters* required
environmentobjectInformation about the environment.
environmentIdstringThe environment's ID.
runCollectionRuns a Postman collection by ID with detailed test results and execution statistics. Supports optional environment for variable substitution. Note: Advanced parameters like custom delays and other runtime options are not yet available.9 params
Runs a Postman collection by ID with detailed test results and execution statistics. Supports optional environment for variable substitution. Note: Advanced parameters like custom delays and other runtime options are not yet available.
Parameters* required
abortOnErrorbooleanAbruptly halt on errors (default: false)
abortOnFailurebooleanAbruptly halt on test failures (default: false)
collectionIdstringThe collection ID in the format <OWNER_ID>-<UUID> (e.g. 12345-33823532ab9e41c9b6fd12d0fd459b8b).
environmentIdstringOptional environment ID to use for variable substitution during the run.
iterationCountnumberNumber of iterations to run (default: 1)
requestTimeoutnumberRequest timeout in milliseconds (default: 60000)
scriptTimeoutnumberScript timeout in milliseconds (default: 5000)
stopOnErrorbooleanGracefully halt on errors (default: false)
stopOnFailurebooleanGracefully halt on test failures (default: false)
syncCollectionWithSpecSyncs a collection generated from an API specification. This is an asynchronous endpoint that returns an HTTP \`202 Accepted\` response. **Note:** - This endpoint only supports the OpenAPI 3.0 specification type. - You can only sync collections generated from the given spec ID.2 params
Syncs a collection generated from an API specification. This is an asynchronous endpoint that returns an HTTP \`202 Accepted\` response. **Note:** - This endpoint only supports the OpenAPI 3.0 specification type. - You can only sync collections generated from the given spec ID.
Parameters* required
collectionUidstringThe collection's unique ID.
specIdstringThe spec's ID.
syncSpecWithCollectionSyncs an API specification linked to a collection. This is an asynchronous endpoint that returns an HTTP \`202 Accepted\` response. **Note:** - This endpoint only supports the OpenAPI 3.0 specification type. - You can only sync specs generated from the given collection ID.2 params
Syncs an API specification linked to a collection. This is an asynchronous endpoint that returns an HTTP \`202 Accepted\` response. **Note:** - This endpoint only supports the OpenAPI 3.0 specification type. - You can only sync specs generated from the given collection ID.
Parameters* required
collectionUidstringThe collection's unique ID.
specIdstringThe spec's ID.
updateCollectionRequestUpdates a request in a collection. For a complete list of properties, refer to the **Request** entry in the [Postman Collection Format documentation](https://schema.postman.com/collection/json/v2.1.0/draft-07/docs/index.html). **Note:** - You must pass a collection ID (\`12ece...15 params
Updates a request in a collection. For a complete list of properties, refer to the **Request** entry in the [Postman Collection Format documentation](https://schema.postman.com/collection/json/v2.1.0/draft-07/docs/index.html). **Note:** - You must pass a collection ID (\`12ece...
Parameters* required
authvalueThe request's authentication information.
collectionIdstringThe collection's ID.
datavalueThe request body's form data.
dataModestringThe request body's data mode.one of
raw · urlencoded · formdata · binary · graphqldataOptionsvalueAdditional configurations and options set for the request body's various data modes.
descriptionstringThe request's description.
eventsvalueA list of scripts configured to run when specific events occur.
graphqlModeDatavalueThe request body's GraphQL mode data.
headerDataarrayThe request's headers.
methodstringThe request's HTTP method.one of
GET · PUT · POST · PATCH · DELETE · COPYnamestringThe request's name.
queryParamsarrayThe request's query parameters.
rawModeDatastringThe request body's raw mode data.
requestIdstringThe request's ID.
urlstringThe request's URL.
updateMockUpdates a mock server. - Resource: Mock server entity associated with a collection UID. - Use this to change name, environment, privacy, or default server response.2 params
Updates a mock server. - Resource: Mock server entity associated with a collection UID. - Use this to change name, environment, privacy, or default server response.
Parameters* required
mockobjectmockIdstringThe mock's ID.
updateSpecFileUpdates an API specification's file. **Note:** - This endpoint does not accept an empty request body. You must pass one of the accepted values. - This endpoint does not accept multiple request body properties in a single call. For example, you cannot pass both the \`content\`...5 params
Updates an API specification's file. **Note:** - This endpoint does not accept an empty request body. You must pass one of the accepted values. - This endpoint does not accept multiple request body properties in a single call. For example, you cannot pass both the \`content\`...
Parameters* required
contentstringThe specification's stringified contents.
filePathstringThe path to the file.
namestringThe file's name.
specIdstringThe spec's ID.
typestringThe type of file:
- `ROOT` — The file containing the full OpenAPI structure. This serves as the entry point for the API spec and references other (`DEFAULT`) spec files. Multi-file specs can only h...one of
DEFAULT · ROOTupdateSpecPropertiesUpdates an API specification's properties, such as its name.2 params
Updates an API specification's properties, such as its name.
Parameters* required
namestringThe spec's name.
specIdstringThe spec's ID.
updateWorkspaceUpdates a workspace. **Note:** - This endpoint does not support the following visibility changes: - \`private\` to \`public\`, \`public\` to \`private\`, and \`private\` to \`personal\` for **Free** and **Solo** [plans](https://www.postman.com/pricing/). - \`public\` to \`pers...2 params
Updates a workspace. **Note:** - This endpoint does not support the following visibility changes: - \`private\` to \`public\`, \`public\` to \`private\`, and \`private\` to \`personal\` for **Free** and **Solo** [plans](https://www.postman.com/pricing/). - \`public\` to \`pers...
Parameters* required
workspaceobjectworkspaceIdstringThe workspace's ID.
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:
https://mcp.postman.com/minimal
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:
npx @postman/postman-mcp-server
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
| Agent / IDE | Remote | Local |
|---|---|---|
| Claude Code | Docs | Docs |
| Claude Desktop | Docs | Docs |
| Cursor | Docs | Docs |
| VS Code | Docs | Docs |
| Codex | Docs | Docs |
| Antigravity CLI | Docs | Docs |
| GitHub Copilot CLI | Docs | Docs |
| Kiro | Docs | Docs |
| Docker | — | Docs |
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
Featured
Fastest browser for AI agents to run web automation tasks, always free.
Download Free life-time →Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →Block distracting apps from your iPhone permanently without a 3rd party app. Free and open source.
Block now (100% free) →Configuration
POSTMAN_API_KEY*secretA valid Postman API key.
Registryactive
Package@postman/postman-mcp-server
TransportSTDIO, HTTP
AuthRequired
UpdatedJun 8, 2026