# Ben Milne — API Reference

> Developer API for Ben Milne. All endpoints are public and unauthenticated.

## REST API

- [API docs](https://benmilne.com/api): Interactive HTML reference
- [OpenAPI spec](https://benmilne.com/openapi.json): OpenAPI 3.0.3 schema
- [Posts](https://benmilne.com/api/posts): Paginated post listing
- [Search](https://benmilne.com/api/search?q={query}): Full-text search
- [Site info](https://benmilne.com/api/site): Site metadata
- [Languages](https://benmilne.com/api/languages): 14 supported languages
- [Products](https://benmilne.com/api/products/the-value-layer): Product metadata
- [Batch](https://benmilne.com/api/batch): Batch multiple API calls
- [SSE streaming](https://benmilne.com/api/stream/search?q={query}): Progressive search results

## GraphQL

- [Endpoint](https://benmilne.com/graphql): POST with `{"query":"..."}`
- [Introspection](https://benmilne.com/graphql): GET returns SDL schema
- Relay-style cursor pagination, typed errors, rate-limit headers

## MCP (Model Context Protocol)

- [MCP endpoint](https://benmilne.com/mcp): Streamable HTTP JSON-RPC
- [Server card](https://benmilne.com/.well-known/mcp/server-card.json): Pre-connection discovery
- Tools: list_posts, get_post, search_posts

## Client libraries

- npm: `npm install -g benmilne-api`
- PyPI: `pip install benmilne-api`

## More

- [Full llms.txt](https://benmilne.com/llms-full.txt): Complete machine-oriented documentation
- [Agent rules](https://github.com/benmilne-com/agents): AGENTS.md, configs, skills
- [Agent card](https://benmilne.com/.well-known/agent.json): A2A discovery
- [Sandbox](https://benmilne.com/sandbox): Try API queries interactively