# Postman (verified)

Test and debug APIs with collections, environments, and monitors. Run requests, inspect responses, and collaborate on API documentation.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add postman

# Browse available tools
npx -y @smithery/cli@latest tool list postman

# Get full schema for a tool
npx -y @smithery/cli@latest tool get postman createCollection

# Call a tool
npx -y @smithery/cli@latest tool call postman createCollection '{}'
```

## Direct MCP Connection

Endpoint: `https://postman.run.tools`

## Tools (41)

- `createCollection` — Creates a collection using the [Postman Collection v2.1.0 schema format](https://schema.postman.com/collection/json/v2.…
- `createCollectionRequest` — Creates a request in a collection. For a complete list of properties, refer to the **Request** entry in the [Postman Co…
- `createCollectionResponse` — Creates a request response in a collection. For a complete list of request body properties, refer to the **Response** e…
- `createEnvironment` — Creates an environment.
- `createMock` — Creates a mock server in a collection.
- `createSpec` — Creates an API specification in Postman's [Spec Hub](https://learning.postman.com/docs/design-apis/specifications/overv…
- `createSpecFile` — Creates an API specification file.
- `createWorkspace` — Creates a new [workspace](https://learning.postman.com/docs/collaborating-in-postman/using-workspaces/creating-workspac…
- `duplicateCollection` — Creates a duplicate of the given collection in another workspace.
- `generateCollection` — Creates a collection from the given API specification.
- `generateSpecFromCollection` — Generates an API specification for the given collection. The response contains a polling link to the task status.
- `getAllSpecs` — Gets all API specifications in a workspace.
- `getAuthenticatedUser` — Gets information about the authenticated user.
- `getCollection` — Get information about a collection. By default this tool returns the lightweight collection map (metadata + recursive i…
- `getCollections` — The workspace ID query is required for this endpoint. If not provided, the LLM should ask the user to provide it.
- `getDuplicateCollectionTaskStatus` — Gets the status of a collection duplication task.
- `getEnabledTools` — IMPORTANT: Run this tool first when a requested tool is unavailable. Returns information about which tools are enabled …
- `getEnvironment` — Gets information about an environment.
- `getEnvironments` — Gets information about all of your [environments](https://learning.postman.com/docs/sending-requests/managing-environme…
- `getGeneratedCollectionSpecs` — Gets the API specification generated for the given collection.
- `getMock` — Gets information about a mock server.
- `getMocks` — Gets all active mock servers. By default, returns only mock servers you created across all workspaces.
- `getSpec` — Gets information about an API specification.
- `getSpecCollections` — Gets all of an API specification's generated collections.
- `getSpecDefinition` — Gets the complete contents of an API specification's definition.
- `getSpecFile` — Gets the contents of an API specification's file.
- `getSpecFiles` — Gets all the files in an API specification.
- `getTaggedEntities` — **Requires an Enterprise plan.** Tagging is only available on Postman Enterprise plans. This tool returns a 404 error o…
- `getWorkspace` — Gets information about a workspace.
- `getWorkspaces` — Gets all workspaces you have access to.
- `publishMock` — Publishes a mock server. Publishing a mock server sets its **Access Control** configuration setting to public.
- `putCollection` — Replaces the contents of a collection using the [Postman Collection v2.1.0 schema format](https://schema.postman.com/co…
- `putEnvironment` — Replaces all the contents of an environment with the given information.
- `runCollection` — Runs a Postman collection by ID with detailed test results and execution statistics. Supports optional environment for …
- `syncCollectionWithSpec` — Syncs a collection generated from an API specification. This is an asynchronous endpoint that returns an HTTP \`202 Acc…
- `syncSpecWithCollection` — Syncs an API specification linked to a collection. This is an asynchronous endpoint that returns an HTTP \`202 Accepted…
- `updateCollectionRequest` — Updates a request in a collection. For a complete list of properties, refer to the **Request** entry in the [Postman Co…
- `updateMock` — Updates a mock server.
- `updateSpecFile` — Updates an API specification's file.
- `updateSpecProperties` — Updates an API specification's properties, such as its name.
- `updateWorkspace` — Updates a workspace.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get postman <tool-name>
```

## Resources

- `postman://instructions` — Instructions for using the Postman MCP server