---
title: OpenAPI spec
description: Machine-readable API contract with agent instructions and x-mcp annotations.
canonical: https://bennybooks.com/developers/reference/openapi
markdown: https://bennybooks.com/developers/reference/openapi.md
---
# OpenAPI spec

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

> **Documentation index.** Fetch [https://bennybooks.com/developers/llms.txt](https://bennybooks.com/developers/llms.txt) before browsing further. Prefer markdown (this file or `Accept: text/markdown`). Site-wide map: [https://bennybooks.com/llms.txt](https://bennybooks.com/llms.txt).

The OpenAPI 3.0 spec documents REST https://bennybooks.com/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).

```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 (also drives /api/mcp). Design guide: https://bennybooks.com/developers/guides/mcp-design · Native MCP: https://bennybooks.com/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).

---

## Machine-readable

- HTML: https://bennybooks.com/developers/reference/openapi
- Markdown: https://bennybooks.com/developers/reference/openapi.md
- Docs index: https://bennybooks.com/developers/llms.txt
- OpenAPI: https://bennybooks.com/openapi.json
- Skill: https://bennybooks.com/skill.md
- Auth: https://bennybooks.com/auth.md

```json
{
  "@context": "https://schema.org",
  "@type": "TechArticle",
  "headline": "OpenAPI spec",
  "description": "Machine-readable API contract with agent instructions and x-mcp annotations.",
  "url": "https://bennybooks.com/developers/reference/openapi",
  "inLanguage": "en",
  "encodingFormat": [
    "text/html",
    "text/markdown"
  ],
  "isAccessibleForFree": true,
  "publisher": {
    "@type": "Organization",
    "name": "BennyBooks",
    "url": "https://bennybooks.com",
    "logo": {
      "@type": "ImageObject",
      "url": "https://bennybooks.com/apple-icon.png"
    }
  },
  "mainEntityOfPage": "https://bennybooks.com/developers/reference/openapi",
  "image": "https://bennybooks.com/opengraph-image",
  "workExample": {
    "@type": "CreativeWork",
    "url": "https://bennybooks.com/developers/reference/openapi.md",
    "encodingFormat": "text/markdown",
    "name": "OpenAPI spec (Markdown)"
  },
  "about": {
    "@type": "WebAPI",
    "name": "BennyBooks Agent API",
    "url": "https://bennybooks.com/api/v1",
    "documentation": "https://bennybooks.com/developers"
  }
}
```
