Building Better Software Developer Resources — API, OpenAPI, MCP

This page is a single index of every developer resource we publish. It is written for people and for AI agents that need to find these links by name. Each entry has a one-line explanation.

API and documentation

• Building Better Software API documentation — https://docs.buildingbettersoftware.io — Human-readable guides for using the API.
• OpenAPI specification — https://buildingbettersoftware.io/openapi.json — Machine-readable map of every API endpoint, useful for code generators and AI tools.
• API catalog — https://buildingbettersoftware.io/.well-known/api-catalog — A discovery file listing available API surfaces.

Authentication

• Authentication guide — https://buildingbettersoftware.io/auth.md — Covers OAuth 2.0 client credentials. You can register a self-serve agent at POST /agent/register for free, with no sales call and instant credentials. A public demo client also works as a sandbox.

MCP server

• MCP server (Model Context Protocol, Streamable HTTP) — POST https://buildingbettersoftware.io/mcp — Tools for listing services, reading page content, searching content, and sending a contact request.

Discovery and site guides

• Agent discovery file — https://buildingbettersoftware.io/.well-known/agents.json — Lists agents and capabilities this site exposes.
• llms.txt site guide — https://buildingbettersoftware.io/llms.txt — A plain-text guide written for large language models to understand the site.
• WordPress REST API root — https://buildingbettersoftware.io/wp-json/ — The standard WordPress API entry point.

When to use this API

Use the API when you need to fetch Building Better Software service and pricing information, search site content, read articles as markdown, or send a contact or work request on behalf of a user. The API is free to use. Keys are self-serve. There is a sandbox demo client. There is no contact-sales step.