# Bridger Tower API

Public APIs for https://bridger.to. No access token is required.

## Discovery

- API catalog: https://bridger.to/.well-known/api-catalog
- OpenAPI: https://bridger.to/openapi.json
- MCP server card: https://bridger.to/.well-known/mcp/server-card.json
- ARD catalog: https://bridger.to/.well-known/ai-catalog.json
- Auth: https://bridger.to/auth.md

## Endpoints

### `GET /api/posts`

List published essays.

### `GET /api/posts/{slug}`

Fetch one essay as JSON, including markdown.

### `GET /api/health`

Liveness check.

### `POST /api/subscribe`

Newsletter signup.

```json
{ "email": "you@example.com" }
```

### `POST /mcp`

MCP Streamable HTTP. Tools: `list_posts`, `get_post`, `get_site_info`.

## Markdown

Send `Accept: text/markdown` on HTML pages to receive markdown.