API v1 · agent-friendly docs

Connect Streamable HTTP MCP

Point Cursor, Claude, or any MCP host at BennyBooks /api/mcp with a bb_live_ bearer token.

View as Markdown Docs index llms.txt skill.md auth.md OpenAPI

BennyBooks hosts a native Streamable HTTP MCP server on this origin. Prefer it over an OpenAPI bridge when your host supports remote MCP URLs.

Endpoint

https://bennybooks.com/api/mcp — Authorization: Bearer bb_live_… (Settings → MCP & agents). Same curated tools as OpenAPI x-mcp.exposeByDefault.

Cursor

mcp.json (remote)

{
  "mcpServers": {
    "bennybooks": {
      "url": "https://bennybooks.com/api/mcp",
      "headers": {
        "Authorization": "Bearer bb_live_YOUR_TOKEN"
      }
    }
  }
}

Claude (custom connector)

Settings → Connectors → Add connector → Remote
Server URL: https://bennybooks.com/api/mcp
Transport: Streamable HTTP
Add Authorization: Bearer bb_live_… via the Headers helper

Claude Directory / OAuth

Directory listing needs OAuth CIMD (not pasted bearer tokens). v1 uses opaque bb_live_ tokens; OAuth is a documented follow-up.

Tools, resources, prompts

Tools: curated ledger actions from lib/mcp/tool-catalog.ts
Resources: bennybooks://ontology (JSON-LD), bennybooks://skill (skill.md)
Prompts: categorize, investigate, month-end

AnythingMCP remains supported if you prefer OpenAPI import. See Connect with AnythingMCP and MCP tool design. For terminal wiring: npx @bennybooks/cli agent setup (see CLI for agents & shell).