{
  "markdown": "<p align=\"center\">\n  <img src=\"https://voyager.postman.com/logo/postman-logo-orange.svg\" alt=\"Postman\" width=\"320\">\n</p>\n\n# Postman Plugin for Claude Code\n\nThe Postman Plugin provides a single, simple install for Claude Code. It provides full API lifecycle management, and best practices when working with Postman APIs. \n\n## What's included:\n- Commands for setting up the Postman MCP Server (no more manual installs!), working with Collections, Tests, Mock Servers, and generating code and documentation from Collections\n- Skills for API discovery and client code generation, OpenAPI spec generation, Postman CLI workflows, and API best practices\n- Agent for reviewing API production readiness and providing recommendations based on the <a href=\"https://www.postman.com/ai/90-day-ai-readiness-playbook/\">Postman API Readiness Guide</a>.\n\n## Installation\n\nInstall from Anthropic's official plugin marketplace.\n\nIn Claude Code:\n\n```\n/plugin install postman@claude-plugins-official\n```\n\nOr from the terminal:\n\n```bash\nclaude plugin install postman@claude-plugins-official\n```\n\n<details>\n<summary>Alternative: install from GitHub</summary>\n\n```bash\nclaude plugin install github:Postman-Devrel/postman-claude-code-plugin\n```\n</details>\n\n<details>\n<summary>Alternative: load from a local clone</summary>\n\n```bash\ngit clone https://github.com/Postman-Devrel/postman-claude-code-plugin.git\ncd your-api-project/\nclaude --plugin-dir /path/to/postman-claude-code-plugin\n```\n</details>\n\n## Quick Start\n\n1. Start Claude Code:\n```bash\nclaude\n```\n\n2. Run setup:\n```\n/postman:setup\n```\n\n3. Authenticate when prompted — **OAuth (recommended)**, which opens a browser sign-in with no key copying, or an API key:\n```bash\nexport POSTMAN_API_KEY=PMAK-your-key-here\n```\nIf you use an API key, add it to your shell profile (`~/.zshrc` or `~/.bashrc`) to persist across sessions. Get one at [go.postman.co/settings/me/api-keys](https://go.postman.co/settings/me/api-keys).\n\nThat's it. The plugin auto-configures the Postman MCP Server, verifies your connection, and lists your workspaces. You're ready to go.\n\n## Commands\n\n| Command | What It Does |\n|---------|-------------|\n| `/postman:setup` | Configure API key, verify connection, select workspace |\n| `/postman:sync` | Create or update Postman collections from OpenAPI specs |\n| `/postman:search` | Find APIs across your org's resources, your workspaces, and the public Postman network |\n| `/postman:context` | Fetch real API definitions, generate and maintain typed client code |\n| `/postman:test` | Run collection tests, diagnose failures, suggest fixes |\n| `/postman:mock` | Create mock servers for frontend development |\n| `/postman:docs` | Generate, improve, and publish API documentation |\n| `/postman:security` | Security audit against OWASP API Top 10 |\n| `/postman:learn` | Search the Postman Learning Center for how-to guidance and suggested workflows (Full mode) |\n\n## What You Can Do\n\n### Sync your API to Postman\n```\n\"Sync my OpenAPI spec with Postman\"\n→ Detects local spec, creates/updates collection, sets up environment\n```\n\n### Generate client code from private APIs\n```\n\"Generate a TypeScript client for the payments API\"\n→ Reads your Postman collection, detects project language, writes typed code\n```\n\n### Search across your workspace\n```\n\"Is there an endpoint that returns user emails?\"\n→ Searches across your org's collections, drills into endpoint details, shows response shapes\n```\n\n### Run API tests\n```\n\"Run the tests for my User API collection\"\n→ Executes collection, parses results, diagnoses failures, suggests code fixes\n```\n\n### Create mock servers\n```\n\"Create a mock for frontend development\"\n→ Generates missing examples, creates mock, provides integration config\n```\n\n### Audit API security\n```\n\"Run a security audit on my API\"\n→ 20+ checks including OWASP Top 10, severity scoring, remediation guidance\n```\n\n### Check if your API is agent-ready\n```\n\"Is my API ready for AI agents?\"\n→ 48 checks across 8 pillars, scored 0-100, prioritized fix recommendations\n```\n\n## Natural Language Routing\n\nYou don't need to remember command names. Claude matches your intent to the right command or skill natively:\n\n- \"Sync my collection\" runs `/postman:sync`\n- \"Check for vulnerabilities\" runs `/postman:security`\n- \"Is my API agent-ready?\" triggers the readiness analyzer\n\n## API Readiness Analyzer\n\nThe built-in readiness analyzer evaluates APIs for AI agent compatibility across 8 pillars:\n\n| Pillar | What It Checks |\n|--------|---------------|\n| Metadata | operationIds, summaries, descriptions, tags |\n| Errors | Error schemas, codes, retry guidance |\n| Introspection | Parameter types, required fields, examples |\n| Naming | Consistent casing, RESTful paths |\n| Predictability | Response schemas, pagination, date formats |\n| Documentation | Auth docs, rate limits |\n| Performance | Rate limit headers, caching, bulk endpoints |\n| Discoverability | OpenAPI version, server URLs |\n\n**70%+ with no critical failures = Agent-Ready.**\n\n## Requirements\n\n- Claude Code v1.0.33+\n- A Postman account — authenticate via OAuth during `/postman:setup`, or set a `POSTMAN_API_KEY` environment variable\n- No Python, Node, or other runtime dependencies\n\n## How It Works\n\nThe plugin bundles a `.mcp.json` file that auto-configures the [Postman MCP Server](https://github.com/postmanlabs/postman-mcp-server) when installed. All commands communicate with Postman through MCP tools. No scripts, no dependencies, pure MCP.\n\nBy default the plugin connects to the full Postman MCP Server (100+ tools). Recent Claude Code versions load MCP tool schemas on demand, so the full server adds little context overhead. If you're on an older client or want a lighter session, set `POSTMAN_MCP_MODE` before starting Claude Code to pick a smaller server mode:\n\n```bash\nexport POSTMAN_MCP_MODE=minimal   # ~42 CRUD tools; code-generation (context) tools unavailable\nexport POSTMAN_MCP_MODE=code      # ~24 read-only tools for API discovery and client code generation\n```\n\n## License\n\nApache-2.0\n\n## See Also\n\n- [Postman Plugin for Cursor](https://github.com/Postman-Devrel/cursor-postman-plugin) - Same capabilities, adapted for Cursor IDE\n- [Postman Agent Skills](https://github.com/Postman-Devrel/agent-skills) - Portable skills for any skills.sh-compatible agent\n- [Postman Cursor Rules](https://github.com/Postman-Devrel/postman-cursor-rules) - Lightweight MCP config + rules for Cursor\n\n## Links\n\n- [Postman MCP Server Docs](https://learning.postman.com/docs/developer/postman-mcp-server/)\n- [Get a Postman API Key](https://go.postman.co/settings/me/api-keys)\n- [Postman Status](https://status.postman.com)\n",
  "bytes": 6640,
  "sha": "e0fbd41279ca846961c4674d6ef203caf93f9bfae14322b089ae74bf1f3e5954",
  "repo_slug": "postman-devrel/postman-claude-code-plugin",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_postman_devrel_postman_claude_code_plugi_9ceb12d8/readme"
}