# OpenAPI spec

Machine-readable API contract with agent instructions and x-mcp annotations.

The OpenAPI 3.0 spec is the source of truth for AnythingMCP and other code generators. At serve time it is enriched with agent instructions, when/when-not descriptions, lean list defaults, and x-mcp annotations (exposeByDefault, readOnlyHint, etc.).

```text Spec URL
https://bennybooks.com/openapi.json
```

Static base: openapi/bennybooks-v1.json. Enrichment: lib/mcp/enrich-openapi.ts from lib/mcp/tool-catalog.ts. Design guide: /developers/guides/mcp-design.

> Import this URL in AnythingMCP, then enable only tools with x-mcp.exposeByDefault true (see config/anythingmcp-bennybooks.yaml).