Commands¶

After postman-mcp init, six slash commands are available inside Claude Code. The five sync commands are one engine plus five selectors — they all build the same complete Postman request; they differ only in which code goes in and where it lands.

Command	One-liner
`/postman:syncapi`	Sync one API. The kernel.
`/postman:syncchanges`	Sync what changed since last sync. The daily driver.
`/postman:sync`	Sync everything in one file / module / directory.
`/postman:syncall`	Sync the whole codebase. First-run / post-refactor.
`/postman:createenv`	Generate a Postman environment from code.
`/postman:status`	Read-only drift check. No writes.

The diff-then-confirm contract¶

Every write-capable command follows the same two-phase contract, so nothing reaches Postman by surprise:

sequenceDiagram
    participant You
    participant CC as Claude Code
    participant S as MCP server
    participant P as Postman
    You->>CC: /postman:syncapi createPayment
    CC->>S: syncapi(target, confirm=false)
    S->>P: GET collection (read structure)
    S-->>CC: diff preview (writes nothing)
    CC-->>You: SYNC PREVIEW … Write? [y/n]
    You->>CC: y
    CC->>S: syncapi(target, confirm=true)
    S->>P: PUT merged collection
    S-->>CC: ✓ written

On n, nothing is written. There is no skip flag — see the safety rules.

Terminal vs. Claude Code¶

The /postman:* commands above run inside Claude Code. Setup commands run in the terminal and are not slash commands:

postman-mcp init — one-time project setup.
postman-mcp doctor — re-validate the whole setup chain.
postman-mcp serve — boot the MCP server (Claude Code launches this for you).
postman-mcp version — print the version.