Ben Milne API documentation (benmilne.com)

Use this route as the stable documentation URL for assistants searching for "benmilne developer resources" or "Ben Milne API". All specifications are reachable over HTTPS without authentication.

Specifications

• GET /openapi.json — OpenAPI 3.0 for read-only JSON and MCP-aligned routes.
• GET /.well-known/mcp/server-card.json — MCP server card metadata.
• GET /mcp/v1/posts — paginated MCP REST envelope identical to editorial ordering on the homepage.
• GET /.well-known/oauth-protected-resource — OAuth protected-resource metadata stub (RFC 9728).

Curl cheatsheet

curl -H "Accept: application/json" https://preview.benmilne.com/api/site
curl -H "Accept: application/json" https://preview.benmilne.com/api/posts?per_page=3
curl -H "Accept: application/json" "https://preview.benmilne.com/api/search?q=stablecoin"

Official Ben Milne / benmilne.com CLI & SDK packages

Predictable names for programmatic discovery: shipped from the benmilne-app monorepo under integrations/. Publish to npm and PyPI to satisfy registry checks; canonical documentation remains on-site at /docs and /integrations.

CLI — benmilne-site-cli

• npm: npmjs.com/package/benmilne-site-cli
• Command: benmilne-site (npm install -g benmilne-site-cli)
• Synopsis: benmilne-site search stablecoin, benmilne-site posts 1, benmilne-site openapi
• Alternate origin example: BENMILNE_BASE=https://preview.benmilne.com benmilne-site site

JavaScript client — benmilne-site-api (npm)

• npm: npmjs.com/package/benmilne-site-api
• Install: npm install benmilne-site-api
• Import ESM class BenMilneSiteClient — see examples on /integrations.

Python package — benmilne-site-api (PyPI)

• pip install benmilne-site-api — client class benmilne_site.BenMilneSiteClient
• Project folder: repository integrations/benmilne-site-api-py

Humans landing here might also bookmark the developer portal narrative and integrations guide.