Sterling Chin

Clara

The API-readiness agent behind Postman's Claude Code plugin.

Clara is the foundation for the Postman Claude Code plugin and the agent that checks whether APIs are ready for AI agents. It looks beyond whether an endpoint works and evaluates whether an agent can safely discover, call, debug, and improve the API in real workflows.

Postman Claude Code plugin analyzing an API for AI readiness

API readiness model

The signals Clara uses to judge agent usability.

Machine-readable API contracts

Agent-safe authentication

Useful error semantics

Canonical request and response examples

Predictable state-changing operations

Observable agent traffic and audit trails

LLM-readable documentation

Repeatable evaluation workflows

Proof from the plugin

Clara powers the built-in API Readiness Analyzer in the Postman Claude Code plugin. It evaluates API definitions for AI agent compatibility, returns a score, calls out critical failures, and prioritizes recommendations.

48

readiness checks

8

readiness pillars

0-100

scored output

70%+

agent-ready threshold

Metadata

operation IDs, summaries, descriptions, and tags

Errors

error schemas, codes, retry guidance, and failure recovery

Introspection

parameter types, required fields, examples, and constraints

Naming

consistent casing, RESTful paths, and agent-readable names

Predictability

response schemas, pagination, dates, and stable output shapes

Documentation

auth docs, rate limits, usage notes, and task context

Performance

rate limit headers, caching, bulk endpoints, and efficient calls

Discoverability

OpenAPI version, server URLs, and crawlable API entry points

Postman Claude Code plugin

Clara is the foundation for the official Postman Claude Code plugin, bringing API creation, management, testing, and documentation into agentic developer workflows.

API readiness agent

Clara checks whether an API gives agents the contracts, examples, guardrails, errors, and observability they need to operate reliably.

Agentic workflow layer

Clara turns Postman collections, MCP patterns, and Claude Code workflows into a practical readiness model for teams shipping APIs to agents.

Focus

Clara focuses on API readiness for agents.

The goal is to help teams see whether their APIs, docs, collections, and workflows are usable by AI agents before those agents reach production users. That means Clara looks for the details that make APIs discoverable, predictable, debuggable, and safe to operate through Claude Code.