Terminal
Terminal/Skill
Postman concepts and MCP tool guidance. Loaded when working with Postman MCP tools to make better decisions about tool selection and workarounds.
By Postman
Works with
npx skills add postmanlabs/postman-plugin --skill postman-mcp-serverReference for Postman concepts and MCP tool selection. Use this context when working with Postman MCP tools to make better decisions.
See references/setup.md for how to to setup postman mcp server and auth.
| 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 |
| Learn how to use a Postman feature | Search Postman docs with searchLearningCenter (Full mode) |
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
Learning Center: searchLearningCenter (Full mode only — searches Postman product docs for how-to guidance)
User: getAuthenticatedUser
See references/mcp-limitations.md for known limitations and workarounds.
Each reference below is a full MCP-tool workflow for one goal — the tool
call sequence, what to present at each step, and error handling. Reach for
one once the Decision Guide above has picked a goal; they assume MCP tools
only, no postman CLI.
references/setup.md — first-run auth (OAuth or API key) and workspace verification.references/search.md — discover APIs across workspaces with searchPostmanElements.references/sync.md — create/update collections from specs, or sync a spec from collection changes.references/mock.md — create a mock server from a collection or spec.references/test.md — run collection tests and diagnose failures.references/docs.md — generate, improve, and publish API documentation.references/security.md — audit a spec or collection against the OWASP API Top 10.references/learn.md — search the Postman Learning Center for how-to guidance.