---
title: Connect Streamable HTTP MCP
description: "Point Cursor, Claude, or any MCP host at BennyBooks /api/mcp with a bb_live_ bearer token."
canonical: https://bennybooks.com/developers/guides/mcp-server
markdown: https://bennybooks.com/developers/guides/mcp-server.md
---
# Connect Streamable HTTP MCP

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

> **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).

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

```json mcp.json (remote)
{
  "mcpServers": {
    "bennybooks": {
      "url": "https://bennybooks.com/api/mcp",
      "headers": {
        "Authorization": "Bearer bb_live_YOUR_TOKEN"
      }
    }
  }
}
```

## Claude (custom connector)

1. Settings → Connectors → Add connector → Remote
2. Server URL: https://bennybooks.com/api/mcp
3. Transport: Streamable HTTP
4. 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).

---

## Machine-readable

- HTML: https://bennybooks.com/developers/guides/mcp-server
- Markdown: https://bennybooks.com/developers/guides/mcp-server.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": "Connect Streamable HTTP MCP",
  "description": "Point Cursor, Claude, or any MCP host at BennyBooks /api/mcp with a bb_live_ bearer token.",
  "url": "https://bennybooks.com/developers/guides/mcp-server",
  "inLanguage": "en",
  "encodingFormat": [
    "text/html",
    "text/markdown"
  ],
  "isAccessibleForFree": true,
  "publisher": {
    "@type": "Organization",
    "name": "BennyBooks",
    "url": "https://bennybooks.com"
  },
  "mainEntityOfPage": "https://bennybooks.com/developers/guides/mcp-server",
  "workExample": {
    "@type": "CreativeWork",
    "url": "https://bennybooks.com/developers/guides/mcp-server.md",
    "encodingFormat": "text/markdown",
    "name": "Connect Streamable HTTP MCP (Markdown)"
  },
  "about": {
    "@type": "WebAPI",
    "name": "BennyBooks Agent API",
    "url": "https://bennybooks.com/api/v1",
    "documentation": "https://bennybooks.com/developers"
  }
}
```