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

Files

Sterling Chin 7fdfac1a86 feat: integrate Learning Center MCP for documentation intelligence

- Add postman-docs MCP server to plugin.json (v1.1.0)
- Update command instructions to use docs MCP for "how do I" questions
- Update README with documentation intelligence section
- Plugin now combines operations (scripts) + knowledge (docs MCP)

This turns AI into a true Postman expert that can both execute
and explain. Jon Konrath's Learning Center MCP endpoint:
https://learning.postman.com/_mcp/server

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

2026-02-02 11:40:23 -08:00

3.0 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

Documentation Intelligence

This plugin includes the Postman Learning Center MCP for documentation access. When you ask "how do I..." questions, Claude can pull actual Postman docs instead of guessing.

/postman
How do I set up OAuth 2.0 authentication?

The plugin queries https://learning.postman.com/_mcp/server for accurate, up-to-date documentation.

Works With

This plugin complements:

Postman Learning Center MCP - Documentation and how-to guides (included)
Postman's MCP Server - Live API operations

License

MIT

Author

Sterling Chin (@sterlingchin) Developer Relations, Postman

3.0 KiB Raw Blame History