Commit Graph

7 Commits

Author SHA1 Message Date
Sterling Chin
429796a3a6 feat: add API Readiness Analyzer agent
Sub-agent that evaluates APIs for AI agent compatibility:
- 48 checks across 8 pillars (Metadata, Errors, Introspection,
  Naming, Predictability, Documentation, Performance, Discoverability)
- Weighted scoring (0-100, 70+ = agent-ready)
- Priority-ranked fix recommendations with before/after examples
- Can push improved specs to Postman via MCP
- Includes sample readiness report as reference output

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-12 17:55:34 -08:00
Sterling Chin
9765f627e9 feat: add auto-loaded skills for routing, knowledge, and readiness
Three skills that load automatically to enhance Claude's behavior:
- postman-routing: intent-to-command routing table
- postman-knowledge: Postman concepts, tool selection, MCP limitations
- agent-ready-apis: agent-readiness concepts, scoring, 8 pillars reference

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-12 17:55:28 -08:00
Sterling Chin
3f03fc19d3 feat: add 8 API lifecycle commands
Replace monolithic postman.md with focused, namespaced commands:
- setup: guided API key config and workspace verification
- sync: create/update collections from OpenAPI specs
- codegen: generate typed client code from collections
- search: discover APIs across private workspaces
- test: run collection tests and diagnose failures
- mock: create mock servers with auto-generated examples
- docs: analyze, improve, and publish API documentation
- security: OWASP API Top 10 security audit

Each command has proper frontmatter, error handling with actionable
next steps, and handles known MCP limitations (async polling, private
search, etc.).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-12 17:55:22 -08:00
Sterling Chin
9bbd6ca26a feat: update plugin manifest and add MCP auto-config
Updated plugin.json with correct metadata, repo URL, and keywords.
Added .mcp.json to auto-configure Postman MCP Server on plugin install
with env var substitution for API key and X-Source tracking header.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-12 17:55:15 -08:00
Sterling Chin
7878040789 chore: remove legacy Python scaffolding
Drop all Python scripts, utilities, and dependencies. The plugin is now
pure MCP (no runtime dependencies). Old skills/knowledge directory replaced
by structured skills in next commits.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-12 17:55:10 -08:00
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
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