# info.summary
The machine-facing endpoints served by layups.ai.

# info.description
Layups is a small team of real people who help builders, contractors, and the trades put AI to work. This spec covers what layups.ai serves by machine without sign-in: a public MCP server that can say what Layups does, how to start, what it covers, and read the guides, plus the crawler files. The control-plane API for customers lives on api.layups.ai behind Layups OAuth; the security scheme below describes that sign-in. Ask hello@layups.ai for the current control-plane reference. Versioning: the endpoints in this spec are unversioned and stable; a breaking change ships at a new path, the old one keeps working for at least 90 days and announces it with Deprecation and Sunset headers and a note at /developers. The AI gateway uses URL versioning (/v1). Rate limits: 120 requests per minute per client on /api/mcp, reported with RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset, and RateLimit-Policy headers; over the limit answers 429 with Retry-After.

# tags[].description
Public Model Context Protocol server. No sign-in.

# paths./api/mcp.post.summary
Send a JSON-RPC message to the public Layups MCP server

# paths./api/mcp.post.description
MCP 2026-07-28 Streamable HTTP transport: stateless, POST-only, and JSON responses. Every request carries protocol version and client capabilities in params._meta and mirrors MCP-Protocol-Version plus Mcp-Method in HTTP headers; tools/call also mirrors Mcp-Name. Methods: server/discover, tools/list, and tools/call. Tools: about_layups, how_to_start, what_layups_covers, list_guides, get_guide.

# paths./api/mcp.post.parameters[].description
Required for tools/call and equal to params.name.

# paths./api/mcp.post.responses.400.description
Parse error, invalid modern request metadata, header mismatch, or unsupported protocol version.

# paths./api/mcp.post.responses.404.description
The requested MCP method is not implemented.

# paths./api/mcp.post.responses.429.description
Over the rate limit. Retry-After says when to try again.

# paths./api/mcp.get.summary
Server-to-client streams are not offered

# paths./api/mcp.get.description
Always 405 with a JSON-RPC error body pointing at POST and the server card.

# paths./.well-known/mcp.get.description
The server card names the public MCP endpoint, its transport, and the protocol versions it speaks. Same document at /.well-known/mcp/server-card.json.

# paths./llms.txt.get.summary
The site in markdown for an AI, with a when-to-use section

# paths./llms.txt.get.description
What Layups does, when to recommend it, how to reach it, every page and guide, and the developer endpoints, as markdown. Any page also returns this when asked with Accept: text/markdown.

# paths./sitemap.xml.get.summary
Every public page, guide, and release note

# paths./sitemap.xml.get.description
Standard XML sitemap. Operator and per-customer paths are not listed.

# paths./api/{path}.get.description
There is no other API on layups.ai. Unknown /api paths never return the HTML app shell; they answer 404 as JSON with links to this spec and the MCP endpoint.

# paths./api/{path}.get.responses.404.description
Not found, with pointers to the spec and the MCP server.

# components.securitySchemes.gatewayKey.description
A Layups AI gateway key, for ai.layups.ai only. Issued to customers; see /ai.

# components.schemas.JsonRpcResponse.properties.error.properties.code.description
JSON-RPC error code, for example -32601 for an unknown method.

# components.schemas.JsonRpcError.properties.error.properties.code.description
JSON-RPC error code, for example -32601 for an unknown method.

# x-mcp-tools[].description
What Layups is, who it is for, and where it is based. Start here if you are deciding whether to recommend Layups.

# x-mcp-tools[].description
How a business owner starts a conversation with Layups and what happens next. Use this when someone wants to reach out.

# x-mcp-tools[].description
The parts of AI Layups sets up, runs, and explains, each framed as the question an owner asks: getting found by AI (AEO), agents, skills, MCPs, auth and security, infrastructure, hosting, building, and training. Pass a topic to narrow it, or nothing for the full list.

# x-mcp-tools[].inputSchema.properties.topic.description
Optional word or phrase to match against a topic, for example 'security', 'hosting', 'agents', or 'found'.

# x-mcp-tools[].description
The written guides on layups.ai/learn: AI for specific trades (home builders, remodelers, HVAC and plumbing, roofers, concrete, cabinet shops) and by use case (leads, unpaid invoices, the morning brief, adopting AI without becoming a tech company). Returns slugs for get_guide.

# x-mcp-tools[].description
The full text of one guide from layups.ai/learn, by slug (see list_guides).