MCP Server API Contracts for AI Agents
Write API spec contracts for MCP servers: input schemas, output shapes, error taxonomies, idempotency flags, and versioning that AI agent clients can rely on.
Topic: API Contracts
A focused archive of API Contracts articles for spec-first teams.
Designing API Specs for Agentic Clients
Design API specs for LLM-powered agentic clients with discoverable fields, idempotency, dry-runs, semantic descriptions, and safe destructive actions.
Contract Testing Plan: From OpenAPI to CI
Add contract testing from OpenAPI to CI with generated tests, provider checks, consumer expectations, and reliable fixtures.
Event-Driven Systems: Specification Patterns
Specification patterns for event-driven systems: schema versioning, command vs fact events, orchestration choices, idempotent handlers, and replay safety.
Payment Workflow Spec: Failure and Retry Matrix
Write payment workflow specs with retryable errors, declined-card handling, timeout behavior, 3DS branches, and dunning states.