Postman Knowledge
Reference for Postman concepts and MCP tool selection. Use this context when working with Postman MCP tools to make better decisions.
Core Concepts
- Collection: A group of API requests organized in folders. The primary unit of work in Postman. Contains requests, examples, tests, and documentation.
- Environment: Key-value pairs (variables) scoped to a context (dev, staging, prod). Used to swap base URLs, auth tokens, and config without changing requests.
- Workspace: Container for collections, environments, and specs. Can be personal, team, or public.
- Spec (Spec Hub): An OpenAPI or AsyncAPI definition stored in Postman. Can generate collections and stay synced.
- Request: A single API call definition (method, URL, headers, body, tests).
- Response: A saved example response for a request. Used by mock servers and documentation.
- Folder: A grouping within a collection, typically by resource (e.g., "Users", "Orders").
- Tags: Labels on collections for categorization and search.
- Monitor: A scheduled collection runner that checks API health.
- Mock Server: A fake API that serves example responses from a collection.
Decision Guide
| Goal |
Approach |
| Push code changes to Postman |
Create/update spec in Spec Hub, then sync to collection |
| Consume a Postman API |
Read collection + generate client code |
| Find an API |
Use searchPostmanElements, then drill into details |
| Test an API |
Run collection with runCollection |
| Create a fake API for frontend |
Create mock server from collection with examples |
| Document an API |
Analyze collection completeness, fill gaps, optionally publish |
| Audit API security |
Run security checks against spec or collection |
MCP Tool Selection
Workspace operations: getWorkspaces, getWorkspace, createWorkspace
Collection CRUD: getCollections, getCollection, createCollection, putCollection, patchCollection, deleteCollection
Request/Response: getCollectionRequest, createCollectionRequest, updateCollectionRequest, getCollectionResponse, createCollectionResponse, updateCollectionResponse
Folder management: getCollectionFolder, createCollectionFolder, updateCollectionFolder
Spec Hub: getAllSpecs, getSpec, createSpec, getSpecDefinition, updateSpecFile, getSpecFiles
Sync: generateCollection, syncCollectionWithSpec, syncSpecWithCollection
Environments: getEnvironments, getEnvironment, createEnvironment, putEnvironment
Mocks: getMocks, getMock, createMock, publishMock, unpublishMock
Tests: runCollection
Docs: publishDocumentation, unpublishDocumentation
Search: searchPostmanElements , getTaggedEntities
User: getAuthenticatedUser
See mcp-limitations.md in this skill folder for known limitations and workarounds.
1---2name: postman-knowledge3description: Postman concepts and MCP tool guidance. Loaded when working with Postman MCP tools to make better decisions about tool selection and workarounds.4user-invocable: false5metadata:6 source: https://skillmd.com/skills/agentcorp-inc/postman-knowledge7---89# Postman Knowledge1011Reference for Postman concepts and MCP tool selection. Use this context when working with Postman MCP tools to make better decisions.1213## Core Concepts1415- **Collection:** A group of API requests organized in folders. The primary unit of work in Postman. Contains requests, examples, tests, and documentation.16- **Environment:** Key-value pairs (variables) scoped to a context (dev, staging, prod). Used to swap base URLs, auth tokens, and config without changing requests.17- **Workspace:** Container for collections, environments, and specs. Can be personal, team, or public.18- **Spec (Spec Hub):** An OpenAPI or AsyncAPI definition stored in Postman. Can generate collections and stay synced.19- **Request:** A single API call definition (method, URL, headers, body, tests).20- **Response:** A saved example response for a request. Used by mock servers and documentation.21- **Folder:** A grouping within a collection, typically by resource (e.g., "Users", "Orders").22- **Tags:** Labels on collections for categorization and search.23- **Monitor:** A scheduled collection runner that checks API health.24- **Mock Server:** A fake API that serves example responses from a collection.2526## Decision Guide2728| Goal | Approach |29|------|----------|30| Push code changes to Postman | Create/update spec in Spec Hub, then sync to collection |31| Consume a Postman API | Read collection + generate client code |32| Find an API | Use `searchPostmanElements`, then drill into details |33| Test an API | Run collection with `runCollection` |34| Create a fake API for frontend | Create mock server from collection with examples |35| Document an API | Analyze collection completeness, fill gaps, optionally publish |36| Audit API security | Run security checks against spec or collection |3738## MCP Tool Selection3940**Workspace operations:** `getWorkspaces`, `getWorkspace`, `createWorkspace`41**Collection CRUD:** `getCollections`, `getCollection`, `createCollection`, `putCollection`, `patchCollection`, `deleteCollection`42**Request/Response:** `getCollectionRequest`, `createCollectionRequest`, `updateCollectionRequest`, `getCollectionResponse`, `createCollectionResponse`, `updateCollectionResponse`43**Folder management:** `getCollectionFolder`, `createCollectionFolder`, `updateCollectionFolder`44**Spec Hub:** `getAllSpecs`, `getSpec`, `createSpec`, `getSpecDefinition`, `updateSpecFile`, `getSpecFiles`45**Sync:** `generateCollection`, `syncCollectionWithSpec`, `syncSpecWithCollection`46**Environments:** `getEnvironments`, `getEnvironment`, `createEnvironment`, `putEnvironment`47**Mocks:** `getMocks`, `getMock`, `createMock`, `publishMock`, `unpublishMock`48**Tests:** `runCollection`49**Docs:** `publishDocumentation`, `unpublishDocumentation`50**Search:** `searchPostmanElements` , `getTaggedEntities`51**User:** `getAuthenticatedUser`5253See `mcp-limitations.md` in this skill folder for known limitations and workarounds.