API v1 · agent-friendly docs
OpenAPI spec
Machine-readable API contract with agent instructions and x-mcp annotations.
The OpenAPI 3.0 spec documents REST /api/v1 and carries the same curated tool metadata used by the native Streamable HTTP MCP server at /api/mcp. Prefer /api/mcp for IDE agents; use this OpenAPI document for code generators and OpenAPI bridges (e.g. AnythingMCP).
https://bennybooks.com/openapi.jsonStatic base: openapi/bennybooks-v1.json. Enrichment: lib/mcp/enrich-openapi.ts from lib/mcp/tool-catalog.ts (also drives /api/mcp). Design guide: /developers/guides/mcp-design · Native MCP: /developers/guides/mcp-server.
Native MCP first
Preferred: https://bennybooks.com/api/mcp with Authorization: Bearer bb_live_…. If you use an OpenAPI bridge, import this URL and enable only tools with x-mcp.exposeByDefault true (config/anythingmcp-bennybooks.yaml).