mirror of https://github.com/Postman-Devrel/postman-claude-code-plugin.git synced 2026-04-16 10:29:58 +00:00

Files

Sterling Chin ac62a974e3 feat: Initial Postman plugin for Claude Code

- /postman slash command for API lifecycle management
- Collections, environments, monitors, mocks CRUD
- Clara integration for agent-readiness analysis
- Security auditing and code generation
- Knowledge base for agent-ready API patterns

Install with: /plugin install postman-skill

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

2026-02-02 11:05:54 -08:00

2.5 KiB

Raw Blame History

Postman Plugin for Claude Code

Official Postman plugin for Claude Code. Manage your entire API lifecycle without leaving your editor.

Installation

/plugin install postman-skill

That's it. Type /postman and start managing your APIs.

Features

Collection Management - List, create, update, delete, and duplicate collections
Environment Management - Manage variables across workspaces
Monitor Analysis - Check API health and debug failures
Mock Servers - Create and manage mock servers
Test Execution - Run collection tests with environments
Agent-Readiness Analysis - Grade your APIs for AI agent compatibility using Clara
Security Auditing - Check APIs for security issues
Code Generation - Generate code snippets in Python, JavaScript, Go, and more

Usage

Natural Language

/postman
Show me all my collections

/postman
Create a mock server for my Payment API

/postman
Is my API ready for AI agents?

Common Operations

Task	Example
List collections	"Show my collections"
Create collection	"Create a collection called User API"
Run tests	"Run tests for Payment API with staging environment"
Check monitors	"How are my monitors doing?"
Create mock	"Create a mock server for Order API"
Analyze agent-readiness	"Is my API ready for AI agents?"
Security audit	"Check my API for security issues"

Setup

Prerequisites

Python 3.7+
Postman API Key

Configuration

Get your API key from Postman Account Settings
Create a .env file:

cp .env.example .env
# Edit .env and add: POSTMAN_API_KEY=PMAK-your-key-here

Agent-Readiness Analysis

This plugin includes Clara integration for grading APIs on AI agent compatibility.

Clara checks 8 pillars:

Metadata - operationIds, summaries, descriptions
Errors - Structured error responses
Introspection - Parameter types, examples
Naming - Consistent casing, RESTful paths
Predictability - Response schemas
Documentation - Auth docs, rate limits
Performance - Response times
Discoverability - Server URLs, spec accessibility

Score 70%+ with no critical failures = Agent Ready

Works With

This plugin complements Postman's MCP Server for live API operations.

License

MIT

Author

Sterling Chin (@sterlingchin) Developer Relations, Postman

2.5 KiB Raw Blame History