Source: https://agentsurface.dev/about
Index: https://agentsurface.dev/llms.txt

# About Agent Surface

Agent Surface explains how to make a website, app, API or CLI work with AI agents, and how to build agents of your own. Daniel Howells writes and maintains it.

## What it covers

The guide has two parts. [Make your product agent-ready](https://agentsurface.dev/docs) covers discovery, context files, APIs, tools, CLIs, MCP servers, authentication, errors, retrieval, agentic UI and agentic commerce. [Build agents](https://agentsurface.dev/docs/agents) is a current inventory of the frameworks, protocols and tools for teams building agents of their own.

## What you can use

Everything here is free to read and reuse under the MIT licence: the docs, the Surface skill for coding agents, the starter templates, and the scorecard used to audit a codebase.

Agents can read the site too. Every page is available as Markdown, the whole site is indexed in [llms.txt](https://agentsurface.dev/llms.txt), and an MCP server at POST /mcp searches and reads the docs. The server is listed in the [official MCP Registry](https://registry.modelcontextprotocol.io/v0/servers/dev.agentsurface%2Fdocs/versions/latest) as dev.agentsurface/docs. None of it needs an account or a key.

## How it's kept current

Pages about fast-moving tools carry a last-verified date, and a page that goes 120 days without a check is flagged to be verified again against primary sources. Model names in examples are checked against a single allowlist during the build, and each entry on it is verified against the provider's own documentation.

The site itself is tested with the public agent-readiness checkers from Google Lighthouse, Cloudflare, Ora and Vercel, and the [scanner guide](https://agentsurface.dev/docs/scoring/public-scanners) explains what each one measures.

## Who makes it

Agent Surface is made by Daniel Howells. More about him at [danielhowells.com](https://danielhowells.com). The source is public on [GitHub](https://github.com/howells/agentsurface).

## Corrections

If something is wrong or out of date, [get in touch](https://agentsurface.dev/contact) or open an issue on GitHub with the page and a link to the source that shows the correct answer.